@backtickjs/core 0.4.0 → 0.5.0

package/dist/ClientScript.d.ts

@@ -13,6 +13,7 @@ export interface ScriptModule {
     readonly dependencies: readonly string[];
     readonly params: readonly Param[];
     readonly kind: "function" | "class" | "expression" | "block";
+    readonly scope: "module" | "function";
 }
 export interface ClientScript {
     readonly "@backtickjs": "ClientScript";

package/dist/ClientScript.js.map

@@ -1 +1 @@
-{"version":3,"file":"ClientScript.js","sourceRoot":"","sources":["../src/ClientScript.ts"],"names":[],"mappings":"AA0CA,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,aAAa,IAAI,KAAK;QACtB,KAAK,CAAC,aAAa,CAAC,KAAK,cAAc,CACxC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,MAAM,CACpB,MAAoB,EACpB,IAA2B;IAE3B,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACzD,CAAC"}
+{"version":3,"file":"ClientScript.js","sourceRoot":"","sources":["../src/ClientScript.ts"],"names":[],"mappings":"AA8CA,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,aAAa,IAAI,KAAK;QACtB,KAAK,CAAC,aAAa,CAAC,KAAK,cAAc,CACxC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,MAAM,CACpB,MAAoB,EACpB,IAA2B;IAE3B,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACzD,CAAC"}

package/dist/cjs.d.ts

@@ -8,6 +8,10 @@ import type { ModuleMap } from "./modulesOf.js";
  * entry an app imports is its format: a web page imports
  * `@backtickjs/core/es`.
  *
+ * Its values are kept in `values` by key, and so are those of the bundles it
+ * runs: one value per app, as a module is, however many bundles use it. A new
+ * `Map` by default, so a bundle run alone has its own.
+ *
  *     const screen = await execRoot(bundle, moduleMap);
  */
-export declare function execRoot<T>(bundle: Bundle<T>, moduleMap: ModuleMap): Promise<Awaited<T>>;
+export declare function execRoot<T>(bundle: Bundle<T>, moduleMap: ModuleMap, values?: Map<string, unknown>): Promise<Awaited<T>>;

package/dist/cjs.js

@@ -6,16 +6,20 @@
  * entry an app imports is its format: a web page imports
  * `@backtickjs/core/es`.
  *
+ * Its values are kept in `values` by key, and so are those of the bundles it
+ * runs: one value per app, as a module is, however many bundles use it. A new
+ * `Map` by default, so a bundle run alone has its own.
+ *
  *     const screen = await execRoot(bundle, moduleMap);
  */
-export async function execRoot(bundle, moduleMap) {
+export async function execRoot(bundle, moduleMap, values = new Map()) {
     const require = (specifier) => {
         if (!Object.hasOwn(moduleMap, specifier)) {
             throw new Error(`The bundle requires "${specifier}", which this app doesn't provide.`);
         }
         return moduleMap[specifier];
     };
-    const module = { exports: {} };
+    const module = { exports: {}, values };
     new Function("module", "exports", "require", bundle)(module, module.exports, require);
     return module.exports;
 }

package/dist/cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"cjs.js","sourceRoot":"","sources":["../src/cjs.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAiB,EACjB,SAAoB;IAEpB,MAAM,OAAO,GAAG,CAAC,SAAiB,EAAW,EAAE;QAC7C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CACb,wBAAwB,SAAS,oCAAoC,CACtE,CAAC;QACJ,CAAC;QACD,OAAO,SAAS,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,EAAa,EAAE,CAAC;IAC1C,IAAI,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAClD,MAAM,EACN,MAAM,CAAC,OAAO,EACd,OAAO,CACR,CAAC;IACF,OAAO,MAAM,CAAC,OAAqB,CAAC;AACtC,CAAC"}
+{"version":3,"file":"cjs.js","sourceRoot":"","sources":["../src/cjs.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAiB,EACjB,SAAoB,EACpB,SAA+B,IAAI,GAAG,EAAE;IAExC,MAAM,OAAO,GAAG,CAAC,SAAiB,EAAW,EAAE;QAC7C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CACb,wBAAwB,SAAS,oCAAoC,CACtE,CAAC;QACJ,CAAC;QACD,OAAO,SAAS,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,EAAa,EAAE,MAAM,EAAE,CAAC;IAClD,IAAI,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAClD,MAAM,EACN,MAAM,CAAC,OAAO,EACd,OAAO,CACR,CAAC;IACF,OAAO,MAAM,CAAC,OAAqB,CAAC;AACtC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backtickjs/core",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "The cs tag for Backtick client scripts, and the types for the values that cross from server to client",
   "keywords": [
     "backtick",

package/src/ClientScript.ts

@@ -23,10 +23,14 @@ export interface ScriptModule {
   readonly dependencies: readonly string[];
   // `params[i]` is the function's `$splice<i>` or `$capture<i>`
   readonly params: readonly Param[];
-  // What the script is written as: a function, `(props) => …`, which a splice
-  // reads as that function; a class, `class … {}`, one class for the bundle;
-  // or an expression or a block, which a splice runs.
+  // What the script is written as: a function, `(props) => …`; a class,
+  // `class … {}`; an expression; or a block, which is the function it runs.
   readonly kind: "function" | "class" | "expression" | "block";
+  // Where its `cs` is written in its host file: at the module's top level,
+  // run once, so its value is the app's, shared by every bundle of it, as a
+  // module-level `const` is; or in a function, run each call, so each value
+  // is its bundle's own.
+  readonly scope: "module" | "function";
 }
 
 // One run of a `cs`: its module, and the values that run passes it. The rest

package/src/cjs.ts

@@ -9,11 +9,16 @@ import type { ModuleMap } from "./modulesOf.js";
  * entry an app imports is its format: a web page imports
  * `@backtickjs/core/es`.
  *
+ * Its values are kept in `values` by key, and so are those of the bundles it
+ * runs: one value per app, as a module is, however many bundles use it. A new
+ * `Map` by default, so a bundle run alone has its own.
+ *
  *     const screen = await execRoot(bundle, moduleMap);
  */
 export async function execRoot<T>(
   bundle: Bundle<T>,
   moduleMap: ModuleMap,
+  values: Map<string, unknown> = new Map(),
 ): Promise<Awaited<T>> {
   const require = (specifier: string): unknown => {
     if (!Object.hasOwn(moduleMap, specifier)) {
@@ -23,7 +28,7 @@ export async function execRoot<T>(
     }
     return moduleMap[specifier];
   };
-  const module = { exports: {} as unknown };
+  const module = { exports: {} as unknown, values };
   new Function("module", "exports", "require", bundle)(
     module,
     module.exports,