@velarscript/web 0.31.0 → 0.32.0

package/dist/parser.d.ts

@@ -1,27 +1,50 @@
+/**
+ * The Web parser's composition root. `parser.ts` was one 1,050-line module;
+ * D115 P4 R3e split the syntax families into `parser/` and left the class that
+ * the Web extension registers here — its one field, the eight `protected` seams,
+ * and the host every collaborator reaches back through.
+ *
+ * Where to look:
+ *
+ *  - `parser/spans.ts`                    span shifting, the three diagnostic constructors
+ *  - `parser/look-source.ts`              a `look:` block's own indented source
+ *  - `parser/keyframes-source.ts`         a `keyframes:` block's own indented source
+ *  - `parser/statements/heads.ts`         whether a contextual word is a declaration head
+ *  - `parser/statements/components.ts`    props, lifecycle names, the component item loop
+ *  - `parser/statements/reactive.ts`      state, computed, resource, action, watch
+ *  - `parser/statements/imports.ts`       `import css unsafe`
+ *  - `parser/statements/unsafe-css.ts`    the inline `unsafe css` block and its placement
+ *  - `parser/expressions/jsx.ts`          the JSX token and its interpolations
+ *  - `parser/expressions/look.ts`         `look:` as a value
+ *  - `parser/expressions/keyframes.ts`    `keyframes:` as a value
+ *  - `parser/expressions/visual-block.ts` consuming the block those two are written in
+ *
+ * A collaborator never names `VelarWebParser`: it declares the interface it
+ * needs, and that interface is the record of what it depends on. The host's
+ * properties are live reads of the parser, because the token cursor moves under
+ * a collaborator while it runs.
+ */
 import { type Span } from "@velarscript/compiler";
 import { Parser, type CompilerLexicalExtension, type Expression, type Parameter, type Statement, type Token, type TypeSyntax } from "@velarscript/compiler/extension";
 export declare class VelarWebParser extends Parser {
     private insideComponentProps;
+    private readonly host;
+    /**
+     * The one object every collaborator is handed. Its properties are live reads
+     * of the parser: the cursor moves under a collaborator, so `current()`, the
+     * diagnostics array and `insideComponentProps` must be the parser's own and
+     * not a snapshot taken when the host was built. `insideComponentProps` is
+     * `private` here, so it arrives as an accessor pair — the component body loop
+     * raises it, the prop list reads it back.
+     */
+    private webParserHost;
     constructor(tokens: readonly Token[], lexicalExtensions: readonly CompilerLexicalExtension[]);
     /**
      * 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.
+     * names, and Core's own list is what every other parameter list is read with.
      */
     protected parseParameters(): readonly Parameter[];
-    /**
-     * 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.
-     */
-    private componentPropKeyword;
     protected createNestedParser(tokens: readonly Token[]): Parser;
-    /**
-     * `@` selects the component's closed compiler namespace. The role names are
-     * `mounted` and `cleanup`; neither is found through author-name lookup.
-     */
-    private matchLifecycleHook;
     protected validateExtensionTypeArguments(name: string, arguments_: readonly TypeSyntax[], nameSpan: Span): boolean;
     protected parseExtensionNumericLiteral(token: Token, value: number, unit: string): Expression;
     protected parseExtensionStatement(start: number, modifiers: {
@@ -30,43 +53,7 @@ export declare class VelarWebParser extends Parser {
         readonly asynchronous: boolean;
     }): Statement | null | undefined;
     protected parseUnsafeExtensionStatement(start: number): Statement | null | undefined;
-    /**
-     * 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.
-     */
-    private namedDeclarationAhead;
-    /**
-     * `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.
-     */
-    private blockHeaderAhead;
-    /**
-     * `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.
-     */
-    private exposeItemAhead;
     protected parseExtensionImport(start: number): Statement | null | undefined;
-    private parseUnsafeCssPlacement;
     protected parseExtensionExpression(token: Token): Expression | undefined;
-    /** Consumes the ':' , the layout around the block, and the block itself. */
-    private consumeVisualBlock;
-    private parseKeyframesExpression;
-    private parseJsxEmbedded;
-    private parseStateDeclaration;
-    /**
-     * 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.
-     */
-    private parseComputedDeclaration;
-    private parseResourceDeclaration;
-    private parseActionDeclaration;
-    private parseWatchDeclaration;
-    private parseComponent;
 }
 //# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwD,KAAK,IAAI,EAAE,MAAM,uBAAuB,CAAC;AACxG,OAAO,EACL,MAAM,EAEN,KAAK,wBAAwB,EAC7B,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,UAAU,EAChB,MAAM,iCAAiC,CAAC;AA4CzC,qBAAa,cAAe,SAAQ,MAAM;IACxC,OAAO,CAAC,oBAAoB,CAAK;IAEjC,YAAY,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,iBAAiB,EAAE,SAAS,wBAAwB,EAAE,EAE3F;IAED;;;;;;OAMG;IACH,UAAmB,eAAe,IAAI,SAAS,SAAS,EAAE,CAkDzD;IAED;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAS5B,UAAmB,kBAAkB,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,MAAM,CAEtE;IAED;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAO1B,UAAmB,8BAA8B,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,UAAU,EAAE,EAAE,QAAQ,EAAE,IAAI,GAAG,OAAO,CAM1H;IAED,UAAmB,4BAA4B,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAKrG;IAED,UAAmB,uBAAuB,CACxC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;KAAE,GACpG,SAAS,GAAG,IAAI,GAAG,SAAS,CAgD9B;IAED,UAAmB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,CAkB5F;IAED;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAI7B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAIvB,UAAmB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,CAoBnF;IAED,OAAO,CAAC,uBAAuB;IAe/B,UAAmB,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,GAAG,SAAS,CAgDhF;IAED,4EAA4E;IAC5E,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,wBAAwB;IAmChC,OAAO,CAAC,gBAAgB;IAoCxB,OAAO,CAAC,qBAAqB;IAQ7B;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IAQhC,OAAO,CAAC,wBAAwB;IAQhC,OAAO,CAAC,sBAAsB;IAoB9B,OAAO,CAAC,qBAAqB;IAa7B,OAAO,CAAC,cAAc;CA6FvB"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EACL,MAAM,EACN,KAAK,wBAAwB,EAC7B,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,UAAU,EAChB,MAAM,iCAAiC,CAAC;AAiCzC,qBAAa,cAAe,SAAQ,MAAM;IACxC,OAAO,CAAC,oBAAoB,CAAK;IAEjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IAErC;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IA8BrB,YAAY,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,iBAAiB,EAAE,SAAS,wBAAwB,EAAE,EAG3F;IAED;;;OAGG;IACH,UAAmB,eAAe,IAAI,SAAS,SAAS,EAAE,CAGzD;IAED,UAAmB,kBAAkB,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,MAAM,CAEtE;IAED,UAAmB,8BAA8B,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,UAAU,EAAE,EAAE,QAAQ,EAAE,IAAI,GAAG,OAAO,CAM1H;IAED,UAAmB,4BAA4B,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAKrG;IAED,UAAmB,uBAAuB,CACxC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;KAAE,GACpG,SAAS,GAAG,IAAI,GAAG,SAAS,CAgD9B;IAED,UAAmB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,CAE5F;IAED,UAAmB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,CAEnF;IAED,UAAmB,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,GAAG,SAAS,CAShF;CACF"}