@refrakt-md/types 0.7.2 → 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

@@ -6,5 +6,6 @@ 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,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,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,EACf,oBAAoB,GACpB,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;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/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 {

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;IACpC;uFACmF;IACnF,QAAQ,CAAC,EAAE,OAAO,eAAe,EAAE,oBAAoB,CAAC;CACxD"}
+{"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/schema/index.d.ts

@@ -3,13 +3,14 @@ export declare class Type<TSchema extends object = object> {
     readonly name: string;
     private schemaCtr;
     context: Record<string, string>;
-    constructor(name: string, schemaCtr: Newable<TSchema>, context?: Record<string, string>);
+    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(name: string, context?: Record<string, string>): Type<TSchema>;
+    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,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;gBAFtB,IAAI,EAAE,MAAM,EACpB,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,EAC5B,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,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;CAG9D;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,SAA2B,EAC5B,UAAkC,EAAE;QAF3B,SAAI,GAAJ,IAAI,CAAQ;QACpB,cAAS,GAAT,SAAS,CAAkB;QAC5B,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,CAAC,IAAY,EAAE,UAAkC,EAAE;QAC3D,OAAO,IAAI,IAAI,CAAU,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvD,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/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.2",
+  "version": "0.8.0",
   "type": "module",
   "license": "MIT",
   "repository": {