@openuji/speculator 0.7.3 → 0.7.5

package/README.md

@@ -35,7 +35,7 @@ A plugin-based pipeline that refines the AST:
 
 ## 💎 Schema-Central Design
 
-The **Speculator AST JSON Schema** is the single source of truth. All pipeline outputs are validated against this schema, ensuring that downstream tools (like `@openuji/render-respec`) can rely on a stable, typed data model.
+The **Speculator AST JSON Schema** is the single source of truth. All pipeline outputs are validated against this schema, ensuring that downstream tools can rely on a stable, typed data model.
 
 ### Core Node Types
 

package/dist/parse/html/SpecStatementHtmlParser.d.ts

@@ -2,7 +2,10 @@
  * Spec Statement HTML Parser
  *
  * Handles <spec-statement> custom elements.
- * Auto-detects RFC 2119 keywords and generates stable IDs.
+ * Reads attributes and delegates child parsing to the context.
+ * Works for both pure HTML and markdown inputs — like <dfn>.
+ * Distribution of normative properties to list items / table rows
+ * is handled by the statement-distribute postprocessing plugin.
  */
 import type { HtmlParserModule } from '#src/parse/registry';
 export declare const SpecStatementHtmlParser: HtmlParserModule;

package/dist/parse/html/SpecStatementHtmlParser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SpecStatementHtmlParser.d.ts","sourceRoot":"","sources":["../../../src/parse/html/SpecStatementHtmlParser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAyD,MAAM,qBAAqB,CAAC;AAMnH,eAAO,MAAM,uBAAuB,EAAE,gBAYrC,CAAC"}
+{"version":3,"file":"SpecStatementHtmlParser.d.ts","sourceRoot":"","sources":["../../../src/parse/html/SpecStatementHtmlParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAyD,MAAM,qBAAqB,CAAC;AAKnH,eAAO,MAAM,uBAAuB,EAAE,gBAYrC,CAAC"}

package/dist/parse/html/SpecStatementHtmlParser.js

@@ -2,7 +2,10 @@
  * Spec Statement HTML Parser
  *
  * Handles <spec-statement> custom elements.
- * Auto-detects RFC 2119 keywords and generates stable IDs.
+ * Reads attributes and delegates child parsing to the context.
+ * Works for both pure HTML and markdown inputs — like <dfn>.
+ * Distribution of normative properties to list items / table rows
+ * is handled by the statement-distribute postprocessing plugin.
  */
 import { slugify, toPlainText } from '#src/parse/normalize';
 import { inferLevel } from '#src/parse/utils/normative';
@@ -19,34 +22,50 @@ export const SpecStatementHtmlParser = {
 };
 function parseNode(element, ctx) {
     const sourcePos = ctx.createSourcePos(element);
-    const children = ctx.transformInlineChildren(element.children);
-    // Extract plain text for contentText from children (strips markup, preserves casing)
-    const rawText = toPlainText(children).trim().replace(/\s+/g, ' ');
-    const contentText = rawText;
-    // Determine level (use lowercase for keyword matching)
+    const allChildren = ctx.transformBlockChildren(element.children);
+    const rawText = toPlainText(allChildren).trim().replace(/\s+/g, ' ');
+    const level = getLevel(element, rawText, ctx);
+    const { id, tempId } = getId(element, rawText, ctx);
+    const dataCopConcept = ctx.getAttr(element, 'data-cop-concept');
+    const dataIdPattern = ctx.getAttr(element, 'data-id-pattern');
+    const isInline = allChildren.length === 1 && allChildren[0].type === 'paragraph';
+    if (isInline) {
+        return {
+            type: 'specStatement',
+            id,
+            tempId,
+            level: level,
+            dataCopConcept,
+            dataIdPattern,
+            contentText: rawText,
+            children: allChildren[0].children,
+            sourcePos,
+        };
+    }
+    else {
+        return {
+            type: 'specStatementGroup',
+            id,
+            level: level,
+            dataCopConcept,
+            dataIdPattern,
+            children: allChildren,
+            sourcePos,
+        };
+    }
+}
+function getLevel(element, text, ctx) {
     let level = (ctx.getAttr(element, 'level') || '').toUpperCase().replace(/\s+/g, ' ');
     if (!level) {
-        level = inferLevel(rawText);
+        level = inferLevel(text);
     }
-    // Determine ID
+    return level;
+}
+function getId(element, text, ctx) {
     const explicitId = ctx.getAttr(element, 'id');
-    const about = ctx.getAttr(element, 'about');
-    const dataCopConcept = ctx.getAttr(element, 'data-cop-concept');
-    const id = explicitId;
-    let tempId = undefined;
-    if (!id) {
-        tempId = about ? (about.startsWith('#') ? about.slice(1) : slugify(about)) : slugify(contentText);
-    }
-    const node = {
-        type: 'specStatement',
-        id,
-        tempId,
-        level: level,
-        dataCopConcept,
-        contentText,
-        children,
-        sourcePos,
-    };
-    return node;
+    if (explicitId)
+        return { id: explicitId };
+    const tempId = slugify(text);
+    return { tempId };
 }
 //# sourceMappingURL=SpecStatementHtmlParser.js.map

package/dist/parse/html/SpecStatementHtmlParser.js.map

@@ -1 +1 @@
-{"version":3,"file":"SpecStatementHtmlParser.js","sourceRoot":"","sources":["../../../src/parse/html/SpecStatementHtmlParser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAGxD,MAAM,CAAC,MAAM,uBAAuB,GAAqB;IACrD,IAAI,EAAE,yBAAyB;IAC/B,OAAO,EAAE,CAAC,gBAAgB,CAAC;IAC3B,KAAK,EAAE,CAAC;IAER,WAAW,CAAC,IAAa,EAAE,GAAiB;QACxC,OAAO,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,YAAY,CAAC,IAAa,EAAE,GAAiB;QACzC,OAAO,SAAS,CAAC,IAAI,EAAE,GAAG,CAAsB,CAAC;IACrD,CAAC;CACJ,CAAC;AAEF,SAAS,SAAS,CAAC,OAAgB,EAAE,GAAiB;IAClD,MAAM,SAAS,GAAG,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,GAAG,CAAC,uBAAuB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE/D,qFAAqF;IACrF,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClE,MAAM,WAAW,GAAG,OAAO,CAAC;IAE5B,uDAAuD;IACvD,IAAI,KAAK,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrF,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED,eAAe;IACf,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IAEhE,MAAM,EAAE,GAAuB,UAAU,CAAC;IAC1C,IAAI,MAAM,GAAuB,SAAS,CAAC;IAE3C,IAAI,CAAC,EAAE,EAAE,CAAC;QACN,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACtG,CAAC;IAED,MAAM,IAAI,GAAuB;QAC7B,IAAI,EAAE,eAAe;QACrB,EAAE;QACF,MAAM;QACN,KAAK,EAAE,KAAoC;QAC3C,cAAc;QACd,WAAW;QACX,QAAQ;QACR,SAAS;KACZ,CAAC;IAEF,OAAO,IAAI,CAAC;AAChB,CAAC"}
+{"version":3,"file":"SpecStatementHtmlParser.js","sourceRoot":"","sources":["../../../src/parse/html/SpecStatementHtmlParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD,MAAM,CAAC,MAAM,uBAAuB,GAAqB;IACrD,IAAI,EAAE,yBAAyB;IAC/B,OAAO,EAAE,CAAC,gBAAgB,CAAC;IAC3B,KAAK,EAAE,CAAC;IAER,WAAW,CAAC,IAAa,EAAE,GAAiB;QACxC,OAAO,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,YAAY,CAAC,IAAa,EAAE,GAAiB;QACzC,OAAO,SAAS,CAAC,IAAI,EAAE,GAAG,CAAsB,CAAC;IACrD,CAAC;CACJ,CAAC;AAEF,SAAS,SAAS,CAAC,OAAgB,EAAE,GAAiB;IAClD,MAAM,SAAS,GAAG,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAE/C,MAAM,WAAW,GAAG,GAAG,CAAC,sBAAsB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEjE,MAAM,OAAO,GAAG,WAAW,CAAC,WAA4C,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACtG,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IAC9C,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IAChE,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;IAE9D,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,KAAK,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC;IAEjF,IAAI,QAAQ,EAAE,CAAC;QACX,OAAO;YACH,IAAI,EAAE,eAAe;YACrB,EAAE;YACF,MAAM;YACN,KAAK,EAAE,KAAoC;YAC3C,cAAc;YACd,aAAa;YACb,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAG,WAAW,CAAC,CAAC,CAAuC,CAAC,QAAQ;YACxE,SAAS;SACZ,CAAC;IACN,CAAC;SAAM,CAAC;QACJ,OAAO;YACH,IAAI,EAAE,oBAAoB;YAC1B,EAAE;YACF,KAAK,EAAE,KAAoC;YAC3C,cAAc;YACd,aAAa;YACb,QAAQ,EAAE,WAAsB;YAChC,SAAS;SACZ,CAAC;IACN,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CAAC,OAAgB,EAAE,IAAY,EAAE,GAAiB;IAC/D,IAAI,KAAK,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrF,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,SAAS,KAAK,CAAC,OAAgB,EAAE,IAAY,EAAE,GAAiB;IAC5D,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAE9C,IAAI,UAAU;QAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC;IAE1C,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;AACtB,CAAC"}

package/dist/parse/html/VocabHtmlParser.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Vocab HTML Parser
+ *
+ * Handles <spec-vocab> custom elements.
+ * Reads pre-loaded sibling metadata from `unit.sideFiles` (populated at preprocess time)
+ * to generate normative prose (Tables, Statements) from vocabulary files.
+ *
+ * This parser is fully isomorphic — it does NOT access the filesystem directly.
+ */
+import type { HtmlParserModule } from '#src/parse/registry';
+export declare const VocabHtmlParser: HtmlParserModule;
+//# sourceMappingURL=VocabHtmlParser.d.ts.map

package/dist/parse/html/VocabHtmlParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VocabHtmlParser.d.ts","sourceRoot":"","sources":["../../../src/parse/html/VocabHtmlParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAoC,MAAM,qBAAqB,CAAC;AA+D9F,eAAO,MAAM,eAAe,EAAE,gBAgC7B,CAAC"}