@backtickjs/core 0.1.2 → 0.1.4

package/dist/ClientScript.d.ts

@@ -12,6 +12,7 @@ export interface ClientModule {
     readonly map: string;
     readonly dependencies: readonly string[];
     readonly params: readonly Param[];
+    readonly kind: "function" | "expression" | "block";
 }
 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":"AAmCA,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":"AAsCA,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/cs.d.ts

@@ -4,6 +4,7 @@ import type { Spliceable } from "./Spliceable.js";
 import type { Spliced } from "./Spliceable.js";
 declare function lift<T>(_: T): Client<T>;
 declare function splice<T extends [T] extends [Spliceable] ? unknown : Spliceable>(_: T): unknown extends Spliced<T> ? any : Spliced<T>;
+declare function awaited<T>(_: T): Awaited<T>;
 /**
  * The globals a project declares — its libs, `@types`, a `declare global` —
  * as an ordinary object type: reading one it doesn't declare is an error
@@ -14,6 +15,7 @@ export type GlobalThis = {
     [Key in keyof typeof globalThis]: (typeof globalThis)[Key];
 };
 export declare const cs: ((_strings: TemplateStringsArray, ..._values: unknown[]) => Client<unknown>) & {
+    awaited: typeof awaited;
     create: typeof create;
     lift: typeof lift;
     splice: typeof splice;

package/dist/cs.js

@@ -13,8 +13,15 @@ function splice(_) {
     throw new Error("Don't call `cs.splice` directly; it's used to generate virtual " +
         "code for the typechecker. Write code using cs`...` instead.");
 }
+// `await`, in a splice the host may await in: what the host's `await` gives,
+// wherever in the script the splice is written.
+function awaited(_) {
+    throw new Error("Don't call `cs.awaited` directly; it's used to generate virtual " +
+        "code for the typechecker. Write code using cs`...` instead.");
+}
 // What hangs off the tag.
 const members = {
+    awaited,
     create,
     lift,
     splice,

package/dist/cs.js.map

@@ -1 +1 @@
-{"version":3,"file":"cs.js","sourceRoot":"","sources":["../src/cs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAI3C,uBAAuB;AACvB,SAAS,IAAI,CAAI,CAAI;IACnB,MAAM,IAAI,KAAK,CACb,+DAA+D;QAC7D,6DAA6D,CAChE,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,0EAA0E;AAC1E,6EAA6E;AAC7E,4EAA4E;AAC5E,4CAA4C;AAC5C,SAAS,MAAM,CACb,CAAI;IAEJ,MAAM,IAAI,KAAK,CACb,iEAAiE;QAC/D,6DAA6D,CAChE,CAAC;AACJ,CAAC;AAED,0BAA0B;AAC1B,MAAM,OAAO,GAAG;IACd,MAAM;IACN,IAAI;IACJ,MAAM;CACP,CAAC;AAYF,6EAA6E;AAC7E,yEAAyE;AACzE,MAAM,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAC7B,CAAC,QAA8B,EAAE,GAAG,OAAkB,EAAmB,EAAE;IACzE,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;AACJ,CAAC,EACD,OAEC,CACF,CAAC"}
+{"version":3,"file":"cs.js","sourceRoot":"","sources":["../src/cs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAI3C,uBAAuB;AACvB,SAAS,IAAI,CAAI,CAAI;IACnB,MAAM,IAAI,KAAK,CACb,+DAA+D;QAC7D,6DAA6D,CAChE,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,0EAA0E;AAC1E,6EAA6E;AAC7E,4EAA4E;AAC5E,4CAA4C;AAC5C,SAAS,MAAM,CACb,CAAI;IAEJ,MAAM,IAAI,KAAK,CACb,iEAAiE;QAC/D,6DAA6D,CAChE,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,gDAAgD;AAChD,SAAS,OAAO,CAAI,CAAI;IACtB,MAAM,IAAI,KAAK,CACb,kEAAkE;QAChE,6DAA6D,CAChE,CAAC;AACJ,CAAC;AAED,0BAA0B;AAC1B,MAAM,OAAO,GAAG;IACd,OAAO;IACP,MAAM;IACN,IAAI;IACJ,MAAM;CACP,CAAC;AAYF,6EAA6E;AAC7E,yEAAyE;AACzE,MAAM,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAC7B,CAAC,QAA8B,EAAE,GAAG,OAAkB,EAAmB,EAAE;IACzE,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;AACJ,CAAC,EACD,OAEC,CACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backtickjs/core",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "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,6 +23,9 @@ export interface ClientModule {
   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; or an expression or a block, which a splice runs.
+  readonly kind: "function" | "expression" | "block";
 }
 
 // One run of a `cs`: its module, and the values that run passes it.

package/src/cs.ts

@@ -25,8 +25,18 @@ function splice<T extends [T] extends [Spliceable] ? unknown : Spliceable>(
   );
 }
 
+// `await`, in a splice the host may await in: what the host's `await` gives,
+// wherever in the script the splice is written.
+function awaited<T>(_: T): Awaited<T> {
+  throw new Error(
+    "Don't call `cs.awaited` directly; it's used to generate virtual " +
+      "code for the typechecker. Write code using cs`...` instead.",
+  );
+}
+
 // What hangs off the tag.
 const members = {
+  awaited,
   create,
   lift,
   splice,