canofold 0.2.0 → 0.3.0

package/dist/{clean-74GN2NZC.js → clean-V2SP7IRD.js}

@@ -1,2 +1,2 @@
-import{a as s,b as f,e as p,f as l}from"./chunk-OATSOVSV.js";import{j as m}from"./chunk-4OALGQQB.js";import{a as n}from"./chunk-M6T5RSNJ.js";import"./chunk-3TIVCYR7.js";import"./chunk-EAYVCA3Z.js";import"./chunk-JK7ZNBUA.js";import{a as u}from"./chunk-AYDF3IFZ.js";import{readdir as R,rm as o}from"fs/promises";import{basename as h,dirname as g,join as b}from"path";async function x({cwd:t}){let i=await m(t),r=s(t),a=await l(t,i,r);await p(r,async()=>{let c=g(a),d=h(a).replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),w=new RegExp(`^\\.${d}\\.(?:backup|(?:tmp|backup)-[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})$`,"i"),v=await R(c,{withFileTypes:!0}).catch(e=>{if(e.code==="ENOENT")return[];throw e});await Promise.all(v.filter(e=>w.test(e.name)).map(e=>o(b(c,e.name),{recursive:!0,force:!0}))),await o(a,{recursive:!0,force:!0}),await o(r,{recursive:!0,force:!0}),await o(f(t),{recursive:!0,force:!0})}),n(`Removed ${i.outputDir}, .canofold/cache, and temporary or interrupted build files`)}u(x,"runClean");export{x as runClean};
-//# sourceMappingURL=clean-74GN2NZC.js.map
+import{a as s,b as f,e as p,f as l}from"./chunk-EQOADO2H.js";import{l as m}from"./chunk-ACUMTEQL.js";import{a as n}from"./chunk-M6T5RSNJ.js";import"./chunk-2XMX5JW6.js";import"./chunk-EAYVCA3Z.js";import"./chunk-JK7ZNBUA.js";import{a as u}from"./chunk-AYDF3IFZ.js";import{readdir as R,rm as o}from"fs/promises";import{basename as h,dirname as g,join as b}from"path";async function x({cwd:t}){let i=await m(t),r=s(t),a=await l(t,i,r);await p(r,async()=>{let c=g(a),d=h(a).replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),w=new RegExp(`^\\.${d}\\.(?:backup|(?:tmp|backup)-[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})$`,"i"),v=await R(c,{withFileTypes:!0}).catch(e=>{if(e.code==="ENOENT")return[];throw e});await Promise.all(v.filter(e=>w.test(e.name)).map(e=>o(b(c,e.name),{recursive:!0,force:!0}))),await o(a,{recursive:!0,force:!0}),await o(r,{recursive:!0,force:!0}),await o(f(t),{recursive:!0,force:!0})}),n(`Removed ${i.outputDir}, .canofold/cache, and temporary or interrupted build files`)}u(x,"runClean");export{x as runClean};
+//# sourceMappingURL=clean-V2SP7IRD.js.map

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -13,5 +13,5 @@ Commands:
                  Preview .canofold/dist on a custom local port
   check          Run documentation checks
   deploy         Generate deployment guidance
-`)}l(g,"printHelp");function a(n,o){let t=n[o];if(t!==void 0)throw new Error(`Unknown option: ${t}`)}l(a,"assertArgumentCount");async function m(n,o=process.cwd()){let t=n[0]??"help";if(t==="help"||t==="--help"||t==="-h"){a(n,1),g();return}if(t==="init"){let{runInit:r}=await import("./init-6R5SLESH.js");return r({cwd:o,...h(n)})}if(t==="build"){let{runBuild:r}=await import("./build-RBMQ6TZ7.js");return r({cwd:o,...d(n)})}if(t==="clean"){a(n,1);let{runClean:r}=await import("./clean-74GN2NZC.js");return r({cwd:o})}if(t==="dev"){let{runDev:r}=await import("./dev-WJCFAWYD.js");return r({cwd:o,port:u(n)})}if(t==="preview"){let{runPreview:r}=await import("./preview-ODXGCQZ7.js"),i=u(n);return r({cwd:o,port:i})}if(t==="check"){a(n,1);let{runCheck:r}=await import("./check-FCYLN6KO.js");return r({cwd:o})}if(t==="deploy"){a(n,1);let{runDeploy:r}=await import("./deploy-4YUYRVRO.js");return r({cwd:o})}throw new Error(`Unknown command: ${t}`)}l(m,"runCli");m(process.argv.slice(2)).catch(n=>{f(n instanceof Error?n.message:String(n)),process.exitCode=1});
+`)}l(g,"printHelp");function a(n,o){let t=n[o];if(t!==void 0)throw new Error(`Unknown option: ${t}`)}l(a,"assertArgumentCount");async function m(n,o=process.cwd()){let t=n[0]??"help";if(t==="help"||t==="--help"||t==="-h"){a(n,1),g();return}if(t==="init"){let{runInit:r}=await import("./init-3PS74OVB.js");return r({cwd:o,...h(n)})}if(t==="build"){let{runBuild:r}=await import("./build-UYV2L7WT.js");return r({cwd:o,...d(n)})}if(t==="clean"){a(n,1);let{runClean:r}=await import("./clean-V2SP7IRD.js");return r({cwd:o})}if(t==="dev"){let{runDev:r}=await import("./dev-3C4T3COS.js");return r({cwd:o,port:u(n)})}if(t==="preview"){let{runPreview:r}=await import("./preview-OAMF5HXH.js"),i=u(n);return r({cwd:o,port:i})}if(t==="check"){a(n,1);let{runCheck:r}=await import("./check-SPGDVG46.js");return r({cwd:o})}if(t==="deploy"){a(n,1);let{runDeploy:r}=await import("./deploy-47AUDPYE.js");return r({cwd:o})}throw new Error(`Unknown command: ${t}`)}l(m,"runCli");m(process.argv.slice(2)).catch(n=>{f(n instanceof Error?n.message:String(n)),process.exitCode=1});
 //# sourceMappingURL=cli.js.map

package/dist/demo-engine.d.ts

@@ -0,0 +1,78 @@
+import { Server, IncomingMessage, ServerResponse } from 'node:http';
+
+type CanofoldDemoCacheValue = string | number | boolean | null | CanofoldDemoCacheValue[] | {
+    [key: string]: CanofoldDemoCacheValue;
+};
+type CanofoldDemoSandbox = 'inline' | 'iframe';
+interface CanofoldDemoReference {
+    id: string;
+    title?: string;
+    description?: string;
+    specifier: string;
+    sandbox: CanofoldDemoSandbox;
+    pageSourcePath: string;
+    pageSourceRelativePath: string;
+    routePath: string;
+    locale: string;
+    line?: number;
+    column?: number;
+    sourceOffset?: number;
+    sourceEndOffset?: number;
+}
+interface CanofoldPreparedDemo extends CanofoldDemoReference {
+    modulePath: string;
+    moduleUrl?: string;
+    /** Project-local files imported by this demo, used for cache invalidation. */
+    dependencyPaths?: string[];
+    source: string;
+    language: 'tsx' | 'ts' | 'jsx' | 'js';
+}
+interface CanofoldDemoManifest {
+    clientUrl: string;
+    styleUrls?: string[];
+    demos: Record<string, CanofoldPreparedDemo>;
+    /** Paths relative to the site output root, used by output safety and caching. */
+    outputPaths?: string[];
+    /** Project-local engine/setup files that affect every demo page. */
+    dependencyPaths?: string[];
+}
+interface CanofoldDemoPrepareContext {
+    cwd: string;
+    outputRoot: string;
+    basePath: string;
+    mode: 'analyze' | 'build' | 'dev';
+    setup?: string;
+    demos: readonly CanofoldDemoReference[];
+}
+interface CanofoldDemoDevRuntime {
+    middleware?: (request: IncomingMessage, response: ServerResponse, next: () => void) => void;
+    handlesFile?: (path: string) => boolean;
+    /** Notify the engine after Canofold refreshes the demo manifest. */
+    update?(): void | Promise<void>;
+    close(): void | Promise<void>;
+}
+interface CanofoldDemoDevContext {
+    cwd: string;
+    basePath: string;
+    setup?: string;
+    server: Server;
+    getDemos(): readonly CanofoldPreparedDemo[];
+    /** Excludes Canofold output, cache, and atomic replacement files from framework watchers. */
+    shouldIgnorePath(path: string): boolean;
+}
+/**
+ * Trusted build/dev adapter for interactive component examples.
+ *
+ * Canofold owns Markdown, routes and the demo declaration model. Engines own
+ * project module resolution, browser transforms, CSS, HMR and production
+ * client chunks.
+ */
+interface CanofoldDemoEngine {
+    id: string;
+    version?: string;
+    cacheKey?: CanofoldDemoCacheValue;
+    prepare(context: CanofoldDemoPrepareContext): Promise<CanofoldDemoManifest>;
+    startDev?(context: CanofoldDemoDevContext): Promise<CanofoldDemoDevRuntime>;
+}
+
+export type { CanofoldDemoCacheValue, CanofoldDemoDevContext, CanofoldDemoDevRuntime, CanofoldDemoEngine, CanofoldDemoManifest, CanofoldDemoPrepareContext, CanofoldDemoReference, CanofoldDemoSandbox, CanofoldPreparedDemo };

package/dist/demo-engine.js

@@ -0,0 +1 @@
+//# sourceMappingURL=demo-engine.js.map

package/dist/{deploy-4YUYRVRO.js → deploy-47AUDPYE.js}

@@ -1,4 +1,4 @@
-import{j as g}from"./chunk-4OALGQQB.js";import{a as d}from"./chunk-M6T5RSNJ.js";import"./chunk-EAYVCA3Z.js";import{a as i,e as f}from"./chunk-JK7ZNBUA.js";import{a as r}from"./chunk-AYDF3IFZ.js";import{mkdir as y,readFile as h,writeFile as $}from"fs/promises";import{join as a}from"path";function k(o){return`"${o.replace(/[\\"$]/g,"\\$&")}"`}r(k,"quoteNginxValue");async function b(o){if(await i(a(o,"pnpm-lock.yaml")))return"pnpm";if(await i(a(o,"yarn.lock")))return"yarn";try{let e=JSON.parse(await h(a(o,"package.json"),"utf8"));if(typeof e.packageManager=="string"){if(e.packageManager.startsWith("pnpm@"))return"pnpm";if(e.packageManager.startsWith("yarn@"))return"yarn"}}catch(e){if(e.code!=="ENOENT"&&!(e instanceof SyntaxError))throw e}return"npm"}r(b,"detectPackageManager");function w(o,e,s){let t=o.replaceAll("\\","/"),c=k(`/var/www/canofold/${t.replace(/^\/+/,"")}`),l=e.replace(/\/$/,"").replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),p=e==="/"?`  location / {
+import{l as g}from"./chunk-ACUMTEQL.js";import{a as d}from"./chunk-M6T5RSNJ.js";import"./chunk-EAYVCA3Z.js";import{a as i,e as f}from"./chunk-JK7ZNBUA.js";import{a as r}from"./chunk-AYDF3IFZ.js";import{mkdir as y,readFile as h,writeFile as $}from"fs/promises";import{join as a}from"path";function k(o){return`"${o.replace(/[\\"$]/g,"\\$&")}"`}r(k,"quoteNginxValue");async function b(o){if(await i(a(o,"pnpm-lock.yaml")))return"pnpm";if(await i(a(o,"yarn.lock")))return"yarn";try{let e=JSON.parse(await h(a(o,"package.json"),"utf8"));if(typeof e.packageManager=="string"){if(e.packageManager.startsWith("pnpm@"))return"pnpm";if(e.packageManager.startsWith("yarn@"))return"yarn"}}catch(e){if(e.code!=="ENOENT"&&!(e instanceof SyntaxError))throw e}return"npm"}r(b,"detectPackageManager");function w(o,e,s){let t=o.replaceAll("\\","/"),c=k(`/var/www/canofold/${t.replace(/^\/+/,"")}`),l=e.replace(/\/$/,"").replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),p=e==="/"?`  location / {
     try_files $uri $uri/ =404;
   }`:`  location = ${e.replace(/\/$/,"")} {
     return 308 ${e};
@@ -141,4 +141,4 @@ server {
 ${p}
 }
 `}}r(w,"createGuides");async function E({cwd:o}){let e=await g(o),s=f(o,e.outputDir);if(!await i(a(s,"index.html")))throw new Error(`Build output not found at ${e.outputDir}. Run canofold build before canofold deploy.`);let t=a(o,".canofold/deploy"),c=await b(o);await y(t,{recursive:!0});for(let[l,p]of Object.entries(w(e.outputDir,e.basePath,c)))await $(a(t,l),p);d(`Wrote deployment guides to ${t}`)}r(E,"runDeploy");export{E as runDeploy};
-//# sourceMappingURL=deploy-4YUYRVRO.js.map
+//# sourceMappingURL=deploy-47AUDPYE.js.map

package/dist/dev-3C4T3COS.js

@@ -0,0 +1,2 @@
+import{a as B}from"./chunk-HS5LEPRC.js";import{b}from"./chunk-OKX7SQKX.js";import{a as P}from"./chunk-EQOADO2H.js";import"./chunk-KJ7FG6AY.js";import{b as w}from"./chunk-ENPRUF6E.js";import"./chunk-XYJ2OBL3.js";import"./chunk-ACUMTEQL.js";import{a as S,b as v}from"./chunk-M6T5RSNJ.js";import"./chunk-2XMX5JW6.js";import"./chunk-EAYVCA3Z.js";import{c as y,e as D}from"./chunk-JK7ZNBUA.js";import{a as r}from"./chunk-AYDF3IFZ.js";import O from"chokidar";import{createMarkdownRenderer as T}from"@canofold/markdown/server";import{relative as I,resolve as E,sep as K}from"path";function k(n,f,u){let t=E(n,u),i=I(n,t).split(K);return i.includes("node_modules")||i.includes(".git")||i.includes(".canofold")||i.some(o=>/^\..+\.(?:tmp|backup)-/.test(o))?!0:y(D(n,f),t)||y(P(n),t)}r(k,"shouldIgnoreGeneratedPath");function U({build:n,reload:f,onBuildError:u=r(o=>v(o instanceof Error?o.message:String(o)),"onBuildError"),onBuildOk:t,debounceMs:i=80}){let o,d,l=!1,c=!1,p=r(()=>{if(o=void 0,!c){if(d){l=!0;return}d=(async()=>{try{let a=await n();c||(t?.(),f(a))}catch(a){u(a)}finally{d=void 0,l&&!c&&(l=!1,o=setTimeout(p,0))}})()}},"run");return{schedule(){if(!c){if(d){l=!0;return}o&&clearTimeout(o),o=setTimeout(p,i)}},async close(){c=!0,l=!1,o&&clearTimeout(o),o=void 0,await d}}}r(U,"createBuildScheduler");async function M({cwd:n,port:f}){let u=T(),t=await b({cwd:n,renderer:u,demoMode:"dev"}),i,o,d,l=r(()=>{let e=t.config.demos.engine;if(!(!t.demoManifest||!e?.startDev))return JSON.stringify({id:e.id,version:e.version??"",cacheKey:e.cacheKey??null,basePath:t.config.basePath,outputDir:t.config.outputDir,setup:t.config.demos.setup??null})},"runtimeKeyForCurrentBuild"),c=r(async()=>{let e=t.config.demos.engine;if(!(!t.demoManifest||!e?.startDev||!d))return e.startDev({cwd:n,basePath:t.config.basePath,setup:t.config.demos.setup,server:d,getDemos:r(()=>Object.values(t.demoManifest?.demos??{}),"getDemos"),shouldIgnorePath:r(s=>k(n,t.config.outputDir,s),"shouldIgnorePath")})},"createDemoRuntime"),p=r(async()=>{let e=l();if(e===o){await i?.update?.();return}let s=await c(),m=i;i=s,o=e,await m?.close()},"refreshDemoRuntime"),a=await B({root:r(()=>D(n,t.config.outputDir),"root"),port:f,liveReload:!0,basePath:r(()=>t.config.basePath,"basePath"),configureServer:r(async e=>(d=e,i=await c(),o=l(),{middleware(s,m,g){if(!i?.middleware){g();return}i.middleware(s,m,()=>g())},close:r(()=>i?.close(),"close")}),"configureServer")}),h=O.watch(".",{cwd:n,ignoreInitial:!0,ignored:r(e=>k(n,t.config.outputDir,e),"ignored")}),R=U({build:r(async()=>{t=await b({cwd:n,renderer:u,demoMode:"dev"}),await p();let e=t.changedPages.flatMap(s=>{let m=t.graph.pages.find(g=>g.sourceRelativePath===s);return m?[w(t.config,m.routePath)]:[]});return{protocol:1,type:"update",mode:t.partialReload&&e.length===1?"page":"full",routes:e}},"build"),reload:r(e=>a.reload(e),"reload"),onBuildError:r(e=>{let s=e instanceof Error?e.message:String(e);v("Build error:",s),a.sendBuildError(s)},"onBuildError"),onBuildOk:r(()=>a.sendBuildOk(),"onBuildOk")});return h.on("all",(e,s)=>{i?.handlesFile?.(E(n,s))||R.schedule()}),h.on("error",e=>{let s=e instanceof Error?e.message:String(e);v("File watcher error:",s),a.sendBuildError(s)}),{port:a.port,close:r(async()=>{await h.close(),await R.close(),await a.close()},"close")}}r(M,"startDevServer");async function L({cwd:n,port:f=3333}){let u=await M({cwd:n,port:f});return S(`Dev server running at http://127.0.0.1:${u.port}/`),u}r(L,"runDev");export{L as runDev};
+//# sourceMappingURL=dev-3C4T3COS.js.map

package/dist/index.d.ts

@@ -0,0 +1,452 @@
+import { MarkdownHtmlPolicy, MarkdownCodeOptions, MarkdownFeatureOptions, MarkdownLabels, MarkdownPlugin } from '@canofold/markdown';
+import { MarkdownThemeInput } from '@canofold/markdown/theme';
+import { MarkdownHeading, MarkdownCodeExample } from '@canofold/markdown/server/analyze';
+import { CanofoldDemoReference, CanofoldDemoEngine } from './demo-engine.js';
+export { CanofoldDemoCacheValue, CanofoldDemoDevContext, CanofoldDemoDevRuntime, CanofoldDemoManifest, CanofoldDemoPrepareContext, CanofoldDemoSandbox, CanofoldPreparedDemo } from './demo-engine.js';
+import 'node:http';
+
+/** Package version injected by tsup so chunk nesting cannot affect lookup. */
+declare const canofoldVersion: string;
+
+declare const homeIconNames: readonly ["ai", "box", "code", "file", "file-code", "gauge", "globe", "layers", "rocket", "search", "sparkles", "terminal"];
+type HomeIconName = (typeof homeIconNames)[number];
+interface CanofoldFrontmatter {
+    title?: string;
+    seoTitle?: string;
+    description?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    order?: number;
+    group?: string;
+    subgroup?: string;
+    collapsed?: boolean;
+    sidebar?: boolean;
+    layout?: 'document' | 'playground';
+    status?: 'draft' | 'published';
+    search?: boolean;
+    ai?: boolean;
+    tags?: string[];
+    owner?: string;
+    hero?: {
+        accent?: string;
+        tagline?: string;
+        image?: string;
+        imageAlt?: string;
+        actions?: Array<{
+            text: string;
+            link: string;
+            primary?: boolean;
+            icon?: HomeIconName;
+        }>;
+    };
+    features?: Array<{
+        icon?: HomeIconName;
+        image?: string;
+        title: string;
+        details: string;
+    }>;
+    [key: string]: unknown;
+}
+
+interface PageLink {
+    title: string;
+    routePath: string;
+}
+interface SidebarLink {
+    type: 'link';
+    title: string;
+    routePath: string;
+}
+interface SidebarTreeGroup {
+    type: 'group';
+    /** Stable identity among sibling directories; display titles may be translated or duplicated. */
+    segment: string;
+    title: string;
+    collapsed: boolean;
+    items: SidebarItem[];
+}
+type SidebarItem = SidebarLink | SidebarTreeGroup;
+interface SidebarGroup {
+    /** First directory segment under the locale; used to select a section sidebar. */
+    segment: string;
+    /** Section title used by automatic top navigation, not rendered inside the sidebar. */
+    title: string;
+    items: SidebarItem[];
+}
+interface NavItem {
+    title: string;
+    routePath: string;
+}
+interface DocPage {
+    sourcePath: string;
+    /** Complete source after extension transforms, including frontmatter and MDX imports. */
+    transformedSource: string;
+    /** Project-relative source path, including a version-specific docsDir. */
+    sourceRelativePath: string;
+    /** Path relative to this version's docs root. */
+    relativePath: string;
+    version: string;
+    versionBase: string;
+    docsDir: string;
+    locale: string;
+    routePath: string;
+    outputPath: string;
+    markdownOutputPath: string;
+    title: string;
+    description: string;
+    order: number;
+    /** First sub-directory segment under the locale, '' for root-level pages. */
+    group: string;
+    status: 'draft' | 'published';
+    search: boolean;
+    ai: boolean;
+    body: string;
+    headings: MarkdownHeading[];
+    searchText: string;
+    codeExamples: MarkdownCodeExample[];
+    demos: CanofoldDemoReference[];
+    lastUpdated: string;
+    previous?: PageLink;
+    next?: PageLink;
+    frontmatter: CanofoldFrontmatter;
+}
+interface ContentGraph {
+    pages: DocPage[];
+    /** Grouped sidebar entries per version and locale. */
+    sidebar: Record<string, Record<string, SidebarGroup[]>>;
+    /** Top navigation entries per version and locale. */
+    nav: Record<string, Record<string, NavItem[]>>;
+    locales: string[];
+    defaultLocale: string;
+    versions: Array<{
+        id: string;
+        label: string;
+        base: string;
+        docsDir: string;
+    }>;
+    currentVersion: string;
+}
+
+interface SearchProviderContext {
+    cwd: string;
+    config: CanofoldConfig;
+    graph: ContentGraph;
+    outputRoot: string;
+    publicPathFor(routePath: string): string;
+    resolveOutputPath(outputPath: string, label: string): string;
+}
+/**
+ * Whole-site index lifecycle. Unlike a Markdown plugin, a provider consumes the
+ * completed ContentGraph and output root; unlike an Extension, it owns only the
+ * configured search implementation's artifacts.
+ */
+interface SearchProvider {
+    readonly id: string;
+    /** Browser-side query protocol consumed by Canofold's built-in search modal. */
+    readonly client: 'compact' | 'pagefind';
+    readonly version?: string;
+    /** Resolved JSON options used for build invalidation. Bump `version` when implementation changes. */
+    readonly cacheKey?: CanofoldJsonValue;
+    write(context: SearchProviderContext): Promise<void>;
+}
+
+declare const THEME_BASE_COLORS: readonly ["paper", "neutral", "slate", "zinc", "stone"];
+declare const CANOFOLD_MARKDOWN_ELEMENT_GROUP_IDS: readonly ["headings", "inline", "lists", "callouts", "code", "tables", "media", "diagrams", "disclosure", "extensions", "api", "metadata"];
+
+type ThemeBaseColor = (typeof THEME_BASE_COLORS)[number];
+type CanofoldMarkdownElementGroupId = (typeof CANOFOLD_MARKDOWN_ELEMENT_GROUP_IDS)[number];
+interface CanofoldNavigationItem {
+    text: string;
+    link: string;
+}
+interface CanofoldVersionItem {
+    id: string;
+    label: string;
+    docsDir: string;
+    /** Absolute URL base. The current version normally uses `/`. */
+    base: string;
+}
+interface CanofoldAdvertisement {
+    image: string;
+    href: string;
+    alt: string;
+    label?: string;
+}
+interface CanofoldSearchConfig {
+    enabled: boolean;
+    provider: 'compact' | SearchProvider;
+}
+type CanofoldJsonValue = string | number | boolean | null | CanofoldJsonValue[] | {
+    [key: string]: CanofoldJsonValue;
+};
+interface CanofoldExtensionDescriptor {
+    /** Project-relative TypeScript or JavaScript module. Extensions execute as trusted build code. */
+    resolve: string;
+    /** JSON-serializable factory options; functions and environment-specific values are rejected. */
+    options?: {
+        [key: string]: CanofoldJsonValue;
+    };
+}
+interface CanofoldLayoutLabels {
+    skipToContent: string;
+    search: string;
+    searchEmpty: string;
+    searchUnavailable: string;
+    language: string;
+    primaryNavigation: string;
+    theme: string;
+    openSidebar: string;
+    onThisPage: string;
+    edit: string;
+    updated: string;
+    previous: string;
+    next: string;
+    close: string;
+    source: string;
+    preview: string;
+    copySource: string;
+    sourceCopied: string;
+    quickActions: string;
+    github: string;
+    docsNavigation: string;
+    pageNavigation: string;
+    advertisement: string;
+    version: string;
+}
+interface CanofoldQuickActionMessages {
+    headingsTitle: string;
+    headingsDescription: string;
+    codeTitle: string;
+    codeDescription: string;
+    tableTitle: string;
+    tableDescription: string;
+    diagramTitle: string;
+    diagramDescription: string;
+    sourceDescription: string;
+    themeDescription: string;
+}
+interface CanofoldMarkdownElementGroupMessages {
+    label?: string;
+    detail?: string;
+    hash?: string;
+}
+interface CanofoldNotFoundMessages {
+    title: string;
+    description: string;
+    home: string;
+}
+interface CanofoldLocaleMessages {
+    labels?: Partial<CanofoldLayoutLabels>;
+    brandTagline?: string;
+    quickActions?: Partial<CanofoldQuickActionMessages>;
+    markdownElementGroups?: Partial<Record<CanofoldMarkdownElementGroupId, CanofoldMarkdownElementGroupMessages>>;
+    markdown?: Partial<MarkdownLabels>;
+    notFound?: Partial<CanofoldNotFoundMessages>;
+}
+/** Public authoring contract for canofold.config.ts. Runtime validation uses the matching strict schema. */
+interface CanofoldConfigInput {
+    title?: string;
+    description?: string;
+    siteUrl?: string;
+    basePath?: string;
+    editUrl?: string;
+    github?: string;
+    requiredVersion?: string;
+    docsDir?: string;
+    outputDir?: string;
+    styles?: string[];
+    demos?: {
+        engine?: CanofoldDemoEngine;
+        /** Optional project module that wraps every interactive demo with shared providers. */
+        setup?: string;
+    };
+    layout?: {
+        header?: boolean;
+    };
+    markdown?: {
+        html?: MarkdownHtmlPolicy;
+        code?: Pick<MarkdownCodeOptions, 'themes' | 'fallbackLanguage' | 'unknownLanguage'>;
+        features?: MarkdownFeatureOptions;
+        labels?: Partial<MarkdownLabels>;
+        /**
+         * Compiler plugins imported into canofold.config.ts, e.g. from
+         * `@canofold/plugins`. They execute as trusted build code; cache identity
+         * comes from each plugin's `name`, `version` and `cacheKey`.
+         */
+        plugins?: readonly MarkdownPlugin[];
+    };
+    theme?: {
+        logo?: string;
+        logoDark?: string;
+        favicon?: string;
+        accentColor?: string;
+        darkMode?: boolean;
+        radius?: number | string;
+        baseColor?: ThemeBaseColor;
+        sidebarWidth?: number | string;
+        outlineWidth?: number | string;
+        tokens?: MarkdownThemeInput;
+    };
+    search?: {
+        enabled?: boolean;
+        /** Use `compact` or a provider such as `pagefind()` from @canofold/plugins. */
+        provider?: 'compact' | SearchProvider;
+    };
+    extensions?: CanofoldExtensionDescriptor[];
+    navigation?: Record<string, CanofoldNavigationItem[]>;
+    versions?: {
+        current: string;
+        items: CanofoldVersionItem[];
+    };
+    redirects?: Record<string, string>;
+    advertising?: CanofoldAdvertisement;
+    i18n?: {
+        defaultLocale?: string;
+        locales?: string[];
+        localeNames?: Record<string, string>;
+        messages?: Record<string, CanofoldLocaleMessages>;
+    };
+    ai?: {
+        llmsTxt?: boolean;
+        llmsFullTxt?: boolean;
+        markdownIndex?: boolean;
+        pageSummaries?: boolean;
+        codeExamples?: boolean;
+        /** Maximum encoded size of one ai/content JSONL shard. */
+        chunkSizeBytes?: number;
+        /** Maximum size of the legacy single-file llms-full.txt body. */
+        llmsFullMaxBytes?: number;
+        /** Write a manifest pointer or fail when llms-full.txt exceeds its budget. */
+        llmsFullOverflow?: 'manifest' | 'error';
+        /** Current avoids duplicate historical answers; all publishes every configured version. */
+        versions?: 'current' | 'all';
+    };
+}
+interface CanofoldConfig {
+    title: string;
+    description: string;
+    siteUrl?: string;
+    basePath: string;
+    editUrl?: string;
+    github?: string;
+    requiredVersion?: string;
+    docsDir: string;
+    outputDir: string;
+    styles: string[];
+    demos: {
+        engine?: CanofoldDemoEngine;
+        setup?: string;
+    };
+    layout: {
+        header: boolean;
+    };
+    markdown: {
+        html: MarkdownHtmlPolicy;
+        code: MarkdownCodeOptions;
+        features: MarkdownFeatureOptions;
+        labels: Partial<MarkdownLabels>;
+        plugins: readonly MarkdownPlugin[];
+    };
+    theme: {
+        logo?: string;
+        logoDark?: string;
+        favicon?: string;
+        accentColor: string;
+        darkMode: boolean;
+        radius: number | string;
+        baseColor: ThemeBaseColor;
+        sidebarWidth: number | string;
+        outlineWidth: number | string;
+        tokens: MarkdownThemeInput;
+    };
+    search: CanofoldSearchConfig;
+    extensions: CanofoldExtensionDescriptor[];
+    navigation: Record<string, CanofoldNavigationItem[]>;
+    versions: {
+        current: string;
+        items: CanofoldVersionItem[];
+    };
+    redirects: Record<string, string>;
+    advertising?: CanofoldAdvertisement;
+    i18n: {
+        defaultLocale: string;
+        locales: string[];
+        localeNames?: Record<string, string>;
+        messages?: Record<string, CanofoldLocaleMessages>;
+    };
+    ai: {
+        llmsTxt: boolean;
+        llmsFullTxt: boolean;
+        markdownIndex: boolean;
+        pageSummaries: boolean;
+        codeExamples: boolean;
+        chunkSizeBytes: number;
+        llmsFullMaxBytes: number;
+        llmsFullOverflow: 'manifest' | 'error';
+        versions: 'current' | 'all';
+    };
+}
+
+/** Add contextual typing to canofold.config.ts without changing its runtime value. */
+declare function defineConfig(config: CanofoldConfigInput): CanofoldConfigInput;
+
+declare function defineSearchProvider<T extends SearchProvider>(provider: T): T;
+
+declare const CANOFOLD_EXTENSION_API_VERSION: 1;
+interface CanofoldExtensionSourceContext {
+    source: string;
+    sourceRelativePath: string;
+    relativePath: string;
+    kind: 'markdown' | 'mdx';
+    version: string;
+    locale: string;
+}
+interface CanofoldExtensionPage {
+    sourceRelativePath: string;
+    relativePath: string;
+    version: string;
+    locale: string;
+    routePath: string;
+    title: string;
+    description: string;
+    status: 'draft' | 'published';
+    search: boolean;
+    ai: boolean;
+    body: string;
+    searchText: string;
+    frontmatter: CanofoldFrontmatter;
+}
+interface CanofoldExtensionPagePatch {
+    title?: string;
+    description?: string;
+    searchText?: string;
+    search?: boolean;
+    ai?: boolean;
+}
+interface CanofoldExtensionGenerateContext {
+    pages: readonly CanofoldExtensionPage[];
+    emitFile(path: string, content: string | Uint8Array): Promise<void>;
+}
+/**
+ * Versioned, semantic site-build contract. Compiler ASTs and internal render
+ * plugins intentionally stay private so upgrades do not depend on pipeline order.
+ * Per-document syntax belongs to MarkdownPlugin; whole-site search indexing
+ * belongs to SearchProvider.
+ */
+interface CanofoldExtension {
+    apiVersion: typeof CANOFOLD_EXTENSION_API_VERSION;
+    name: string;
+    /** Every generated path must be declared up front and is scoped under extensions/{name}/. */
+    outputs?: string[];
+    transformSource?(context: Readonly<CanofoldExtensionSourceContext>): string | Promise<string>;
+    extendPage?(page: Readonly<CanofoldExtensionPage>): CanofoldExtensionPagePatch | void | Promise<CanofoldExtensionPagePatch | void>;
+    generate?(context: CanofoldExtensionGenerateContext): void | Promise<void>;
+}
+type CanofoldExtensionOptions = {
+    [key: string]: CanofoldJsonValue;
+};
+type CanofoldExtensionFactory = (options: Readonly<CanofoldExtensionOptions>) => CanofoldExtension | Promise<CanofoldExtension>;
+declare function defineExtension(extension: CanofoldExtension): CanofoldExtension;
+declare function defineExtension(factory: CanofoldExtensionFactory): CanofoldExtensionFactory;
+
+export { CANOFOLD_EXTENSION_API_VERSION, type CanofoldConfigInput, CanofoldDemoEngine, CanofoldDemoReference, type CanofoldExtension, type CanofoldExtensionDescriptor, type CanofoldExtensionFactory, type CanofoldExtensionGenerateContext, type CanofoldExtensionPage, type CanofoldExtensionPagePatch, type CanofoldExtensionSourceContext, type CanofoldJsonValue, type SearchProvider, type SearchProviderContext, canofoldVersion, defineConfig, defineExtension, defineSearchProvider };

package/dist/index.js

@@ -1,2 +1,2 @@
-import{c as t,f,g as r}from"./chunk-ENPRUF6E.js";import"./chunk-XYJ2OBL3.js";import{a as n}from"./chunk-3TIVCYR7.js";import"./chunk-JK7ZNBUA.js";import{a as o}from"./chunk-AYDF3IFZ.js";function i(e){return e}o(i,"defineConfig");export{f as CANOFOLD_EXTENSION_API_VERSION,n as canofoldVersion,i as defineConfig,r as defineExtension,t as defineSearchProvider};
+import{c as t,f,g as a}from"./chunk-ENPRUF6E.js";import"./chunk-XYJ2OBL3.js";import{a as n}from"./chunk-2XMX5JW6.js";import"./chunk-JK7ZNBUA.js";import{a as o}from"./chunk-AYDF3IFZ.js";function r(e){return e}o(r,"defineConfig");export{f as CANOFOLD_EXTENSION_API_VERSION,n as canofoldVersion,r as defineConfig,a as defineExtension,t as defineSearchProvider};
 //# sourceMappingURL=index.js.map

package/dist/{init-6R5SLESH.js → init-3PS74OVB.js}

@@ -1,4 +1,4 @@
-import{a as d}from"./chunk-M6T5RSNJ.js";import{a as b}from"./chunk-3TIVCYR7.js";import{a as k,d as S}from"./chunk-EAYVCA3Z.js";import{a as T,d as j,f as N}from"./chunk-JK7ZNBUA.js";import{a as l}from"./chunk-AYDF3IFZ.js";import{mkdir as U,readFile as B,readdir as G,rm as V,rmdir as Y,writeFile as _}from"fs/promises";import{dirname as W,isAbsolute as Q,join as E}from"path";import{createInterface as Z}from"readline/promises";import{join as y}from"path";var R=`/**
+import{a as d}from"./chunk-M6T5RSNJ.js";import{a as b}from"./chunk-2XMX5JW6.js";import{a as k,d as S}from"./chunk-EAYVCA3Z.js";import{a as T,d as j,f as N}from"./chunk-JK7ZNBUA.js";import{a as l}from"./chunk-AYDF3IFZ.js";import{mkdir as U,readFile as B,readdir as G,rm as V,rmdir as Y,writeFile as _}from"fs/promises";import{dirname as W,isAbsolute as Q,join as E}from"path";import{createInterface as Z}from"readline/promises";import{join as y}from"path";var R=`/**
  * Minimal declarations for trusted project-local TSX components.
  *
  * Canofold intentionally does not publish or emulate a UI component module.
@@ -67,5 +67,5 @@ export default defineConfig({
     locales: [${n.map(i=>`'${i}'`).join(", ")}]
   }
 })
-`}l(H,"configTemplate");function O(e){let{docsDir:t,defaultLocale:n,locales:i,includeContent:r,includeConfig:s}=e,c={[y(t,"canofold-env.d.ts")]:R};if(s&&(c["canofold.config.ts"]=H(t,n,i)),!r)return c;for(let g of i){let p=g===n?t:y(t,g),a=q(g);c[y(p,"index.md")]=a?.index??A,a&&(c[y(p,"guide.md")]=a.guide)}return c}l(O,"createInitFiles");async function J(e,t=""){let n;try{n=await G(e,{withFileTypes:!0})}catch(r){if(r.code==="ENOENT")return[];throw r}let i=[];for(let r of n){let s=t?E(t,r.name):r.name;if(r.isFile()&&k(r.name)&&i.push(s),r.isDirectory()&&(t||r.name!=="public"))for(let c of await J(E(e,r.name),s))i.push(c)}return i.sort((r,s)=>r.localeCompare(s))}l(J,"listMarkdownFiles");function ee(e,t){for(let n of t)try{Intl.getCanonicalLocales(n)}catch{throw new Error(`Invalid locale: ${n}`)}if(new Set(t.map(n=>n.toLowerCase())).size!==t.length)throw new Error("Locales must not contain duplicates");if(!t.some(n=>n.toLowerCase()===e.toLowerCase()))throw new Error(`Default locale ${e} must be included in locales`)}l(ee,"validateLocaleSelection");async function te(e=Z({input:process.stdin,output:process.stdout})){try{let n=((await e.question("Existing documents found. Enter their locale, or a comma-separated locale list (default: zh): ")).trim()||"zh").split(",").map(i=>i.trim());if(n.some(i=>!i))throw new Error("Locales must be a comma-separated list of locale identifiers");return n}catch(t){throw t.code==="ABORT_ERR"?new Error("Canofold initialization cancelled"):t}finally{e.close()}}l(te,"promptForLocales");function ne(e,t){return e.length===t.length&&e.every((n,i)=>n.toLowerCase()===t[i]?.toLowerCase())}l(ne,"sameLocales");function oe(e,t){if(e.docsDir&&e.docsDir!==t.docsDir)throw new Error(`--docs-dir ${e.docsDir} conflicts with configured docsDir ${t.docsDir}`);if(e.locale&&e.locale.toLowerCase()!==t.i18n.defaultLocale.toLowerCase())throw new Error(`--locale ${e.locale} conflicts with configured defaultLocale ${t.i18n.defaultLocale}`);if(e.locales&&!ne(e.locales,t.i18n.locales))throw new Error(`--locales ${e.locales.join(",")} conflicts with configured locales ${t.i18n.locales.join(",")}`)}l(oe,"assertOptionsMatchConfig");function $(e){return S(e.replace(/\\/g,"/")).normalize("NFC").toLocaleLowerCase("en-US")}l($,"portablePageKey");function ie(e,t,n){if(!e.length)return[];let i=[],r=e.map(a=>a.replace(/\\/g,"/")),s=l(a=>n==="."?a:`${n.replace(/\\/g,"/")}/${a}`,"displayPath"),c=t.normalize("NFC").toLocaleLowerCase("en-US");r.some(a=>{let h=$(a);return h==="index"||h===`${c}/index`})||i.push(`no default-language index.md or index.mdx was found in ${n}`);let p=new Map;for(let a of r)a.startsWith(`${t}/`)||p.set($(a),a);for(let a of r){if(!a.startsWith(`${t}/`))continue;let h=a.slice(t.length+1),u=p.get($(h));u&&i.push(`${s(u)} and ${s(a)} map to the same default-language page; keep only one source`)}return i}l(ie,"existingContentWarnings");async function re(e,t){let n=[],i=e;for(;!await T(i);){n.push(i);let r=W(i);if(r===i)break;i=r}for(let r of n.reverse())try{await U(r),t.push(r)}catch(s){if(s.code!=="EEXIST")throw s}}l(re,"createMissingDirectoryChain");async function xe(e,t={}){let n=e.targetDir?E(e.cwd,e.targetDir):e.cwd,{findConfigPath:i,loadConfig:r}=await import("./load-W4JHZIBF.js"),s=!!await i(n),c=s?await r(n):void 0;c&&oe(e,c);let g=c?.docsDir??e.docsDir??"docs";if(Q(g))throw new Error("docsDir must be a relative path");let p=j(n,g,"docsDir");await N(n,p,"docsDir");let a=await J(p),h=a.length>0,u=e.locales;if(h&&!s&&!e.locale&&!u){let o=e.localePrompt??(process.stdin.isTTY&&process.stdout.isTTY?te:void 0);if(!o){let f=a[0]??"";throw new Error(`Found ${a.length} existing Markdown file(s) in "${g}" (e.g. "${f}"), but cannot determine their language in a non-interactive environment. Specify the locale explicitly: canofold init --locale <locale> (e.g. --locale zh)`)}u=await o()}let x=c?.i18n.defaultLocale??e.locale??u?.[0]??"zh";u=c?.i18n.locales??u??[x],ee(x,u);let M=O({docsDir:g,defaultLocale:x,locales:u,includeContent:!h,includeConfig:!s}),P=[],F=[],D=ie(a,x,g);for(let[o,f]of Object.entries(M)){let w=E(n,o);try{let C=await B(w,"utf8");F.push(o),C!==f&&D.push(`${o} already exists with different content`)}catch(C){let v=C.code;if(v==="EISDIR")throw new Error(`Cannot create ${o} because a directory exists at that path`);if(v!=="ENOENT")throw C;P.push({relativePath:o,content:f,fullPath:w})}}let m={mode:s?"configured":h?"adopt":"create",createFiles:P,keepFiles:F,warnings:D};if(!m.createFiles.length){for(let o of m.warnings)d(`Warning: ${o}`);d(`Canofold is already initialized in ${n}`);return}let L=[],K=t.writeFile??((o,f,w)=>_(o,f,w)),X=[...new Set(m.createFiles.map(o=>W(o.fullPath)))].sort((o,f)=>o.length-f.length),I=[];try{for(let o of X)await re(o,I);for(let o of m.createFiles)await K(o.fullPath,o.content,{flag:"wx"}),L.push(o.fullPath)}catch(o){await Promise.all(L.map(f=>V(f,{force:!0})));for(let f of I.sort((w,C)=>C.length-w.length))try{await Y(f)}catch{}throw o}for(let o of m.createFiles)d(`Created ${o.relativePath}`);for(let o of m.keepFiles)d(`Kept existing ${o}`);for(let o of m.warnings)d(`Warning: ${o}`);if(m.mode==="adopt"){let o=a.length===1?"document":"documents";d(`Adopted ${a.length} existing ${o} in ${n}`),d(`Kept ${a.length} existing ${o} unchanged`),d("Next: canofold check")}else m.mode==="configured"?(d(`Created missing documentation files in ${n}`),d("Next: canofold dev")):(d(`Created Canofold docs in ${n}`),d("Next: canofold dev"));d("Add .canofold/ to .gitignore if this directory is versioned.")}l(xe,"runInit");export{te as promptForLocales,xe as runInit};
-//# sourceMappingURL=init-6R5SLESH.js.map
+`}l(H,"configTemplate");function O(e){let{docsDir:t,defaultLocale:n,locales:i,includeContent:r,includeConfig:s}=e,c={[y(t,"canofold-env.d.ts")]:R};if(s&&(c["canofold.config.ts"]=H(t,n,i)),!r)return c;for(let g of i){let p=g===n?t:y(t,g),a=q(g);c[y(p,"index.md")]=a?.index??A,a&&(c[y(p,"guide.md")]=a.guide)}return c}l(O,"createInitFiles");async function J(e,t=""){let n;try{n=await G(e,{withFileTypes:!0})}catch(r){if(r.code==="ENOENT")return[];throw r}let i=[];for(let r of n){let s=t?E(t,r.name):r.name;if(r.isFile()&&k(r.name)&&i.push(s),r.isDirectory()&&(t||r.name!=="public"))for(let c of await J(E(e,r.name),s))i.push(c)}return i.sort((r,s)=>r.localeCompare(s))}l(J,"listMarkdownFiles");function ee(e,t){for(let n of t)try{Intl.getCanonicalLocales(n)}catch{throw new Error(`Invalid locale: ${n}`)}if(new Set(t.map(n=>n.toLowerCase())).size!==t.length)throw new Error("Locales must not contain duplicates");if(!t.some(n=>n.toLowerCase()===e.toLowerCase()))throw new Error(`Default locale ${e} must be included in locales`)}l(ee,"validateLocaleSelection");async function te(e=Z({input:process.stdin,output:process.stdout})){try{let n=((await e.question("Existing documents found. Enter their locale, or a comma-separated locale list (default: zh): ")).trim()||"zh").split(",").map(i=>i.trim());if(n.some(i=>!i))throw new Error("Locales must be a comma-separated list of locale identifiers");return n}catch(t){throw t.code==="ABORT_ERR"?new Error("Canofold initialization cancelled"):t}finally{e.close()}}l(te,"promptForLocales");function ne(e,t){return e.length===t.length&&e.every((n,i)=>n.toLowerCase()===t[i]?.toLowerCase())}l(ne,"sameLocales");function oe(e,t){if(e.docsDir&&e.docsDir!==t.docsDir)throw new Error(`--docs-dir ${e.docsDir} conflicts with configured docsDir ${t.docsDir}`);if(e.locale&&e.locale.toLowerCase()!==t.i18n.defaultLocale.toLowerCase())throw new Error(`--locale ${e.locale} conflicts with configured defaultLocale ${t.i18n.defaultLocale}`);if(e.locales&&!ne(e.locales,t.i18n.locales))throw new Error(`--locales ${e.locales.join(",")} conflicts with configured locales ${t.i18n.locales.join(",")}`)}l(oe,"assertOptionsMatchConfig");function $(e){return S(e.replace(/\\/g,"/")).normalize("NFC").toLocaleLowerCase("en-US")}l($,"portablePageKey");function ie(e,t,n){if(!e.length)return[];let i=[],r=e.map(a=>a.replace(/\\/g,"/")),s=l(a=>n==="."?a:`${n.replace(/\\/g,"/")}/${a}`,"displayPath"),c=t.normalize("NFC").toLocaleLowerCase("en-US");r.some(a=>{let h=$(a);return h==="index"||h===`${c}/index`})||i.push(`no default-language index.md or index.mdx was found in ${n}`);let p=new Map;for(let a of r)a.startsWith(`${t}/`)||p.set($(a),a);for(let a of r){if(!a.startsWith(`${t}/`))continue;let h=a.slice(t.length+1),u=p.get($(h));u&&i.push(`${s(u)} and ${s(a)} map to the same default-language page; keep only one source`)}return i}l(ie,"existingContentWarnings");async function re(e,t){let n=[],i=e;for(;!await T(i);){n.push(i);let r=W(i);if(r===i)break;i=r}for(let r of n.reverse())try{await U(r),t.push(r)}catch(s){if(s.code!=="EEXIST")throw s}}l(re,"createMissingDirectoryChain");async function xe(e,t={}){let n=e.targetDir?E(e.cwd,e.targetDir):e.cwd,{findConfigPath:i,loadConfig:r}=await import("./load-BG2H2Q65.js"),s=!!await i(n),c=s?await r(n):void 0;c&&oe(e,c);let g=c?.docsDir??e.docsDir??"docs";if(Q(g))throw new Error("docsDir must be a relative path");let p=j(n,g,"docsDir");await N(n,p,"docsDir");let a=await J(p),h=a.length>0,u=e.locales;if(h&&!s&&!e.locale&&!u){let o=e.localePrompt??(process.stdin.isTTY&&process.stdout.isTTY?te:void 0);if(!o){let f=a[0]??"";throw new Error(`Found ${a.length} existing Markdown file(s) in "${g}" (e.g. "${f}"), but cannot determine their language in a non-interactive environment. Specify the locale explicitly: canofold init --locale <locale> (e.g. --locale zh)`)}u=await o()}let x=c?.i18n.defaultLocale??e.locale??u?.[0]??"zh";u=c?.i18n.locales??u??[x],ee(x,u);let M=O({docsDir:g,defaultLocale:x,locales:u,includeContent:!h,includeConfig:!s}),P=[],F=[],D=ie(a,x,g);for(let[o,f]of Object.entries(M)){let w=E(n,o);try{let C=await B(w,"utf8");F.push(o),C!==f&&D.push(`${o} already exists with different content`)}catch(C){let v=C.code;if(v==="EISDIR")throw new Error(`Cannot create ${o} because a directory exists at that path`);if(v!=="ENOENT")throw C;P.push({relativePath:o,content:f,fullPath:w})}}let m={mode:s?"configured":h?"adopt":"create",createFiles:P,keepFiles:F,warnings:D};if(!m.createFiles.length){for(let o of m.warnings)d(`Warning: ${o}`);d(`Canofold is already initialized in ${n}`);return}let L=[],K=t.writeFile??((o,f,w)=>_(o,f,w)),X=[...new Set(m.createFiles.map(o=>W(o.fullPath)))].sort((o,f)=>o.length-f.length),I=[];try{for(let o of X)await re(o,I);for(let o of m.createFiles)await K(o.fullPath,o.content,{flag:"wx"}),L.push(o.fullPath)}catch(o){await Promise.all(L.map(f=>V(f,{force:!0})));for(let f of I.sort((w,C)=>C.length-w.length))try{await Y(f)}catch{}throw o}for(let o of m.createFiles)d(`Created ${o.relativePath}`);for(let o of m.keepFiles)d(`Kept existing ${o}`);for(let o of m.warnings)d(`Warning: ${o}`);if(m.mode==="adopt"){let o=a.length===1?"document":"documents";d(`Adopted ${a.length} existing ${o} in ${n}`),d(`Kept ${a.length} existing ${o} unchanged`),d("Next: canofold check")}else m.mode==="configured"?(d(`Created missing documentation files in ${n}`),d("Next: canofold dev")):(d(`Created Canofold docs in ${n}`),d("Next: canofold dev"));d("Add .canofold/ to .gitignore if this directory is versioned.")}l(xe,"runInit");export{te as promptForLocales,xe as runInit};
+//# sourceMappingURL=init-3PS74OVB.js.map

package/dist/{load-W4JHZIBF.js → load-BG2H2Q65.js}

@@ -1,2 +1,2 @@
-import{i as a,j as b}from"./chunk-4OALGQQB.js";import"./chunk-EAYVCA3Z.js";import"./chunk-JK7ZNBUA.js";import"./chunk-AYDF3IFZ.js";export{a as findConfigPath,b as loadConfig};
-//# sourceMappingURL=load-W4JHZIBF.js.map
+import{k as a,l as b}from"./chunk-ACUMTEQL.js";import"./chunk-EAYVCA3Z.js";import"./chunk-JK7ZNBUA.js";import"./chunk-AYDF3IFZ.js";export{a as findConfigPath,b as loadConfig};
+//# sourceMappingURL=load-BG2H2Q65.js.map

package/dist/playground-client.d.ts

@@ -0,0 +1,17 @@
+import { RenderMarkdownOptions } from '@canofold/markdown';
+
+declare global {
+    interface Window {
+        __canofoldBootstrapMarkdown?: () => Promise<void>;
+        __canofoldEnhanceMarkdown?: (root: ParentNode) => Promise<() => void>;
+        __canofoldMarkdownDispose?: () => void;
+        __canofoldMarkdownReady?: Promise<void>;
+    }
+}
+interface PlaygroundClientOptions {
+    basePath: string;
+    markdown: Omit<RenderMarkdownOptions, 'labels'>;
+}
+declare function mountPlaygrounds(options: PlaygroundClientOptions): void;
+
+export { type PlaygroundClientOptions, mountPlaygrounds };

package/dist/{preview-ODXGCQZ7.js → preview-OAMF5HXH.js}

@@ -1,2 +1,2 @@
-import{a as p}from"./chunk-JZIKHPBO.js";import{j as n}from"./chunk-4OALGQQB.js";import{a}from"./chunk-M6T5RSNJ.js";import"./chunk-EAYVCA3Z.js";import{e as i}from"./chunk-JK7ZNBUA.js";import{a as e}from"./chunk-AYDF3IFZ.js";async function g({cwd:r,port:s=4173}){let t=await n(r),o=await p({root:i(r,t.outputDir),port:s,basePath:t.basePath});return a(`Preview running at http://127.0.0.1:${o.port}${t.basePath}`),o}e(g,"runPreview");export{g as runPreview};
-//# sourceMappingURL=preview-ODXGCQZ7.js.map
+import{a as p}from"./chunk-HS5LEPRC.js";import{l as n}from"./chunk-ACUMTEQL.js";import{a}from"./chunk-M6T5RSNJ.js";import"./chunk-EAYVCA3Z.js";import{e as i}from"./chunk-JK7ZNBUA.js";import{a as e}from"./chunk-AYDF3IFZ.js";async function g({cwd:r,port:s=4173}){let t=await n(r),o=await p({root:i(r,t.outputDir),port:s,basePath:t.basePath});return a(`Preview running at http://127.0.0.1:${o.port}${t.basePath}`),o}e(g,"runPreview");export{g as runPreview};
+//# sourceMappingURL=preview-OAMF5HXH.js.map