@velarscript/web 0.31.0 → 0.33.0

package/dist/parser/statements/components.js

@@ -0,0 +1,185 @@
+/**
+ * `component Name(props) exposes Handle:` — its prop list, its lifecycle hook
+ * names, and the item loop that reads its body.
+ *
+ * The prop list is the only place `insideComponentProps` is read, and the body
+ * loop is the only writer of it, so the depth counter is the one piece of
+ * parser state this face declares.
+ */
+import { typeParameterDeclarationFormsPhrase } from "@velarscript/compiler";
+import {} from "@velarscript/compiler/extension";
+import {} from "../../ast.js";
+import { diagnostic, recoveredDiagnostic, span } from "../spans.js";
+import { actionHeaderShapes, blockHeaderAhead, exposeItemAhead, namedDeclarationAhead, reactiveBindingShapes, } from "./heads.js";
+import { parseActionDeclaration, parseComputedDeclaration, parseResourceDeclaration, parseStateDeclaration, parseWatchDeclaration, } from "./reactive.js";
+const renderBlockSpellings = new Set(["render", "show", "view"]);
+const lifecycleHookSpellings = new Set(["mounted", "cleanup"]);
+/**
+ * WEB-N4: a component prop list is where a Web author reaches for the HTML
+ * names, and `class`, `look`, and the Core keywords are all tokens rather than
+ * identifiers. Recovering the keyword as the prop name turns an eleven-message
+ * parser cascade into one directed message, and a declaration-position `?`
+ * teaches the default value that actually makes a prop omittable.
+ */
+export function parseComponentProps(host) {
+    host.expect("leftParen", "Expected '('");
+    const parameters = [];
+    if (!host.check("rightParen")) {
+        do {
+            if (host.match("ellipsis"))
+                host.diagnostics.push(diagnostic("VEL2016", "Components use named props and do not support rest parameters", host.previous().span));
+            // 'class' and 'look' are the props every component already carries, so
+            // the same message answers both the keyword token and the now-ordinary
+            // name.
+            const universalProp = host.checkWord("look") || host.check("class");
+            if (universalProp) {
+                const token = host.advance();
+                host.diagnostics.push(diagnostic("VEL2016", `Every component already accepts '${token.value}'; remove it from the prop list and pass it at the call site with ${token.value}={...}`, token.span));
+            }
+            const nameToken = universalProp ? host.previous() : host.check("identifier") ? host.advance() : componentPropKeyword(host);
+            if (!nameToken) {
+                host.diagnostics.push(diagnostic("VEL2016", "A component prop list holds 'name: Type' props separated by commas", host.current().span));
+                break;
+            }
+            let optionalMarker = false;
+            if (host.check("question")) {
+                host.advance();
+                optionalMarker = true;
+            }
+            const type = host.match("colon") ? host.parseTypeReference() : null;
+            let defaultValue = host.match("assign") ? host.parseExpression() : null;
+            if (optionalMarker) {
+                host.diagnostics.push(diagnostic("VEL2016", `A component prop becomes omittable through its default value, not through '?': write '${nameToken.value}: Type = default' for a real default, or '${nameToken.value}: Type? = null' when absence is the value`, span(nameToken.span.start, (defaultValue ?? type ?? nameToken).span.end)));
+                defaultValue ??= { kind: "LiteralExpression", value: null, raw: "null", span: nameToken.span };
+            }
+            parameters.push({
+                name: nameToken.value,
+                type: optionalMarker && type ? { syntax: { kind: "OptionalTypeSyntax", inner: type.syntax, span: type.span }, span: type.span } : type,
+                defaultValue,
+                rest: false,
+                span: span(nameToken.span.start, (defaultValue ?? type ?? nameToken).span.end),
+            });
+        } while (host.match("comma") && !host.check("rightParen"));
+    }
+    host.expect("rightParen", "Expected ')' after parameters");
+    return parameters;
+}
+/**
+ * Consumes a keyword standing where a prop name belongs and reports the one
+ * message that names it, or returns null when the token cannot be a name.
+ */
+function componentPropKeyword(host) {
+    const token = host.current();
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/u.test(token.value))
+        return null;
+    if (token.kind === "identifier" || token.kind === "eof" || token.kind === "newline")
+        return null;
+    host.advance();
+    host.diagnostics.push(diagnostic("VEL2016", `'${token.value}' is a VelarScript keyword and cannot name a component prop; choose another name`, token.span));
+    return token;
+}
+/**
+ * `@` selects the component's closed compiler namespace. The role names are
+ * `mounted` and `cleanup`; neither is found through author-name lookup.
+ */
+function matchLifecycleHook(host, name) {
+    if (!host.check("at") || host.peekKind(1) !== "identifier" || host.peekValue(1) !== name)
+        return false;
+    host.advance();
+    host.advance();
+    return true;
+}
+export function parseComponent(host, start, exported) {
+    const name = host.expect("identifier", "Expected a component name");
+    if (host.check("less")) {
+        host.parseTypeParameters();
+        host.diagnostics.push(diagnostic("VEL2025", `Component '${name.value}' cannot declare type parameters; ${typeParameterDeclarationFormsPhrase()} take '<T>'`, name.span));
+    }
+    host.insideComponentProps += 1;
+    const parameters = host.check("leftParen") ? host.parseParameters() : [];
+    host.insideComponentProps -= 1;
+    for (const parameter of parameters) {
+        if (parameter.rest) {
+            host.diagnostics.push(diagnostic("VEL2016", "Components use named props and do not support rest parameters", parameter.span));
+        }
+    }
+    const handleType = host.matchExtensionKeyword("exposes") ? host.parseTypeReference() : null;
+    host.expect("colon", "Expected ':' before component body");
+    host.expect("newline", "Expected a newline before component body");
+    host.consumeNewlines();
+    host.expect("indent", "Expected an indented component body");
+    const body = [];
+    host.consumeNewlines();
+    while (!host.check("dedent") && !host.check("eof")) {
+        const itemStart = host.current().span.start;
+        let item = null;
+        if (exposeItemAhead(host)) {
+            host.advance();
+            const value = host.parseExpression();
+            item = { kind: "ExtensionStatement:web:expose", value, span: span(itemStart, value.span.end) };
+        }
+        else if (namedDeclarationAhead(host, "state", reactiveBindingShapes)) {
+            host.advance();
+            item = parseStateDeclaration(host, itemStart, false);
+        }
+        else if (namedDeclarationAhead(host, "computed", reactiveBindingShapes)) {
+            host.advance();
+            item = parseComputedDeclaration(host, itemStart, false);
+        }
+        else if (namedDeclarationAhead(host, "resource", reactiveBindingShapes)) {
+            host.advance();
+            item = parseResourceDeclaration(host, itemStart, false);
+        }
+        else if (namedDeclarationAhead(host, "action", actionHeaderShapes)) {
+            host.advance();
+            item = parseActionDeclaration(host, itemStart, false);
+        }
+        else if (blockHeaderAhead(host, "watch")) {
+            host.advance();
+            item = parseWatchDeclaration(host, itemStart);
+        }
+        else if (matchLifecycleHook(host, "mounted")) {
+            const body = host.parseBlock();
+            item = { kind: "ExtensionStatement:web:mounted", body, span: span(itemStart, body.at(-1)?.span.end ?? itemStart) };
+        }
+        else if (matchLifecycleHook(host, "cleanup")) {
+            const body = host.parseBlock();
+            item = { kind: "ExtensionStatement:web:cleanup", body, span: span(itemStart, body.at(-1)?.span.end ?? itemStart) };
+        }
+        else if (host.check("at")) {
+            const marker = host.advance();
+            const name = host.check("identifier") ? host.advance() : null;
+            host.diagnostics.push(diagnostic("VEL5061", name
+                ? `Unknown compiler-owned name '@${name.value}' in a component; the component namespace contains only '@mounted:' and '@cleanup:'`
+                : "Expected a compiler-owned component name after '@'; the component namespace contains only '@mounted:' and '@cleanup:'", span(marker.span.start, (name ?? marker).span.end)));
+            host.skipMistypedDeclaration();
+        }
+        else if (host.check("identifier") && lifecycleHookSpellings.has(host.current().value) && host.peekKind(1) === "colon") {
+            // The bare words are ordinary author names. Recover as the one accepted
+            // compiler-owned spelling so the body keeps analyzing, while retaining
+            // a diagnostic: recovery is not a second alias.
+            const keyword = host.advance();
+            host.diagnostics.push(recoveredDiagnostic("VEL5061", `Use '@${keyword.value}:'; it is a compiler-owned component name, which leaves '${keyword.value}' free for your own method`, keyword.span));
+            const body = host.parseBlock();
+            item = keyword.value === "mounted"
+                ? { kind: "ExtensionStatement:web:mounted", body, span: span(itemStart, body.at(-1)?.span.end ?? itemStart) }
+                : { kind: "ExtensionStatement:web:cleanup", body, span: span(itemStart, body.at(-1)?.span.end ?? itemStart) };
+        }
+        else if (host.check("identifier") && renderBlockSpellings.has(host.current().value) && host.peekKind(1) === "colon") {
+            const keyword = host.advance();
+            host.diagnostics.push(diagnostic("VEL5048", `Use 'return <...>'; a component returns its JSX directly and has no '${keyword.value}:' block`, keyword.span));
+            host.skipMistypedDeclaration();
+        }
+        else {
+            item = host.parseStatement();
+        }
+        if (item)
+            body.push(item);
+        if (host.previous().kind !== "dedent")
+            host.expectStatementBoundary();
+        host.consumeNewlines();
+    }
+    const close = host.expect("dedent", "Expected the end of component body");
+    return { kind: "ExtensionStatement:web:component", exported, name: name.value, parameters, handleType, body, span: span(start, body.at(-1)?.span.end ?? close.span.end) };
+}
+//# sourceMappingURL=components.js.map

package/dist/parser/statements/components.js.map

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

package/dist/parser/statements/heads.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Whether a contextual Web word standing at the start of a line is a
+ * declaration head at all, and the token shapes each head is claimed by.
+ *
+ * D30 item 16 is one rule with three readings — a name and a shape token, a
+ * header line ending in ':', a word followed by a fresh value — and both the
+ * module-level dispatcher in `parser.ts` and `parseComponent` ask all three, so
+ * the lookaheads are a shared module rather than a copy on each side.
+ */
+import type { TokenKind } from "@velarscript/compiler/extension";
+export interface StatementHeadParserHost {
+    checkWord(value: string): boolean;
+    peekKind(distance: number): TokenKind;
+}
+export declare const componentHeaderShapes: Set<string>;
+export declare const reactiveBindingShapes: Set<string>;
+export declare const actionHeaderShapes: Set<string>;
+/**
+ * D30 item 16: a Web declaration head is claimed only in its own declaration
+ * shape — the word, a name, and one of the tokens that can follow it there.
+ * `state = 1`, `state(x)`, and `state.field` all keep the identifier reading.
+ */
+export declare function namedDeclarationAhead(host: StatementHeadParserHost, word: string, shapes: ReadonlySet<string>): boolean;
+/**
+ * `watch` opens a block: its header line ends in ':' and an indented body
+ * follows. No expression statement can end in ':', so the lookahead is exact
+ * and `watch = 1` / `watch(value)` stay ordinary code.
+ */
+export declare function blockHeaderAhead(host: StatementHeadParserHost, word: string): boolean;
+/**
+ * `expose value` is the one Web statement head followed by a bare expression
+ * rather than by a name and a shape token. It is claimed only when the next
+ * token opens a fresh value, so `expose(handle)` reads as a call and
+ * `expose = handle` as an assignment — the identifier reading wins wherever
+ * the two could compete.
+ */
+export declare function exposeItemAhead(host: StatementHeadParserHost): boolean;
+//# sourceMappingURL=heads.d.ts.map

package/dist/parser/statements/heads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heads.d.ts","sourceRoot":"","sources":["../../../src/parser/statements/heads.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAEjE,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAGD,eAAO,MAAM,qBAAqB,aAAwD,CAAC;AAC3F,eAAO,MAAM,qBAAqB,aAA+B,CAAC;AAClE,eAAO,MAAM,kBAAkB,aAAyB,CAAC;AAOzD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAEvH;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAcrF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAEtE"}

package/dist/parser/statements/heads.js

@@ -0,0 +1,55 @@
+// The tokens that may follow the declared name in each Web declaration head.
+export const componentHeaderShapes = new Set(["leftParen", "colon", "less", "identifier"]);
+export const reactiveBindingShapes = new Set(["assign", "colon"]);
+export const actionHeaderShapes = new Set(["leftParen"]);
+// Tokens that open a fresh value rather than continuing the expression before
+// them; only these make `expose` the component's expose item.
+const exposeValueStartKinds = new Set([
+    "identifier", "string", "fstring", "number", "unitNumber", "true", "false", "null", "super", "leftBrace", "extensionToken",
+]);
+/**
+ * D30 item 16: a Web declaration head is claimed only in its own declaration
+ * shape — the word, a name, and one of the tokens that can follow it there.
+ * `state = 1`, `state(x)`, and `state.field` all keep the identifier reading.
+ */
+export function namedDeclarationAhead(host, word, shapes) {
+    return host.checkWord(word) && host.peekKind(1) === "identifier" && shapes.has(host.peekKind(2));
+}
+/**
+ * `watch` opens a block: its header line ends in ':' and an indented body
+ * follows. No expression statement can end in ':', so the lookahead is exact
+ * and `watch = 1` / `watch(value)` stay ordinary code.
+ */
+export function blockHeaderAhead(host, word) {
+    if (!host.checkWord(word))
+        return false;
+    let depth = 0;
+    let offset = 1;
+    for (;; offset += 1) {
+        const kind = host.peekKind(offset);
+        if (kind === "leftParen" || kind === "leftBracket" || kind === "leftBrace")
+            depth += 1;
+        else if (kind === "rightParen" || kind === "rightBracket" || kind === "rightBrace")
+            depth -= 1;
+        else if (kind === "eof")
+            return false;
+        else if (depth === 0 && (kind === "newline" || kind === "dedent"))
+            break;
+    }
+    if (offset < 3 || host.peekKind(offset - 1) !== "colon")
+        return false;
+    while (host.peekKind(offset) === "newline")
+        offset += 1;
+    return host.peekKind(offset) === "indent";
+}
+/**
+ * `expose value` is the one Web statement head followed by a bare expression
+ * rather than by a name and a shape token. It is claimed only when the next
+ * token opens a fresh value, so `expose(handle)` reads as a call and
+ * `expose = handle` as an assignment — the identifier reading wins wherever
+ * the two could compete.
+ */
+export function exposeItemAhead(host) {
+    return host.checkWord("expose") && exposeValueStartKinds.has(host.peekKind(1));
+}
+//# sourceMappingURL=heads.js.map

package/dist/parser/statements/heads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heads.js","sourceRoot":"","sources":["../../../src/parser/statements/heads.ts"],"names":[],"mappings":"AAgBA,6EAA6E;AAC7E,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;AAC3F,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;AACzD,8EAA8E;AAC9E,8DAA8D;AAC9D,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB;CAC3H,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAA6B,EAAE,IAAY,EAAE,MAA2B;IAC5G,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,YAAY,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACnG,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAA6B,EAAE,IAAY;IAC1E,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,QAAS,MAAM,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,aAAa,IAAI,IAAI,KAAK,WAAW;YAAE,KAAK,IAAI,CAAC,CAAC;aAClF,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,YAAY;YAAE,KAAK,IAAI,CAAC,CAAC;aAC1F,IAAI,IAAI,KAAK,KAAK;YAAE,OAAO,KAAK,CAAC;aACjC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,QAAQ,CAAC;YAAE,MAAM;IAC3E,CAAC;IACD,IAAI,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IACtE,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,SAAS;QAAE,MAAM,IAAI,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC;AAC5C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,IAA6B;IAC3D,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACjF,CAAC"}

package/dist/parser/statements/imports.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The one import form the Web extension adds: `import css unsafe "./file.css"`,
+ * with the same stated placement its inline sibling carries.
+ */
+import { type Statement } from "@velarscript/compiler/extension";
+import { type UnsafeCssParserHost } from "./unsafe-css.ts";
+export type ImportParserHost = UnsafeCssParserHost;
+export declare function parseCssImport(host: ImportParserHost, start: number): Statement | null | undefined;
+//# sourceMappingURL=imports.d.ts.map

package/dist/parser/statements/imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../../../src/parser/statements/imports.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAGjE,OAAO,EAA2B,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEpF,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AAEnD,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,CAoBlG"}

package/dist/parser/statements/imports.js

@@ -0,0 +1,31 @@
+/**
+ * The one import form the Web extension adds: `import css unsafe "./file.css"`,
+ * with the same stated placement its inline sibling carries.
+ */
+import {} from "@velarscript/compiler/extension";
+import {} from "../../ast.js";
+import { diagnostic, span } from "../spans.js";
+import { parseUnsafeCssPlacement } from "./unsafe-css.js";
+export function parseCssImport(host, start) {
+    // `import css unsafe "./file.css"` against `import css from "./module.vel"`:
+    // the CSS boundary is claimed only when the word is followed by the
+    // boundary marker or by the path itself, so a module named `css` still
+    // imports by name.
+    if (!host.checkWord("css") || !(host.peekKind(1) === "unsafe" || host.peekKind(1) === "string"))
+        return undefined;
+    host.advance();
+    host.expect("unsafe", "Native CSS is an unsafe boundary; write 'import css unsafe'");
+    const source = host.expect("string", "Expected a relative .css path after 'import css unsafe'");
+    const placement = parseUnsafeCssPlacement(host);
+    if ((!source.value.startsWith("./") && !source.value.startsWith("../")) || !source.value.endsWith(".css")) {
+        host.diagnostics.push(diagnostic("VEL5037", "Unsafe CSS imports require an explicit relative path ending in '.css'", source.span));
+    }
+    const declaration = {
+        kind: "ExtensionStatement:web:unsafe-css",
+        source: { kind: "external", path: source.value, span: source.span },
+        placement,
+        span: span(start, host.previous().span.end),
+    };
+    return declaration;
+}
+//# sourceMappingURL=imports.js.map

package/dist/parser/statements/imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.js","sourceRoot":"","sources":["../../../src/parser/statements/imports.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAkB,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAwD,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,uBAAuB,EAA4B,MAAM,iBAAiB,CAAC;AAIpF,MAAM,UAAU,cAAc,CAAC,IAAsB,EAAE,KAAa;IAClE,6EAA6E;IAC7E,oEAAoE;IACpE,uEAAuE;IACvE,mBAAmB;IACnB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAClH,IAAI,CAAC,OAAO,EAAE,CAAC;IACf,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,6DAA6D,CAAC,CAAC;IACrF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,yDAAyD,CAAC,CAAC;IAChG,MAAM,SAAS,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1G,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,uEAAuE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACrI,CAAC;IACD,MAAM,WAAW,GAAyB;QACxC,IAAI,EAAE,mCAAmC;QACzC,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;QACnE,SAAS;QACT,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;KAC5C,CAAC;IACF,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/parser/statements/reactive.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The five reactive declarations — `state`, `computed`, `resource`, `action`
+ * and `watch` — read after their head has already been claimed.
+ *
+ * Each is a module-level statement and a component item both, so the dispatcher
+ * in `parser.ts` and `parseComponent` call the same five readers.
+ */
+import { type Parameter, type Statement, type Token, type TokenKind, type TypeReference } from "@velarscript/compiler/extension";
+import { type WebActionDeclaration as ActionDeclaration, type WebComputedDeclaration as ComputedDeclaration, type WebResourceDeclaration as ResourceDeclaration, type WebStateDeclaration as StateDeclaration, type WebWatchDeclaration as WatchDeclaration } from "../../ast.ts";
+import type { Expression } from "@velarscript/compiler/extension";
+export interface ReactiveParserHost {
+    expect(kind: TokenKind, message: string): Token;
+    match(kind: TokenKind): boolean;
+    matchWord(value: string): boolean;
+    parseBlock(): readonly Statement[];
+    parseExpression(minimumPrecedence?: number): Expression;
+    parseParameters(): readonly Parameter[];
+    parseTypeReference(allowTrailingOptional?: boolean): TypeReference;
+    previous(): Token;
+}
+export declare function parseStateDeclaration(host: ReactiveParserHost, start: number, exported: boolean): StateDeclaration;
+/**
+ * D71 rule 182: `computed` parses exactly where `state` parses, through the
+ * same shape lookahead — the two halves of the reactive row differ in what
+ * they mean, not in how they are written.
+ */
+export declare function parseComputedDeclaration(host: ReactiveParserHost, start: number, exported: boolean): ComputedDeclaration;
+export declare function parseResourceDeclaration(host: ReactiveParserHost, start: number, exported: boolean): ResourceDeclaration;
+export declare function parseActionDeclaration(host: ReactiveParserHost, start: number, exported: boolean): ActionDeclaration;
+export declare function parseWatchDeclaration(host: ReactiveParserHost, start: number): WatchDeclaration;
+//# sourceMappingURL=reactive.d.ts.map

package/dist/parser/statements/reactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive.d.ts","sourceRoot":"","sources":["../../../src/parser/statements/reactive.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,KAAK,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACjI,OAAO,EACL,KAAK,oBAAoB,IAAI,iBAAiB,EAC9C,KAAK,sBAAsB,IAAI,mBAAmB,EAClD,KAAK,sBAAsB,IAAI,mBAAmB,EAClD,KAAK,mBAAmB,IAAI,gBAAgB,EAC5C,KAAK,mBAAmB,IAAI,gBAAgB,EAC7C,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAGlE,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;IAChD,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAChC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,UAAU,IAAI,SAAS,SAAS,EAAE,CAAC;IACnC,eAAe,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACxD,eAAe,IAAI,SAAS,SAAS,EAAE,CAAC;IACxC,kBAAkB,CAAC,qBAAqB,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;IACnE,QAAQ,IAAI,KAAK,CAAC;CACnB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,gBAAgB,CAMlH;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,mBAAmB,CAMxH;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,mBAAmB,CAMxH;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,iBAAiB,CAkBpH;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAW/F"}

package/dist/parser/statements/reactive.js

@@ -0,0 +1,68 @@
+/**
+ * The five reactive declarations — `state`, `computed`, `resource`, `action`
+ * and `watch` — read after their head has already been claimed.
+ *
+ * Each is a module-level statement and a component item both, so the dispatcher
+ * in `parser.ts` and `parseComponent` call the same five readers.
+ */
+import {} from "@velarscript/compiler/extension";
+import {} from "../../ast.js";
+import { span } from "../spans.js";
+export function parseStateDeclaration(host, start, exported) {
+    const name = host.expect("identifier", "Expected a state name");
+    const type = host.match("colon") ? host.parseTypeReference() : null;
+    host.expect("assign", "Expected '=' after state name");
+    const initializer = host.parseExpression();
+    return { kind: "ExtensionStatement:web:state", exported, name: name.value, type, initializer, span: span(start, initializer.span.end) };
+}
+/**
+ * D71 rule 182: `computed` parses exactly where `state` parses, through the
+ * same shape lookahead — the two halves of the reactive row differ in what
+ * they mean, not in how they are written.
+ */
+export function parseComputedDeclaration(host, start, exported) {
+    const name = host.expect("identifier", "Expected a computed name");
+    const type = host.match("colon") ? host.parseTypeReference() : null;
+    host.expect("assign", "Expected '=' after computed name");
+    const initializer = host.parseExpression();
+    return { kind: "ExtensionStatement:web:computed", exported, name: name.value, type, initializer, span: span(start, initializer.span.end) };
+}
+export function parseResourceDeclaration(host, start, exported) {
+    const name = host.expect("identifier", "Expected a resource name");
+    const type = host.match("colon") ? host.parseTypeReference() : null;
+    host.expect("assign", "Expected '=' after resource name");
+    const initializer = host.parseExpression();
+    return { kind: "ExtensionStatement:web:resource", exported, name: name.value, type, initializer, span: span(start, initializer.span.end) };
+}
+export function parseActionDeclaration(host, start, exported) {
+    const name = host.expect("identifier", "Expected an action name");
+    const parameters = host.parseParameters();
+    const parameterListEnd = host.previous().span.end;
+    const returnType = host.match("arrow") ? host.parseTypeReference() : null;
+    const body = host.parseBlock();
+    const end = body.at(-1)?.span.end ?? returnType?.span.end ?? name.span.end;
+    return {
+        kind: "ExtensionStatement:web:action",
+        exported,
+        name: name.value,
+        parameters,
+        returnType,
+        ...(returnType ? { resultAnnotationSpan: span(parameterListEnd, returnType.span.end) } : {}),
+        signatureSpan: span(start, returnType?.span.end ?? parameterListEnd),
+        body,
+        span: span(start, end),
+    };
+}
+export function parseWatchDeclaration(host, start) {
+    const expression = host.parseExpression();
+    let currentName = null;
+    let previousName = null;
+    if (host.matchWord("as")) {
+        currentName = host.expect("identifier", "Expected the current watch value name").value;
+        host.expect("comma", "Expected ',' between watch value names");
+        previousName = host.expect("identifier", "Expected the previous watch value name").value;
+    }
+    const body = host.parseBlock();
+    return { kind: "ExtensionStatement:web:watch", expression, currentName, previousName, body, span: span(start, body.at(-1)?.span.end ?? expression.span.end) };
+}
+//# sourceMappingURL=reactive.js.map

package/dist/parser/statements/reactive.js.map

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

package/dist/parser/statements/unsafe-css.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The explicit native-CSS boundary: the inline `unsafe css` block, and the
+ * `before look` / `after look` placement both it and `import css unsafe` must
+ * state in source.
+ */
+import type { Diagnostic } from "@velarscript/compiler";
+import { type Statement, type Token, type TokenKind } from "@velarscript/compiler/extension";
+export interface UnsafeCssParserHost {
+    advance(): Token;
+    checkWord(value: string): boolean;
+    current(): Token;
+    readonly diagnostics: Diagnostic[];
+    expect(kind: TokenKind, message: string): Token;
+    matchExtensionKeyword(value: string): boolean;
+    peekKind(distance: number): TokenKind;
+    peekValue(distance: number): string;
+    previous(): Token;
+}
+export declare function parseUnsafeCssStatement(host: UnsafeCssParserHost, start: number): Statement | null | undefined;
+export declare function parseUnsafeCssPlacement(host: UnsafeCssParserHost): "before" | "after";
+//# sourceMappingURL=unsafe-css.d.ts.map

package/dist/parser/statements/unsafe-css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsafe-css.d.ts","sourceRoot":"","sources":["../../../src/parser/statements/unsafe-css.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAK7F,MAAM,WAAW,mBAAmB;IAClC,OAAO,IAAI,KAAK,CAAC;IACjB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,OAAO,IAAI,KAAK,CAAC;IACjB,QAAQ,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC;IACnC,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;IAChD,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,QAAQ,IAAI,KAAK,CAAC;CACnB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,CAkB9G;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,mBAAmB,GAAG,QAAQ,GAAG,OAAO,CAarF"}

package/dist/parser/statements/unsafe-css.js

@@ -0,0 +1,42 @@
+import {} from "@velarscript/compiler/extension";
+import {} from "../../ast.js";
+import { WEB_UNSAFE_CSS_TOKEN } from "../../lexer.js";
+import { diagnostic, span } from "../spans.js";
+export function parseUnsafeCssStatement(host, start) {
+    if (!host.checkWord("css") || host.peekKind(1) !== "extensionToken"
+        || host.peekValue(1) !== WEB_UNSAFE_CSS_TOKEN)
+        return undefined;
+    host.advance();
+    const token = host.advance();
+    const payload = token.payload;
+    if (!payload || payload.kind !== "WebUnsafeCssBlockSyntax") {
+        host.diagnostics.push(diagnostic("VEL5037", "The inline unsafe CSS token is missing its raw source", token.span));
+        return { kind: "PassStatement", span: token.span };
+    }
+    const placement = parseUnsafeCssPlacement(host);
+    const declaration = {
+        kind: "ExtensionStatement:web:unsafe-css",
+        source: { kind: "inline", css: payload.css, span: payload.contentSpan },
+        placement,
+        span: span(start, host.previous().span.end),
+    };
+    return declaration;
+}
+export function parseUnsafeCssPlacement(host) {
+    let placement = "before";
+    if (host.current().kind === "identifier" && host.current().value === "before") {
+        host.expect("identifier", "Expected 'before'");
+        placement = "before";
+    }
+    else if (host.current().kind === "identifier" && host.current().value === "after") {
+        host.expect("identifier", "Expected 'after'");
+        placement = "after";
+    }
+    else
+        host.diagnostics.push(diagnostic("VEL5037", "Unsafe CSS must explicitly declare 'before look' or 'after look'", host.current().span));
+    if (!host.matchExtensionKeyword("look")) {
+        host.diagnostics.push(diagnostic("VEL5037", "Unsafe CSS order must end with 'look'", host.current().span));
+    }
+    return placement;
+}
+//# sourceMappingURL=unsafe-css.js.map

package/dist/parser/statements/unsafe-css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsafe-css.js","sourceRoot":"","sources":["../../../src/parser/statements/unsafe-css.ts"],"names":[],"mappings":"AAMA,OAAO,EAA8C,MAAM,iCAAiC,CAAC;AAC7F,OAAO,EAAwD,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAgC,MAAM,gBAAgB,CAAC;AACpF,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAc/C,MAAM,UAAU,uBAAuB,CAAC,IAAyB,EAAE,KAAa;IAC9E,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,gBAAgB;WAC9D,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,oBAAoB;QAAE,OAAO,SAAS,CAAC;IAClE,IAAI,CAAC,OAAO,EAAE,CAAC;IACf,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,OAA8C,CAAC;IACrE,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,yBAAyB,EAAE,CAAC;QAC3D,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,uDAAuD,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAClH,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IACrD,CAAC;IACD,MAAM,SAAS,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,WAAW,GAAyB;QACxC,IAAI,EAAE,mCAAmC;QACzC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE;QACvE,SAAS;QACT,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;KAC5C,CAAC;IACF,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAyB;IAC/D,IAAI,SAAS,GAAuB,QAAQ,CAAC;IAC7C,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9E,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAAC;QAC/C,SAAS,GAAG,QAAQ,CAAC;IACvB,CAAC;SAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;QACpF,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;QAC9C,SAAS,GAAG,OAAO,CAAC;IACtB,CAAC;;QAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,kEAAkE,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7I,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,uCAAuC,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7G,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}