@refrakt-md/content 0.12.0 → 0.14.0

package/dist/frontmatter.d.ts

@@ -9,6 +9,23 @@ export interface Frontmatter {
     author?: string;
     tags?: string[];
     image?: string;
+    /** Icon name resolvable by the `{% icon %}` rune. Used by `nav layout="cards"`
+     *  to render an icon on each child page card. */
+    icon?: string;
+    /** Named tint preset to apply for this page (or subtree, when set in a
+     *  `_layout.md`). Cascades down the layout chain; explicit `null` resets
+     *  to inherit from the layer above. See SPEC-052. */
+    tint?: string | null;
+    /** Initial colour-scheme behaviour for this page (or subtree, when set in
+     *  a `_layout.md`). `'auto'` follows user preference and system pref;
+     *  `'light'` / `'dark'` lock the SSR-emitted mode. Cascades down the
+     *  layout chain. */
+    'tint-mode'?: 'auto' | 'light' | 'dark';
+    /** When `true`, the page (or subtree) ignores user theme preference and
+     *  hides the theme-toggle UI — used for marketing surfaces where the
+     *  brand should look the same to every visitor. Cascades down the layout
+     *  chain. See SPEC-052. */
+    'tint-lock'?: boolean;
     [key: string]: unknown;
 }
 /**

package/dist/frontmatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAW3F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKtF"}
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;qDACiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;yDAEqD;IACrD,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;wBAGoB;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACxC;;;+BAG2B;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAW3F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKtF"}

package/dist/frontmatter.js.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAgBxB;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAExE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAgB,IAAI,EAAE,CAAC;IACpE,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEzB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAAwB,EAAE,OAAe;IAC5E,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IACxE,OAAO,QAAQ,OAAO,UAAU,OAAO,EAAE,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAiCxB;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAExE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAgB,IAAI,EAAE,CAAC;IACpE,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEzB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAAwB,EAAE,OAAe;IAC5E,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IACxE,OAAO,QAAQ,OAAO,UAAU,OAAO,EAAE,CAAC;AAC5C,CAAC"}

package/dist/index.d.ts

@@ -2,13 +2,15 @@ export { ContentTree, type ContentNode, type ContentPage, type ContentDirectory,
 export { parseFrontmatter, serializeFrontmatter, type Frontmatter } from './frontmatter.js';
 export { Router, type Route } from './router.js';
 export { resolveLayouts, type ResolvedLayout, type Region } from './layout.js';
+export { resolveTintCascade, type ResolvedTintCascade, type CascadeRootDefaults, } from './tint-cascade.js';
+export { htmlTintAttributes, colorSchemeMetaContent, prePaintScript } from './tint-ssr.js';
 export { buildNavigation, type NavTree, type NavGroup, type NavItem } from './navigation.js';
-export { loadContent, type Site, type SitePage } from './site.js';
-export { createSiteLoader, type SiteLoader, type SiteLoaderOptions } from './loader.js';
+export { loadContent, loadContentFromTree, type Site, type SitePage, type LoadContentFromTreeOptions, type VirtualReader } from './site.js';
+export { createSiteLoader, createVirtualSiteLoader, type SiteLoader, type SiteLoaderOptions, type VirtualSiteLoaderOptions } from './loader.js';
 export { generateSitemap, type SitemapEntry } from './sitemap.js';
 export { collectRuneTypes, analyzeRuneUsage, type RuneUsageReport } from './analyze.js';
 export { getGitTimestamps, getStatTimestamps, resolveTimestamps, type FileTimestamps } from './timestamps.js';
 export { EntityRegistryImpl } from './registry.js';
-export { createRefraktLoader, type RefraktLoader, type RefraktLoaderOptions } from './refract-loader.js';
+export { createRefraktLoader, createVirtualRefraktLoader, buildHighlightOptions, type RefraktLoader, type RefraktLoaderOptions, type VirtualRefraktLoaderOptions } from './refract-loader.js';
 export { runPipeline, type HookSet, type PipelineResult, type PipelineStats } 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":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC7H,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAE,MAAM,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC9G,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACzG,OAAO,EAAE,WAAW,EAAE,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC7H,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAE,MAAM,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EACL,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,KAAK,0BAA0B,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAC5I,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAChJ,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC9G,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,KAAK,aAAa,EAAE,KAAK,oBAAoB,EAAE,KAAK,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAC9L,OAAO,EAAE,WAAW,EAAE,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -2,13 +2,15 @@ export { ContentTree } from './content-tree.js';
 export { parseFrontmatter, serializeFrontmatter } from './frontmatter.js';
 export { Router } from './router.js';
 export { resolveLayouts } from './layout.js';
+export { resolveTintCascade, } from './tint-cascade.js';
+export { htmlTintAttributes, colorSchemeMetaContent, prePaintScript } from './tint-ssr.js';
 export { buildNavigation } from './navigation.js';
-export { loadContent } from './site.js';
-export { createSiteLoader } from './loader.js';
+export { loadContent, loadContentFromTree } from './site.js';
+export { createSiteLoader, createVirtualSiteLoader } from './loader.js';
 export { generateSitemap } from './sitemap.js';
 export { collectRuneTypes, analyzeRuneUsage } from './analyze.js';
 export { getGitTimestamps, getStatTimestamps, resolveTimestamps } from './timestamps.js';
 export { EntityRegistryImpl } from './registry.js';
-export { createRefraktLoader } from './refract-loader.js';
+export { createRefraktLoader, createVirtualRefraktLoader, buildHighlightOptions } from './refract-loader.js';
 export { runPipeline } from './pipeline.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA+E,MAAM,mBAAmB,CAAC;AAC7H,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAoB,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAE,MAAM,EAAc,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,cAAc,EAAoC,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,eAAe,EAA6C,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EAAE,WAAW,EAA4B,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAA2C,MAAM,aAAa,CAAC;AACxF,OAAO,EAAE,eAAe,EAAqB,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAwB,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAuB,MAAM,iBAAiB,CAAC;AAC9G,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAiD,MAAM,qBAAqB,CAAC;AACzG,OAAO,EAAE,WAAW,EAAyD,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA+E,MAAM,mBAAmB,CAAC;AAC7H,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAoB,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAE,MAAM,EAAc,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,cAAc,EAAoC,MAAM,aAAa,CAAC;AAC/E,OAAO,EACL,kBAAkB,GAGnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC3F,OAAO,EAAE,eAAe,EAA6C,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAiF,MAAM,WAAW,CAAC;AAC5I,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAA0E,MAAM,aAAa,CAAC;AAChJ,OAAO,EAAE,eAAe,EAAqB,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAwB,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAuB,MAAM,iBAAiB,CAAC;AAC9G,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,qBAAqB,EAAmF,MAAM,qBAAqB,CAAC;AAC9L,OAAO,EAAE,WAAW,EAAyD,MAAM,eAAe,CAAC"}

package/dist/loader.d.ts

@@ -1,6 +1,7 @@
 import type { Schema } from '@markdoc/markdoc';
-import type { Plugin } from '@refrakt-md/types';
-import { type Site } from './site.js';
+import type { Plugin, SecurityPolicy } from '@refrakt-md/types';
+import { type Site, type VirtualReader } from './site.js';
+import type { ContentTree } from './content-tree.js';
 export interface SiteLoaderOptions {
     dirPath: string;
     basePath?: string;
@@ -20,4 +21,30 @@ export interface SiteLoader {
     invalidate(): void;
 }
 export declare function createSiteLoader(options: SiteLoaderOptions): SiteLoader;
+export interface VirtualSiteLoaderOptions {
+    /** Pre-built content tree. The page corpus, layouts, and partials are read
+     *  from here — there is no filesystem fallback. */
+    tree: ContentTree;
+    basePath?: string;
+    icons?: Record<string, Record<string, string>>;
+    additionalTags?: Record<string, Schema>;
+    plugins?: Plugin[];
+    /** Site-wide Markdoc variables available in content via {% $name %} syntax. */
+    variables?: Record<string, unknown>;
+    /** Security policy for sandbox runes. Default: `'trusted'`. */
+    securityPolicy?: SecurityPolicy;
+    /** Optional async reader for ad-hoc lookups. Forward-compatibility hook —
+     *  see `LoadContentFromTreeOptions.reader` for details. */
+    reader?: VirtualReader;
+    /** When true, every load() call re-runs the pipeline against the current
+     *  tree (no caching). Use when the host swaps the tree's contents in place. */
+    dev?: boolean;
+}
+/**
+ * Site loader for hosted (non-filesystem) environments. Wraps
+ * {@link loadContentFromTree} with the same caching semantics as
+ * {@link createSiteLoader}: the result is memoized until `invalidate()` is
+ * called, unless `dev: true`.
+ */
+export declare function createVirtualSiteLoader(options: VirtualSiteLoaderOptions): SiteLoader;
 //# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAe,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAEnD,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,oFAAoF;IACpF,GAAG,CAAC,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IAC1B,0DAA0D;IAC1D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,sEAAsE;IACtE,UAAU,IAAI,IAAI,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAsBvE"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAoC,KAAK,IAAI,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAC5F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,oFAAoF;IACpF,GAAG,CAAC,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IAC1B,0DAA0D;IAC1D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,sEAAsE;IACtE,UAAU,IAAI,IAAI,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAsBvE;AAED,MAAM,WAAW,wBAAwB;IACxC;uDACmD;IACnD,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,+DAA+D;IAC/D,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;+DAC2D;IAC3D,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB;mFAC+E;IAC/E,GAAG,CAAC,EAAE,OAAO,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,UAAU,CAsBrF"}

package/dist/loader.js

@@ -1,4 +1,4 @@
-import { loadContent } from './site.js';
+import { loadContent, loadContentFromTree } from './site.js';
 export function createSiteLoader(options) {
     let cached = null;
     return {
@@ -15,4 +15,34 @@ export function createSiteLoader(options) {
         },
     };
 }
+/**
+ * Site loader for hosted (non-filesystem) environments. Wraps
+ * {@link loadContentFromTree} with the same caching semantics as
+ * {@link createSiteLoader}: the result is memoized until `invalidate()` is
+ * called, unless `dev: true`.
+ */
+export function createVirtualSiteLoader(options) {
+    let cached = null;
+    return {
+        load() {
+            if (!options.dev && cached)
+                return cached;
+            const promise = loadContentFromTree(options.tree, {
+                basePath: options.basePath,
+                icons: options.icons,
+                additionalTags: options.additionalTags,
+                plugins: options.plugins,
+                variables: options.variables,
+                securityPolicy: options.securityPolicy,
+                reader: options.reader,
+            });
+            if (!options.dev)
+                cached = promise;
+            return promise;
+        },
+        invalidate() {
+            cached = null;
+        },
+    };
+}
 //# sourceMappingURL=loader.js.map

package/dist/loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAa,MAAM,WAAW,CAAC;AAsBnD,MAAM,UAAU,gBAAgB,CAAC,OAA0B;IAC1D,IAAI,MAAM,GAAyB,IAAI,CAAC;IAExC,OAAO;QACN,IAAI;YACH,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC;YAC1C,MAAM,OAAO,GAAG,WAAW,CAC1B,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,cAAc,EACtB,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,kBAAkB,EAC1B,OAAO,CAAC,SAAS,CACjB,CAAC;YACF,IAAI,CAAC,OAAO,CAAC,GAAG;gBAAE,MAAM,GAAG,OAAO,CAAC;YACnC,OAAO,OAAO,CAAC;QAChB,CAAC;QACD,UAAU;YACT,MAAM,GAAG,IAAI,CAAC;QACf,CAAC;KACD,CAAC;AACH,CAAC"}
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAiC,MAAM,WAAW,CAAC;AAuB5F,MAAM,UAAU,gBAAgB,CAAC,OAA0B;IAC1D,IAAI,MAAM,GAAyB,IAAI,CAAC;IAExC,OAAO;QACN,IAAI;YACH,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC;YAC1C,MAAM,OAAO,GAAG,WAAW,CAC1B,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,cAAc,EACtB,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,kBAAkB,EAC1B,OAAO,CAAC,SAAS,CACjB,CAAC;YACF,IAAI,CAAC,OAAO,CAAC,GAAG;gBAAE,MAAM,GAAG,OAAO,CAAC;YACnC,OAAO,OAAO,CAAC;QAChB,CAAC;QACD,UAAU;YACT,MAAM,GAAG,IAAI,CAAC;QACf,CAAC;KACD,CAAC;AACH,CAAC;AAsBD;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAiC;IACxE,IAAI,MAAM,GAAyB,IAAI,CAAC;IAExC,OAAO;QACN,IAAI;YACH,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC;YAC1C,MAAM,OAAO,GAAG,mBAAmB,CAAC,OAAO,CAAC,IAAI,EAAE;gBACjD,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,MAAM,EAAE,OAAO,CAAC,MAAM;aACtB,CAAC,CAAC;YACH,IAAI,CAAC,OAAO,CAAC,GAAG;gBAAE,MAAM,GAAG,OAAO,CAAC;YACnC,OAAO,OAAO,CAAC;QAChB,CAAC;QACD,UAAU;YACT,MAAM,GAAG,IAAI,CAAC;QACf,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/refract-loader.d.ts

@@ -1,4 +1,6 @@
-import type { Site } from './site.js';
+import type { SiteConfig } from '@refrakt-md/types';
+import type { ContentTree } from './content-tree.js';
+import type { Site, VirtualReader } from './site.js';
 export interface RefraktLoaderOptions {
     /** Path to refrakt.config.json. Default: './refrakt.config.json' */
     configPath?: string;
@@ -23,5 +25,55 @@ export interface RefraktLoader {
     /** Clears the cached site so the next getSite() re-reads from disk. */
     invalidateSite(): void;
 }
+/** Compose the options bag handed to `createHighlightTransform`. Merges the
+ *  site's `highlight.*` block with theme-level code settings (`theme.code.*`)
+ *  so a single object reaches the transform — keeps adapter call sites tidy
+ *  and lets the highlight package stay unaware of where each option comes
+ *  from. Exported so non-SvelteKit adapters (HTML build script, Astro setup,
+ *  custom hosts) can compose options the same way. */
+export declare function buildHighlightOptions(site: SiteConfig): {
+    codeColorScheme?: "auto" | "light" | "dark" | undefined;
+    theme?: string | {
+        light: string;
+        dark: string;
+    };
+};
 export declare function createRefraktLoader(options?: RefraktLoaderOptions): RefraktLoader;
+export interface VirtualRefraktLoaderOptions {
+    /** Pre-resolved per-site configuration. The caller is responsible for
+     *  selecting the site (e.g., via `resolveSite()`) and normalizing any
+     *  config-relative paths. Filesystem paths inside this config (`theme`,
+     *  `contentDir`, plugin specifiers) are still resolved through the Node
+     *  module loader where applicable; only authoring content is virtualized. */
+    site: SiteConfig;
+    /** Pre-built content tree. Required — the page corpus, layouts, and
+     *  partials all come from here. */
+    tree: ContentTree;
+    /** Optional async reader for ad-hoc lookups. Reserved; see
+     *  {@link VirtualReader}. */
+    reader?: VirtualReader;
+    /** Markdoc variables available in content via {% $name %} syntax. */
+    variables?: Record<string, unknown>;
+    /** URL base path for the Router. Default: `'/'`. */
+    basePath?: string;
+    /** Skip caching — re-run the pipeline on every load(). Default: false. */
+    dev?: boolean;
+}
+/**
+ * Refrakt loader for hosted (non-filesystem) environments. Sibling to
+ * {@link createRefraktLoader}.
+ *
+ * Differences:
+ * - Accepts a pre-resolved {@link SiteConfig} instead of reading
+ *   `refrakt.config.json` from disk. The caller is expected to source and
+ *   normalize the config however suits their host (env, DB, GitHub, etc.).
+ * - Drives content from a pre-built {@link ContentTree} rather than walking
+ *   the filesystem. Combine with a `reader` for forward-compatibility with
+ *   future async lookup paths.
+ *
+ * Theme module and plugin specifiers are still resolved through Node's module
+ * loader, so the theme package and any plugins must be reachable as installed
+ * dependencies in the host environment.
+ */
+export declare function createVirtualRefraktLoader(options: VirtualRefraktLoaderOptions): RefraktLoader;
 //# sourceMappingURL=refract-loader.d.ts.map

package/dist/refract-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"refract-loader.d.ts","sourceRoot":"","sources":["../src/refract-loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,WAAW,oBAAoB;IACpC,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;2DACuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,8DAA8D;IAC9D,GAAG,CAAC,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC7B,wDAAwD;IACxD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,yDAAyD;IACzD,YAAY,IAAI,OAAO,CAAC,CAAC,IAAI,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC;IAC5C,8CAA8C;IAC9C,qBAAqB,IAAI,OAAO,CAAC;QAAE,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,uEAAuE;IACvE,cAAc,IAAI,IAAI,CAAC;CACvB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAkGjF"}
+{"version":3,"file":"refract-loader.d.ts","sourceRoot":"","sources":["../src/refract-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAU,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAQ5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACpC,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;2DACuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,8DAA8D;IAC9D,GAAG,CAAC,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC7B,wDAAwD;IACxD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,yDAAyD;IACzD,YAAY,IAAI,OAAO,CAAC,CAAC,IAAI,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC;IAC5C,8CAA8C;IAC9C,qBAAqB,IAAI,OAAO,CAAC;QAAE,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,uEAAuE;IACvE,cAAc,IAAI,IAAI,CAAC;CACvB;AASD;;;;;sDAKsD;AACtD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU;;;;;;EAQrD;AA0DD,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAuDjF;AAED,MAAM,WAAW,2BAA2B;IAC3C;;;;iFAI6E;IAC7E,IAAI,EAAE,UAAU,CAAC;IACjB;uCACmC;IACnC,IAAI,EAAE,WAAW,CAAC;IAClB;iCAC6B;IAC7B,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,OAAO,CAAC;CACd;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,2BAA2B,GAAG,aAAa,CAkD9F"}

package/dist/refract-loader.js

@@ -1,7 +1,69 @@
 import { readFileSync } from 'node:fs';
 import { dirname, resolve } from 'node:path';
+import { getThemePackage } from '@refrakt-md/types';
 import { normalizeRefraktConfig, resolveSite } from '@refrakt-md/transform/node';
-import { createSiteLoader } from './loader.js';
+import { createSiteLoader, createVirtualSiteLoader, } from './loader.js';
+/** Compose the options bag handed to `createHighlightTransform`. Merges the
+ *  site's `highlight.*` block with theme-level code settings (`theme.code.*`)
+ *  so a single object reaches the transform — keeps adapter call sites tidy
+ *  and lets the highlight package stay unaware of where each option comes
+ *  from. Exported so non-SvelteKit adapters (HTML build script, Astro setup,
+ *  custom hosts) can compose options the same way. */
+export function buildHighlightOptions(site) {
+    const themeCode = typeof site.theme === 'object' && site.theme !== null
+        ? site.theme.code
+        : undefined;
+    return {
+        ...(site.highlight ?? {}),
+        ...(themeCode?.colorScheme ? { codeColorScheme: themeCode.colorScheme } : {}),
+    };
+}
+/** Resolve a site's theme module + plugin merges into a single context object.
+ *  Shared between the FS loader and the virtual loader so both produce
+ *  byte-identical transforms from the same SiteConfig. */
+async function assembleSiteContext(site) {
+    const themePackage = getThemePackage(site.theme);
+    const themeModule = await import(/* @vite-ignore */ themePackage + '/transform');
+    const themeConfig = themeModule.themeConfig ?? themeModule.luminaConfig ?? themeModule.default;
+    const icons = {
+        ...themeConfig.icons,
+        global: { ...(themeConfig.icons?.global ?? {}), ...(site.icons ?? {}) },
+    };
+    const { assembleThemeConfig, createTransform } = await import('@refrakt-md/transform');
+    const pluginNames = site.plugins ?? [];
+    if (pluginNames.length === 0) {
+        return {
+            transform: createTransform(themeConfig),
+            communityTags: undefined,
+            communityPackages: undefined,
+            icons,
+        };
+    }
+    const { loadPlugin, mergePlugins, runes: coreRunes } = await import('@refrakt-md/runes');
+    const loaded = await Promise.all(pluginNames.map((name) => loadPlugin(name)));
+    const coreRuneNames = new Set(Object.keys(coreRunes));
+    const merged = mergePlugins(loaded, coreRuneNames, site.runes?.prefer);
+    const { config: assembledConfig } = assembleThemeConfig({
+        coreConfig: themeConfig,
+        pluginRunes: merged.themeRunes,
+        pluginIcons: merged.themeIcons,
+        pluginBackgrounds: merged.themeBackgrounds,
+        extensions: merged.extensions,
+        provenance: merged.provenance,
+    });
+    if (site.tints) {
+        assembledConfig.tints = { ...assembledConfig.tints, ...site.tints };
+    }
+    if (site.backgrounds) {
+        assembledConfig.backgrounds = { ...assembledConfig.backgrounds, ...site.backgrounds };
+    }
+    return {
+        transform: createTransform(assembledConfig),
+        communityTags: Object.keys(merged.tags).length > 0 ? merged.tags : undefined,
+        communityPackages: merged.plugins,
+        icons,
+    };
+}
 export function createRefraktLoader(options) {
     const configPath = resolve(options?.configPath ?? './refrakt.config.json');
     const rawConfig = JSON.parse(readFileSync(configPath, 'utf-8'));
@@ -12,55 +74,20 @@ export function createRefraktLoader(options) {
     const contentDir = resolve(site.contentDir);
     let _initPromise = null;
     let _transform = null;
-    let _communityTags;
-    let _communityPackages;
     let _loader = null;
     let _hl = null;
     async function init() {
         if (_initPromise)
             return _initPromise;
         _initPromise = (async () => {
-            // Dynamically import theme transform module
-            const themeModule = await import(/* @vite-ignore */ site.theme + '/transform');
-            const themeConfig = themeModule.themeConfig ?? themeModule.luminaConfig ?? themeModule.default;
-            const icons = {
-                ...themeConfig.icons,
-                global: { ...(themeConfig.icons?.global ?? {}), ...(site.icons ?? {}) },
-            };
-            const { assembleThemeConfig, createTransform } = await import('@refrakt-md/transform');
-            const pluginNames = site.plugins ?? [];
-            if (pluginNames.length === 0) {
-                _transform = createTransform(themeConfig);
-            }
-            else {
-                const { loadPlugin, mergePlugins, runes: coreRunes } = await import('@refrakt-md/runes');
-                const loaded = await Promise.all(pluginNames.map((name) => loadPlugin(name)));
-                const coreRuneNames = new Set(Object.keys(coreRunes));
-                const merged = mergePlugins(loaded, coreRuneNames, site.runes?.prefer);
-                _communityTags = Object.keys(merged.tags).length > 0 ? merged.tags : undefined;
-                _communityPackages = merged.plugins;
-                const { config: assembledConfig } = assembleThemeConfig({
-                    coreConfig: themeConfig,
-                    pluginRunes: merged.themeRunes,
-                    pluginIcons: merged.themeIcons,
-                    pluginBackgrounds: merged.themeBackgrounds,
-                    extensions: merged.extensions,
-                    provenance: merged.provenance,
-                });
-                if (site.tints) {
-                    assembledConfig.tints = { ...assembledConfig.tints, ...site.tints };
-                }
-                if (site.backgrounds) {
-                    assembledConfig.backgrounds = { ...assembledConfig.backgrounds, ...site.backgrounds };
-                }
-                _transform = createTransform(assembledConfig);
-            }
+            const ctx = await assembleSiteContext(site);
+            _transform = ctx.transform;
             _loader = createSiteLoader({
                 dirPath: contentDir,
                 basePath: '/',
-                icons,
-                additionalTags: _communityTags,
-                plugins: _communityPackages,
+                icons: ctx.icons,
+                additionalTags: ctx.communityTags,
+                plugins: ctx.communityPackages,
                 variables: options?.variables,
                 dev: options?.dev ?? false,
             });
@@ -80,7 +107,69 @@ export function createRefraktLoader(options) {
             if (_hl)
                 return _hl;
             const { createHighlightTransform } = await import('@refrakt-md/highlight');
-            _hl = await createHighlightTransform(site.highlight);
+            _hl = await createHighlightTransform(buildHighlightOptions(site));
+            return _hl;
+        },
+        invalidateSite() {
+            _loader?.invalidate();
+        },
+    };
+}
+/**
+ * Refrakt loader for hosted (non-filesystem) environments. Sibling to
+ * {@link createRefraktLoader}.
+ *
+ * Differences:
+ * - Accepts a pre-resolved {@link SiteConfig} instead of reading
+ *   `refrakt.config.json` from disk. The caller is expected to source and
+ *   normalize the config however suits their host (env, DB, GitHub, etc.).
+ * - Drives content from a pre-built {@link ContentTree} rather than walking
+ *   the filesystem. Combine with a `reader` for forward-compatibility with
+ *   future async lookup paths.
+ *
+ * Theme module and plugin specifiers are still resolved through Node's module
+ * loader, so the theme package and any plugins must be reachable as installed
+ * dependencies in the host environment.
+ */
+export function createVirtualRefraktLoader(options) {
+    const { site, tree, reader, variables, basePath, dev } = options;
+    let _initPromise = null;
+    let _transform = null;
+    let _loader = null;
+    let _hl = null;
+    async function init() {
+        if (_initPromise)
+            return _initPromise;
+        _initPromise = (async () => {
+            const ctx = await assembleSiteContext(site);
+            _transform = ctx.transform;
+            _loader = createVirtualSiteLoader({
+                tree,
+                basePath: basePath ?? '/',
+                icons: ctx.icons,
+                additionalTags: ctx.communityTags,
+                plugins: ctx.communityPackages,
+                variables,
+                reader,
+                dev: dev ?? false,
+            });
+        })();
+        return _initPromise;
+    }
+    return {
+        async getSite() {
+            await init();
+            return _loader.load();
+        },
+        async getTransform() {
+            await init();
+            return _transform;
+        },
+        async getHighlightTransform() {
+            if (_hl)
+                return _hl;
+            const { createHighlightTransform } = await import('@refrakt-md/highlight');
+            _hl = await createHighlightTransform(buildHighlightOptions(site));
             return _hl;
         },
         invalidateSite() {

package/dist/refract-loader.js.map

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

package/dist/site.d.ts

@@ -6,7 +6,11 @@ import { ContentTree, type PartialFile } from './content-tree.js';
 import { Frontmatter } from './frontmatter.js';
 import { Route } from './router.js';
 import { ResolvedLayout } from './layout.js';
+import { type ResolvedTintCascade } from './tint-cascade.js';
 import { NavTree } from './navigation.js';
+/** Async reader for ad-hoc lookups in virtual (non-FS) hosting environments.
+ *  Returns the file content or `null` when the path is unknown. */
+export type VirtualReader = (path: string) => Promise<string | null>;
 export interface Site {
     /** The content tree */
     tree: ContentTree;
@@ -31,6 +35,10 @@ export interface SitePage {
     headings: HeadingInfo[];
     layout: ResolvedLayout;
     seo: PageSeo;
+    /** Per-page tint cascade resolved from the layout chain + page frontmatter
+     *  (SPEC-052). Adapters emit this as `data-theme` / `data-tint` /
+     *  `data-tint-lock` attributes on `<html>` at SSR time. */
+    tintCascade: ResolvedTintCascade;
 }
 /**
  * Load a content directory and resolve all pages, routes, layouts, and navigation.
@@ -47,4 +55,48 @@ export interface SitePage {
  * to strip scripts and harden the sandbox iframe.
  */
 export declare function loadContent(dirPath: string, basePath?: string, icons?: Record<string, Record<string, string>>, additionalTags?: Record<string, Schema>, packages?: Plugin[], sandboxExamplesDir?: string, variables?: Record<string, unknown>, securityPolicy?: SecurityPolicy): Promise<Site>;
+/** Options accepted by {@link loadContentFromTree}. */
+export interface LoadContentFromTreeOptions {
+    /** URL base path for the Router. Default: `'/'`. */
+    basePath?: string;
+    /** Icon registry to inject into the Markdoc transform context. */
+    icons?: Record<string, Record<string, string>>;
+    /** Markdoc tag schemas to merge on top of the core runes. */
+    additionalTags?: Record<string, Schema>;
+    /** Plugins whose pipeline hooks should run in addition to core hooks. */
+    plugins?: Plugin[];
+    /** Site-wide Markdoc variables available in content via `{% $name %}`. */
+    variables?: Record<string, unknown>;
+    /** Security policy for sandbox runes. Default: `'trusted'`. */
+    securityPolicy?: SecurityPolicy;
+    /** Site-wide `theme.colorScheme` default — seeds the per-page tint cascade.
+     *  Defaults to `'auto'`. Adapters typically read this from
+     *  `refrakt.config.json` site.theme.colorScheme. See SPEC-052. */
+    colorScheme?: 'auto' | 'light' | 'dark';
+    /** Optional reader for ad-hoc lookups in virtual environments.
+     *
+     *  Reserved for future asynchronous resolution paths (e.g., on-demand sandbox
+     *  source resolution). Not currently consumed by any built-in code path — the
+     *  page corpus, partials, and layouts all come from `tree`. Accepted here so
+     *  hosts can wire it once and not need to thread it again when new internal
+     *  consumers land. */
+    reader?: VirtualReader;
+}
+/**
+ * Like {@link loadContent}, but driven by a pre-built {@link ContentTree}
+ * instead of a filesystem directory. The full transform + cross-page pipeline
+ * still runs.
+ *
+ * Use this from hosted environments where content originates somewhere other
+ * than the local filesystem (e.g., a GitHub fetch, a database, an in-memory
+ * authoring sandbox). The caller is responsible for assembling the tree.
+ *
+ * Differences from `loadContent`:
+ * - No directory read — accepts the tree directly.
+ * - No git history — timestamps come from frontmatter only.
+ * - No sandbox filesystem access — sandbox runes resolve to null/empty.
+ *   (Provide `__sandboxReadFile` etc. via `variables` if your host has its own
+ *   synchronous access strategy.)
+ */
+export declare function loadContentFromTree(tree: ContentTree, options?: LoadContentFromTreeOptions): Promise<Site>;
 //# sourceMappingURL=site.d.ts.map

package/dist/site.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAQ,mBAAmB,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1E,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEjG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAoB,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAU,KAAK,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAkB,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAI1C,MAAM,WAAW,IAAI;IACnB,uBAAuB;IACvB,IAAI,EAAE,WAAW,CAAC;IAClB,iDAAiD;IACjD,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,wCAAwC;IACxC,UAAU,EAAE,OAAO,EAAE,CAAC;IACtB,kFAAkF;IAClF,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,mDAAmD;IACnD,aAAa,EAAE,aAAa,CAAC;IAC7B,6EAA6E;IAC7E,UAAU,EAAE,cAAc,CAAC;IAC3B,sEAAsE;IACtE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,mBAAmB,CAAC;IAChC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,EAAE,OAAO,CAAC;CACd;AA0CD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAY,EACtB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC9C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACvC,QAAQ,CAAC,EAAE,MAAM,EAAE,EACnB,kBAAkB,CAAC,EAAE,MAAM,EAC3B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,IAAI,CAAC,CAyEf"}
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"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"}

package/dist/site.js

@@ -1,12 +1,13 @@
 import { readFileSync, readdirSync, statSync } from 'node:fs';
 import { resolve } from 'node:path';
 import Markdoc from '@markdoc/markdoc';
-import { tags, nodes, extractHeadings, extractSeo, corePipelineHooks, escapeFenceTags } from '@refrakt-md/runes';
+import { tags, nodes, extractHeadings, extractSeo, corePipelineHooks, escapeFenceTags, resolveCoreSentinels } from '@refrakt-md/runes';
 import { resolveSecurityPolicy } from '@refrakt-md/types';
 import { ContentTree } from './content-tree.js';
 import { parseFrontmatter } from './frontmatter.js';
 import { Router } from './router.js';
 import { resolveLayouts } from './layout.js';
+import { resolveTintCascade } from './tint-cascade.js';
 import { runPipeline } from './pipeline.js';
 import { getGitTimestamps, resolveTimestamps } from './timestamps.js';
 /** Synchronous file reader that returns null on failure. */
@@ -50,29 +51,17 @@ function transformContent(content, path, icons, additionalTags, contentVariables
     }
     return { renderable: Markdoc.transform(ast, config), headings };
 }
-/**
- * Load a content directory and resolve all pages, routes, layouts, and navigation.
- *
- * When `packages` are provided, the cross-page pipeline runs after loading:
- * core hooks + package hooks register entities, aggregate cross-page data,
- * and post-process pages before returning.
- *
- * When `sandboxExamplesDir` is provided, sandbox runes with `src` attributes
- * can load code from external files in that directory.
- *
- * `securityPolicy` controls how runes treat untrusted author content. Defaults
- * to `'trusted'` (current behaviour). Set `'strict'` for hosted-product use
- * to strip scripts and harden the sandbox iframe.
- */
-export async function loadContent(dirPath, basePath = '/', icons, additionalTags, packages, sandboxExamplesDir, variables, securityPolicy) {
-    const resolvedSecurity = resolveSecurityPolicy(securityPolicy);
-    const tree = await ContentTree.fromDirectory(dirPath);
-    const router = new Router(basePath);
+const nullSandboxHooks = {
+    read: () => null,
+    list: () => [],
+    exists: () => false,
+};
+async function processContentTree(tree, opts) {
+    const resolvedSecurity = resolveSecurityPolicy(opts.securityPolicy);
+    const router = new Router(opts.basePath ?? '/');
     const pages = [];
-    // Resolve examples directory for sandbox src support
-    const resolvedExamplesDir = sandboxExamplesDir
-        ? resolve(sandboxExamplesDir)
-        : resolve(dirPath, '..', 'examples');
+    const sandbox = opts.sandbox ?? nullSandboxHooks;
+    const gitTimestamps = opts.gitTimestamps ?? new Map();
     // Pre-parse partials into Markdoc ASTs for the transform config
     const partialFiles = tree.partials();
     let parsedPartials;
@@ -82,39 +71,76 @@ export async function loadContent(dirPath, basePath = '/', icons, additionalTags
             parsedPartials[name] = Markdoc.parse(escapeFenceTags(partial.raw));
         }
     }
-    // Batch-collect git timestamps once before the page loop
-    const gitTimestamps = getGitTimestamps(dirPath);
     for (const page of tree.pages()) {
         const { frontmatter, content } = parseFrontmatter(page.raw);
         const route = router.resolve(page.relativePath, frontmatter);
-        const layout = resolveLayouts(page, tree.root, icons);
+        const layout = resolveLayouts(page, tree.root, opts.icons);
         const fileTimestamps = resolveTimestamps(page.relativePath, page.filePath, gitTimestamps, frontmatter);
         const contentVariables = {
-            ...variables,
+            ...opts.variables,
             frontmatter,
             page: { url: route.url, filePath: route.filePath, draft: route.draft },
             file: {
                 created: fileTimestamps.created,
                 modified: fileTimestamps.modified,
             },
-            __sandboxReadFile: sandboxReadFile,
-            __sandboxListDir: sandboxListDir,
-            __sandboxDirExists: sandboxDirExists,
-            __sandboxExamplesDir: resolvedExamplesDir,
+            __sandboxReadFile: sandbox.read,
+            __sandboxListDir: sandbox.list,
+            __sandboxDirExists: sandbox.exists,
+            __sandboxExamplesDir: opts.sandboxExamplesDir,
             __securityPolicy: resolvedSecurity,
         };
-        const { renderable, headings } = transformContent(content, route.url, icons, additionalTags, contentVariables, parsedPartials);
+        const { renderable, headings } = transformContent(content, route.url, opts.icons, opts.additionalTags, contentVariables, parsedPartials);
         const seo = extractSeo(renderable, frontmatter, route.url);
-        pages.push({ route, frontmatter, content, renderable, headings, layout, seo });
+        const tintCascade = resolveTintCascade(page, tree.root, {
+            colorScheme: opts.colorScheme,
+        });
+        pages.push({ route, frontmatter, content, renderable, headings, layout, seo, tintCascade });
     }
     // Build hook sets: core always runs first, then plugins in config order
     const hookSets = [{ pluginName: '__core__', hooks: corePipelineHooks }];
-    for (const pkg of packages ?? []) {
+    for (const pkg of opts.plugins ?? []) {
         if (pkg.pipeline) {
             hookSets.push({ pluginName: pkg.name, hooks: pkg.pipeline });
         }
     }
     const { pages: enrichedPages, warnings, stats, aggregated } = await runPipeline(pages, hookSets);
+    // Apply auto-resolutions to layout regions per page. Layouts are parsed once
+    // and shared across pages, but the auto-open / auto-pagination sentinels need
+    // per-page context (current URL, sibling order). The pipeline already wired
+    // core hooks against each page's renderable; here we apply the same resolvers
+    // to every region's content with the same aggregated data.
+    const coreData = aggregated['__core__'];
+    if (coreData) {
+        for (const page of enrichedPages) {
+            if (page.layout.regions.size === 0)
+                continue;
+            const ctx = makeContextForRegions(warnings, page.route.url);
+            // Build the global search scope: page.renderable + every region's content.
+            // This gives auto-pagination visibility into navs that live in other
+            // regions (e.g. the sidebar nav in the `nav` region) so prev/next can
+            // follow the declared reading order.
+            const navSearchScope = [page.renderable];
+            for (const region of page.layout.regions.values()) {
+                navSearchScope.push(region.content);
+            }
+            const resolvedRegions = new Map();
+            let mutated = false;
+            for (const [name, region] of page.layout.regions) {
+                const resolved = resolveCoreSentinels(region.content, page.route.url, coreData, ctx, navSearchScope);
+                if (resolved !== region.content) {
+                    mutated = true;
+                    resolvedRegions.set(name, { ...region, content: resolved });
+                }
+                else {
+                    resolvedRegions.set(name, region);
+                }
+            }
+            if (mutated) {
+                page.layout.regions = resolvedRegions;
+            }
+        }
+    }
     return {
         tree,
         pages: enrichedPages,
@@ -125,4 +151,76 @@ export async function loadContent(dirPath, basePath = '/', icons, additionalTags
         partials: partialFiles,
     };
 }
+function makeContextForRegions(warnings, url) {
+    return {
+        info(message, infoUrl) { warnings.push({ severity: 'info', phase: 'postProcess', pluginName: '__core__/regions', url: infoUrl ?? url, message }); },
+        warn(message, warnUrl) { warnings.push({ severity: 'warning', phase: 'postProcess', pluginName: '__core__/regions', url: warnUrl ?? url, message }); },
+        error(message, errUrl) { warnings.push({ severity: 'error', phase: 'postProcess', pluginName: '__core__/regions', url: errUrl ?? url, message }); },
+    };
+}
+/**
+ * Load a content directory and resolve all pages, routes, layouts, and navigation.
+ *
+ * When `packages` are provided, the cross-page pipeline runs after loading:
+ * core hooks + package hooks register entities, aggregate cross-page data,
+ * and post-process pages before returning.
+ *
+ * When `sandboxExamplesDir` is provided, sandbox runes with `src` attributes
+ * can load code from external files in that directory.
+ *
+ * `securityPolicy` controls how runes treat untrusted author content. Defaults
+ * to `'trusted'` (current behaviour). Set `'strict'` for hosted-product use
+ * to strip scripts and harden the sandbox iframe.
+ */
+export async function loadContent(dirPath, basePath = '/', icons, additionalTags, packages, sandboxExamplesDir, variables, securityPolicy) {
+    const tree = await ContentTree.fromDirectory(dirPath);
+    const resolvedExamplesDir = sandboxExamplesDir
+        ? resolve(sandboxExamplesDir)
+        : resolve(dirPath, '..', 'examples');
+    return processContentTree(tree, {
+        basePath,
+        icons,
+        additionalTags,
+        plugins: packages,
+        variables,
+        securityPolicy,
+        gitTimestamps: getGitTimestamps(dirPath),
+        sandbox: {
+            read: sandboxReadFile,
+            list: sandboxListDir,
+            exists: sandboxDirExists,
+        },
+        sandboxExamplesDir: resolvedExamplesDir,
+    });
+}
+/**
+ * Like {@link loadContent}, but driven by a pre-built {@link ContentTree}
+ * instead of a filesystem directory. The full transform + cross-page pipeline
+ * still runs.
+ *
+ * Use this from hosted environments where content originates somewhere other
+ * than the local filesystem (e.g., a GitHub fetch, a database, an in-memory
+ * authoring sandbox). The caller is responsible for assembling the tree.
+ *
+ * Differences from `loadContent`:
+ * - No directory read — accepts the tree directly.
+ * - No git history — timestamps come from frontmatter only.
+ * - No sandbox filesystem access — sandbox runes resolve to null/empty.
+ *   (Provide `__sandboxReadFile` etc. via `variables` if your host has its own
+ *   synchronous access strategy.)
+ */
+export async function loadContentFromTree(tree, options = {}) {
+    // `reader` is accepted on the options bag for forward compatibility but not
+    // currently plumbed — sandbox runes call file ops synchronously, so an async
+    // reader can't back them today.
+    return processContentTree(tree, {
+        basePath: options.basePath,
+        icons: options.icons,
+        additionalTags: options.additionalTags,
+        plugins: options.plugins,
+        variables: options.variables,
+        securityPolicy: options.securityPolicy,
+        colorScheme: options.colorScheme,
+    });
+}
 //# sourceMappingURL=site.js.map

package/dist/site.js.map

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

package/dist/tint-cascade.d.ts

@@ -0,0 +1,45 @@
+import type { ContentDirectory, ContentPage } from './content-tree.js';
+/**
+ * The resolved tint cascade for a page — a deterministic three-field tuple
+ * the renderer emits onto `<html>` as `data-*` attributes per SPEC-052.
+ *
+ *   - `tint` — named tint preset, or `null` (no named tint active)
+ *   - `tintMode` — `'auto'` / `'light'` / `'dark'`. `'auto'` is the default;
+ *     `'light'` and `'dark'` indicate an explicit mode preference.
+ *   - `locked` — when `true`, the SSR-emitted mode is final: user
+ *     preference is preserved in localStorage but not applied, and the
+ *     theme-toggle UI hides.
+ */
+export interface ResolvedTintCascade {
+    tint: string | null;
+    tintMode: 'auto' | 'light' | 'dark';
+    locked: boolean;
+}
+/**
+ * Root defaults applied before any layout / page frontmatter contributes.
+ * Adapters can pass `theme.colorScheme` from `refrakt.config.json` to seed
+ * `tintMode`; everything else starts unset.
+ */
+export interface CascadeRootDefaults {
+    /** Maps to {@link ResolvedTintCascade.tintMode}. */
+    colorScheme?: 'auto' | 'light' | 'dark';
+}
+/**
+ * Resolve the tint cascade for a page by walking its layout chain
+ * outermost-to-innermost and overlaying its own frontmatter last.
+ *
+ * Cascade order (last writer wins per field):
+ *
+ *   1. Root defaults (typically from `theme.colorScheme` in site config)
+ *   2. Each `_layout.md` from the root toward the page, in order
+ *   3. The page's own frontmatter
+ *
+ * `undefined` at any level means "inherit from the next outer layer".
+ * Explicit `null` for `tint` is the canonical "reset to no named tint"
+ * idiom — preserved through the cascade so authors can break out of a
+ * parent layout's tint without applying a new one.
+ *
+ * Pure function: given the same inputs, returns the same tuple. No I/O.
+ */
+export declare function resolveTintCascade(page: ContentPage, rootDir: ContentDirectory, defaults?: CascadeRootDefaults): ResolvedTintCascade;
+//# sourceMappingURL=tint-cascade.d.ts.map

package/dist/tint-cascade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tint-cascade.d.ts","sourceRoot":"","sources":["../src/tint-cascade.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGvE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACpC,MAAM,EAAE,OAAO,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IACnC,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;CACxC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,gBAAgB,EACzB,QAAQ,GAAE,mBAAwB,GAChC,mBAAmB,CAiBrB"}

package/dist/tint-cascade.js

@@ -0,0 +1,71 @@
+import { parseFrontmatter } from './frontmatter.js';
+/**
+ * Resolve the tint cascade for a page by walking its layout chain
+ * outermost-to-innermost and overlaying its own frontmatter last.
+ *
+ * Cascade order (last writer wins per field):
+ *
+ *   1. Root defaults (typically from `theme.colorScheme` in site config)
+ *   2. Each `_layout.md` from the root toward the page, in order
+ *   3. The page's own frontmatter
+ *
+ * `undefined` at any level means "inherit from the next outer layer".
+ * Explicit `null` for `tint` is the canonical "reset to no named tint"
+ * idiom — preserved through the cascade so authors can break out of a
+ * parent layout's tint without applying a new one.
+ *
+ * Pure function: given the same inputs, returns the same tuple. No I/O.
+ */
+export function resolveTintCascade(page, rootDir, defaults = {}) {
+    const resolved = {
+        tint: null,
+        tintMode: defaults.colorScheme ?? 'auto',
+        locked: false,
+    };
+    const layoutChain = findLayoutChain(page, rootDir);
+    for (const layoutPage of layoutChain) {
+        const layoutFrontmatter = parseFrontmatter(layoutPage.raw).frontmatter;
+        applyLayer(resolved, layoutFrontmatter);
+    }
+    const pageFrontmatter = parseFrontmatter(page.raw).frontmatter;
+    applyLayer(resolved, pageFrontmatter);
+    return resolved;
+}
+function applyLayer(resolved, layer) {
+    if ('tint' in layer && layer.tint !== undefined) {
+        // `null` is a real value here — author's "reset to no named tint" idiom.
+        resolved.tint = layer.tint;
+    }
+    if ('tint-mode' in layer && layer['tint-mode'] !== undefined) {
+        const mode = layer['tint-mode'];
+        if (mode === 'auto' || mode === 'light' || mode === 'dark') {
+            resolved.tintMode = mode;
+        }
+    }
+    if ('tint-lock' in layer && layer['tint-lock'] !== undefined) {
+        resolved.locked = Boolean(layer['tint-lock']);
+    }
+}
+/**
+ * Walk from the root down to the page's directory, collecting every
+ * `_layout.md` along the way. Returns the chain in outermost-to-innermost
+ * order so the cascade can apply each in turn.
+ *
+ * Mirrors `layout.ts`'s `findLayoutChain` so the two stay in lockstep.
+ */
+function findLayoutChain(page, rootDir) {
+    const parts = page.relativePath.split('/').slice(0, -1);
+    const chain = [];
+    let current = rootDir;
+    if (current.layout)
+        chain.push(current.layout);
+    for (const part of parts) {
+        current = current.children.find(c => c.name === part);
+        if (!current)
+            break;
+        if (current.layout)
+            chain.push(current.layout);
+    }
+    return chain;
+}
+//# sourceMappingURL=tint-cascade.js.map

package/dist/tint-cascade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tint-cascade.js","sourceRoot":"","sources":["../src/tint-cascade.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAoB,MAAM,kBAAkB,CAAC;AA6BtE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,kBAAkB,CACjC,IAAiB,EACjB,OAAyB,EACzB,WAAgC,EAAE;IAElC,MAAM,QAAQ,GAAwB;QACrC,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,QAAQ,CAAC,WAAW,IAAI,MAAM;QACxC,MAAM,EAAE,KAAK;KACb,CAAC;IAEF,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACtC,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC;QACvE,UAAU,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,eAAe,GAAG,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC;IAC/D,UAAU,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAEtC,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,SAAS,UAAU,CAAC,QAA6B,EAAE,KAAkB;IACpE,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACjD,yEAAyE;QACzE,QAAQ,CAAC,IAAI,GAAG,KAAK,CAAC,IAAqB,CAAC;IAC7C,CAAC;IACD,IAAI,WAAW,IAAI,KAAK,IAAI,KAAK,CAAC,WAAW,CAAC,KAAK,SAAS,EAAE,CAAC;QAC9D,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;QAChC,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5D,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC;QAC1B,CAAC;IACF,CAAC;IACD,IAAI,WAAW,IAAI,KAAK,IAAI,KAAK,CAAC,WAAW,CAAC,KAAK,SAAS,EAAE,CAAC;QAC9D,QAAQ,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IAC/C,CAAC;AACF,CAAC;AAED;;;;;;GAMG;AACH,SAAS,eAAe,CAAC,IAAiB,EAAE,OAAyB;IACpE,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxD,MAAM,KAAK,GAAkB,EAAE,CAAC;IAEhC,IAAI,OAAO,GAAiC,OAAO,CAAC;IACpD,IAAI,OAAO,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACtD,IAAI,CAAC,OAAO;YAAE,MAAM;QACpB,IAAI,OAAO,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/tint-ssr.d.ts

@@ -0,0 +1,46 @@
+import type { ResolvedTintCascade } from './tint-cascade.js';
+/**
+ * Build the attribute string adapters should put on the `<html>` element at
+ * SSR time, per SPEC-052. Reads the resolved cascade tuple from a SitePage
+ * and emits `data-theme`, `data-tint`, `data-tint-lock`, plus the matching
+ * `color-scheme` declaration when locked.
+ *
+ * The returned string is just the attributes (no leading/trailing space) —
+ * adapters interpolate it into their HTML shell however suits them best.
+ * For example, in a SvelteKit `hooks.server.ts` `transformPageChunk`:
+ *
+ *   ```ts
+ *   html.replace('<html', `<html ${htmlTintAttributes(cascade)}`)
+ *   ```
+ *
+ * If the cascade has no opinions (default `'auto'`, no locked mode, no
+ * named tint), returns the empty string — `<html>` stays clean and the
+ * pre-paint script handles user / system preference at runtime.
+ */
+export declare function htmlTintAttributes(cascade: ResolvedTintCascade): string;
+/**
+ * Build the `<meta name="color-scheme">` content value adapters should
+ * emit. `'light dark'` when unlocked (browser may pick); explicit when
+ * locked.
+ */
+export declare function colorSchemeMetaContent(cascade: ResolvedTintCascade): string;
+/**
+ * The canonical anti-FOIT pre-paint script. Drop this inline into `<head>`
+ * before any stylesheets so it runs before first paint and there's no flash
+ * of incorrect theme.
+ *
+ * Behaviour per SPEC-052:
+ *   - On a locked page (`data-tint-lock="true"`), do nothing — the SSR
+ *     output is final.
+ *   - On an unlocked page, apply the user's saved preference from
+ *     localStorage (key `rf-theme`); fall back to system
+ *     `prefers-color-scheme` if no preference is saved.
+ *   - The toggle component (separate concern) writes the same localStorage
+ *     key on click. Saved preference is preserved across visits to locked
+ *     pages.
+ *
+ * Returns the raw JavaScript string (no `<script>` wrapper) so adapters
+ * can inline it however their templating system prefers.
+ */
+export declare function prePaintScript(): string;
+//# sourceMappingURL=tint-ssr.d.ts.map

package/dist/tint-ssr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tint-ssr.d.ts","sourceRoot":"","sources":["../src/tint-ssr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAYvE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAK3E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/dist/tint-ssr.js

@@ -0,0 +1,67 @@
+/**
+ * Build the attribute string adapters should put on the `<html>` element at
+ * SSR time, per SPEC-052. Reads the resolved cascade tuple from a SitePage
+ * and emits `data-theme`, `data-tint`, `data-tint-lock`, plus the matching
+ * `color-scheme` declaration when locked.
+ *
+ * The returned string is just the attributes (no leading/trailing space) —
+ * adapters interpolate it into their HTML shell however suits them best.
+ * For example, in a SvelteKit `hooks.server.ts` `transformPageChunk`:
+ *
+ *   ```ts
+ *   html.replace('<html', `<html ${htmlTintAttributes(cascade)}`)
+ *   ```
+ *
+ * If the cascade has no opinions (default `'auto'`, no locked mode, no
+ * named tint), returns the empty string — `<html>` stays clean and the
+ * pre-paint script handles user / system preference at runtime.
+ */
+export function htmlTintAttributes(cascade) {
+    const parts = [];
+    if (cascade.tintMode === 'light' || cascade.tintMode === 'dark') {
+        parts.push(`data-theme="${cascade.tintMode}"`);
+    }
+    if (cascade.tint !== null) {
+        parts.push(`data-tint="${escapeAttr(cascade.tint)}"`);
+    }
+    if (cascade.locked) {
+        parts.push('data-tint-lock="true"');
+    }
+    return parts.join(' ');
+}
+/**
+ * Build the `<meta name="color-scheme">` content value adapters should
+ * emit. `'light dark'` when unlocked (browser may pick); explicit when
+ * locked.
+ */
+export function colorSchemeMetaContent(cascade) {
+    if (cascade.locked && (cascade.tintMode === 'light' || cascade.tintMode === 'dark')) {
+        return cascade.tintMode;
+    }
+    return 'light dark';
+}
+/**
+ * The canonical anti-FOIT pre-paint script. Drop this inline into `<head>`
+ * before any stylesheets so it runs before first paint and there's no flash
+ * of incorrect theme.
+ *
+ * Behaviour per SPEC-052:
+ *   - On a locked page (`data-tint-lock="true"`), do nothing — the SSR
+ *     output is final.
+ *   - On an unlocked page, apply the user's saved preference from
+ *     localStorage (key `rf-theme`); fall back to system
+ *     `prefers-color-scheme` if no preference is saved.
+ *   - The toggle component (separate concern) writes the same localStorage
+ *     key on click. Saved preference is preserved across visits to locked
+ *     pages.
+ *
+ * Returns the raw JavaScript string (no `<script>` wrapper) so adapters
+ * can inline it however their templating system prefers.
+ */
+export function prePaintScript() {
+    return `(function(){var d=document.documentElement;if(d.dataset.tintLock==='true')return;var s=null;try{s=localStorage.getItem('rf-theme')}catch(e){}var m=s&&s!=='auto'?s:(matchMedia('(prefers-color-scheme: dark)').matches?'dark':'light');d.setAttribute('data-theme',m)})();`;
+}
+function escapeAttr(value) {
+    return value.replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;');
+}
+//# sourceMappingURL=tint-ssr.js.map

package/dist/tint-ssr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tint-ssr.js","sourceRoot":"","sources":["../src/tint-ssr.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC9D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QACjE,KAAK,CAAC,IAAI,CAAC,eAAe,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,cAAc,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAA4B;IAClE,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,MAAM,CAAC,EAAE,CAAC;QACrF,OAAO,OAAO,CAAC,QAAQ,CAAC;IACzB,CAAC;IACD,OAAO,YAAY,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,cAAc;IAC7B,OAAO,4QAA4Q,CAAC;AACrR,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAChC,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACnF,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@refrakt-md/content",
   "description": "Content loading and transformation pipeline",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -29,10 +29,10 @@
     "build": "tsc"
   },
   "dependencies": {
-    "@refrakt-md/highlight": "0.12.0",
-    "@refrakt-md/runes": "0.12.0",
-    "@refrakt-md/transform": "0.12.0",
-    "@refrakt-md/types": "0.12.0",
+    "@refrakt-md/highlight": "0.14.0",
+    "@refrakt-md/runes": "0.14.0",
+    "@refrakt-md/transform": "0.14.0",
+    "@refrakt-md/types": "0.14.0",
     "@markdoc/markdoc": "0.4.0",
     "yaml": "^2.4.0"
   }