@openuji/speculator 0.5.3 → 0.6.0

package/dist/types/ast.generated.js

@@ -2,7 +2,7 @@
  * AUTO-GENERATED FILE - DO NOT EDIT DIRECTLY
  *
  * Generated from: schema/spec-ast.schema.json
- * Generated at: 2026-01-02T15:58:42.008Z
+ * Generated at: 2026-01-27T16:58:52.776Z
  *
  * Regenerate with: npx ts-node scripts/generate-types.ts
  */
@@ -45,7 +45,9 @@ export function isInline(node) {
     const type = node.type;
     return [
         'text', 'emphasis', 'strong', 'inlineCode', 'link',
-        'image', 'definition', 'reference', 'requirement', 'issue'
+        'image', 'definition', 'requirement', 'issue', 'cite', 'variable',
+        'workspaceDfnReference', 'workspaceIdlReference', 'workspaceElementReference',
+        'externalDfnReference', 'externalIdlReference', 'externalElementReference'
     ].includes(type);
 }
 /**
@@ -55,7 +57,11 @@ export function isIndexableInline(node) {
     if (typeof node !== 'object' || node === null)
         return false;
     const type = node.type;
-    return ['definition', 'reference', 'requirement', 'issue'].includes(type);
+    return [
+        'definition', 'requirement', 'issue',
+        'workspaceDfnReference', 'workspaceIdlReference', 'workspaceElementReference',
+        'externalDfnReference', 'externalIdlReference', 'externalElementReference'
+    ].includes(type);
 }
 /**
  * Type guard for BlockExample (indexable block)

package/dist/types/ast.generated.js.map

@@ -1 +1 @@
-{"version":3,"file":"ast.generated.js","sourceRoot":"","sources":["../../src/types/ast.generated.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4gBH;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAK,IAAY,CAAC,IAAI,KAAK,WAAW,CAAC;AACzF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAK,IAAY,CAAC,IAAI,KAAK,UAAU,CAAC;AACxF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAK,IAAY,CAAC,IAAI,KAAK,SAAS,CAAC;AACvF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,IAAa;IACnC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC5D,MAAM,IAAI,GAAI,IAAY,CAAC,IAAI,CAAC;IAChC,OAAO;QACL,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS;QAC9C,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM;KACvD,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAa;IACpC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC5D,MAAM,IAAI,GAAI,IAAY,CAAC,IAAI,CAAC;IAChC,OAAO;QACL,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM;QAClD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO;KAC3D,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAa;IAC7C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC5D,MAAM,IAAI,GAAI,IAAY,CAAC,IAAI,CAAC;IAChC,OAAO,CAAC,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC5E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAK,IAAY,CAAC,IAAI,KAAK,SAAS,CAAC;AACvF,CAAC"}
+{"version":3,"file":"ast.generated.js","sourceRoot":"","sources":["../../src/types/ast.generated.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA2kBH;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAK,IAAY,CAAC,IAAI,KAAK,WAAW,CAAC;AACzF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAK,IAAY,CAAC,IAAI,KAAK,UAAU,CAAC;AACxF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAK,IAAY,CAAC,IAAI,KAAK,SAAS,CAAC;AACvF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,IAAa;IACnC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC5D,MAAM,IAAI,GAAI,IAAY,CAAC,IAAI,CAAC;IAChC,OAAO;QACL,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS;QAC9C,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM;KACvD,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAa;IACpC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC5D,MAAM,IAAI,GAAI,IAAY,CAAC,IAAI,CAAC;IAChC,OAAO;QACL,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM;QAClD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU;QACjE,uBAAuB,EAAE,uBAAuB,EAAE,2BAA2B;QAC7E,sBAAsB,EAAE,sBAAsB,EAAE,0BAA0B;KAC3E,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAa;IAC7C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC5D,MAAM,IAAI,GAAI,IAAY,CAAC,IAAI,CAAC;IAChC,OAAO;QACL,YAAY,EAAE,aAAa,EAAE,OAAO;QACpC,uBAAuB,EAAE,uBAAuB,EAAE,2BAA2B;QAC7E,sBAAsB,EAAE,sBAAsB,EAAE,0BAA0B;KAC3E,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAK,IAAY,CAAC,IAAI,KAAK,SAAS,CAAC;AACvF,CAAC"}

package/dist/workspace/__tests__/sort.test.js

@@ -3,17 +3,17 @@ import { MemoryFileProvider } from '#src/file-provider/memory';
 import { sortEntriesByDeps } from '../sort.js';
 import { generateIdFromPath, getConfigPath } from '#src/preprocess/config/doc-config';
 describe('generateIdFromPath', () => {
-    it('should generate id from parent folder and filename', () => {
-        expect(generateIdFromPath('/spec/workspace/pkg-a/index.html')).toBe('pkg-a-index');
-        expect(generateIdFromPath('/spec/overview/intro.md')).toBe('overview-intro');
-        expect(generateIdFromPath('/docs/api/reference.html')).toBe('api-reference');
+    it('should generate id from parent folder', () => {
+        expect(generateIdFromPath('/spec/workspace/pkg-a/index.html')).toBe('pkg-a');
+        expect(generateIdFromPath('/spec/overview/intro.md')).toBe('overview');
+        expect(generateIdFromPath('/docs/api/reference.html')).toBe('api');
     });
     it('should handle single-segment paths', () => {
         expect(generateIdFromPath('/index.html')).toBe('index');
         expect(generateIdFromPath('readme.md')).toBe('readme');
     });
     it('should handle Windows-style paths', () => {
-        expect(generateIdFromPath('C:\\spec\\core\\index.html')).toBe('core-index');
+        expect(generateIdFromPath('C:\\spec\\core\\index.html')).toBe('core');
     });
 });
 describe('getConfigPath', () => {
@@ -62,14 +62,14 @@ describe('sortEntriesByDeps', () => {
         // Only core has config, depends on auto-generated ID
         fileProvider.setFile('/spec/core/config.json', JSON.stringify({
             id: 'core',
-            deps: ['overview-index'] // auto-generated ID pattern
+            deps: ['overview'] // auto-generated ID is now just the parent folder
         }));
         const result = await sortEntriesByDeps([
             { entry: '/spec/core/index.html' },
-            { entry: '/spec/overview/index.html' }, // will get auto-generated ID
+            { entry: '/spec/overview/index.html' }, // will get auto-generated ID 'overview'
         ], fileProvider);
         expect(result.errors).toHaveLength(0);
-        // overview should come before core (core depends on overview-index)
+        // overview should come before core (core depends on overview)
         expect(result.entries[0].entry).toBe('/spec/overview/index.html');
         expect(result.entries[1].entry).toBe('/spec/core/index.html');
     });

package/dist/workspace/__tests__/sort.test.js.map

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

package/dist/workspace/builder.d.ts

@@ -0,0 +1,23 @@
+import { SpeculatorPipeline } from '#src/pipeline/runner';
+import type { FileProvider } from '#src/file-provider/types';
+import type { Workspace } from '#src/types/ast.generated';
+import type { WorkspaceConfig } from '#src/preprocess/types';
+/**
+ * Result of building workspaces
+ */
+export interface BuildWorkspacesResult {
+    /** Map of workspace name -> built Workspace AST */
+    workspaces: Record<string, Workspace>;
+    /** Any errors encountered during process */
+    errors: string[];
+}
+/**
+ * Build multiple isolated workspaces from a configuration
+ *
+ * @param config - Workspace configuration (map of name -> entries)
+ * @param fileProvider - File provider for reading specs
+ * @param configPath - Optional path to the config file (for relative path resolution)
+ * @param pipeline - Optional pipeline instance (uses core plugins by default)
+ */
+export declare function buildWorkspaces(config: WorkspaceConfig, _fileProvider?: FileProvider, configPath?: string, pipeline?: SpeculatorPipeline): Promise<BuildWorkspacesResult>;
+//# sourceMappingURL=builder.d.ts.map

package/dist/workspace/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/workspace/builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,4CAA4C;IAC5C,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACjC,MAAM,EAAE,eAAe,EACvB,aAAa,CAAC,EAAE,YAAY,EAC5B,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,kBAAkB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAwChC"}

package/dist/workspace/builder.js

@@ -0,0 +1,50 @@
+import { resolve, dirname } from 'path';
+import { SpeculatorPipeline } from '#src/pipeline/runner';
+import { corePlugins } from '#src/postprocess/index';
+import { sortEntriesByDeps } from '#src/workspace/sort';
+import { NodeFileProvider } from '#src/file-provider/node';
+/**
+ * Build multiple isolated workspaces from a configuration
+ *
+ * @param config - Workspace configuration (map of name -> entries)
+ * @param fileProvider - File provider for reading specs
+ * @param configPath - Optional path to the config file (for relative path resolution)
+ * @param pipeline - Optional pipeline instance (uses core plugins by default)
+ */
+export async function buildWorkspaces(config, _fileProvider, configPath, pipeline) {
+    const fileProvider = _fileProvider ?? new NodeFileProvider();
+    const workspaces = {};
+    const errors = [];
+    const p = pipeline ?? new SpeculatorPipeline(corePlugins);
+    const configDir = configPath ? dirname(resolve(configPath)) : process.cwd();
+    for (const [name, entries] of Object.entries(config)) {
+        try {
+            // 1. Resolve entry paths relative to config file
+            const resolvedEntries = entries.map(e => ({
+                ...e,
+                entry: resolve(configDir, e.entry)
+            }));
+            // 2. Sort entries by dependencies
+            const sortResult = await sortEntriesByDeps(resolvedEntries, fileProvider);
+            if (sortResult.errors.length > 0) {
+                errors.push(...sortResult.errors.map(err => `[${name}] ${err}`));
+                continue;
+            }
+            // 3. Build workspace AST
+            const result = await p.runWorkspace({
+                entries: sortResult.entries,
+                fileProvider,
+            });
+            if (!result.workspace) {
+                errors.push(`[${name}] Failed to build workspace AST.`);
+                continue;
+            }
+            workspaces[name] = result.workspace;
+        }
+        catch (error) {
+            errors.push(`[${name}] ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return { workspaces, errors };
+}
+//# sourceMappingURL=builder.js.map

package/dist/workspace/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/workspace/builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAIxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAY3D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACjC,MAAuB,EACvB,aAA4B,EAC5B,UAAmB,EACnB,QAA6B;IAE7B,MAAM,YAAY,GAAG,aAAa,IAAI,IAAI,gBAAgB,EAAE,CAAC;IAC7D,MAAM,UAAU,GAA8B,EAAE,CAAC;IACjD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,CAAC,GAAG,QAAQ,IAAI,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAE5E,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC;YACD,iDAAiD;YACjD,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACtC,GAAG,CAAC;gBACJ,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC;aACrC,CAAC,CAAC,CAAC;YAEJ,kCAAkC;YAClC,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;YAC1E,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC;gBACjE,SAAS;YACb,CAAC;YAED,yBAAyB;YACzB,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,YAAY,CAAC;gBAChC,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,YAAY;aACf,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBACpB,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,kCAAkC,CAAC,CAAC;gBACxD,SAAS;YACb,CAAC;YAED,UAAU,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACvF,CAAC;IACL,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AAClC,CAAC"}

package/dist/workspace/index.d.ts

@@ -5,4 +5,6 @@
  */
 export { sortEntriesByDeps } from './sort.js';
 export type { EntryWithConfig, SortResult } from './sort.js';
+export { buildWorkspaces } from './builder.js';
+export type { BuildWorkspacesResult } from './builder.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/workspace/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}

package/dist/workspace/index.js

@@ -4,4 +4,5 @@
  * Utilities for working with multi-document workspaces.
  */
 export { sortEntriesByDeps } from './sort.js';
+export { buildWorkspaces } from './builder.js';
 //# sourceMappingURL=index.js.map

package/dist/workspace/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openuji/speculator",
-  "version": "0.5.3",
+  "version": "0.6.0",
   "description": "AST-first specification processor with schema-central architecture",
   "type": "module",
   "main": "dist/index.js",
@@ -9,7 +9,6 @@
     "#src/*": "./dist/*.js"
   },
   "devDependencies": {
-    "@changesets/cli": "^2.29.8",
     "@types/hast": "^3.0.4",
     "@types/mdast": "^4.0.4",
     "@types/node": "^20.10.0",

package/schema/spec-ast.schema.json

@@ -280,75 +280,71 @@
                 }
             ]
         },
-        "InlineReference": {
+        "WorkspaceReferenceBase": {
+            "type": "object",
+            "properties": {
+                "targetTerm": { "type": "string" },
+                "candidateTerms": { "type": "array", "items": { "type": "string" } },
+                "forContexts": { "type": "array", "items": { "type": ["string", "null"] } },
+                "targetId": { "type": "string" },
+                "targetDocumentId": { "type": "string" },
+                "children": { "type": "array", "items": { "$ref": "#/definitions/Inline" } }
+            },
+            "required": ["targetTerm", "children"]
+        },
+        "ExternalReferenceBase": {
+            "type": "object",
+            "properties": {
+                "targetTerm": { "type": "string" },
+                "candidateTerms": { "type": "array", "items": { "type": "string" } },
+                "forContexts": { "type": "array", "items": { "type": ["string", "null"] } },
+                "xrefSpec": { "type": "string" },
+                "targetId": { "type": "string" },
+                "url": { "type": "string" },
+                "children": { "type": "array", "items": { "$ref": "#/definitions/Inline" } }
+            },
+            "required": ["targetTerm", "xrefSpec", "children"]
+        },
+        "InlineWorkspaceDfnReference": {
             "allOf": [
-                {
-                    "$ref": "#/definitions/BaseNode"
-                },
-                {
-                    "type": "object",
-                    "description": "Cross-reference marker. Parse requires targetTerm and children. Resolve may bind targetId after global dfn collection. Indexed during the indexing phase.",
-                    "properties": {
-                        "type": {
-                            "const": "reference"
-                        },
-                        "targetTerm": {
-                            "type": "string",
-                            "description": "Primary reference term used to resolve a target definition."
-                        },
-                        "candidateTerms": {
-                            "type": "array",
-                            "items": {
-                                "type": "string"
-                            },
-                            "description": "Alternative term candidates from data-lt. Parse fills from data-lt or [targetTerm]."
-                        },
-                        "forContexts": {
-                            "type": "array",
-                            "items": {
-                                "type": [
-                                    "string",
-                                    "null"
-                                ]
-                            },
-                            "description": "For-contexts from data-xref-for (e.g., owning interface). Parse fills from data-xref-for or [null]."
-                        },
-                        "preferredType": {
-                            "type": [
-                                "string",
-                                "null"
-                            ],
-                            "description": "Preferred definition type from data-link-type."
-                        },
-                        "xrefSpec": {
-                            "type": [
-                                "string",
-                                "null"
-                            ],
-                            "description": "Explicit spec to search from data-xref-spec. Restricts external search."
-                        },
-                        "allowExternal": {
-                            "type": "boolean",
-                            "description": "Whether external lookup is allowed. False if data-allow-external='no'.",
-                            "default": true
-                        },
-                        "targetId": {
-                            "type": "string",
-                            "description": "Resolved ID of the referenced definition. Filled during resolve phase."
-                        },
-                        "children": {
-                            "type": "array",
-                            "items": {
-                                "$ref": "#/definitions/Inline"
-                            }
-                        }
-                    },
-                    "required": [
-                        "type",
-                        "targetTerm",
-                        "children"
-                    ]
-                }
+                { "$ref": "#/definitions/BaseNode" },
+                { "$ref": "#/definitions/WorkspaceReferenceBase" },
+                { "type": "object", "properties": { "type": { "const": "workspaceDfnReference" } }, "required": ["type"] }
+            ]
+        },
+        "InlineWorkspaceIdlReference": {
+            "allOf": [
+                { "$ref": "#/definitions/BaseNode" },
+                { "$ref": "#/definitions/WorkspaceReferenceBase" },
+                { "type": "object", "properties": { "type": { "const": "workspaceIdlReference" } }, "required": ["type"] }
+            ]
+        },
+        "InlineWorkspaceElementReference": {
+            "allOf": [
+                { "$ref": "#/definitions/BaseNode" },
+                { "$ref": "#/definitions/WorkspaceReferenceBase" },
+                { "type": "object", "properties": { "type": { "const": "workspaceElementReference" } }, "required": ["type"] }
+            ]
+        },
+        "InlineExternalDfnReference": {
+            "allOf": [
+                { "$ref": "#/definitions/BaseNode" },
+                { "$ref": "#/definitions/ExternalReferenceBase" },
+                { "type": "object", "properties": { "type": { "const": "externalDfnReference" } }, "required": ["type"] }
+            ]
+        },
+        "InlineExternalIdlReference": {
+            "allOf": [
+                { "$ref": "#/definitions/BaseNode" },
+                { "$ref": "#/definitions/ExternalReferenceBase" },
+                { "type": "object", "properties": { "type": { "const": "externalIdlReference" } }, "required": ["type"] }
+            ]
+        },
+        "InlineExternalElementReference": {
+            "allOf": [
+                { "$ref": "#/definitions/BaseNode" },
+                { "$ref": "#/definitions/ExternalReferenceBase" },
+                { "type": "object", "properties": { "type": { "const": "externalElementReference" } }, "required": ["type"] }
             ]
         },
         "InlineRequirement": {
@@ -485,6 +481,14 @@
                             ],
                             "description": "Fragment identifier from data-cite (e.g., 'the-a-element')."
                         },
+                        "targetId": {
+                            "type": "string",
+                            "description": "Resolved ID of the bibliography entry. Filled during resolve phase."
+                        },
+                        "url": {
+                            "type": "string",
+                            "description": "Resolved URL of the citation. Filled during resolve phase."
+                        },
                         "children": {
                             "type": "array",
                             "items": {
@@ -500,6 +504,30 @@
                 }
             ]
         },
+        "InlineVariable": {
+            "allOf": [
+                {
+                    "$ref": "#/definitions/BaseNode"
+                },
+                {
+                    "type": "object",
+                    "description": "Algorithm variable marker (e.g., |x| in ReSpec). Rendered as <var> in HTML.",
+                    "properties": {
+                        "type": {
+                            "const": "variable"
+                        },
+                        "value": {
+                            "type": "string",
+                            "description": "The variable name or content."
+                        }
+                    },
+                    "required": [
+                        "type",
+                        "value"
+                    ]
+                }
+            ]
+        },
         "Inline": {
             "oneOf": [
                 {
@@ -534,6 +562,9 @@
                 },
                 {
                     "$ref": "#/definitions/InlineCite"
+                },
+                {
+                    "$ref": "#/definitions/InlineVariable"
                 }
             ]
         },
@@ -1051,6 +1082,10 @@
                 "term": {
                     "type": "string"
                 },
+                "documentId": {
+                    "type": "string",
+                    "description": "ID of the document containing this definition"
+                },
                 "linkTexts": {
                     "type": "array",
                     "items": {
@@ -1086,12 +1121,22 @@
             "type": "object",
             "description": "Entry in the references index, extracted from InlineReference nodes",
             "properties": {
+                "type": {
+                    "type": "string",
+                    "description": "Concrete reference type (e.g., workspaceDfnReference, externalIdlReference)"
+                },
                 "targetId": {
                     "type": "string"
                 },
                 "targetTerm": {
                     "type": "string"
                 },
+                "targetDocumentId": {
+                    "type": "string"
+                },
+                "url": {
+                    "type": "string"
+                },
                 "sourcePos": {
                     "$ref": "#/definitions/SourcePos"
                 }
@@ -1318,6 +1363,29 @@
                 }
             }
         },
+        "InlineReference": {
+            "description": "Union of all inline reference types",
+            "oneOf": [
+                {
+                    "$ref": "#/definitions/InlineWorkspaceDfnReference"
+                },
+                {
+                    "$ref": "#/definitions/InlineWorkspaceIdlReference"
+                },
+                {
+                    "$ref": "#/definitions/InlineWorkspaceElementReference"
+                },
+                {
+                    "$ref": "#/definitions/InlineExternalDfnReference"
+                },
+                {
+                    "$ref": "#/definitions/InlineExternalIdlReference"
+                },
+                {
+                    "$ref": "#/definitions/InlineExternalElementReference"
+                }
+            ]
+        },
         "DocumentMetadata": {
             "type": "object",
             "description": "Document-level metadata from frontmatter or config",
@@ -1376,8 +1444,28 @@
                     "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                     "description": "ISO 8601 date format (YYYY-MM-DD)"
                 },
+                "lastUpdateDate": {
+                    "type": "string",
+                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+                    "description": "Last update date (YYYY-MM-DD)"
+                },
                 "abstract": {
                     "type": "string"
+                },
+                "maturityLevel": {
+                    "type": "string",
+                    "enum": [
+                        "incubating",
+                        "draft",
+                        "prerelease",
+                        "stable"
+                    ],
+                    "description": "Normalized maturity level"
+                },
+                "custom": {
+                    "type": "object",
+                    "description": "Highest priority user-defined properties",
+                    "additionalProperties": true
                 }
             }
         },
@@ -1388,6 +1476,10 @@
                 "type": {
                     "const": "document"
                 },
+                "id": {
+                    "type": "string",
+                    "description": "Document identifier, used as slug for internal link resolution. Synced from config.id"
+                },
                 "metadata": {
                     "$ref": "#/definitions/DocumentMetadata"
                 },
@@ -1418,6 +1510,7 @@
             },
             "required": [
                 "type",
+                "id",
                 "children"
             ]
         }