Add a stub client lib

Author: aomarks

.gitignore

@@ -1,4 +1,5 @@
 lib/**/*
+lib_client/**/*
 node_modules/
 *.tgz
 testdata/*/output

package.json

@@ -12,16 +12,17 @@
   "bin": {
     "lit-localize": "bin/lit-localize.js"
   },
+  "main": "lib_client/index.js",
   "scripts": {
-    "clean": "rimraf 'lib/*' 'lib/.*' 'testdata/*/output'",
-    "build": "npm run clean && npm run generate-json-schema && tsc",
+    "clean": "rimraf 'lib/*' 'lib/.*' 'lib_client/*' 'lib_client/.*' 'testdata/*/output'",
+    "build": "npm run clean && npm run generate-json-schema && tsc && tsc --project tsconfig.client.json",
     "generate-json-schema": "typescript-json-schema tsconfig.schema.json ConfigFile --include=src/config.ts --required --noExtraProps > config.schema.json",
     "test": "npm run build && ava --verbose && npm run test:check-tsc && npm run test:check-eslint",
     "test:update-goldens": "npm run build && UPDATE_TEST_GOLDENS=true ava --verbose",
     "test:check-tsc": "ls testdata/*/output/tsconfig.json | xargs -n 1 tsc --noEmit --project",
     "test:check-eslint": "eslint 'testdata/*/output/*.ts' 'testdata/*/output/**/*.ts' --max-warnings 0",
-    "lint": "eslint 'src/*.ts' 'src/**/*.ts' --max-warnings 0",
-    "prettier": "prettier 'src/**/*.ts'",
+    "lint": "eslint 'src/*.ts' 'src/**/*.ts' 'src_client/*.ts' 'src_client/**/*.ts' --max-warnings 0",
+    "prettier": "prettier 'src/**/*.ts' 'src_client/**/*.ts'",
     "format:check": "npm run prettier -- --check",
     "format": "npm run prettier -- --write",
     "watch": "scripts/watch.sh",

scripts/watch.sh

@@ -7,6 +7,7 @@ trap "kill 0" EXIT
 
 npm run clean
 npx tsc --watch --noEmitOnError &
+npx tsc --watch --noEmitOnError --project tsconfig.client.json &
 npx chokidar "src/**/*.ts" .eslintrc.json -c "npm run lint" &
 npx chokidar "src/config.ts" -c "npm run generate-json-schema" &
 

src_client/index.ts

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright (c) 2020 The Polymer Project Authors. All rights reserved.
+ * This code may only be used under the BSD style license found at
+ * http://polymer.github.io/LICENSE.txt The complete set of authors may be found
+ * at http://polymer.github.io/AUTHORS.txt The complete set of contributors may
+ * be found at http://polymer.github.io/CONTRIBUTORS.txt Code distributed by
+ * Google as part of the polymer project is also subject to an additional IP
+ * rights grant found at http://polymer.github.io/PATENTS.txt
+ */
+
+import {TemplateResult} from 'lit-html';
+
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+export function msg(id: string, template: string): string;
+
+export function msg(id: string, template: TemplateResult): TemplateResult;
+
+export function msg<F extends (...args: any[]) => string>(
+  id: string,
+  fn: F,
+  ...params: Parameters<F>
+): string;
+
+export function msg<F extends (...args: any[]) => TemplateResult>(
+  id: string,
+  fn: F,
+  ...params: Parameters<F>
+): TemplateResult;
+
+/**
+ * TODO(aomarks) This is a temporary stub implementation of the msg function. It
+ * does not yet support actual localization, and is only used by the "transform"
+ * output mode, since the user needs something to import.
+ *
+ * It may actually make more sense to move most of the generated code from
+ * "runtime" mode into this library, so that users can
+ * `import {msg} from 'lit-localize'` and tell it where to fetch translation
+ * (this will make more sense after the planned revamp to support runtime async
+ * locale loading and re-rendering).
+ */
+export function msg(
+  _id: string,
+  template: string | TemplateResult | (() => string | TemplateResult),
+  ...params: any[]
+): string | TemplateResult {
+  if (typeof template === 'function') {
+    return (template as any)(...params);
+  }
+  return template;
+}

tsconfig.client.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "es2018",
+    "module": "esnext",
+    "moduleResolution": "node",
+    "lib": ["es2018", "DOM"],
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "preserveConstEnums": true,
+    "forceConsistentCasingInFileNames": true,
+    "rootDir": "src_client/",
+    "outDir": "lib_client/",
+    "declaration": true,
+    "sourceMap": true,
+    "incremental": true,
+    "tsBuildInfoFile": "lib_client/.tsbuildinfo"
+  },
+  "include": ["src_client/**/*"]
+}