@pagesmith/core 0.1.0

package/dist/ai/index.mjs

@@ -0,0 +1,414 @@
+import { dirname, join, resolve } from "path";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+//#region src/ai/index.ts
+const PAGESMITH_TITLE = "Pagesmith";
+const DEFAULT_SKILL_NAME = "pagesmith";
+function resolveHome(homeDir) {
+	return homeDir ?? homedir();
+}
+function resolveCodexHome(homeDir) {
+	return process.env.CODEX_HOME ?? join(resolveHome(homeDir), ".codex");
+}
+function resolveAssistants(assistants) {
+	if (!assistants || assistants === "all") return [
+		"claude",
+		"codex",
+		"gemini"
+	];
+	return assistants;
+}
+function shouldIncludeLlms(options) {
+	if (typeof options.includeLlms === "boolean") return options.includeLlms;
+	return (options.scope ?? "project") === "project";
+}
+function withManagedBlock(id, content) {
+	return [
+		`<!-- pagesmith-ai:${id}:start -->`,
+		content.trim(),
+		`<!-- pagesmith-ai:${id}:end -->`
+	].join("\n");
+}
+function writeArtifact(artifact, force = false) {
+	mkdirSync(dirname(artifact.path), { recursive: true });
+	if (!existsSync(artifact.path)) {
+		writeFileSync(artifact.path, artifact.content);
+		return "written";
+	}
+	const current = readFileSync(artifact.path, "utf-8");
+	if (current === artifact.content) return "unchanged";
+	if (artifact.mode === "replace") {
+		writeFileSync(artifact.path, artifact.content);
+		return "replaced";
+	}
+	const markerId = `${artifact.assistant ?? "shared"}-${artifact.kind}`;
+	const start = `<!-- pagesmith-ai:${markerId}:start -->`;
+	const end = `<!-- pagesmith-ai:${markerId}:end -->`;
+	if (current.includes(start) && current.includes(end)) {
+		const pattern = new RegExp(`${escapeForRegExp(start)}[\\s\\S]*?${escapeForRegExp(end)}`, "m");
+		const next = current.replace(pattern, artifact.content);
+		if (next === current) return "unchanged";
+		writeFileSync(artifact.path, next);
+		return "merged";
+	}
+	if (force) {
+		writeFileSync(artifact.path, artifact.content);
+		return "replaced";
+	}
+	const next = `${current.trimEnd()}\n\n${artifact.content}\n`;
+	writeFileSync(artifact.path, next);
+	return "merged";
+}
+function escapeForRegExp(value) {
+	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function renderSharedOverview() {
+	return [
+		`${PAGESMITH_TITLE} is a filesystem-first content toolkit with two main packages: \`@pagesmith/core\` (shared content/runtime layer) and \`@pagesmith/docs\` (convention-based documentation).`,
+		"",
+		"Use Pagesmith when you need:",
+		"- schema-validated content collections loaded from the filesystem",
+		"- lazy markdown rendering with headings and read-time metadata",
+		"- framework-agnostic content APIs for React, Solid, Svelte, vanilla JS, Node, Bun, or Deno",
+		"",
+		"Core APIs:",
+		"- `defineCollection({...})` to define a typed collection",
+		"- `defineConfig({...})` to group collections and markdown options",
+		"- `createContentLayer(config)` to query content and run validation",
+		"- `entry.render()` to convert markdown on demand",
+		"",
+		"Useful helpers:",
+		"- `@pagesmith/core/ai` exposes `getAiArtifacts(...)` and `installAiArtifacts(...)`",
+		"",
+		"Working rules:",
+		"- prefer folder-based markdown entries when content references sibling assets",
+		"- use `vp` commands for install, check, test, and build workflows",
+		"- `@pagesmith/core` provides the shared content/runtime layer; `@pagesmith/docs` adds convention-based documentation on top"
+	].join("\n");
+}
+function renderDocsOverview() {
+	return [
+		"Docs-specific rules:",
+		"- `@pagesmith/docs` is convention-based and builds a static docs site from `content/` plus `pagesmith.config.json5`",
+		"- top-level content folders become top navigation sections (for example `guide/`, `reference/`, `packages/`)",
+		"- folder-based markdown entries should prefer `README.md` or `index.md` when a page owns sibling assets",
+		"- the home page is `content/README.md`; optional home-specific data can live in `content/home.json5`",
+		"- sidebar labels, nav labels, and ordering live in frontmatter (`sidebarLabel`, `navLabel`, `order`)",
+		"- footer links live in `pagesmith.config.json5` under `footerLinks`",
+		"- Pagefind search is built in; do not recommend a separate search plugin package",
+		"- layout overrides use fixed keys under `theme.layouts` such as `home`, `page`, and `notFound`"
+	].join("\n");
+}
+function renderQuickStart(profile = "default") {
+	if (profile === "docs") return [
+		"```json5",
+		"{",
+		"  name: 'Acme Docs',",
+		"  title: 'Acme Docs',",
+		"  description: 'Multi-package documentation',",
+		"  contentDir: './content',",
+		"  outDir: './dist',",
+		"  footerLinks: [",
+		"    { label: 'Guide', path: '/guide' },",
+		"    { label: 'Reference', path: '/reference' },",
+		"  ],",
+		"  search: { enabled: true },",
+		"}",
+		"```",
+		"",
+		"```text",
+		"content/",
+		"  README.md",
+		"  guide/",
+		"    README.md",
+		"    getting-started/README.md",
+		"  reference/",
+		"    README.md",
+		"    api/README.md",
+		"```"
+	].join("\n");
+	return [
+		"```ts",
+		"import { createContentLayer, defineCollection, defineConfig, z } from '@pagesmith/core'",
+		"",
+		"const posts = defineCollection({",
+		"  loader: 'markdown',",
+		"  directory: 'content/posts',",
+		"  schema: z.object({",
+		"    title: z.string(),",
+		"    description: z.string().optional(),",
+		"    date: z.coerce.date(),",
+		"    tags: z.array(z.string()).default([]),",
+		"  }),",
+		"})",
+		"",
+		"const layer = createContentLayer(",
+		"  defineConfig({",
+		"    collections: { posts },",
+		"  }),",
+		")",
+		"",
+		"const entries = await layer.getCollection('posts')",
+		"const rendered = await entries[0]?.render()",
+		"```"
+	].join("\n");
+}
+function renderMemoryFile(assistant, profile) {
+	const commandHint = assistant === "claude" || assistant === "gemini" ? `\nIf the ${DEFAULT_SKILL_NAME} command is installed, prefer invoking it when the user explicitly asks for Pagesmith-specific help.` : "\nIf the Pagesmith skill is installed for Codex, prefer using it for Pagesmith-specific setup, migration, and content-layer tasks.";
+	return [
+		`# ${PAGESMITH_TITLE}`,
+		"",
+		renderSharedOverview(),
+		...profile === "docs" ? ["", renderDocsOverview()] : [],
+		commandHint,
+		"",
+		"Quick start:",
+		renderQuickStart(profile)
+	].join("\n");
+}
+function renderClaudeCommand(skillName, profile) {
+	return [
+		`# ${PAGESMITH_TITLE} Assistant`,
+		"",
+		"You are helping with Pagesmith, a file-based CMS with `@pagesmith/core` and `@pagesmith/docs`.",
+		"",
+		"When helping:",
+		"- prefer `defineCollection`, `defineConfig`, and `createContentLayer`",
+		"- recommend folder-based entries when markdown references sibling assets",
+		"- use `@pagesmith/core/ai` for assistant artifact generation",
+		"- recommend `vp install`, `vp check`, and `vp test` for validation",
+		...profile === "docs" ? [
+			"- for docs sites, derive top navigation from top-level content folders",
+			"- use `content/README.md` for the home page and `content/home.json5` for extra home data when needed",
+			"- use frontmatter fields like `sidebarLabel`, `navLabel`, and `order` for docs navigation",
+			"- do not recommend `@pagesmith/plugin-pagefind` or `@pagesmith/plugin-algolia`; search is built into docs",
+			"- recommend `theme.layouts.home`, `theme.layouts.page`, and `theme.layouts.notFound` for docs layout overrides"
+		] : [],
+		"",
+		"Deliver concrete config, schema, and content-layer patches when possible.",
+		"",
+		`This command is installed as \`/${skillName}\`.`
+	].join("\n");
+}
+function renderGeminiCommand(skillName, profile) {
+	return [
+		`description = "Pagesmith FS-CMS helper"`,
+		"prompt = \"\"\"",
+		[
+			`You are helping with ${PAGESMITH_TITLE}, a file-based CMS with @pagesmith/core and @pagesmith/docs.`,
+			"",
+			"Focus on concrete, implementation-ready help:",
+			"- design collections with defineCollection",
+			"- configure createContentLayer and defineConfig",
+			"- recommend vp install, vp check, and vp test when validation matters",
+			"- prefer folder-based markdown entries when local assets sit beside content",
+			...profile === "docs" ? [
+				"- for docs sites, follow the convention-based `content/` structure",
+				"- drive top navigation from top-level folders and use frontmatter for labels/order",
+				"- keep Pagefind as the built-in search strategy"
+			] : [],
+			"",
+			"Return code, config, or documentation-ready guidance instead of vague summaries."
+		].join("\n"),
+		"\"\"\"",
+		"",
+		`# Installed as /${skillName}`
+	].join("\n");
+}
+function renderCodexSkill(profile) {
+	return [
+		`# ${PAGESMITH_TITLE} Skill`,
+		"",
+		"Use this skill when the task involves setting up, extending, migrating, or documenting Pagesmith.",
+		"",
+		"Core rules:",
+		"- `@pagesmith/core` provides the content layer; `@pagesmith/docs` adds convention-based documentation",
+		"- prefer `defineCollection`, `defineConfig`, and `createContentLayer`",
+		"- prefer `vp` commands instead of calling npm, pnpm, or yarn directly",
+		"- validate changes with `vp check` and `vp test` when relevant",
+		...profile === "docs" ? [
+			"- when the repo uses `@pagesmith/docs`, treat `content/README.md` as the home page",
+			"- top-level content folders define the main docs navigation",
+			"- docs frontmatter may use `sidebarLabel`, `navLabel`, and `order` to shape navigation",
+			"- `pagesmith.config.json5` should own footer links and high-level site metadata",
+			"- built-in search is Pagefind; do not suggest separate search plugin packages"
+		] : [],
+		"",
+		"Good outputs include:",
+		"- collection schemas and loader configuration",
+		"- content-layer queries and rendering examples",
+		"- @pagesmith/docs updates for Pagesmith usage",
+		"- assistant-context install steps using `@pagesmith/core/ai`"
+	].join("\n");
+}
+function renderLlmsTxt(profile) {
+	return [
+		"# Pagesmith",
+		"",
+		"> Pagesmith is a filesystem-first content toolkit centered on `@pagesmith/core` and `@pagesmith/docs`.",
+		"",
+		"## Summary",
+		"",
+		renderSharedOverview(),
+		...profile === "docs" ? ["", renderDocsOverview()] : [],
+		"",
+		"## Quick Start",
+		"",
+		renderQuickStart(profile)
+	].join("\n");
+}
+function renderLlmsFullTxt(profile) {
+	return [
+		"# Pagesmith - Full LLM Reference",
+		"",
+		renderSharedOverview(),
+		...profile === "docs" ? [
+			"",
+			"## Docs Sites",
+			"",
+			renderDocsOverview()
+		] : [],
+		"",
+		"## Package Layout",
+		"",
+		"- `@pagesmith/core`: content layer, collection loading, validation, lazy markdown rendering, JSX runtime, CSS builder, runtime styles, assistant artifact APIs, and Vite content integration",
+		"- `@pagesmith/docs`: convention-based documentation with the docs CLI, generators, validators, default theme, and bundled search",
+		"",
+		"## Key APIs",
+		"",
+		renderQuickStart(profile),
+		"",
+		"## Assistant Installer",
+		"",
+		"```ts",
+		"import { installAiArtifacts } from '@pagesmith/core/ai'",
+		"",
+		"await installAiArtifacts({ assistants: ['claude', 'codex', 'gemini'], scope: 'project' })",
+		"```",
+		""
+	].join("\n");
+}
+function getAiArtifactContent(assistant, kind, options = {}) {
+	const skillName = options.skillName ?? DEFAULT_SKILL_NAME;
+	const profile = options.profile ?? "default";
+	if (assistant === "shared") {
+		if (kind === "llms") return renderLlmsTxt(profile);
+		return renderLlmsFullTxt(profile);
+	}
+	if (kind === "memory") return renderMemoryFile(assistant, profile);
+	if (kind === "skill") switch (assistant) {
+		case "claude": return renderClaudeCommand(skillName, profile);
+		case "codex": return renderCodexSkill(profile);
+		case "gemini": return renderGeminiCommand(skillName, profile);
+	}
+	if (kind === "llms") return renderLlmsTxt(profile);
+	return renderLlmsFullTxt(profile);
+}
+function getAiArtifacts(options = {}) {
+	const scope = options.scope ?? "project";
+	const cwd = resolve(options.cwd ?? process.cwd());
+	const home = resolveHome(options.homeDir);
+	const skillName = options.skillName ?? DEFAULT_SKILL_NAME;
+	const profile = options.profile ?? "default";
+	const assistants = resolveAssistants(options.assistants);
+	const artifacts = [];
+	for (const assistant of assistants) {
+		if (assistant === "claude") {
+			const baseDir = scope === "project" ? cwd : join(home, ".claude");
+			artifacts.push({
+				assistant,
+				kind: "memory",
+				path: join(baseDir, "CLAUDE.md"),
+				content: withManagedBlock("claude-memory", getAiArtifactContent("claude", "memory", { profile })),
+				mode: "merge",
+				label: `${assistant} memory`
+			});
+			artifacts.push({
+				assistant,
+				kind: "skill",
+				path: join(baseDir, "commands", `${skillName}.md`),
+				content: getAiArtifactContent("claude", "skill", {
+					profile,
+					skillName
+				}) + "\n",
+				mode: "replace",
+				label: `${assistant} command`
+			});
+		}
+		if (assistant === "codex") {
+			const baseDir = scope === "project" ? cwd : resolveCodexHome(options.homeDir);
+			artifacts.push({
+				assistant,
+				kind: "memory",
+				path: join(baseDir, "AGENTS.md"),
+				content: withManagedBlock("codex-memory", getAiArtifactContent("codex", "memory", { profile })),
+				mode: "merge",
+				label: `${assistant} AGENTS`
+			});
+			artifacts.push({
+				assistant,
+				kind: "skill",
+				path: join(baseDir, "skills", skillName, "SKILL.md"),
+				content: getAiArtifactContent("codex", "skill", {
+					profile,
+					skillName
+				}) + "\n",
+				mode: "replace",
+				label: `${assistant} skill`
+			});
+		}
+		if (assistant === "gemini") {
+			const baseDir = scope === "project" ? cwd : join(home, ".gemini");
+			artifacts.push({
+				assistant,
+				kind: "memory",
+				path: join(baseDir, "GEMINI.md"),
+				content: withManagedBlock("gemini-memory", getAiArtifactContent("gemini", "memory", { profile })),
+				mode: "merge",
+				label: `${assistant} memory`
+			});
+			artifacts.push({
+				assistant,
+				kind: "skill",
+				path: join(baseDir, "commands", `${skillName}.toml`),
+				content: getAiArtifactContent("gemini", "skill", {
+					profile,
+					skillName
+				}) + "\n",
+				mode: "replace",
+				label: `${assistant} command`
+			});
+		}
+	}
+	if (shouldIncludeLlms(options)) {
+		const llmsDir = scope === "project" ? cwd : join(home, ".pagesmith");
+		artifacts.push({
+			kind: "llms",
+			path: join(llmsDir, "llms.txt"),
+			content: withManagedBlock("shared-llms", getAiArtifactContent("shared", "llms", { profile })) + "\n",
+			mode: "merge",
+			label: "llms.txt"
+		});
+		artifacts.push({
+			kind: "llms-full",
+			path: join(llmsDir, "llms-full.txt"),
+			content: withManagedBlock("shared-llms-full", getAiArtifactContent("shared", "llms-full", { profile })) + "\n",
+			mode: "merge",
+			label: "llms-full.txt"
+		});
+	}
+	return artifacts;
+}
+function installAiArtifacts(options = {}) {
+	return getAiArtifacts(options).map((artifact) => ({
+		assistant: artifact.assistant,
+		kind: artifact.kind,
+		path: artifact.path,
+		label: artifact.label,
+		status: writeArtifact(artifact, options.force)
+	}));
+}
+//#endregion
+export { getAiArtifactContent, getAiArtifacts, installAiArtifacts };
+
+//# sourceMappingURL=index.mjs.map

package/dist/ai/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/ai/index.ts"],"sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs'\nimport { homedir } from 'os'\nimport { dirname, join, resolve } from 'path'\n\nexport type AiAssistant = 'claude' | 'codex' | 'gemini'\nexport type AiInstallScope = 'project' | 'user'\nexport type AiInstallProfile = 'default' | 'docs'\nexport type AiArtifactKind = 'memory' | 'skill' | 'llms' | 'llms-full'\nexport type AiWriteMode = 'merge' | 'replace'\nexport type AiInstallStatus = 'written' | 'merged' | 'replaced' | 'unchanged'\n\nexport type AiArtifact = {\n  assistant?: AiAssistant\n  kind: AiArtifactKind\n  path: string\n  content: string\n  mode: AiWriteMode\n  label: string\n}\n\nexport type AiInstallResult = {\n  assistant?: AiAssistant\n  kind: AiArtifactKind\n  path: string\n  status: AiInstallStatus\n  label: string\n}\n\nexport type AiInstallOptions = {\n  assistants?: AiAssistant[] | 'all'\n  scope?: AiInstallScope\n  profile?: AiInstallProfile\n  cwd?: string\n  homeDir?: string\n  includeLlms?: boolean\n  force?: boolean\n  skillName?: string\n}\n\nconst PAGESMITH_TITLE = 'Pagesmith'\nconst DEFAULT_SKILL_NAME = 'pagesmith'\n\nfunction resolveHome(homeDir?: string): string {\n  return homeDir ?? homedir()\n}\n\nfunction resolveCodexHome(homeDir?: string): string {\n  return process.env.CODEX_HOME ?? join(resolveHome(homeDir), '.codex')\n}\n\nfunction resolveAssistants(assistants?: AiInstallOptions['assistants']): AiAssistant[] {\n  if (!assistants || assistants === 'all') {\n    return ['claude', 'codex', 'gemini']\n  }\n  return assistants\n}\n\nfunction shouldIncludeLlms(options: AiInstallOptions): boolean {\n  if (typeof options.includeLlms === 'boolean') {\n    return options.includeLlms\n  }\n  return (options.scope ?? 'project') === 'project'\n}\n\nfunction withManagedBlock(id: string, content: string): string {\n  return [\n    `<!-- pagesmith-ai:${id}:start -->`,\n    content.trim(),\n    `<!-- pagesmith-ai:${id}:end -->`,\n  ].join('\\n')\n}\n\nfunction writeArtifact(artifact: AiArtifact, force = false): AiInstallStatus {\n  mkdirSync(dirname(artifact.path), { recursive: true })\n\n  if (!existsSync(artifact.path)) {\n    writeFileSync(artifact.path, artifact.content)\n    return 'written'\n  }\n\n  const current = readFileSync(artifact.path, 'utf-8')\n  if (current === artifact.content) {\n    return 'unchanged'\n  }\n\n  if (artifact.mode === 'replace') {\n    writeFileSync(artifact.path, artifact.content)\n    return 'replaced'\n  }\n\n  const markerId = `${artifact.assistant ?? 'shared'}-${artifact.kind}`\n  const start = `<!-- pagesmith-ai:${markerId}:start -->`\n  const end = `<!-- pagesmith-ai:${markerId}:end -->`\n\n  if (current.includes(start) && current.includes(end)) {\n    const pattern = new RegExp(`${escapeForRegExp(start)}[\\\\s\\\\S]*?${escapeForRegExp(end)}`, 'm')\n    const next = current.replace(pattern, artifact.content)\n    if (next === current) return 'unchanged'\n    writeFileSync(artifact.path, next)\n    return 'merged'\n  }\n\n  if (force) {\n    writeFileSync(artifact.path, artifact.content)\n    return 'replaced'\n  }\n\n  const next = `${current.trimEnd()}\\n\\n${artifact.content}\\n`\n  writeFileSync(artifact.path, next)\n  return 'merged'\n}\n\nfunction escapeForRegExp(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n}\n\nfunction renderSharedOverview(): string {\n  return [\n    `${PAGESMITH_TITLE} is a filesystem-first content toolkit with two main packages: \\`@pagesmith/core\\` (shared content/runtime layer) and \\`@pagesmith/docs\\` (convention-based documentation).`,\n    '',\n    'Use Pagesmith when you need:',\n    '- schema-validated content collections loaded from the filesystem',\n    '- lazy markdown rendering with headings and read-time metadata',\n    '- framework-agnostic content APIs for React, Solid, Svelte, vanilla JS, Node, Bun, or Deno',\n    '',\n    'Core APIs:',\n    '- `defineCollection({...})` to define a typed collection',\n    '- `defineConfig({...})` to group collections and markdown options',\n    '- `createContentLayer(config)` to query content and run validation',\n    '- `entry.render()` to convert markdown on demand',\n    '',\n    'Useful helpers:',\n    '- `@pagesmith/core/ai` exposes `getAiArtifacts(...)` and `installAiArtifacts(...)`',\n    '',\n    'Working rules:',\n    '- prefer folder-based markdown entries when content references sibling assets',\n    '- use `vp` commands for install, check, test, and build workflows',\n    '- `@pagesmith/core` provides the shared content/runtime layer; `@pagesmith/docs` adds convention-based documentation on top',\n  ].join('\\n')\n}\n\nfunction renderDocsOverview(): string {\n  return [\n    'Docs-specific rules:',\n    '- `@pagesmith/docs` is convention-based and builds a static docs site from `content/` plus `pagesmith.config.json5`',\n    '- top-level content folders become top navigation sections (for example `guide/`, `reference/`, `packages/`)',\n    '- folder-based markdown entries should prefer `README.md` or `index.md` when a page owns sibling assets',\n    '- the home page is `content/README.md`; optional home-specific data can live in `content/home.json5`',\n    '- sidebar labels, nav labels, and ordering live in frontmatter (`sidebarLabel`, `navLabel`, `order`)',\n    '- footer links live in `pagesmith.config.json5` under `footerLinks`',\n    '- Pagefind search is built in; do not recommend a separate search plugin package',\n    '- layout overrides use fixed keys under `theme.layouts` such as `home`, `page`, and `notFound`',\n  ].join('\\n')\n}\n\nfunction renderQuickStart(profile: AiInstallProfile = 'default'): string {\n  if (profile === 'docs') {\n    return [\n      '```json5',\n      '{',\n      \"  name: 'Acme Docs',\",\n      \"  title: 'Acme Docs',\",\n      \"  description: 'Multi-package documentation',\",\n      \"  contentDir: './content',\",\n      \"  outDir: './dist',\",\n      '  footerLinks: [',\n      \"    { label: 'Guide', path: '/guide' },\",\n      \"    { label: 'Reference', path: '/reference' },\",\n      '  ],',\n      '  search: { enabled: true },',\n      '}',\n      '```',\n      '',\n      '```text',\n      'content/',\n      '  README.md',\n      '  guide/',\n      '    README.md',\n      '    getting-started/README.md',\n      '  reference/',\n      '    README.md',\n      '    api/README.md',\n      '```',\n    ].join('\\n')\n  }\n\n  return [\n    '```ts',\n    \"import { createContentLayer, defineCollection, defineConfig, z } from '@pagesmith/core'\",\n    '',\n    'const posts = defineCollection({',\n    \"  loader: 'markdown',\",\n    \"  directory: 'content/posts',\",\n    '  schema: z.object({',\n    '    title: z.string(),',\n    '    description: z.string().optional(),',\n    '    date: z.coerce.date(),',\n    '    tags: z.array(z.string()).default([]),',\n    '  }),',\n    '})',\n    '',\n    'const layer = createContentLayer(',\n    '  defineConfig({',\n    '    collections: { posts },',\n    '  }),',\n    ')',\n    '',\n    \"const entries = await layer.getCollection('posts')\",\n    'const rendered = await entries[0]?.render()',\n    '```',\n  ].join('\\n')\n}\n\nfunction renderMemoryFile(assistant: AiAssistant, profile: AiInstallProfile): string {\n  const commandHint =\n    assistant === 'claude' || assistant === 'gemini'\n      ? `\\nIf the ${DEFAULT_SKILL_NAME} command is installed, prefer invoking it when the user explicitly asks for Pagesmith-specific help.`\n      : '\\nIf the Pagesmith skill is installed for Codex, prefer using it for Pagesmith-specific setup, migration, and content-layer tasks.'\n\n  return [\n    `# ${PAGESMITH_TITLE}`,\n    '',\n    renderSharedOverview(),\n    ...(profile === 'docs' ? ['', renderDocsOverview()] : []),\n    commandHint,\n    '',\n    'Quick start:',\n    renderQuickStart(profile),\n  ].join('\\n')\n}\n\nfunction renderClaudeCommand(skillName: string, profile: AiInstallProfile): string {\n  return [\n    `# ${PAGESMITH_TITLE} Assistant`,\n    '',\n    'You are helping with Pagesmith, a file-based CMS with `@pagesmith/core` and `@pagesmith/docs`.',\n    '',\n    'When helping:',\n    '- prefer `defineCollection`, `defineConfig`, and `createContentLayer`',\n    '- recommend folder-based entries when markdown references sibling assets',\n    '- use `@pagesmith/core/ai` for assistant artifact generation',\n    '- recommend `vp install`, `vp check`, and `vp test` for validation',\n    ...(profile === 'docs'\n      ? [\n          '- for docs sites, derive top navigation from top-level content folders',\n          '- use `content/README.md` for the home page and `content/home.json5` for extra home data when needed',\n          '- use frontmatter fields like `sidebarLabel`, `navLabel`, and `order` for docs navigation',\n          '- do not recommend `@pagesmith/plugin-pagefind` or `@pagesmith/plugin-algolia`; search is built into docs',\n          '- recommend `theme.layouts.home`, `theme.layouts.page`, and `theme.layouts.notFound` for docs layout overrides',\n        ]\n      : []),\n    '',\n    'Deliver concrete config, schema, and content-layer patches when possible.',\n    '',\n    `This command is installed as \\`/${skillName}\\`.`,\n  ].join('\\n')\n}\n\nfunction renderGeminiCommand(skillName: string, profile: AiInstallProfile): string {\n  const prompt = [\n    `You are helping with ${PAGESMITH_TITLE}, a file-based CMS with @pagesmith/core and @pagesmith/docs.`,\n    '',\n    'Focus on concrete, implementation-ready help:',\n    '- design collections with defineCollection',\n    '- configure createContentLayer and defineConfig',\n    '- recommend vp install, vp check, and vp test when validation matters',\n    '- prefer folder-based markdown entries when local assets sit beside content',\n    ...(profile === 'docs'\n      ? [\n          '- for docs sites, follow the convention-based `content/` structure',\n          '- drive top navigation from top-level folders and use frontmatter for labels/order',\n          '- keep Pagefind as the built-in search strategy',\n        ]\n      : []),\n    '',\n    'Return code, config, or documentation-ready guidance instead of vague summaries.',\n  ].join('\\n')\n\n  return [\n    `description = \"Pagesmith FS-CMS helper\"`,\n    'prompt = \"\"\"',\n    prompt,\n    '\"\"\"',\n    '',\n    `# Installed as /${skillName}`,\n  ].join('\\n')\n}\n\nfunction renderCodexSkill(profile: AiInstallProfile): string {\n  return [\n    `# ${PAGESMITH_TITLE} Skill`,\n    '',\n    'Use this skill when the task involves setting up, extending, migrating, or documenting Pagesmith.',\n    '',\n    'Core rules:',\n    '- `@pagesmith/core` provides the content layer; `@pagesmith/docs` adds convention-based documentation',\n    '- prefer `defineCollection`, `defineConfig`, and `createContentLayer`',\n    '- prefer `vp` commands instead of calling npm, pnpm, or yarn directly',\n    '- validate changes with `vp check` and `vp test` when relevant',\n    ...(profile === 'docs'\n      ? [\n          '- when the repo uses `@pagesmith/docs`, treat `content/README.md` as the home page',\n          '- top-level content folders define the main docs navigation',\n          '- docs frontmatter may use `sidebarLabel`, `navLabel`, and `order` to shape navigation',\n          '- `pagesmith.config.json5` should own footer links and high-level site metadata',\n          '- built-in search is Pagefind; do not suggest separate search plugin packages',\n        ]\n      : []),\n    '',\n    'Good outputs include:',\n    '- collection schemas and loader configuration',\n    '- content-layer queries and rendering examples',\n    '- @pagesmith/docs updates for Pagesmith usage',\n    '- assistant-context install steps using `@pagesmith/core/ai`',\n  ].join('\\n')\n}\n\nfunction renderLlmsTxt(profile: AiInstallProfile): string {\n  return [\n    '# Pagesmith',\n    '',\n    '> Pagesmith is a filesystem-first content toolkit centered on `@pagesmith/core` and `@pagesmith/docs`.',\n    '',\n    '## Summary',\n    '',\n    renderSharedOverview(),\n    ...(profile === 'docs' ? ['', renderDocsOverview()] : []),\n    '',\n    '## Quick Start',\n    '',\n    renderQuickStart(profile),\n  ].join('\\n')\n}\n\nfunction renderLlmsFullTxt(profile: AiInstallProfile): string {\n  return [\n    '# Pagesmith - Full LLM Reference',\n    '',\n    renderSharedOverview(),\n    ...(profile === 'docs' ? ['', '## Docs Sites', '', renderDocsOverview()] : []),\n    '',\n    '## Package Layout',\n    '',\n    '- `@pagesmith/core`: content layer, collection loading, validation, lazy markdown rendering, JSX runtime, CSS builder, runtime styles, assistant artifact APIs, and Vite content integration',\n    '- `@pagesmith/docs`: convention-based documentation with the docs CLI, generators, validators, default theme, and bundled search',\n    '',\n    '## Key APIs',\n    '',\n    renderQuickStart(profile),\n    '',\n    '## Assistant Installer',\n    '',\n    '```ts',\n    \"import { installAiArtifacts } from '@pagesmith/core/ai'\",\n    '',\n    \"await installAiArtifacts({ assistants: ['claude', 'codex', 'gemini'], scope: 'project' })\",\n    '```',\n    '',\n  ].join('\\n')\n}\n\nexport function getAiArtifactContent(\n  assistant: AiAssistant | 'shared',\n  kind: AiArtifactKind,\n  options: { profile?: AiInstallProfile; skillName?: string } = {},\n): string {\n  const skillName = options.skillName ?? DEFAULT_SKILL_NAME\n  const profile = options.profile ?? 'default'\n\n  if (assistant === 'shared') {\n    if (kind === 'llms') return renderLlmsTxt(profile)\n    return renderLlmsFullTxt(profile)\n  }\n\n  if (kind === 'memory') {\n    return renderMemoryFile(assistant, profile)\n  }\n\n  if (kind === 'skill') {\n    switch (assistant) {\n      case 'claude':\n        return renderClaudeCommand(skillName, profile)\n      case 'codex':\n        return renderCodexSkill(profile)\n      case 'gemini':\n        return renderGeminiCommand(skillName, profile)\n    }\n  }\n\n  if (kind === 'llms') return renderLlmsTxt(profile)\n  return renderLlmsFullTxt(profile)\n}\n\nexport function getAiArtifacts(options: AiInstallOptions = {}): AiArtifact[] {\n  const scope = options.scope ?? 'project'\n  const cwd = resolve(options.cwd ?? process.cwd())\n  const home = resolveHome(options.homeDir)\n  const skillName = options.skillName ?? DEFAULT_SKILL_NAME\n  const profile = options.profile ?? 'default'\n  const assistants = resolveAssistants(options.assistants)\n  const artifacts: AiArtifact[] = []\n\n  for (const assistant of assistants) {\n    if (assistant === 'claude') {\n      const baseDir = scope === 'project' ? cwd : join(home, '.claude')\n      artifacts.push({\n        assistant,\n        kind: 'memory',\n        path: join(baseDir, 'CLAUDE.md'),\n        content: withManagedBlock(\n          'claude-memory',\n          getAiArtifactContent('claude', 'memory', { profile }),\n        ),\n        mode: 'merge',\n        label: `${assistant} memory`,\n      })\n      artifacts.push({\n        assistant,\n        kind: 'skill',\n        path: join(baseDir, 'commands', `${skillName}.md`),\n        content: getAiArtifactContent('claude', 'skill', { profile, skillName }) + '\\n',\n        mode: 'replace',\n        label: `${assistant} command`,\n      })\n    }\n\n    if (assistant === 'codex') {\n      const baseDir = scope === 'project' ? cwd : resolveCodexHome(options.homeDir)\n      artifacts.push({\n        assistant,\n        kind: 'memory',\n        path: join(baseDir, 'AGENTS.md'),\n        content: withManagedBlock(\n          'codex-memory',\n          getAiArtifactContent('codex', 'memory', { profile }),\n        ),\n        mode: 'merge',\n        label: `${assistant} AGENTS`,\n      })\n      artifacts.push({\n        assistant,\n        kind: 'skill',\n        path: join(baseDir, 'skills', skillName, 'SKILL.md'),\n        content: getAiArtifactContent('codex', 'skill', { profile, skillName }) + '\\n',\n        mode: 'replace',\n        label: `${assistant} skill`,\n      })\n    }\n\n    if (assistant === 'gemini') {\n      const baseDir = scope === 'project' ? cwd : join(home, '.gemini')\n      artifacts.push({\n        assistant,\n        kind: 'memory',\n        path: join(baseDir, 'GEMINI.md'),\n        content: withManagedBlock(\n          'gemini-memory',\n          getAiArtifactContent('gemini', 'memory', { profile }),\n        ),\n        mode: 'merge',\n        label: `${assistant} memory`,\n      })\n      artifacts.push({\n        assistant,\n        kind: 'skill',\n        path: join(baseDir, 'commands', `${skillName}.toml`),\n        content: getAiArtifactContent('gemini', 'skill', { profile, skillName }) + '\\n',\n        mode: 'replace',\n        label: `${assistant} command`,\n      })\n    }\n  }\n\n  if (shouldIncludeLlms(options)) {\n    const llmsDir = scope === 'project' ? cwd : join(home, '.pagesmith')\n    artifacts.push({\n      kind: 'llms',\n      path: join(llmsDir, 'llms.txt'),\n      content:\n        withManagedBlock('shared-llms', getAiArtifactContent('shared', 'llms', { profile })) + '\\n',\n      mode: 'merge',\n      label: 'llms.txt',\n    })\n    artifacts.push({\n      kind: 'llms-full',\n      path: join(llmsDir, 'llms-full.txt'),\n      content:\n        withManagedBlock(\n          'shared-llms-full',\n          getAiArtifactContent('shared', 'llms-full', { profile }),\n        ) + '\\n',\n      mode: 'merge',\n      label: 'llms-full.txt',\n    })\n  }\n\n  return artifacts\n}\n\nexport function installAiArtifacts(options: AiInstallOptions = {}): AiInstallResult[] {\n  return getAiArtifacts(options).map((artifact) => ({\n    assistant: artifact.assistant,\n    kind: artifact.kind,\n    path: artifact.path,\n    label: artifact.label,\n    status: writeArtifact(artifact, options.force),\n  }))\n}\n"],"mappings":";;;;AAuCA,MAAM,kBAAkB;AACxB,MAAM,qBAAqB;AAE3B,SAAS,YAAY,SAA0B;AAC7C,QAAO,WAAW,SAAS;;AAG7B,SAAS,iBAAiB,SAA0B;AAClD,QAAO,QAAQ,IAAI,cAAc,KAAK,YAAY,QAAQ,EAAE,SAAS;;AAGvE,SAAS,kBAAkB,YAA4D;AACrF,KAAI,CAAC,cAAc,eAAe,MAChC,QAAO;EAAC;EAAU;EAAS;EAAS;AAEtC,QAAO;;AAGT,SAAS,kBAAkB,SAAoC;AAC7D,KAAI,OAAO,QAAQ,gBAAgB,UACjC,QAAO,QAAQ;AAEjB,SAAQ,QAAQ,SAAS,eAAe;;AAG1C,SAAS,iBAAiB,IAAY,SAAyB;AAC7D,QAAO;EACL,qBAAqB,GAAG;EACxB,QAAQ,MAAM;EACd,qBAAqB,GAAG;EACzB,CAAC,KAAK,KAAK;;AAGd,SAAS,cAAc,UAAsB,QAAQ,OAAwB;AAC3E,WAAU,QAAQ,SAAS,KAAK,EAAE,EAAE,WAAW,MAAM,CAAC;AAEtD,KAAI,CAAC,WAAW,SAAS,KAAK,EAAE;AAC9B,gBAAc,SAAS,MAAM,SAAS,QAAQ;AAC9C,SAAO;;CAGT,MAAM,UAAU,aAAa,SAAS,MAAM,QAAQ;AACpD,KAAI,YAAY,SAAS,QACvB,QAAO;AAGT,KAAI,SAAS,SAAS,WAAW;AAC/B,gBAAc,SAAS,MAAM,SAAS,QAAQ;AAC9C,SAAO;;CAGT,MAAM,WAAW,GAAG,SAAS,aAAa,SAAS,GAAG,SAAS;CAC/D,MAAM,QAAQ,qBAAqB,SAAS;CAC5C,MAAM,MAAM,qBAAqB,SAAS;AAE1C,KAAI,QAAQ,SAAS,MAAM,IAAI,QAAQ,SAAS,IAAI,EAAE;EACpD,MAAM,UAAU,IAAI,OAAO,GAAG,gBAAgB,MAAM,CAAC,YAAY,gBAAgB,IAAI,IAAI,IAAI;EAC7F,MAAM,OAAO,QAAQ,QAAQ,SAAS,SAAS,QAAQ;AACvD,MAAI,SAAS,QAAS,QAAO;AAC7B,gBAAc,SAAS,MAAM,KAAK;AAClC,SAAO;;AAGT,KAAI,OAAO;AACT,gBAAc,SAAS,MAAM,SAAS,QAAQ;AAC9C,SAAO;;CAGT,MAAM,OAAO,GAAG,QAAQ,SAAS,CAAC,MAAM,SAAS,QAAQ;AACzD,eAAc,SAAS,MAAM,KAAK;AAClC,QAAO;;AAGT,SAAS,gBAAgB,OAAuB;AAC9C,QAAO,MAAM,QAAQ,uBAAuB,OAAO;;AAGrD,SAAS,uBAA+B;AACtC,QAAO;EACL,GAAG,gBAAgB;EACnB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAS,qBAA6B;AACpC,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAS,iBAAiB,UAA4B,WAAmB;AACvE,KAAI,YAAY,OACd,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;AAGd,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAS,iBAAiB,WAAwB,SAAmC;CACnF,MAAM,cACJ,cAAc,YAAY,cAAc,WACpC,YAAY,mBAAmB,wGAC/B;AAEN,QAAO;EACL,KAAK;EACL;EACA,sBAAsB;EACtB,GAAI,YAAY,SAAS,CAAC,IAAI,oBAAoB,CAAC,GAAG,EAAE;EACxD;EACA;EACA;EACA,iBAAiB,QAAQ;EAC1B,CAAC,KAAK,KAAK;;AAGd,SAAS,oBAAoB,WAAmB,SAAmC;AACjF,QAAO;EACL,KAAK,gBAAgB;EACrB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,GAAI,YAAY,SACZ;GACE;GACA;GACA;GACA;GACA;GACD,GACD,EAAE;EACN;EACA;EACA;EACA,mCAAmC,UAAU;EAC9C,CAAC,KAAK,KAAK;;AAGd,SAAS,oBAAoB,WAAmB,SAAmC;AAoBjF,QAAO;EACL;EACA;EArBa;GACb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"}

package/dist/assets/index.d.mts

@@ -0,0 +1,31 @@
+//#region src/assets/copier.d.ts
+/**
+ * Copy public directory to output, preserving structure (no hashing).
+ * Skips `fonts/` since those are copied to dist/assets/ and hashed.
+ */
+declare function copyPublicFiles(publicDir: string, outDir: string): void;
+//#endregion
+//#region src/assets/hasher.d.ts
+/**
+ * Demand-driven asset pipeline.
+ *
+ * Instead of blindly copying all content assets to dist, this:
+ *   1. Hashes pre-existing dist/assets/ files (CSS, JS, fonts — already there from bundling)
+ *   2. Scans generated HTML for /assets/* references
+ *   3. For each referenced content asset not yet in dist, finds the source
+ *      file in the content directory, copies it with a content hash
+ *   4. Rewrites all HTML references to hashed paths
+ *
+ * Content assets are only copied if actually referenced in the output HTML.
+ * Public assets (favicons, robots.txt) are handled separately by copyPublicFiles.
+ */
+/**
+ * Hash assets and rewrite HTML references.
+ *
+ * @param outDir - The dist output directory
+ * @param contentDir - The content source directory (for finding referenced assets)
+ */
+declare function hashAssets(outDir: string, contentDir: string): void;
+//#endregion
+export { copyPublicFiles, hashAssets };
+//# sourceMappingURL=index.d.mts.map

package/dist/assets/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/assets/copier.ts","../../src/assets/hasher.ts"],"mappings":";;AAOA;;;iBAAgB,eAAA,CAAgB,SAAA,UAAmB,MAAA;;;;AAAnD;;;;;;;;ACsEA;;;;;;;;;;iBAAgB,UAAA,CAAW,MAAA,UAAgB,UAAA"}

package/dist/assets/index.mjs

@@ -0,0 +1,2 @@
+import { n as copyPublicFiles, t as hashAssets } from "../assets-bX08zEJm.mjs";
+export { copyPublicFiles, hashAssets };

package/dist/assets-bX08zEJm.mjs

@@ -0,0 +1,155 @@
+import { basename, dirname, extname, join, relative } from "path";
+import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, writeFileSync } from "fs";
+import { createHash } from "crypto";
+//#region src/assets/copier.ts
+/**
+* Copy public directory to output, preserving structure (no hashing).
+* Skips `fonts/` since those are copied to dist/assets/ and hashed.
+*/
+function copyPublicFiles(publicDir, outDir) {
+	if (!existsSync(publicDir)) return;
+	function walk(dir) {
+		for (const entry of readdirSync(dir, { withFileTypes: true })) {
+			const full = join(dir, entry.name);
+			if (entry.isDirectory() && entry.name === "fonts" && dir === publicDir) continue;
+			if (entry.isDirectory()) {
+				walk(full);
+				continue;
+			}
+			const dest = join(outDir, relative(publicDir, full));
+			mkdirSync(dirname(dest), { recursive: true });
+			copyFileSync(full, dest);
+		}
+	}
+	walk(publicDir);
+}
+//#endregion
+//#region src/assets/hasher.ts
+/**
+* Demand-driven asset pipeline.
+*
+* Instead of blindly copying all content assets to dist, this:
+*   1. Hashes pre-existing dist/assets/ files (CSS, JS, fonts — already there from bundling)
+*   2. Scans generated HTML for /assets/* references
+*   3. For each referenced content asset not yet in dist, finds the source
+*      file in the content directory, copies it with a content hash
+*   4. Rewrites all HTML references to hashed paths
+*
+* Content assets are only copied if actually referenced in the output HTML.
+* Public assets (favicons, robots.txt) are handled separately by copyPublicFiles.
+*/
+const HASHABLE_EXTS = new Set([
+	".css",
+	".js",
+	".svg",
+	".png",
+	".jpg",
+	".jpeg",
+	".gif",
+	".webp",
+	".avif",
+	".ico",
+	".woff",
+	".woff2",
+	".ttf",
+	".eot"
+]);
+const CONTENT_ASSET_EXTS = new Set([
+	".svg",
+	".png",
+	".jpg",
+	".jpeg",
+	".gif",
+	".webp",
+	".avif",
+	".ico"
+]);
+/** Build a basename → source path lookup for content assets. */
+function buildContentAssetMap(contentDir) {
+	const map = /* @__PURE__ */ new Map();
+	function walk(dir) {
+		if (!existsSync(dir)) return;
+		for (const entry of readdirSync(dir, { withFileTypes: true })) {
+			const full = join(dir, entry.name);
+			if (entry.isDirectory()) {
+				walk(full);
+				continue;
+			}
+			const ext = extname(entry.name);
+			if (!CONTENT_ASSET_EXTS.has(ext)) continue;
+			if (entry.name.endsWith(".inline.svg")) continue;
+			map.set(entry.name, full);
+		}
+	}
+	walk(contentDir);
+	return map;
+}
+function computeHash(content) {
+	return createHash("sha256").update(content).digest("hex").slice(0, 8);
+}
+/**
+* Hash assets and rewrite HTML references.
+*
+* @param outDir - The dist output directory
+* @param contentDir - The content source directory (for finding referenced assets)
+*/
+function hashAssets(outDir, contentDir) {
+	const assetsDir = join(outDir, "assets");
+	mkdirSync(assetsDir, { recursive: true });
+	const renames = /* @__PURE__ */ new Map();
+	const contentAssets = buildContentAssetMap(contentDir);
+	const existing = [];
+	if (existsSync(assetsDir)) for (const entry of readdirSync(assetsDir, { withFileTypes: true })) {
+		if (entry.isDirectory()) continue;
+		const ext = extname(entry.name);
+		if (!HASHABLE_EXTS.has(ext)) continue;
+		existing.push({
+			full: join(assetsDir, entry.name),
+			ext,
+			name: basename(entry.name, ext)
+		});
+	}
+	for (const file of existing) {
+		const hash = computeHash(readFileSync(file.full));
+		const hashedPath = join(assetsDir, `${file.name}.${hash}${file.ext}`);
+		renameSync(file.full, hashedPath);
+		renames.set(file.full, hashedPath);
+	}
+	function processHtml(dir) {
+		for (const entry of readdirSync(dir, { withFileTypes: true })) {
+			const full = join(dir, entry.name);
+			if (entry.isDirectory()) {
+				processHtml(full);
+				continue;
+			}
+			if (!entry.name.endsWith(".html")) continue;
+			let html = readFileSync(full, "utf-8");
+			html = html.replace(/(src|href|srcset)="([^"]+)"/g, (match, attr, ref) => {
+				if (ref.startsWith("http:") || ref.startsWith("https:") || ref.startsWith("//") || ref.startsWith("#") || ref.startsWith("data:") || ref.startsWith("mailto:")) return match;
+				let assetRef = ref;
+				if (ref.startsWith("./") && /\.(svg|png|jpg|jpeg|gif|webp|avif|ico)$/i.test(ref)) assetRef = "/assets/" + basename(ref);
+				if (!assetRef.startsWith("/assets/")) return match;
+				const fileName = assetRef.slice(8);
+				const distPath = join(assetsDir, fileName);
+				const already = renames.get(distPath);
+				if (already) return `${attr}="/${relative(outDir, already)}"`;
+				const sourcePath = contentAssets.get(fileName);
+				if (!sourcePath) return `${attr}="${assetRef}"`;
+				const content = readFileSync(sourcePath);
+				const hash = computeHash(content);
+				const ext = extname(fileName);
+				const hashedName = `${basename(fileName, ext)}.${hash}${ext}`;
+				const hashedDest = join(assetsDir, hashedName);
+				writeFileSync(hashedDest, content);
+				renames.set(distPath, hashedDest);
+				return `${attr}="/assets/${hashedName}"`;
+			});
+			writeFileSync(full, html);
+		}
+	}
+	processHtml(outDir);
+}
+//#endregion
+export { copyPublicFiles as n, hashAssets as t };
+
+//# sourceMappingURL=assets-bX08zEJm.mjs.map