@refrakt-md/types 0.14.4 → 0.16.0

package/dist/index.d.ts

@@ -1,13 +1,13 @@
 export { Newable, NodeType, } from './interfaces.js';
 export type { DesignTokens } from './tokens.js';
 export type { TokenContract, PartialTokenContract, ThemeTokensConfig, ThemeTokensModeOverlay, SentimentTokens, PrimaryScale, SyntaxTokens, DeepPartial, } from './token-contract.js';
-export type { RefraktConfig, SiteConfig, SiteThemeConfig, PlanConfig, ThemeManifest, LayoutDefinition, RouteRule, ComponentDefinition, } from './theme.js';
+export type { RefraktConfig, SiteConfig, SiteThemeConfig, PlanConfig, XrefPattern, ThemeManifest, LayoutDefinition, RouteRule, EntityRoute, ComponentDefinition, } from './theme.js';
 export { getThemePackage } from './theme.js';
 export type { Plugin, PluginRune, PluginAttribute, RuneExtension, PluginThemeConfig, } from './package.js';
 export type { SerializedTag, RendererNode } from './serialized.js';
 export type { BaseComponentProps, PageSectionSlots, SplitLayoutProperties, } from './component-props.js';
 export type { ContentFieldDefinition, SequenceModel, HeadingExtractField, HeadingExtract, KnownSectionDefinition, SectionsModel, DelimitedZone, DelimitedModel, CustomModel, ItemFieldDefinition, ItemModel, AttributeInCondition, AttributeExistsCondition, HasChildCondition, ContentModelCondition, ConditionalContentModel, StructuralContentModel, ContentModel, ResolvedField, ResolvedContent, } from './content-model.js';
-export type { TransformedPage, PipelineHeadingInfo, EntityRegistration, EntityRegistry, AggregatedData, PipelineContext, PipelineWarning, PluginPipelineHooks, } from './pipeline.js';
+export type { TransformedPage, PipelineHeadingInfo, EntityRegistration, EntityRegistry, EntityEdge, ResolvedEdge, AggregatedData, PipelineContext, PipelineWarning, PluginPipelineHooks, PluginConfigureOptions, PreprocessContext, PreprocessPage, ContributePagesContext, ContributedPage, } from './pipeline.js';
 export type { CliPlugin, CliPluginCommand, McpHandlerContext, JSONSchema7, } from './cli-plugin.js';
 export type { SecurityPolicy, ResolvedSecurityPolicy } from './security.js';
 export { resolveSecurityPolicy } from './security.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EACP,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAIzB,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EACV,aAAa,EACb,UAAU,EACV,eAAe,EACf,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG7C,YAAY,EACV,MAAM,EACN,UAAU,EACV,eAAe,EACf,aAAa,EACb,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGnE,YAAY,EACX,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,GACrB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACX,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,aAAa,EACb,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,SAAS,EACT,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,eAAe,GACf,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACX,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,EACf,mBAAmB,GACnB,MAAM,eAAe,CAAC;AAGvB,YAAY,EACX,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,GACX,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EACP,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAIzB,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EACV,aAAa,EACb,UAAU,EACV,eAAe,EACf,UAAU,EACV,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,WAAW,EACX,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG7C,YAAY,EACV,MAAM,EACN,UAAU,EACV,eAAe,EACf,aAAa,EACb,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGnE,YAAY,EACX,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,GACrB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACX,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,aAAa,EACb,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,SAAS,EACT,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,eAAe,GACf,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACX,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,YAAY,EACZ,cAAc,EACd,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,eAAe,GACf,MAAM,eAAe,CAAC;AAGvB,YAAY,EACX,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,GACX,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiCA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAmE7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmCA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA0E7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/package.d.ts

@@ -46,6 +46,11 @@ export interface PluginThemeConfig {
     icons?: Record<string, Record<string, string>>;
     /** Background preset definitions for this plugin's runes */
     backgrounds?: Record<string, Record<string, unknown>>;
+    /** Domain-aware ordering overrides for collection/relationships sort &
+     *  group (SPEC-072), keyed `type → field → ordered values`. Only needed
+     *  where presentation order differs from a rune attribute's declaration
+     *  `matches` (which is used as the default automatically). */
+    orderings?: Record<string, Record<string, string[]>>;
 }
 /** A plugin's exported registration object.
  *  A plugin is an npm package that may contribute runes, layouts, theme config,
@@ -70,5 +75,12 @@ export interface Plugin {
     /** Build-time cross-page pipeline hooks.
      *  Optional — plugins that don't need cross-page awareness omit this entirely. */
     pipeline?: import('./pipeline.js').PluginPipelineHooks;
+    /** File-root namespaces this plugin contributes, keyed by namespace.
+     *  Values are paths relative to the plugin package's own directory.
+     *  Once registered, references like `{% partial file="<ns>:foo.md" /%}`
+     *  (and `{% snippet path="<ns>:bar.svelte" /%}` once SPEC-062's v2
+     *  lands) resolve from the named root. See SPEC-063 for the full
+     *  authoring + resolution model. */
+    fileRoots?: Record<string, string>;
 }
 //# sourceMappingURL=package.d.ts.map

package/dist/package.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../src/package.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,yCAAyC;AACzC,MAAM,WAAW,UAAU;IAC1B,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACzC,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;iEAC6D;IAC7D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC7B,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CACzC;AAED,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IACjC,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChD,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED;;;oBAGoB;AACpB,MAAM,WAAW,MAAM;IACtB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClC,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC,kEAAkE;IAClE,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B;yFACqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC;sFACkF;IAClF,QAAQ,CAAC,EAAE,OAAO,eAAe,EAAE,mBAAmB,CAAC;CACvD"}
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../src/package.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,yCAAyC;AACzC,MAAM,WAAW,UAAU;IAC1B,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACzC,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;iEAC6D;IAC7D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC7B,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CACzC;AAED,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IACjC,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChD,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD;;;kEAG8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;CACrD;AAED;;;oBAGoB;AACpB,MAAM,WAAW,MAAM;IACtB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClC,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC,kEAAkE;IAClE,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B;yFACqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC;sFACkF;IAClF,QAAQ,CAAC,EAAE,OAAO,eAAe,EAAE,mBAAmB,CAAC;IACvD;;;;;wCAKoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC"}

package/dist/pipeline.d.ts

@@ -28,29 +28,110 @@ export interface TransformedPage {
 }
 /**
  * A named entity registered during Phase 2 (Register).
- * The id field must be unique within its type.
+ * Identity within the registry is `(type, id)` for site-scoped entries
+ * (the default and back-compatible shape), or `(type, sourceUrl, id)` for
+ * page-scoped entries (where two pages may legitimately reuse the same id).
  */
 export interface EntityRegistration {
     /** Entity category (e.g. 'page', 'heading', 'character', 'term') */
     type: string;
-    /** Unique identifier within this type (e.g. '/docs/guide/' or '/docs/guide/#intro') */
+    /** Identifier. Unique within its type when `scope` is `'site'` (the default);
+     *  unique within `(type, sourceUrl)` when `scope` is `'page'`. */
     id: string;
-    /** URL of the page this entity was registered from */
-    sourceUrl: string;
+    /** Registration scope. `'site'` (default) means the entity is globally
+     *  addressable across the build — two registrations with the same
+     *  `(type, id)` collide and the last one wins. `'page'` means the entity
+     *  is local to the page it was registered from (its {@link sourceUrl}):
+     *  the registry namespaces the entry by URL internally so two pages can
+     *  legitimately register the same `(type, id)` without collision. Page-
+     *  scoped entries are still discoverable via {@link EntityRegistry.getAll}
+     *  and {@link EntityRegistry.getByUrl}; {@link EntityRegistry.getById}
+     *  needs the calling page's URL to match them, falling back to a site-
+     *  scoped match if no page-scoped one exists. */
+    scope?: 'page' | 'site';
+    /** URL of the page this entity was registered from, when one exists.
+     *  May be `undefined` when the entity isn't reachable via a local page URL
+     *  (e.g. SPEC-064 plan content registered from `plan.dir` outside any
+     *  site's content tree). The xref resolver treats undefined / empty as
+     *  "no usable URL" and falls through to {@link XrefPattern} resolution.
+     *  Empty strings passed at registration are normalized to `undefined`.
+     *  Required in practice for `scope: 'page'` — page-scoped entries
+     *  without a URL fall back to site-scoped keying (with a likely
+     *  collision warning from the registry implementation). */
+    sourceUrl?: string;
+    /** Project-root-relative path to the source `.md` file backing this entity.
+     *  Populated by plugins that can extract content from disk (e.g. the plan
+     *  plugin's unconditional-scan path). Consumed by content-embedding runes
+     *  like {% expand %} (SPEC-066) that need to read and slice the source
+     *  file at build time. Optional — entities registered from in-memory
+     *  sources or pages without a stable file path may omit it. */
+    sourceFile?: string;
+    /** Function returning the entity's top-level AST node from a freshly-
+     *  parsed source file, or `null` if the file's structure has been edited
+     *  away from the expected shape. Consumed by {% expand %} (SPEC-066) to
+     *  extract the entity's subtree for inline substitution. Optional and
+     *  paired with `sourceFile` — entities without a backing file omit both. */
+    extract?: (parsedSource: import('@markdoc/markdoc').Node) => import('@markdoc/markdoc').Node | null;
+    /** Return the entity's embeddable content as a Markdoc AST node directly,
+     *  without reading a source file (SPEC-069). The generalization of
+     *  `sourceFile` + `extract`: an entity is embeddable via `embed()` *or*
+     *  (`sourceFile` + `extract`). Plugins backed by in-memory / external data
+     *  (no file on disk) provide `embed()`; file-backed plugins keep
+     *  `sourceFile` + `extract`. Consumed by {% expand %}. */
+    embed?: () => import('@markdoc/markdoc').Node | null;
     /** Entity-specific payload */
     data: Record<string, unknown>;
 }
+/** A directed, typed relationship edge between two entities (SPEC-072).
+ *  `kind` is an arbitrary, domain-defined string (e.g. `implements`,
+ *  `blocked-by`, `ally`). Bidirectional relationships are expressed by
+ *  contributing both directions, so "every edge touching X" is X's outgoing
+ *  edges. `fromType`/`toType` are optional hints that speed up target
+ *  resolution; when absent the registry resolves `toId` by scanning types. */
+export interface EntityEdge {
+    fromId: string;
+    toId: string;
+    kind: string;
+    fromType?: string;
+    toType?: string;
+}
+/** An edge with its target entity resolved, returned by
+ *  {@link EntityRegistry.getRelated}. */
+export interface ResolvedEdge {
+    kind: string;
+    fromId: string;
+    toId: string;
+    target: EntityRegistration;
+}
 /** The site-wide entity registry built during Phase 2 (Register) */
 export interface EntityRegistry {
     register(entry: EntityRegistration): void;
-    /** All entities of a given type, in registration order */
+    /** All entities of a given type, in registration order. Mixed scopes —
+     *  page-scoped and site-scoped entries appear together. */
     getAll(type: string): EntityRegistration[];
-    /** All entities of a given type registered from a specific page URL */
+    /** All entities of a given type registered from a specific page URL.
+     *  Includes both page-scoped and site-scoped entries from that page. */
     getByUrl(type: string, url: string): EntityRegistration[];
-    /** Find a specific entity by type and id */
-    getById(type: string, id: string): EntityRegistration | undefined;
+    /** Find a specific entity by type and id. When `pageUrl` is provided,
+     *  page-scoped entries from that page take precedence over site-scoped
+     *  matches of the same id; if no page-scoped match exists the search
+     *  falls back to a site-scoped match. Without `pageUrl` only site-scoped
+     *  entries are returned. */
+    getById(type: string, id: string, pageUrl?: string): EntityRegistration | undefined;
     /** All registered entity type names */
     getTypes(): string[];
+    /** Contribute a relationship edge to the graph (SPEC-072). Called by
+     *  plugins during the aggregate phase. Exact `(fromId, toId, kind)`
+     *  duplicates are deduped. Optional — a minimal registry need not carry a
+     *  relationship graph. */
+    relate?(edge: EntityEdge): void;
+    /** Edges whose `fromId` is `id`, each with its target resolved (SPEC-072).
+     *  `opts.kind` / `opts.type` filter by edge kind and target entity type.
+     *  Edges to unknown entities are dropped. Optional — see {@link relate}. */
+    getRelated?(id: string, opts?: {
+        kind?: string | string[];
+        type?: string | string[];
+    }): ResolvedEdge[];
 }
 /**
  * Cross-page data produced by aggregate hooks (Phase 3).
@@ -66,24 +147,107 @@ export interface PipelineContext {
 /** A diagnostic emitted by a pipeline hook */
 export interface PipelineWarning {
     severity: 'info' | 'warning' | 'error';
-    phase: 'register' | 'aggregate' | 'postProcess';
+    phase: 'register' | 'contribute' | 'aggregate' | 'postProcess';
     pluginName: string;
     /** Page URL that triggered the warning, if applicable */
     url?: string;
     message: string;
 }
+/** Per-build configuration handed to {@link PluginPipelineHooks.configure}.
+ *  Plugins that need access to the full `refrakt.config.json` (e.g. the plan
+ *  plugin needs `plan.dir` for its unconditional-scan path) read it here. */
+export interface PluginConfigureOptions {
+    /** The full, normalized refrakt config. Typed as `unknown` here to avoid
+     *  a circular import between pipeline.ts and theme.ts; plugins cast to
+     *  `RefraktConfig` from `@refrakt-md/types`. */
+    config: unknown;
+    /** Absolute path to the directory containing `refrakt.config.json`.
+     *  Useful for resolving config-relative paths (`plan.dir`, etc.). */
+    configDir: string;
+    /** Dynamically register a file-root namespace. Use this when the plugin's
+     *  contribution depends on user config (e.g., the plan plugin registers
+     *  `plan:` pointing at the user's `plan.dir`, which isn't knowable
+     *  statically from the plugin's package directory). Roots registered
+     *  here merge with `Plugin.fileRoots` and user-config `fileRoots`; user
+     *  config still wins any namespace collision. */
+    registerFileRoot?: (namespace: string, absolutePath: string) => void;
+}
+/** Per-page context handed to {@link PluginPipelineHooks.preprocess}.
+ *  Extends {@link PipelineContext} with the file-system + project-root
+ *  information preprocess hooks need to do sandboxed file reads. Variables
+ *  from the transform `config.variables` aren't available yet (the
+ *  transform hasn't run), so file-reading preprocessors that need disk
+ *  access read here. */
+export interface PreprocessContext extends PipelineContext {
+    /** Absolute path to the project root (the directory containing
+     *  `refrakt.config.json`). The snippet rune uses this as its sandbox
+     *  anchor; any preprocessor that resolves files relative to the project
+     *  root reads it here. */
+    projectRoot?: string;
+    /** Sandbox file-reading helpers — same shape as the transform-time
+     *  `__sandboxReadFile` family. Preprocess runs before the transform
+     *  config exists, so the helpers are exposed here instead. */
+    sandbox?: {
+        read: (path: string) => string | null;
+        list: (path: string) => string[];
+        exists: (path: string) => boolean;
+    };
+    /** Markdoc variables that would otherwise be available to transforms
+     *  via `config.variables`. Snippet's preprocess uses these to resolve
+     *  attribute values that come in as Markdoc `Variable` nodes (e.g.
+     *  `path=$file.path` parses as a variable reference, not a string).
+     *  Variable nodes that aren't resolvable here render as empty strings,
+     *  matching transform-time behaviour. */
+    variables?: Record<string, unknown>;
+}
+/** Per-page metadata handed to {@link PluginPipelineHooks.preprocess}. */
+export interface PreprocessPage {
+    /** Resolved URL for this page. */
+    url: string;
+    /** Path relative to the content root. */
+    relativePath: string;
+    /** Absolute filesystem path to the source `.md` file. */
+    filePath: string;
+}
 /**
  * Build-time cross-page pipeline hooks a Plugin can provide.
- * All three hooks are optional — plugins that don't need cross-page
- * awareness omit this field entirely.
+ * All hooks are optional — plugins that don't need cross-page awareness
+ * omit this field entirely.
  */
 export interface PluginPipelineHooks {
+    /** Phase −1 — Configure.
+     *  Runs once per build before any other hook, receiving the user's
+     *  `refrakt.config.json` and the config-file directory. Plugins that need
+     *  build-time configuration (e.g. plan reading `plan.dir`) wire it up
+     *  here. Sync or async; the loader awaits the promise. */
+    configure?: (opts: PluginConfigureOptions) => void | Promise<void>;
+    /** Phase 0 — Preprocess.
+     *  Runs per page on the parsed Markdoc AST before the schema-driven
+     *  transform. Hooks may rewrite the AST (replace tags with other node
+     *  types, inject nodes, resolve include-style references). The returned
+     *  AST is the one passed to the transform. Return `undefined` (or `void`)
+     *  to leave the AST unchanged.
+     *
+     *  Use sparingly — most concerns belong in transforms or postProcess
+     *  hooks. Preprocess is for cases where the rune needs to be invisible
+     *  to downstream transforms (e.g., snippet → fence so container runes
+     *  don't need per-rune awareness). */
+    preprocess?: (ast: import('@markdoc/markdoc').Node, page: PreprocessPage, ctx: PreprocessContext) => import('@markdoc/markdoc').Node | void | Promise<import('@markdoc/markdoc').Node | void>;
     /**
      * Phase 2 — Register.
      * Scan all transformed pages and register named entities in the site-wide registry.
      * Called once with the full page array after Phase 1 is complete.
      */
     register?: (pages: readonly TransformedPage[], registry: EntityRegistry, ctx: PipelineContext) => void;
+    /**
+     * Phase 2.5 — Contribute pages (SPEC-069).
+     * Synthesize virtual pages (from registered entities or external data) that
+     * flow through the rest of the pipeline exactly like file-backed pages.
+     * Runs after register (so the registry is populated) and before aggregate.
+     * Sync or async; the loader awaits the promise. Errors are caught and the
+     * plugin's contributions are skipped with a build warning.
+     */
+    contributePages?: (ctx: ContributePagesContext) => ContributedPage[] | Promise<ContributedPage[]>;
     /**
      * Phase 3 — Aggregate.
      * Build cross-page indexes, graphs, or collections from the full registry.
@@ -99,4 +263,34 @@ export interface PluginPipelineHooks {
      */
     postProcess?: (page: TransformedPage, aggregated: AggregatedData, ctx: PipelineContext) => TransformedPage;
 }
+/** Context handed to {@link PluginPipelineHooks.contributePages} (SPEC-069). */
+export interface ContributePagesContext extends PipelineContext {
+    /** The registry after Phase 2 — read entities to derive routes. */
+    registry: Readonly<EntityRegistry>;
+    /** Absolute path to the project root, for resolving config-relative paths. */
+    projectRoot?: string;
+    /** The per-site config slice (typed `unknown` to avoid a circular import;
+     *  the built-in entityRoutes adapter casts to `SiteConfig`). */
+    siteConfig?: unknown;
+}
+/** A page synthesized by a plugin (SPEC-069). The framework parses + transforms
+ *  it and runs it through register / aggregate / postProcess like a file page. */
+export interface ContributedPage {
+    /** Site-root-relative route (basePath is applied by the loader). */
+    url: string;
+    /** Page title; falls back to the rendered content's heading when omitted. */
+    title?: string;
+    /** Frontmatter for the synthesized page. */
+    frontmatter?: Record<string, unknown>;
+    /** Markdoc source for the page body. */
+    content: string;
+    /** Extra markdoc variables bound when transforming the page body (e.g. the
+     *  entityRoutes adapter binds `{ item }` so `$item` resolves in `render`). */
+    variables?: Record<string, unknown>;
+    /** Attribution for diagnostics / collision messages. */
+    source?: {
+        plugin?: string;
+        ruleIndex?: number;
+    };
+}
 //# sourceMappingURL=pipeline.d.ts.map

package/dist/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,wDAAwD;AACxD,MAAM,WAAW,mBAAmB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACX;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC/B,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;;;;;OAKG;IACH,UAAU,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAClC,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,uFAAuF;IACvF,EAAE,EAAE,MAAM,CAAC;IACX,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAED,oEAAoE;AACpE,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC1C,0DAA0D;IAC1D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAAC;IAC3C,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAAC;IAC1D,4CAA4C;IAC5C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAC;IAClE,uCAAuC;IACvC,QAAQ,IAAI,MAAM,EAAE,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD,mFAAmF;AACnF,MAAM,WAAW,eAAe;IAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3C;AAED,8CAA8C;AAC9C,MAAM,WAAW,eAAe;IAC/B,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,aAAa,CAAC;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IACnC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CACV,KAAK,EAAE,SAAS,eAAe,EAAE,EACjC,QAAQ,EAAE,cAAc,EACxB,GAAG,EAAE,eAAe,KAChB,IAAI,CAAC;IAEV;;;;;OAKG;IACH,SAAS,CAAC,EAAE,CACX,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,EAClC,GAAG,EAAE,eAAe,KAChB,OAAO,CAAC;IAEb;;;;;OAKG;IACH,WAAW,CAAC,EAAE,CACb,IAAI,EAAE,eAAe,EACrB,UAAU,EAAE,cAAc,EAC1B,GAAG,EAAE,eAAe,KAChB,eAAe,CAAC;CACrB"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"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"}

package/dist/theme.d.ts

@@ -42,6 +42,27 @@ export interface SiteThemeConfig {
         colorScheme?: 'auto' | 'light' | 'dark';
     };
 }
+/** A declarative entity → page route (SPEC-069). Generates one page per
+ *  registered entity matching `type` + optional `filter`. `{name}` placeholders
+ *  in `url` / `title` / `frontmatter` interpolate entity fields; `$item` is
+ *  bound in `render` / `render-template`. `render` and `render-template` are
+ *  mutually exclusive. */
+export interface EntityRoute {
+    /** Entity type(s) the rule matches, comma-separated for multiple. */
+    type: string;
+    /** Optional field:value filter (SPEC-070 grammar). */
+    filter?: string;
+    /** Templated route, site-root-relative (basePath applied by the loader). */
+    url: string;
+    /** Templated page title; falls back to the rendered content's heading. */
+    title?: string;
+    /** Inline markdoc body, with `$item` bound. */
+    render?: string;
+    /** Markdoc partial used as the body instead of `render`. */
+    'render-template'?: string;
+    /** Frontmatter for the generated page (`{name}` placeholders interpolate). */
+    frontmatter?: Record<string, unknown>;
+}
 /** Per-site configuration. A project may declare a single site (via `site`) or
  *  multiple named sites (via `sites: { name: SiteConfig }`).
  *  Only `contentDir` and `theme` are strictly required for the site to load. */
@@ -60,6 +81,9 @@ export interface SiteConfig {
     overrides?: Record<string, string>;
     /** Route-to-layout mapping rules, evaluated in order (first match wins) */
     routeRules?: RouteRule[];
+    /** Declarative entity → page routes (SPEC-069). Each rule generates one page
+     *  per registered entity matching `type` + optional `filter`. */
+    entityRoutes?: EntityRoute[];
     /** Syntax highlighting options */
     highlight?: {
         theme?: string | {
@@ -120,6 +144,20 @@ export interface RefraktConfig {
     plugins?: string[];
     /** Plan-management configuration. */
     plan?: PlanConfig;
+    /** Cross-reference URL templates. Patterns are tried in array order when an
+     *  xref's ID isn't found in the registry (or when the registry-found entity
+     *  has no usable `sourceUrl`). First match wins. See {@link XrefPattern}. */
+    xrefs?: XrefPattern[];
+    /** Named file roots — directories that file-reading runes can reach via
+     *  a `namespace:filename` syntax. Markdoc partials extend `{% partial %}`
+     *  to honor namespaced refs (`shared:footer.md`); the snippet rune
+     *  ({% ref "SPEC-062" /%}) consumes the same resolver when its v2 lands.
+     *
+     *  Keys are namespace names; values are paths relative to the config
+     *  file's directory (i.e. the project root). Paths must point to existing
+     *  directories. The namespace `site` is reserved for future site-level
+     *  resolution. See SPEC-063 for the full resolution model. */
+    fileRoots?: Record<string, string>;
     /** Singular-site declaration. Mutually exclusive with `sites`. */
     site?: SiteConfig;
     /** Multi-site declaration keyed by site name. Mutually exclusive with `site`. */
@@ -164,6 +202,39 @@ export interface RefraktConfig {
         local?: Record<string, string>;
     };
 }
+/** A single cross-reference resolution pattern. Configures how unresolved xref
+ *  IDs (those without a matching registry entity) are turned into URLs.
+ *
+ *  Example: route GitHub-style refs to issue pages.
+ *  ```jsonc
+ *  {
+ *    "match": "^GH-(?<num>\\d+)$",
+ *    "template": "https://github.com/myuser/myrepo/issues/{num}",
+ *    "type": "github-issue",
+ *    "label": "GitHub #{num}"
+ *  }
+ *  ```
+ *
+ *  See SPEC-065 for the full resolution model. */
+export interface XrefPattern {
+    /** Regex pattern matched against the ID. Anchored to whole-string match by
+     *  default — `^` and `$` are auto-applied unless explicit anchors are
+     *  present at the start/end. Named groups (`(?<name>...)`) are extractable
+     *  in `template` and `label` as `{name}`. */
+    match: string;
+    /** URL template. Supports `{id}` (the full matched ID) and `{name}` for
+     *  named groups. Each substituted value is encoded per URL segment (split
+     *  on `/`, encode each segment, rejoin) so path-shaped captures preserve
+     *  slashes. */
+    template: string;
+    /** CSS modifier class — applied as `rf-xref--{type}`. Default: `"external"`.
+     *  The value `"unresolved"` is reserved and rejected at config load. */
+    type?: string;
+    /** Template for the rendered link text. Same placeholder syntax as
+     *  `template`. Default: `"{id}"`. The rune's `label=` attribute (if set)
+     *  still overrides this. */
+    label?: string;
+}
 /** Theme manifest — the universal contract between content and rendering */
 export interface ThemeManifest {
     name: string;

package/dist/theme.d.ts.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@refrakt-md/types",
   "description": "Shared type definitions for refrakt.md",
-  "version": "0.14.4",
+  "version": "0.16.0",
   "type": "module",
   "license": "MIT",
   "repository": {