WRNexusJSDoc/app/pages/packages/content.wrn

page wrnexuscontent {
  seo {
    title = "@wrnexus/content"
    description = "Content collections, validation, querying, and publishing workflows."
  }

  view {
    <div class="docs-shell">
      <a href="#main" class="skip-link">Skip to content</a>
      <header class="topbar">
        <a class="brand" href="/"><span>W</span> WRNexusJS</a>
        <nav aria-label="Primary"><a href="/getting-started">Get started</a><a href="/packages">Packages</a><a href="https://component.wrnexusjs.dev/">Components</a><a href="/language">Language</a><a href="/architecture">Architecture</a></nav>
        <div class="topbar-actions"><a class="preview-pill" href="/access">Private preview · v0.8.5</a><button data-wire-theme-toggle class="theme-button" aria-label="Toggle color theme" title="Toggle color theme">◐</button></div>
      </header>
      <div class="mobile-doc-nav"><details><summary>Browse documentation</summary><nav><a href="/getting-started">Get started</a><a href="/packages">Packages</a><a href="https://component.wrnexusjs.dev/">Components</a><a href="/language">Language</a><a href="/architecture">Architecture</a><a href="/tutorial">Tutorial</a><a href="/guides/project-structure">Guides</a><a href="/examples">Examples</a><a href="/search">Search</a></nav></details></div>
      <main class="portal-main docs-layout">
      <article id="main" class="documentation prose standalone package-document"><nav class="breadcrumbs" aria-label="Breadcrumb"><a href="/">Home</a><span>/</span><a href="/packages">Packages</a><span>/</span><span aria-current="page">@wrnexus/content</span></nav><section class="doc-intro"><span class="eyebrow">Data · Package reference</span><h1>@wrnexus/content</h1><p>Content collections, validation, querying, and publishing workflows.</p><div class="doc-meta"><span>v0.8.5</span><span>Private registry</span><span>Data</span></div><section id="access" class="access-callout"><h2>Install the package</h2><p>After WorkRoot approves private registry access, install the release-aligned package:</p><pre><code>bun add @wrnexus/content@0.8.5</code><button type="button" class="copy-button" aria-label="Copy installation command">Copy</button></pre><p><a href="/access">Request preview access</a>. Never put registry tokens in source control.</p></section></section><section id="guide"><p>Typed content collections for Markdown/MDX-like documents and remote CMS records. Collections validate frontmatter through any <code>&#123; parse(input) &#125;</code> schema, render escaped HTML, and expose draft preview, versions, references, headings, search indexes, pagination, RSS and sitemaps.</p>
<pre data-language="ts"><code>const posts = defineCollection(&#123;
  name: &quot;posts&quot;,
  schema: PostSchema,
  loader: localContentLoader(&quot;content/posts&quot;),
  previewToken: process.env.CONTENT_PREVIEW_TOKEN,
&#125;);

const published = await posts.load();
const preview = await posts.load(&#123; previewToken: request.headers.get(&quot;x-preview-token&quot;) ?? &quot;&quot; &#125;);</code></pre>
<p>Remote systems implement <code>CmsAdapter</code>, use <code>cmsContentLoader</code>, or return JSON records through <code>remoteContentLoader</code>. Markdown HTML is escaped by default; raw executable HTML is never trusted.</p></section><section id="api" class="api"><h2>Complete TypeScript API</h2><p>Generated from the exact installed package declarations.</p><pre data-language="typescript"><code>type MdxComponent = (props: Record&lt;string, string&gt;, children: string) =&gt; string;
/** Execute explicitly registered MDX components without evaluating arbitrary JavaScript. */
declare function renderMdxComponents(source: string, components: Record&lt;string, MdxComponent&gt;): string;
interface SyntaxLanguageBundle &#123;
    highlight(source: string): string;
&#125;
declare function createIncrementalHighlighter(loaders: Record&lt;string, () =&gt; SyntaxLanguageBundle | Promise&lt;SyntaxLanguageBundle&gt;&gt;): &#123;
    languages: () =&gt; string[];
    highlight(language: string, source: string): Promise&lt;string&gt;;
    render(html: string): Promise&lt;string&gt;;
&#125;;
interface VendorAdapterOptions &#123;
    fetch?: (input: string | URL | Request, init?: RequestInit) =&gt; Promise&lt;Response&gt;;
    token?: string;
    map?: (entry: any) =&gt; &#123;
        id: string;
        content: string;
        source?: string;
    &#125;;
&#125;
declare function contentfulAdapter(space: string, environment?: string, options?: VendorAdapterOptions): &#123;
    list(collection: string): Promise&lt;any&gt;;
&#125;;
declare function sanityAdapter(project: string, dataset: string, options?: VendorAdapterOptions &amp; &#123;
    apiVersion?: string;
&#125;): &#123;
    list(collection: string): Promise&lt;any&gt;;
&#125;;
declare function strapiAdapter(baseUrl: string, options?: VendorAdapterOptions): &#123;
    list(collection: string): Promise&lt;any&gt;;
&#125;;

interface ContentSchema&lt;T&gt; &#123;
    parse(input: unknown): T;
&#125;
interface ContentEntry&lt;T = Record&lt;string, unknown&gt;&gt; &#123;
    id: string;
    slug: string;
    collection: string;
    data: T;
    body: string;
    html: string;
    excerpt: string;
    headings: ContentHeading[];
    draft: boolean;
    version?: string;
    source: string;
&#125;
interface ContentHeading &#123;
    depth: number;
    text: string;
    slug: string;
&#125;
interface ContentLoaderResult &#123;
    id: string;
    source: string;
    content: string;
&#125;
interface ContentLoader &#123;
    load(): ContentLoaderResult[] | Promise&lt;ContentLoaderResult[]&gt;;
&#125;
interface ContentCollectionOptions&lt;T&gt; &#123;
    name: string;
    schema: ContentSchema&lt;T&gt;;
    loader: ContentLoader;
    includeDrafts?: boolean;
    previewToken?: string;
    references?: Record&lt;string, ContentCollection&lt;unknown&gt;&gt;;
&#125;
interface ContentCollection&lt;T&gt; &#123;
    name: string;
    load(options?: &#123;
        drafts?: boolean;
        previewToken?: string;
        version?: string;
    &#125;): Promise&lt;ContentEntry&lt;T&gt;[]&gt;;
    get(id: string, options?: &#123;
        drafts?: boolean;
        previewToken?: string;
        version?: string;
    &#125;): Promise&lt;ContentEntry&lt;T&gt; | null&gt;;
&#125;
declare function parseFrontmatter(source: string): &#123;
    data: Record&lt;string, unknown&gt;;
    body: string;
&#125;;
declare function renderMarkdown(source: string): &#123;
    html: string;
    headings: ContentHeading[];
    excerpt: string;
&#125;;
declare function localContentLoader(directory: string): ContentLoader;
declare function remoteContentLoader(url: string, options?: &#123;
    fetch?: (input: string | URL | Request, init?: RequestInit) =&gt; Promise&lt;Response&gt;;
    headers?: HeadersInit;
&#125;): ContentLoader;
declare function defineCollection&lt;T&gt;(options: ContentCollectionOptions&lt;T&gt;): ContentCollection&lt;T&gt;;
declare function resolveContentReference(collections: Record&lt;string, ContentCollection&lt;unknown&gt;&gt;, reference: string): Promise&lt;ContentEntry&lt;unknown&gt; | null&gt;;
declare function paginateContent&lt;T&gt;(entries: T[], page?: number, pageSize?: number): &#123;
    items: T[];
    page: number;
    pageSize: number;
    total: number;
    totalPages: number;
    hasNext: boolean;
    hasPrevious: boolean;
&#125;;
declare function createSearchIndex(entries: ContentEntry[]): &#123;
    id: string;
    slug: string;
    title: string;
    text: string;
&#125;[];
declare function searchContent(index: ReturnType&lt;typeof createSearchIndex&gt;, query: string): &#123;
    id: string;
    slug: string;
    title: string;
    text: string;
&#125;[];
declare function contentSitemap(entries: ContentEntry[], baseUrl: string): string;
declare function contentRss(entries: ContentEntry[], options: &#123;
    title: string;
    baseUrl: string;
    description?: string;
&#125;): string;
interface CmsAdapter &#123;
    list(collection: string): Promise&lt;Array&lt;&#123;
        id: string;
        content: string;
        source?: string;
    &#125;&gt;&gt;;
&#125;
declare function cmsContentLoader(adapter: CmsAdapter, collection: string): ContentLoader;

export &#123; type CmsAdapter, type ContentCollection, type ContentCollectionOptions, type ContentEntry, type ContentHeading, type ContentLoader, type ContentLoaderResult, type ContentSchema, type MdxComponent, type SyntaxLanguageBundle, type VendorAdapterOptions, cmsContentLoader, contentRss, contentSitemap, contentfulAdapter, createIncrementalHighlighter, createSearchIndex, defineCollection, localContentLoader, paginateContent, parseFrontmatter, remoteContentLoader, renderMarkdown, renderMdxComponents, resolveContentReference, sanityAdapter, searchContent, strapiAdapter &#125;;
</code></pre></section><section id="examples" class="examples"><h2>Examples</h2><p>Copy-ready examples from the installed package documentation.</p><div class="example-grid"><article class="example-card"><h3>preview, versions, references, headings, search indexes, pagination, RSS and sitemaps.</h3><pre data-language="ts"><code>const posts = defineCollection(&#123;
  name: &quot;posts&quot;,
  schema: PostSchema,
  loader: localContentLoader(&quot;content/posts&quot;),
  previewToken: process.env.CONTENT_PREVIEW_TOKEN,
&#125;);

const published = await posts.load();
const preview = await posts.load(&#123; previewToken: request.headers.get(&quot;x-preview-token&quot;) ?? &quot;&quot; &#125;);</code></pre></article><article class="example-card"><h3>Install @wrnexus/content</h3><pre data-language="sh"><code>bun add @wrnexus/content</code></pre></article></div></section></article>
      <aside class="on-this-page"><h2>On this page</h2><nav><a class="toc-level-2" href="#guide">Guide</a><a class="toc-level-2" href="#api">Complete API</a><a class="toc-level-2" href="#examples">Examples</a></nav></aside>
    </main>
      <footer><div class="footer-brand"><span class="footer-mark" aria-hidden="true">W</span><p><strong>WRNexusJS 0.8.5</strong><span>Complete API documentation generated from installed package declarations.</span></p></div><nav aria-label="Footer"><a href="/packages">All packages</a><a href="/getting-started">Get started</a><a href="/security">Security</a><a href="/support">Support</a><a href="/llms.txt">AI guide</a></nav><p class="footer-meta">Private Developer Preview · Bun-native</p></footer>
    </div>
  }
}