@velarscript/web 0.10.1

package/dist/ast.js

@@ -0,0 +1,102 @@
+export const WEB_STATEMENT_CONSTRUCTS = Object.freeze({
+    "ExtensionStatement:web:component": "component Name:",
+    "ExtensionStatement:web:state": "state name = value",
+    "ExtensionStatement:web:computed": "computed name = value",
+    "ExtensionStatement:web:resource": "resource name = load()",
+    "ExtensionStatement:web:action": "action name():",
+    "ExtensionStatement:web:watch": "watch value as current:",
+    "ExtensionStatement:web:expose": "expose {member}",
+    "ExtensionStatement:web:mounted": "@mounted:",
+    "ExtensionStatement:web:cleanup": "@cleanup:",
+    "ExtensionStatement:web:unsafe-css/external": 'import css unsafe "./sheet.css" before look',
+    "ExtensionStatement:web:unsafe-css/inline": "unsafe css`…` after look",
+});
+/**
+ * The construct key of one parsed node, or null when this extension does not
+ * own it. The gate walks every node in a module and asks each installed
+ * extension, so this has to answer for Core nodes and for another extension's
+ * nodes without knowing them.
+ */
+export function webStatementConstructKey(node) {
+    if (!node.kind.startsWith("ExtensionStatement:web:"))
+        return null;
+    if (node.kind !== "ExtensionStatement:web:unsafe-css")
+        return node.kind;
+    return `${node.kind}/${node.source.kind}`;
+}
+export function isWebStatement(statement) {
+    return statement.kind.startsWith("ExtensionStatement:web:");
+}
+export function isWebExpression(expression) {
+    return expression.kind.startsWith("ExtensionExpression:web:");
+}
+export function isWebComponent(statement) {
+    return statement.kind === "ExtensionStatement:web:component";
+}
+export function isWebJsx(expression) {
+    return expression.kind === "ExtensionExpression:web:jsx";
+}
+export function isWebLook(expression) {
+    return expression.kind === "ExtensionExpression:web:look";
+}
+function webLookContainsDirectAwait(entries, contains) {
+    return entries.some((entry) => {
+        if (entry.kind === "LookProperty" || entry.kind === "LookSpread")
+            return contains(entry.value);
+        if (entry.kind === "LookIf") {
+            return contains(entry.condition)
+                || webLookContainsDirectAwait(entry.thenEntries, contains)
+                || webLookContainsDirectAwait(entry.elseEntries, contains);
+        }
+        return webLookContainsDirectAwait(entry.entries, contains);
+    });
+}
+/** Web owns the frame semantics of every expression node its parser adds. */
+export function webExpressionContainsDirectAwait(expression, contains) {
+    if (!isWebExpression(expression))
+        return undefined;
+    if (isWebUnit(expression) || expression.kind === "ExtensionExpression:web:look-hook")
+        return false;
+    if (isWebKeyframes(expression)) {
+        return expression.stops.some((stop) => stop.entries.some((entry) => contains(entry.value)));
+    }
+    if (isWebLook(expression))
+        return webLookContainsDirectAwait(expression.entries, contains);
+    return expression.attributes.some((attribute) => typeof attribute.value !== "string"
+        && attribute.value !== null
+        && contains(attribute.value))
+        || expression.children.some((child) => child.kind === "JSXExpressionChild"
+            ? contains(child.expression)
+            : child.kind === "ExtensionExpression:web:jsx" && contains(child));
+}
+/** Web owns whether each statement form executes in this frame or a child. */
+export function webStatementContainsDirectAwait(statement, containsExpression, _containsBlock) {
+    if (!isWebStatement(statement))
+        return undefined;
+    switch (statement.kind) {
+        case "ExtensionStatement:web:state":
+            // State initialization is emitted directly in its containing frame.
+            return containsExpression(statement.initializer);
+        case "ExtensionStatement:web:expose":
+            // A component handle is assembled during component setup.
+            return containsExpression(statement.value);
+        case "ExtensionStatement:web:component":
+        case "ExtensionStatement:web:computed":
+        case "ExtensionStatement:web:resource":
+        case "ExtensionStatement:web:action":
+        case "ExtensionStatement:web:watch":
+        case "ExtensionStatement:web:mounted":
+        case "ExtensionStatement:web:cleanup":
+        case "ExtensionStatement:web:unsafe-css":
+            // Each executable child is emitted behind its own callback/frame; unsafe
+            // CSS has no runtime expression.
+            return false;
+    }
+}
+export function isWebKeyframes(expression) {
+    return expression.kind === "ExtensionExpression:web:keyframes";
+}
+export function isWebUnit(expression) {
+    return expression.kind === "ExtensionExpression:web:unit";
+}
+//# sourceMappingURL=ast.js.map

package/dist/ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.js","sourceRoot":"","sources":["../src/ast.ts"],"names":[],"mappings":"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"}

package/dist/browser-test.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The one place the browser-test boundary is written down.
+ *
+ * Three consumers need the same two facts — the analyzer rejects a
+ * `velar/web-test` import outside a browser test, the compiler extension swaps
+ * in browser-test guidance for the DOM globals by path suffix, and the
+ * framework host tells the CLI which files the browser runner discovers. D57
+ * rule 134 rules that a name with an authority is derived from it rather than
+ * hand-copied, so the suffix and the module specifier live here and the three
+ * import them.
+ */
+/** The file name a browser test is declared in; the CLI runner discovers exactly these. */
+export declare const BROWSER_TEST_SOURCE_SUFFIX = ".browser.test.vel";
+/** The module that reaches from a browser test body into the running page. */
+export declare const BROWSER_TEST_MODULE = "velar/web-test";
+/**
+ * The one sentence an author standing in a `.browser.test.vel` needs: the body
+ * runs in the test process, not in the page, and the only surface from there
+ * that reaches across is `velar/web-test`.
+ */
+export declare function browserTestDrivingGuidance(name: string): string;
+/**
+ * D57 rule 138: `velar/web-test` only has a runtime under `velar test
+ * --browser`, so importing it anywhere else compiles a call that is certain to
+ * fail. Following D51 rule 109, the refusal lands on the import rather than on
+ * the eventual call, and it names the file the import belongs in.
+ */
+export declare function browserTestImportGuidance(): string;
+//# sourceMappingURL=browser-test.d.ts.map

package/dist/browser-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-test.d.ts","sourceRoot":"","sources":["../src/browser-test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,2FAA2F;AAC3F,eAAO,MAAM,0BAA0B,sBAAsB,CAAC;AAE9D,8EAA8E;AAC9E,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAElD"}

package/dist/browser-test.js

@@ -0,0 +1,33 @@
+/**
+ * The one place the browser-test boundary is written down.
+ *
+ * Three consumers need the same two facts — the analyzer rejects a
+ * `velar/web-test` import outside a browser test, the compiler extension swaps
+ * in browser-test guidance for the DOM globals by path suffix, and the
+ * framework host tells the CLI which files the browser runner discovers. D57
+ * rule 134 rules that a name with an authority is derived from it rather than
+ * hand-copied, so the suffix and the module specifier live here and the three
+ * import them.
+ */
+/** The file name a browser test is declared in; the CLI runner discovers exactly these. */
+export const BROWSER_TEST_SOURCE_SUFFIX = ".browser.test.vel";
+/** The module that reaches from a browser test body into the running page. */
+export const BROWSER_TEST_MODULE = "velar/web-test";
+/**
+ * The one sentence an author standing in a `.browser.test.vel` needs: the body
+ * runs in the test process, not in the page, and the only surface from there
+ * that reaches across is `velar/web-test`.
+ */
+export function browserTestDrivingGuidance(name) {
+    return `A browser test drives the running page, so '${name}' is not available in its body; import {browser} from "${BROWSER_TEST_MODULE}" and use browser.open("/"), browser.fill(selector, text), browser.click(selector), browser.waitForText(selector, text), and browser.text(selector) — the same module exports localStorage and sessionStorage for the page's storage`;
+}
+/**
+ * D57 rule 138: `velar/web-test` only has a runtime under `velar test
+ * --browser`, so importing it anywhere else compiles a call that is certain to
+ * fail. Following D51 rule 109, the refusal lands on the import rather than on
+ * the eventual call, and it names the file the import belongs in.
+ */
+export function browserTestImportGuidance() {
+    return `'${BROWSER_TEST_MODULE}' drives the running page from the test process, so it only has a runtime under 'velar test --browser'; import it from a '*${BROWSER_TEST_SOURCE_SUFFIX}' module — rename this module, or move the browser test into one of its own — while application code reaches the page through velar/browser`;
+}
+//# sourceMappingURL=browser-test.js.map

package/dist/browser-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-test.js","sourceRoot":"","sources":["../src/browser-test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,2FAA2F;AAC3F,MAAM,CAAC,MAAM,0BAA0B,GAAG,mBAAmB,CAAC;AAE9D,8EAA8E;AAC9E,MAAM,CAAC,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,OAAO,+CAA+C,IAAI,0DAA0D,mBAAmB,sOAAsO,CAAC;AAChX,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO,IAAI,mBAAmB,8HAA8H,0BAA0B,6IAA6I,CAAC;AACtU,CAAC"}

package/dist/compiler.d.ts

@@ -0,0 +1,9 @@
+import { type CompilerExtension, type ModuleInterface } from "@velarscript/compiler";
+import { webModuleSource, webModuleSources, type VelarWebRuntimeConfig } from "./runtime.ts";
+export declare const VELAR_WEB_API_VERSION = "0.10";
+export { BROWSER_TEST_MODULE, BROWSER_TEST_SOURCE_SUFFIX } from "./browser-test.ts";
+export declare const webModuleInterfaces: ReadonlyMap<string, ModuleInterface>;
+export declare const velarCompilerExtension: CompilerExtension;
+export { webModuleSource, webModuleSources, type VelarWebRuntimeConfig };
+export { velarProjectExtension, type VelarWebConfig } from "./project-config.ts";
+//# sourceMappingURL=compiler.d.ts.map

package/dist/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,iBAAiB,EAAiB,KAAK,eAAe,EAAkB,MAAM,uBAAuB,CAAC;AAgB5J,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAK7F,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAO5C,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AA6WpF,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAsKnE,CAAC;AAYH,eAAO,MAAM,sBAAsB,EAAE,iBAyLnC,CAAC;AAEH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC"}