@refrakt-md/types 0.7.1 → 0.8.0

package/dist/content-model.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Declarative content model types.
+ *
+ * A content model describes how a rune's AST children are grouped and
+ * assigned to named fields.  The resolver engine uses these declarations
+ * to replace per-rune `processChildren` methods with a generic, data-driven
+ * resolution step.
+ */
+/** Describes a single named field in a content model. */
+export interface ContentFieldDefinition {
+    /** Field name — becomes the key in the resolved output. */
+    name: string;
+    /**
+     * Node type to match.
+     *
+     * Block-level: 'paragraph', 'heading', 'heading:2', 'list',
+     *   'list:ordered', 'list:unordered', 'image', 'blockquote',
+     *   'fence', 'hr', 'tag:NAME', 'any'.
+     *
+     * Inline-level (for itemModel / headingExtract — future):
+     *   'strong', 'em', 'link', 'image', 'code', 'text'.
+     */
+    match: string;
+    /** Whether the field can be absent without warning. Default `false`. */
+    optional?: boolean;
+    /** Consume all consecutive matching nodes into an array. Default `false`. */
+    greedy?: boolean;
+    /** Markdoc snippet for editor insertion (future). */
+    template?: string;
+    /** Human-readable description for editor UI (future). */
+    description?: string;
+    /** For list fields: declares how to extract structured data from each list item. */
+    itemModel?: ItemModel;
+}
+/** Pattern 1 — children matched in order by node type. */
+export interface SequenceModel {
+    type: 'sequence';
+    fields: ContentFieldDefinition[];
+}
+/** A named zone within a delimited model. */
+export interface DelimitedZone extends SequenceModel {
+    name: string;
+}
+/** A field extracted from section heading text. */
+export interface HeadingExtractField {
+    /** Field name — becomes key in extracted output. */
+    name: string;
+    /** Match type — currently only 'text' (matches against heading text). */
+    match: 'text';
+    /** Pattern to extract. RegExp uses capture group 1. 'remainder' takes rest of text. */
+    pattern: RegExp | 'remainder';
+    /** Whether the field can fail to match. Default `false`. */
+    optional?: boolean;
+}
+/** Defines how structured data is parsed from section heading text. */
+export interface HeadingExtract {
+    fields: HeadingExtractField[];
+}
+/** Pattern 2 — children split into sections by heading elements. */
+export interface SectionsModel {
+    type: 'sections';
+    /**
+     * Heading type to split on.
+     * `'heading'` auto-detects level from first heading child.
+     * `'heading:N'` uses an explicit level (e.g. `'heading:2'`).
+     */
+    sectionHeading: string;
+    /** Preamble fields — resolved against content before the first section heading. */
+    fields?: ContentFieldDefinition[];
+    /** Content model applied to each section's body. */
+    sectionModel: ContentModel;
+    /** When set, sections are emitted as child rune tag nodes with this tag name. */
+    emitTag?: string;
+    /**
+     * Attribute mapping for emitted tags.
+     * Values starting with `$` are references: `$heading` = heading text,
+     * `$fieldName` = heading-extracted field. Other values are literals.
+     */
+    emitAttributes?: Record<string, string>;
+    /** Extract structured data from heading text. */
+    headingExtract?: HeadingExtract;
+}
+/** Pattern 3 — children split into groups by a delimiter node. */
+export interface DelimitedModel {
+    type: 'delimited';
+    /** Delimiter node type (typically `'hr'`). */
+    delimiter: string;
+    /** Named zones — each group maps to a declared zone by index. */
+    zones?: DelimitedZone[];
+    /** When `true`, the number of zones is determined by delimiter count. */
+    dynamicZones?: boolean;
+    /** Zone model used when `dynamicZones` is `true`. */
+    zoneModel?: SequenceModel;
+}
+/**
+ * Pattern 4 — explicit escape hatch for runes whose content parsing is
+ * genuinely stateful and cannot be expressed declaratively.
+ *
+ * The `processChildren` function receives AST children and the rune's
+ * attribute values, returns rewritten nodes.
+ */
+export interface CustomModel {
+    type: 'custom';
+    processChildren: (nodes: unknown[], attributes: Record<string, unknown>) => unknown[];
+    /** Human-readable description of what the custom parser does. */
+    description: string;
+}
+/** A field extracted from inline content within a list item. */
+export interface ItemFieldDefinition {
+    /** Field name — becomes key in extracted output. */
+    name: string;
+    /**
+     * Inline node type to match.
+     *
+     * Inline: 'strong', 'em', 'link', 'image', 'code', 'text'.
+     * Block (for nested content): 'list', 'paragraph'.
+     */
+    match: string;
+    /** Whether the field can fail to match. Default `false`. */
+    optional?: boolean;
+    /** Consume all consecutive matching nodes into an array. Default `false`. */
+    greedy?: boolean;
+    /**
+     * Which attribute to extract instead of text content.
+     * E.g., `'href'` on a link match extracts the URL.
+     */
+    extract?: string;
+    /**
+     * For text-level extraction: regex pattern or `'remainder'` for leftover text.
+     * When a RegExp, capture group 1 is used. When `'remainder'`, captures
+     * whatever text is left after all other patterns have matched.
+     */
+    pattern?: RegExp | 'remainder';
+    /** Nested item model for sub-lists. */
+    itemModel?: ItemModel;
+}
+/** Declares how to extract structured data from each list item's inline children. */
+export interface ItemModel {
+    fields: ItemFieldDefinition[];
+}
+/** Condition: attribute value is in a set. */
+export interface AttributeInCondition {
+    attribute: string;
+    in: string[];
+}
+/** Condition: attribute is present (truthy). */
+export interface AttributeExistsCondition {
+    attribute: string;
+    exists: true;
+}
+/** Condition: a child matching a node type is present. */
+export interface HasChildCondition {
+    hasChild: string;
+}
+/** A content model condition — used in `when` branches. */
+export type ContentModelCondition = AttributeInCondition | AttributeExistsCondition | HasChildCondition;
+/** A conditional content model that branches on attributes or content shape. */
+export interface ConditionalContentModel {
+    when: Array<{
+        condition: ContentModelCondition;
+        model: ContentModel;
+    }>;
+    default: ContentModel;
+}
+/** A structural content model pattern. */
+export type StructuralContentModel = SequenceModel | SectionsModel | DelimitedModel | CustomModel;
+/**
+ * A content model declaration.
+ *
+ * Supports `sequence`, `sections`, `delimited`, and `custom` patterns,
+ * plus `when` conditional branching.
+ */
+export type ContentModel = StructuralContentModel | ConditionalContentModel;
+/** A single resolved field value. */
+export type ResolvedField = unknown | unknown[] | ResolvedContent | undefined;
+/** The output of resolving a content model against AST children. */
+export interface ResolvedContent {
+    [fieldName: string]: ResolvedField;
+}
+//# sourceMappingURL=content-model.d.ts.map

package/dist/content-model.d.ts.map

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

package/dist/content-model.js

@@ -0,0 +1,10 @@
+/**
+ * Declarative content model types.
+ *
+ * A content model describes how a rune's AST children are grouped and
+ * assigned to named fields.  The resolver engine uses these declarations
+ * to replace per-rune `processChildren` methods with a generic, data-driven
+ * resolution step.
+ */
+export {};
+//# sourceMappingURL=content-model.js.map

package/dist/content-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-model.js","sourceRoot":"","sources":["../src/content-model.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/index.d.ts

@@ -1,9 +1,11 @@
-export { Newable, NodeType, PropertyNodes, ComponentType, } from './interfaces.js';
+export { Newable, NodeType, } from './interfaces.js';
 export { Type, TypeFactory, useSchema, } from './schema/index.js';
-export { Page, PageSection, PageSectionProperties, PageSectionComponent, PageProperties, PageComponent } from './schema/page.js';
-export { LinkItem, Command, LinkItemComponent, CommandComponent } from './schema/common.js';
+export { Page, PageSection } from './schema/page.js';
+export { LinkItem, Command } from './schema/common.js';
 export type { DesignTokens } from './tokens.js';
 export type { RefraktConfig, ThemeManifest, LayoutDefinition, RouteRule, ComponentDefinition, } from './theme.js';
 export type { RunePackage, RunePackageEntry, RunePackageAttribute, RuneExtension, RunePackageThemeConfig, } from './package.js';
 export type { SerializedTag, RendererNode } from './serialized.js';
+export type { ContentFieldDefinition, SequenceModel, HeadingExtractField, HeadingExtract, 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, PackagePipelineHooks, } from './pipeline.js';
 //# sourceMappingURL=index.d.ts.map

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,EACR,aAAa,EACb,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,IAAI,EACJ,WAAW,EACX,SAAS,GACV,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjI,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG5F,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,YAAY,EACV,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EACP,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,IAAI,EACJ,WAAW,EACX,SAAS,GACV,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGvD,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,YAAY,EACV,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGnE,YAAY,EACX,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,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,oBAAoB,GACpB,MAAM,eAAe,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,8BAA8B;AAC9B,OAAO,EACL,IAAI,EACJ,WAAW,EACX,SAAS,GACV,MAAM,mBAAmB,CAAC;AAE3B,4DAA4D;AAC5D,OAAO,EAAE,IAAI,EAAE,WAAW,EAA8E,MAAM,kBAAkB,CAAC;AACjI,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAuC,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,8BAA8B;AAC9B,OAAO,EACL,IAAI,EACJ,WAAW,EACX,SAAS,GACV,MAAM,mBAAmB,CAAC;AAE3B,4DAA4D;AAC5D,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/interfaces.d.ts

@@ -1,14 +1,5 @@
 export interface Newable<T> {
     new (...args: any[]): T;
 }
-export type PropertyNodes<TSchema> = {
-    [P in keyof TSchema]: NodeType;
-};
 export type NodeType = 'document' | 'meta' | 'address' | 'article' | 'aside' | 'details' | 'footer' | 'form' | 'header' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'hgroup' | 'main' | 'nav' | 'section' | 'search' | 'blockquote' | 'dd' | 'div' | 'dl' | 'dt' | 'figcaption' | 'figure' | 'hr' | 'li' | 'menu' | 'ol' | 'p' | 'pre' | 'ul' | 'a' | 'abbr' | 'b' | 'bdi' | 'bdo' | 'br' | 'cite' | 'code' | 'data' | 'dfn' | 'em' | 'i' | 'kbd' | 'span' | 'strong' | 'summary' | 'time' | 'area' | 'audio' | 'img' | 'map' | 'track' | 'video' | 'svg' | 'path' | 'math' | 'button' | 'fieldset' | 'input' | 'label' | 'legend' | 'option' | 'select' | 'textarea' | 'caption' | 'col' | 'colgroup' | 'table' | 'tbody' | 'td' | 'tfoot' | 'th' | 'thead' | 'tr';
-export interface ComponentType<TSchema> {
-    tag: NodeType;
-    schema: TSchema;
-    properties: PropertyNodes<TSchema>;
-    refs: Record<string, NodeType>;
-}
 //# sourceMappingURL=interfaces.d.ts.map

package/dist/interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO,CAAC,CAAC;IACxB,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;CACzB;AAED,MAAM,MAAM,aAAa,CAAC,OAAO,IAAI;KAAG,CAAC,IAAI,MAAM,OAAO,GAAI,QAAQ;CAAE,CAAC;AAEzE,MAAM,MAAM,QAAQ,GAClB,UAAU,GAGV,MAAM,GAGN,SAAS,GACT,SAAS,GACT,OAAO,GACP,SAAS,GACT,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GACvC,QAAQ,GACR,MAAM,GACN,KAAK,GACL,SAAS,GACT,QAAQ,GAGR,YAAY,GACZ,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,IAAI,GACJ,YAAY,GACZ,QAAQ,GACR,IAAI,GACJ,IAAI,GACJ,MAAM,GACN,IAAI,GACJ,GAAG,GACH,KAAK,GACL,IAAI,GAGJ,GAAG,GACH,MAAM,GACN,GAAG,GACH,KAAK,GACL,KAAK,GACL,IAAI,GACJ,MAAM,GACN,MAAM,GACN,MAAM,GACN,KAAK,GACL,IAAI,GACJ,GAAG,GACH,KAAK,GACL,MAAM,GACN,QAAQ,GACR,SAAS,GACT,MAAM,GAGN,MAAM,GACN,OAAO,GACP,KAAK,GACL,KAAK,GACL,OAAO,GACP,OAAO,GAGP,KAAK,GACL,MAAM,GACN,MAAM,GAGN,QAAQ,GACR,UAAU,GACV,OAAO,GACP,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,UAAU,GAGV,SAAS,GACT,KAAK,GACL,UAAU,GACV,OAAO,GACP,OAAO,GACP,IAAI,GACJ,OAAO,GACP,IAAI,GACJ,OAAO,GACP,IAAI,CAAC;AAGP,MAAM,WAAW,aAAa,CAAC,OAAO;IACpC,GAAG,EAAE,QAAQ,CAAC;IAEd,MAAM,EAAE,OAAO,CAAC;IAEhB,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAEnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;CAC/B"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO,CAAC,CAAC;IACxB,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;CACzB;AAED,MAAM,MAAM,QAAQ,GAClB,UAAU,GAGV,MAAM,GAGN,SAAS,GACT,SAAS,GACT,OAAO,GACP,SAAS,GACT,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GACvC,QAAQ,GACR,MAAM,GACN,KAAK,GACL,SAAS,GACT,QAAQ,GAGR,YAAY,GACZ,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,IAAI,GACJ,YAAY,GACZ,QAAQ,GACR,IAAI,GACJ,IAAI,GACJ,MAAM,GACN,IAAI,GACJ,GAAG,GACH,KAAK,GACL,IAAI,GAGJ,GAAG,GACH,MAAM,GACN,GAAG,GACH,KAAK,GACL,KAAK,GACL,IAAI,GACJ,MAAM,GACN,MAAM,GACN,MAAM,GACN,KAAK,GACL,IAAI,GACJ,GAAG,GACH,KAAK,GACL,MAAM,GACN,QAAQ,GACR,SAAS,GACT,MAAM,GAGN,MAAM,GACN,OAAO,GACP,KAAK,GACL,KAAK,GACL,OAAO,GACP,OAAO,GAGP,KAAK,GACL,MAAM,GACN,MAAM,GAGN,QAAQ,GACR,UAAU,GACV,OAAO,GACP,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,UAAU,GAGV,SAAS,GACT,KAAK,GACL,UAAU,GACV,OAAO,GACP,OAAO,GACP,IAAI,GACJ,OAAO,GACP,IAAI,GACJ,OAAO,GACP,IAAI,CAAC"}

package/dist/package.d.ts

@@ -37,6 +37,8 @@ export interface RunePackageThemeConfig {
     runes?: Record<string, Record<string, unknown>>;
     /** Additional icon SVGs (group name → icon name → SVG string) */
     icons?: Record<string, Record<string, string>>;
+    /** Background preset definitions for this package's runes */
+    backgrounds?: Record<string, Record<string, unknown>>;
 }
 /** A community rune package's exported registration object */
 export interface RunePackage {
@@ -55,5 +57,8 @@ export interface RunePackage {
     /** Client-side behavior functions keyed by rune typeof name (lowercase).
      *  Typed as unknown here — actual BehaviorFn type lives in @refrakt-md/behaviors. */
     behaviors?: Record<string, unknown>;
+    /** Build-time cross-page pipeline hooks.
+     *  Optional — packages that don't need cross-page awareness omit this entirely. */
+    pipeline?: import('./pipeline.js').PackagePipelineHooks;
 }
 //# 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,gDAAgD;AAEhD,qEAAqE;AACrE,MAAM,WAAW,oBAAoB;IACpC,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,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAChC,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAC9C,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,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,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC7B,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;CAC9C;AAED,6DAA6D;AAC7D,MAAM,WAAW,sBAAsB;IACtC,wEAAwE;IACxE,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;CAC/C;AAED,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC3B,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACxC,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC,mEAAmE;IACnE,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B;yFACqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../src/package.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAEhD,qEAAqE;AACrE,MAAM,WAAW,oBAAoB;IACpC,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,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAChC,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAC9C,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,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,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC7B,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;CAC9C;AAED,6DAA6D;AAC7D,MAAM,WAAW,sBAAsB;IACtC,wEAAwE;IACxE,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,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC3B,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACxC,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC,mEAAmE;IACnE,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B;yFACqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC;uFACmF;IACnF,QAAQ,CAAC,EAAE,OAAO,eAAe,EAAE,oBAAoB,CAAC;CACxD"}

package/dist/pipeline.d.ts

@@ -0,0 +1,102 @@
+/** Cross-page pipeline types */
+/** A page heading (level, text, generated anchor id) */
+export interface PipelineHeadingInfo {
+    level: number;
+    text: string;
+    id: string;
+}
+/**
+ * A page after Phase 1 (parse + rune transform), before Phase 4 (post-process).
+ * Passed to all three pipeline hooks.
+ */
+export interface TransformedPage {
+    /** Resolved URL for this page (e.g. '/docs/getting-started/') */
+    url: string;
+    /** Page title from frontmatter */
+    title: string;
+    /** Headings extracted from the page content */
+    headings: PipelineHeadingInfo[];
+    /** Raw frontmatter values */
+    frontmatter: Record<string, unknown>;
+    /**
+     * The page's renderable content after rune transforms.
+     * At pipeline time this holds the framework's native AST node type
+     * (e.g. Markdoc Tag instances), which is serialized to plain objects later.
+     * Typed as unknown to avoid importing framework-specific types here.
+     */
+    renderable: unknown;
+}
+/**
+ * A named entity registered during Phase 2 (Register).
+ * The id field must be unique within its type.
+ */
+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') */
+    id: string;
+    /** URL of the page this entity was registered from */
+    sourceUrl: string;
+    /** Entity-specific payload */
+    data: Record<string, unknown>;
+}
+/** 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 */
+    getAll(type: string): EntityRegistration[];
+    /** All entities of a given type registered from a specific page URL */
+    getByUrl(type: string, url: string): EntityRegistration[];
+    /** Find a specific entity by type and id */
+    getById(type: string, id: string): EntityRegistration | undefined;
+    /** All registered entity type names */
+    getTypes(): string[];
+}
+/**
+ * Cross-page data produced by aggregate hooks (Phase 3).
+ * Keyed by package name to prevent collisions between packages.
+ */
+export type AggregatedData = Record<string, unknown>;
+/** Context object passed to each pipeline hook for emitting structured warnings */
+export interface PipelineContext {
+    info(message: string, url?: string): void;
+    warn(message: string, url?: string): void;
+    error(message: string, url?: string): void;
+}
+/** A diagnostic emitted by a pipeline hook */
+export interface PipelineWarning {
+    severity: 'info' | 'warning' | 'error';
+    phase: 'register' | 'aggregate' | 'postProcess';
+    packageName: string;
+    /** Page URL that triggered the warning, if applicable */
+    url?: string;
+    message: string;
+}
+/**
+ * Build-time cross-page pipeline hooks a RunePackage can provide.
+ * All three hooks are optional — packages that don't need cross-page
+ * awareness omit this field entirely.
+ */
+export interface PackagePipelineHooks {
+    /**
+     * 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 3 — Aggregate.
+     * Build cross-page indexes, graphs, or collections from the full registry.
+     * Called once after all register hooks have run.
+     * Return value is stored as aggregated[packageName].
+     */
+    aggregate?: (registry: Readonly<EntityRegistry>, ctx: PipelineContext) => unknown;
+    /**
+     * Phase 4 — Post-process.
+     * Enrich a page's renderable tree using cross-page data from aggregated.
+     * Called once per page, in package registration order.
+     * Return the modified page (or the original if no changes needed).
+     */
+    postProcess?: (page: TransformedPage, aggregated: AggregatedData, ctx: PipelineContext) => TransformedPage;
+}
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/pipeline.d.ts.map

@@ -0,0 +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,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACpC;;;;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"}

package/dist/pipeline.js

@@ -0,0 +1,3 @@
+/** Cross-page pipeline types */
+export {};
+//# sourceMappingURL=pipeline.js.map

package/dist/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAAA,gCAAgC"}

package/dist/schema/common.d.ts

@@ -1,4 +1,3 @@
-import { ComponentType } from "../interfaces.js";
 export declare class LinkItem {
     name: string;
     url: string;
@@ -6,17 +5,4 @@ export declare class LinkItem {
 export declare class Command {
     code: string;
 }
-export interface LinkItemComponent extends ComponentType<LinkItem> {
-    tag: 'li';
-    properties: {
-        name: 'span' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
-        url: 'a';
-    };
-}
-export interface CommandComponent extends ComponentType<Command> {
-    tag: 'div';
-    properties: {
-        code: 'code';
-    };
-}
 //# sourceMappingURL=common.d.ts.map

package/dist/schema/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/schema/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,qBAAa,QAAQ;IACnB,IAAI,EAAE,MAAM,CAAM;IAClB,GAAG,EAAE,MAAM,CAAM;CAClB;AAED,qBAAa,OAAO;IAClB,IAAI,EAAE,MAAM,CAAM;CACnB;AAED,MAAM,WAAW,iBAAkB,SAAQ,aAAa,CAAC,QAAQ,CAAC;IAChE,GAAG,EAAE,IAAI,CAAC;IACV,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;QACvD,GAAG,EAAE,GAAG,CAAC;KACV,CAAC;CACH;AAED,MAAM,WAAW,gBAAiB,SAAQ,aAAa,CAAC,OAAO,CAAC;IAC9D,GAAG,EAAE,KAAK,CAAC;IACX,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/schema/common.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAQ;IACnB,IAAI,EAAE,MAAM,CAAM;IAClB,GAAG,EAAE,MAAM,CAAM;CAClB;AAED,qBAAa,OAAO;IAClB,IAAI,EAAE,MAAM,CAAM;CACnB"}

package/dist/schema/common.js.map

@@ -1 +1 @@
-{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/schema/common.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,QAAQ;IACnB,IAAI,GAAW,EAAE,CAAC;IAClB,GAAG,GAAW,EAAE,CAAC;CAClB;AAED,MAAM,OAAO,OAAO;IAClB,IAAI,GAAW,EAAE,CAAC;CACnB"}
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/schema/common.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAQ;IACnB,IAAI,GAAW,EAAE,CAAC;IAClB,GAAG,GAAW,EAAE,CAAC;CAClB;AAED,MAAM,OAAO,OAAO;IAClB,IAAI,GAAW,EAAE,CAAC;CACnB"}

package/dist/schema/index.d.ts

@@ -1,15 +1,16 @@
-import { ComponentType, Newable } from "../interfaces.js";
-export declare class Type<T extends ComponentType<object>> {
+import { Newable } from "../interfaces.js";
+export declare class Type<TSchema extends object = object> {
     readonly name: string;
     private schemaCtr;
     context: Record<string, string>;
-    constructor(name: string, schemaCtr: Newable<T["schema"]>, context?: Record<string, string>);
-    create(): T["schema"];
+    readonly schemaOrgType?: string | undefined;
+    constructor(name: string, schemaCtr: Newable<TSchema>, context?: Record<string, string>, schemaOrgType?: string | undefined);
+    create(): TSchema;
 }
 export declare class TypeFactory<TSchema extends object> {
     private schema;
     constructor(schema: Newable<TSchema>);
-    defineType<T extends ComponentType<TSchema>>(name: string, context?: Record<string, string>): Type<T>;
+    defineType(name: string, context?: Record<string, string>, schemaOrgType?: string): Type<TSchema>;
 }
 export declare function useSchema<T extends object>(schema: Newable<T>): TypeFactory<T>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE1D,qBAAa,IAAI,CAAC,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC;aAE7B,IAAI,EAAE,MAAM;IAC5B,OAAO,CAAC,SAAS;IACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;gBAFtB,IAAI,EAAE,MAAM,EACpB,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAChC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;IAG7C,MAAM;CAGP;AAED,qBAAa,WAAW,CAAC,OAAO,SAAS,MAAM;IACjC,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC;IAE5C,UAAU,CAAC,CAAC,SAAS,aAAa,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;CAGhG;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,kBAE7D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,qBAAa,IAAI,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM;aAE7B,IAAI,EAAE,MAAM;IAC5B,OAAO,CAAC,SAAS;IACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;aACtB,aAAa,CAAC,EAAE,MAAM;gBAHtB,IAAI,EAAE,MAAM,EACpB,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,EAC5B,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EAC3B,aAAa,CAAC,EAAE,MAAM,YAAA;IAGxC,MAAM;CAGP;AAED,qBAAa,WAAW,CAAC,OAAO,SAAS,MAAM;IACjC,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC;IAE5C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EAAE,aAAa,CAAC,EAAE,MAAM;CAGtF;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,kBAE7D"}

package/dist/schema/index.js

@@ -2,10 +2,12 @@ export class Type {
     name;
     schemaCtr;
     context;
-    constructor(name, schemaCtr, context = {}) {
+    schemaOrgType;
+    constructor(name, schemaCtr, context = {}, schemaOrgType) {
         this.name = name;
         this.schemaCtr = schemaCtr;
         this.context = context;
+        this.schemaOrgType = schemaOrgType;
     }
     create() {
         return new this.schemaCtr();
@@ -16,8 +18,8 @@ export class TypeFactory {
     constructor(schema) {
         this.schema = schema;
     }
-    defineType(name, context = {}) {
-        return new Type(name, this.schema, context);
+    defineType(name, context = {}, schemaOrgType) {
+        return new Type(name, this.schema, context, schemaOrgType);
     }
 }
 export function useSchema(schema) {

package/dist/schema/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,IAAI;IAEG;IACR;IACD;IAHT,YACkB,IAAY,EACpB,SAA+B,EAChC,UAAkC,EAAE;QAF3B,SAAI,GAAJ,IAAI,CAAQ;QACpB,cAAS,GAAT,SAAS,CAAsB;QAChC,YAAO,GAAP,OAAO,CAA6B;IAC1C,CAAC;IAEJ,MAAM;QACJ,OAAO,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,WAAW;IACF;IAApB,YAAoB,MAAwB;QAAxB,WAAM,GAAN,MAAM,CAAkB;IAAG,CAAC;IAEhD,UAAU,CAAmC,IAAY,EAAE,UAAkC,EAAE;QAC7F,OAAO,IAAI,IAAI,CAAI,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;CACF;AAED,MAAM,UAAU,SAAS,CAAmB,MAAkB;IAC5D,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,IAAI;IAEG;IACR;IACD;IACS;IAJlB,YACkB,IAAY,EACpB,SAA2B,EAC5B,UAAkC,EAAE,EAC3B,aAAsB;QAHtB,SAAI,GAAJ,IAAI,CAAQ;QACpB,cAAS,GAAT,SAAS,CAAkB;QAC5B,YAAO,GAAP,OAAO,CAA6B;QAC3B,kBAAa,GAAb,aAAa,CAAS;IACrC,CAAC;IAEJ,MAAM;QACJ,OAAO,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,WAAW;IACF;IAApB,YAAoB,MAAwB;QAAxB,WAAM,GAAN,MAAM,CAAkB;IAAG,CAAC;IAEhD,UAAU,CAAC,IAAY,EAAE,UAAkC,EAAE,EAAE,aAAsB;QACnF,OAAO,IAAI,IAAI,CAAU,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IACtE,CAAC;CACF;AAED,MAAM,UAAU,SAAS,CAAmB,MAAkB;IAC5D,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC"}

package/dist/schema/page.d.ts

@@ -1,33 +1,11 @@
-import { ComponentType, PropertyNodes } from "../interfaces.js";
 export declare class PageSection {
     eyebrow: string | undefined;
     headline: string | undefined;
     blurb: string | undefined;
 }
-export interface PageSectionProperties extends PropertyNodes<PageSection> {
-    eyebrow: 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
-    headline: 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
-    blurb: 'p';
-}
-export interface PageSectionComponent extends ComponentType<PageSection> {
-    tag: 'section';
-    properties: PageSectionProperties;
-}
 export declare class Page {
     name: string;
     description: string;
     contentSection: PageSection[];
 }
-export interface PageProperties extends PropertyNodes<Page> {
-    name: 'h1';
-    description: 'p';
-    contentSection: 'section';
-}
-export interface PageComponent extends ComponentType<Page> {
-    tag: 'document';
-    properties: PageProperties;
-    refs: {
-        body: 'main';
-    };
-}
 //# sourceMappingURL=page.d.ts.map

package/dist/schema/page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/schema/page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEhE,qBAAa,WAAW;IACtB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAa;IACxC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAa;IACzC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;CACvC;AAED,MAAM,WAAW,qBAAsB,SAAQ,aAAa,CAAC,WAAW,CAAC;IACvE,OAAO,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACjD,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAClD,KAAK,EAAE,GAAG,CAAC;CACZ;AAED,MAAM,WAAW,oBAAqB,SAAQ,aAAa,CAAC,WAAW,CAAC;IACtE,GAAG,EAAE,SAAS,CAAC;IACf,UAAU,EAAE,qBAAqB,CAAC;CACnC;AAED,qBAAa,IAAI;IACf,IAAI,EAAE,MAAM,CAAM;IAClB,WAAW,EAAE,MAAM,CAAM;IACzB,cAAc,EAAE,WAAW,EAAE,CAAM;CACpC;AAED,MAAM,WAAW,cAAe,SAAQ,aAAa,CAAC,IAAI,CAAC;IACzD,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,GAAG,CAAC;IACjB,cAAc,EAAE,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,aAAc,SAAQ,aAAa,CAAC,IAAI,CAAC;IACxD,GAAG,EAAE,UAAU,CAAC;IAChB,UAAU,EAAE,cAAc,CAAC;IAC3B,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;KACd,CAAA;CACF"}
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/schema/page.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAW;IACtB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAa;IACxC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAa;IACzC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;CACvC;AAED,qBAAa,IAAI;IACf,IAAI,EAAE,MAAM,CAAM;IAClB,WAAW,EAAE,MAAM,CAAM;IACzB,cAAc,EAAE,WAAW,EAAE,CAAM;CACpC"}

package/dist/schema/page.js.map

@@ -1 +1 @@
-{"version":3,"file":"page.js","sourceRoot":"","sources":["../../src/schema/page.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,WAAW;IACtB,OAAO,GAAuB,SAAS,CAAC;IACxC,QAAQ,GAAuB,SAAS,CAAC;IACzC,KAAK,GAAuB,SAAS,CAAC;CACvC;AAaD,MAAM,OAAO,IAAI;IACf,IAAI,GAAW,EAAE,CAAC;IAClB,WAAW,GAAW,EAAE,CAAC;IACzB,cAAc,GAAkB,EAAE,CAAC;CACpC"}
+{"version":3,"file":"page.js","sourceRoot":"","sources":["../../src/schema/page.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAW;IACtB,OAAO,GAAuB,SAAS,CAAC;IACxC,QAAQ,GAAuB,SAAS,CAAC;IACzC,KAAK,GAAuB,SAAS,CAAC;CACvC;AAED,MAAM,OAAO,IAAI;IACf,IAAI,GAAW,EAAE,CAAC;IAClB,WAAW,GAAW,EAAE,CAAC;IACzB,cAAc,GAAkB,EAAE,CAAC;CACpC"}

package/dist/theme.d.ts

@@ -22,6 +22,10 @@ export interface RefraktConfig {
     icons?: Record<string, string>;
     /** Community rune packages to load (npm package names) */
     packages?: string[];
+    /** Project-level tint presets — merged after theme tints (last wins) */
+    tints?: Record<string, Record<string, unknown>>;
+    /** Project-level background presets — merged after theme backgrounds (last wins) */
+    backgrounds?: Record<string, Record<string, unknown>>;
     /** Rune resolution configuration */
     runes?: {
         /** Resolve name collisions between community packages: rune name → preferred package name.

package/dist/theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC7B,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,2EAA2E;IAC3E,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,kCAAkC;IAClC,SAAS,CAAC,EAAE;QACX,mFAAmF;QACnF,KAAK,CAAC,EAAE,MAAM,GAAG;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;KACjD,CAAC;IACF,4FAA4F;IAC5F,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oCAAoC;IACpC,KAAK,CAAC,EAAE;QACP;iGACyF;QACzF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC;oGAC4F;QAC5F,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC;yEACiE;QACjE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC/B,CAAC;CACF;AAED,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC1C;;gFAE4E;IAC5E,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAChD,qDAAqD;IACrD,uBAAuB,CAAC,EAAE,UAAU,GAAG,aAAa,GAAG,MAAM,CAAC;IAC9D,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAChC,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACzB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IACnC,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,8CAA8C;IAC9C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD"}
+{"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.7.1",
+  "version": "0.8.0",
   "type": "module",
   "license": "MIT",
   "repository": {