@atom63/slides 0.1.0

package/dist/index.js

@@ -0,0 +1,3 @@
+export { Accent, Avatar, Badge, Bleed, Body, BodyLines, Box, CONFIG_GAP_PX, Cell, Center, ClosingSlide, Collage, ColorBlock, Columns, CoverSlide, Demo, Display, Divider, FRAME_PADDING_PX, FigureMark, Fill, FullBleedCoverSlide, FullBleedGallery, FullBleedSlide, Grid, Headline, HeroBento, Highlight, Icon, Image, ImageDuoSlide, ImageSlide, ImageTrioSlide, InlineCode, Item, Label, List, Live, MediaTrio, Mono, Position, Quote, QuoteSlide, QuoteWithMedia, Reveal, Row, SLIDE_FRAME_WATERMARK_PX, Section, SectionMarker, SectionSlide, SlideCodeBlock, SlidePaddingContext, SlideRenderModeContext, SlidesPlayer, Spacer, Split, SplitHalf, SplitWithStat, Stack, StatBento, StatementSlide, Subtitle, Syllabus, SyllabusDetectContext, TYPOGRAPHY_SCALE_VALUES, TalkTrack, TextLead, TimelineBento, Title, Trio, Video, getTemplate, listTemplates, slideMdxComponents, syllabusMdxComponents, templateNames, templateRegistry, useSlideConfig, useSlidePadding, useSlideRenderMode } from './chunk-AD3ZOVWR.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/template-registry-BOJP4rlI.d.ts

@@ -0,0 +1,81 @@
+import { ReactNode, ComponentType } from 'react';
+
+type SlideLayout = 'cover' | 'title' | 'content' | 'split' | 'media-full' | 'quote';
+interface SlideDeckMeta {
+    date: string;
+    description?: string;
+    /**
+     * When `true`, deck requires a password (server env `SLIDE_PASSWORD_<SLUG>`).
+     * Defaults to `false`.
+     */
+    locked?: boolean;
+    preset?: string;
+    /**
+     * Deck theme. `'auto'` (the default) inherits the site theme so the deck
+     * follows the user's current setting. `'dark'` / `'light'` force the canvas
+     * regardless of the site theme.
+     */
+    theme?: 'auto' | 'dark' | 'light';
+    title: string;
+}
+interface SlideDeckItem {
+    content?: ComponentType;
+    meta: SlideDeckMeta;
+    slideCount?: number;
+    slug: string;
+}
+interface ParsedSlide {
+    content: ReactNode[];
+    layout: SlideLayout;
+    notes: ReactNode | null;
+}
+
+/** The kind of fillable content a slot accepts. Layout enums are out of scope. */
+type SlotKind = 'text' | 'richtext' | 'media' | 'list';
+/** A single fillable field — a direct template prop or a compound-slot prop. */
+interface SlotDef {
+    /** Prop name as written in MDX/JSX. */
+    key: string;
+    kind: SlotKind;
+    required: boolean;
+    /** Human-readable label for editor UIs. */
+    label: string;
+    /**
+     * True when the prop is a repeated scalar value that is NOT a compound child
+     * (e.g. ImageTrioSlide.images, ClosingSlide.handles). Repeated compound
+     * children (e.g. HeroBento.Card) are modeled via SlotGroupDef, not this flag.
+     */
+    array?: boolean;
+}
+/** A compound child slot, e.g. `HeroBento.Card`, with cardinality + its own props. */
+interface SlotGroupDef {
+    /** Sub-component name as written after the dot, e.g. "Card" for HeroBento.Card. */
+    name: string;
+    min: number;
+    max: number;
+    props: SlotDef[];
+}
+type TemplateCategory = 'cover' | 'statement' | 'quote' | 'media' | 'gallery' | 'data' | 'split' | 'closing';
+/** Full machine-readable description of one author-facing template. */
+interface TemplateDef {
+    /** Component name as written in MDX, e.g. "HeroBento". */
+    name: string;
+    label: string;
+    category: TemplateCategory;
+    /** Direct props on the template component. */
+    props: SlotDef[];
+    /** Compound child slots; empty for simple templates. */
+    slots: SlotGroupDef[];
+}
+/** Registry of every author-facing template, keyed by component name. */
+declare const templateRegistry: Record<string, TemplateDef>;
+/** Union of every registered template name, derived from the registry. */
+type TemplateName = keyof typeof templateRegistry;
+/** All registered template names. */
+declare const templateNames: readonly TemplateName[];
+/** Look up one template definition by component name. */
+declare function getTemplate(name: string): TemplateDef | undefined;
+/** Every template definition, insertion order. */
+declare function listTemplates(): TemplateDef[];
+
+export { type ParsedSlide as P, type SlideLayout as S, type TemplateCategory as T, type SlideDeckItem as a, type SlideDeckMeta as b, type SlotDef as c, type SlotGroupDef as d, type SlotKind as e, type TemplateDef as f, type TemplateName as g, getTemplate as h, templateRegistry as i, listTemplates as l, templateNames as t };

package/dist/vite/index.d.ts

@@ -0,0 +1,30 @@
+import { Plugin } from 'vite';
+
+interface ManifestConfig {
+    /** Content directory relative to project root */
+    contentDir: string;
+    /** Output manifest file path relative to project root */
+    outputPath: string;
+}
+/**
+ * Vite plugin that extracts slide-deck MDX frontmatter into a static manifest.
+ *
+ * Mirrors the atom63.io plugin: it decouples metadata from MDX module loading
+ * (so Rollup can code-split decks into lazy chunks) and — critically for os63 —
+ * regenerates `manifest.gen.ts` in dev when a deck is added/edited, so new decks
+ * actually surface in the picker. The committed manifest is the build input.
+ */
+declare function mdxManifestPlugin(configs?: ManifestConfig[]): Plugin;
+
+/**
+ * Serve raw `.mdx?raw` imports as plain strings.
+ *
+ * Vite's built-in `?raw` works for most files, but `@mdx-js/rollup` strips the
+ * query and compiles every `.mdx` to a component — so `?raw` would otherwise
+ * yield the compiled module, not the source. This `pre` plugin resolves
+ * `*.mdx?raw` to a virtual id ending in `.raw` (not `.mdx`), which MDX's
+ * extension check skips, then loads the file text for it.
+ */
+declare function mdxRawPlugin(): Plugin;
+
+export { type ManifestConfig, mdxManifestPlugin, mdxRawPlugin };

package/dist/vite/index.js

@@ -0,0 +1,121 @@
+import fs from 'fs';
+import path from 'path';
+import matter from 'gray-matter';
+import fs2 from 'fs/promises';
+
+// src/vite/mdx-manifest-plugin.ts
+var DEFAULT_CONFIGS = [
+  {
+    contentDir: "src/content/slides",
+    outputPath: "src/content/slides/manifest.gen.ts"
+  }
+];
+function extractFrontmatter(filePath) {
+  try {
+    const content = fs.readFileSync(filePath, "utf-8");
+    const { data } = matter(content);
+    return data;
+  } catch {
+    return null;
+  }
+}
+function generateManifest(root, config) {
+  const contentDir = path.resolve(root, config.contentDir);
+  if (!fs.existsSync(contentDir)) {
+    return "// Auto-generated \u2014 no content found\nexport const manifest: Record<string, never> = {}\n";
+  }
+  const entries = [];
+  const topLevel = fs.readdirSync(contentDir).filter((f) => f.endsWith(".mdx"));
+  for (const file of topLevel) {
+    const filePath = path.join(contentDir, file);
+    if (fs.statSync(filePath).isDirectory()) continue;
+    const data = extractFrontmatter(filePath);
+    if (data) {
+      entries.push({ slug: file.replace(".mdx", ""), data });
+    }
+  }
+  const subdirs = fs.readdirSync(contentDir).filter((f) => {
+    const fp = path.join(contentDir, f);
+    return fs.statSync(fp).isDirectory();
+  });
+  for (const subdir of subdirs) {
+    const subdirPath = path.join(contentDir, subdir);
+    const subFiles = fs.readdirSync(subdirPath).filter((f) => f.endsWith(".mdx"));
+    for (const file of subFiles) {
+      const data = extractFrontmatter(path.join(subdirPath, file));
+      if (data) {
+        entries.push({ slug: file.replace(".mdx", ""), data });
+      }
+    }
+  }
+  return [
+    "// Auto-generated by mdx-manifest-plugin \u2014 do not edit manually",
+    `export const manifest = ${JSON.stringify(
+      Object.fromEntries(entries.map((e) => [e.slug, e.data])),
+      null,
+      2
+    )} as const`,
+    ""
+  ].join("\n");
+}
+function mdxManifestPlugin(configs = DEFAULT_CONFIGS) {
+  let root = "";
+  return {
+    name: "mdx-manifest-plugin",
+    configResolved(config) {
+      root = config.root;
+    },
+    buildStart() {
+      for (const config of configs) {
+        const outputPath = path.resolve(root, config.outputPath);
+        const content = generateManifest(root, config);
+        const outputDir = path.dirname(outputPath);
+        if (!fs.existsSync(outputDir)) {
+          fs.mkdirSync(outputDir, { recursive: true });
+        }
+        fs.writeFileSync(outputPath, content, "utf-8");
+      }
+    },
+    // In dev, regenerate the manifest when a deck MDX file changes.
+    handleHotUpdate({ file }) {
+      if (!file.endsWith(".mdx")) return;
+      for (const config of configs) {
+        const contentDir = path.resolve(root, config.contentDir);
+        if (file.startsWith(contentDir)) {
+          const content = generateManifest(root, config);
+          fs.writeFileSync(path.resolve(root, config.outputPath), content, "utf-8");
+        }
+      }
+    }
+  };
+}
+var RAW_MDX = /\.mdx\?raw$/;
+var VIRTUAL_PREFIX = "\0mdx-raw:";
+var VIRTUAL_SUFFIX = ".raw";
+function mdxRawPlugin() {
+  return {
+    name: "mdx-raw",
+    enforce: "pre",
+    async resolveId(id, importer) {
+      if (!RAW_MDX.test(id)) {
+        return null;
+      }
+      const clean = id.replace(/\?raw$/, "");
+      const resolved = await this.resolve(clean, importer, { skipSelf: true });
+      const filePath = resolved?.id ?? clean;
+      return `${VIRTUAL_PREFIX}${filePath}${VIRTUAL_SUFFIX}`;
+    },
+    async load(id) {
+      if (!id.startsWith(VIRTUAL_PREFIX)) {
+        return null;
+      }
+      const filePath = id.slice(VIRTUAL_PREFIX.length, id.length - VIRTUAL_SUFFIX.length);
+      const code = await fs2.readFile(filePath, "utf-8");
+      return { code: `export default ${JSON.stringify(code)}`, map: null };
+    }
+  };
+}
+
+export { mdxManifestPlugin, mdxRawPlugin };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/vite/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/vite/mdx-manifest-plugin.ts","../../src/vite/mdx-raw-plugin.ts"],"names":["fs"],"mappings":"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","file":"index.js","sourcesContent":["import fs from 'node:fs'\nimport path from 'node:path'\nimport matter from 'gray-matter'\nimport type { Plugin } from 'vite'\n\nexport interface ManifestConfig {\n  /** Content directory relative to project root */\n  contentDir: string\n  /** Output manifest file path relative to project root */\n  outputPath: string\n}\n\nconst DEFAULT_CONFIGS: ManifestConfig[] = [\n  {\n    contentDir: 'src/content/slides',\n    outputPath: 'src/content/slides/manifest.gen.ts',\n  },\n]\n\nfunction extractFrontmatter(filePath: string): Record<string, unknown> | null {\n  try {\n    const content = fs.readFileSync(filePath, 'utf-8')\n    const { data } = matter(content)\n    return data\n  } catch {\n    return null\n  }\n}\n\nfunction generateManifest(root: string, config: ManifestConfig): string {\n  const contentDir = path.resolve(root, config.contentDir)\n\n  if (!fs.existsSync(contentDir)) {\n    return '// Auto-generated — no content found\\nexport const manifest: Record<string, never> = {}\\n'\n  }\n\n  const entries: Array<{ slug: string; data: Record<string, unknown> }> = []\n\n  const topLevel = fs.readdirSync(contentDir).filter(f => f.endsWith('.mdx'))\n  for (const file of topLevel) {\n    const filePath = path.join(contentDir, file)\n    if (fs.statSync(filePath).isDirectory()) continue\n    const data = extractFrontmatter(filePath)\n    if (data) {\n      entries.push({ slug: file.replace('.mdx', ''), data })\n    }\n  }\n\n  // Also scan one level of subdirectories for nested content groups.\n  const subdirs = fs.readdirSync(contentDir).filter(f => {\n    const fp = path.join(contentDir, f)\n    return fs.statSync(fp).isDirectory()\n  })\n  for (const subdir of subdirs) {\n    const subdirPath = path.join(contentDir, subdir)\n    const subFiles = fs.readdirSync(subdirPath).filter(f => f.endsWith('.mdx'))\n    for (const file of subFiles) {\n      const data = extractFrontmatter(path.join(subdirPath, file))\n      if (data) {\n        entries.push({ slug: file.replace('.mdx', ''), data })\n      }\n    }\n  }\n\n  return [\n    '// Auto-generated by mdx-manifest-plugin — do not edit manually',\n    `export const manifest = ${JSON.stringify(\n      Object.fromEntries(entries.map(e => [e.slug, e.data])),\n      null,\n      2\n    )} as const`,\n    '',\n  ].join('\\n')\n}\n\n/**\n * Vite plugin that extracts slide-deck MDX frontmatter into a static manifest.\n *\n * Mirrors the atom63.io plugin: it decouples metadata from MDX module loading\n * (so Rollup can code-split decks into lazy chunks) and — critically for os63 —\n * regenerates `manifest.gen.ts` in dev when a deck is added/edited, so new decks\n * actually surface in the picker. The committed manifest is the build input.\n */\nexport function mdxManifestPlugin(configs: ManifestConfig[] = DEFAULT_CONFIGS): Plugin {\n  let root = ''\n\n  return {\n    name: 'mdx-manifest-plugin',\n\n    configResolved(config) {\n      root = config.root\n    },\n\n    buildStart() {\n      for (const config of configs) {\n        const outputPath = path.resolve(root, config.outputPath)\n        const content = generateManifest(root, config)\n        const outputDir = path.dirname(outputPath)\n        if (!fs.existsSync(outputDir)) {\n          fs.mkdirSync(outputDir, { recursive: true })\n        }\n        fs.writeFileSync(outputPath, content, 'utf-8')\n      }\n    },\n\n    // In dev, regenerate the manifest when a deck MDX file changes.\n    handleHotUpdate({ file }) {\n      if (!file.endsWith('.mdx')) return\n      for (const config of configs) {\n        const contentDir = path.resolve(root, config.contentDir)\n        if (file.startsWith(contentDir)) {\n          const content = generateManifest(root, config)\n          fs.writeFileSync(path.resolve(root, config.outputPath), content, 'utf-8')\n        }\n      }\n    },\n  }\n}\n","import fs from 'node:fs/promises'\nimport type { Plugin } from 'vite'\n\nconst RAW_MDX = /\\.mdx\\?raw$/\nconst VIRTUAL_PREFIX = '\\0mdx-raw:'\nconst VIRTUAL_SUFFIX = '.raw'\n\n/**\n * Serve raw `.mdx?raw` imports as plain strings.\n *\n * Vite's built-in `?raw` works for most files, but `@mdx-js/rollup` strips the\n * query and compiles every `.mdx` to a component — so `?raw` would otherwise\n * yield the compiled module, not the source. This `pre` plugin resolves\n * `*.mdx?raw` to a virtual id ending in `.raw` (not `.mdx`), which MDX's\n * extension check skips, then loads the file text for it.\n */\nexport function mdxRawPlugin(): Plugin {\n  return {\n    name: 'mdx-raw',\n    enforce: 'pre',\n    async resolveId(id, importer) {\n      if (!RAW_MDX.test(id)) {\n        return null\n      }\n      const clean = id.replace(/\\?raw$/, '')\n      const resolved = await this.resolve(clean, importer, { skipSelf: true })\n      const filePath = resolved?.id ?? clean\n      return `${VIRTUAL_PREFIX}${filePath}${VIRTUAL_SUFFIX}`\n    },\n    async load(id) {\n      if (!id.startsWith(VIRTUAL_PREFIX)) {\n        return null\n      }\n      const filePath = id.slice(VIRTUAL_PREFIX.length, id.length - VIRTUAL_SUFFIX.length)\n      const code = await fs.readFile(filePath, 'utf-8')\n      return { code: `export default ${JSON.stringify(code)}`, map: null }\n    },\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,139 @@
+{
+  "name": "@atom63/slides",
+  "version": "0.1.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ATOM63/atom63-vite.git",
+    "directory": "packages/slides"
+  },
+  "homepage": "https://github.com/ATOM63/atom63-vite/tree/main/packages/slides#readme",
+  "type": "module",
+  "description": "Host-agnostic MDX slide presentation engine — an opinionated template grammar + token theming for building decks in MDX.",
+  "keywords": [
+    "slides",
+    "presentation",
+    "mdx",
+    "react",
+    "deck",
+    "slideshow",
+    "tailwind",
+    "design-system"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "typescript": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./vite": {
+      "typescript": "./src/vite/index.ts",
+      "types": "./dist/vite/index.d.ts",
+      "import": "./dist/vite/index.js"
+    },
+    "./editor": {
+      "typescript": "./src/editor/index.ts",
+      "types": "./dist/editor/index.d.ts",
+      "import": "./dist/editor/index.js"
+    },
+    "./editor/styles": {
+      "types": "./src/editor/styles.d.ts",
+      "default": "./src/editor/styles.css"
+    },
+    "./styles": {
+      "types": "./src/styles/styles.d.ts",
+      "default": "./src/styles/slides.css"
+    },
+    "./theme-defaults": {
+      "types": "./src/styles/theme-defaults.d.ts",
+      "default": "./src/styles/theme-defaults.css"
+    },
+    "./themes/dark": {
+      "default": "./src/styles/themes/dark.css"
+    },
+    "./themes/terminal": {
+      "default": "./src/styles/themes/terminal.css"
+    },
+    "./themes/editorial": {
+      "default": "./src/styles/themes/editorial.css"
+    },
+    "./themes/neon": {
+      "default": "./src/styles/themes/neon.css"
+    },
+    "./themes/bold": {
+      "default": "./src/styles/themes/bold.css"
+    }
+  },
+  "sideEffects": [
+    "*.css"
+  ],
+  "files": [
+    "dist",
+    "src/styles/slides.css",
+    "src/styles/theme-defaults.css",
+    "src/styles/themes/dark.css",
+    "src/styles/themes/terminal.css",
+    "src/styles/themes/editorial.css",
+    "src/styles/themes/neon.css",
+    "src/styles/themes/bold.css",
+    "src/editor/styles.css",
+    "src/editor/styles.d.ts"
+  ],
+  "dependencies": {
+    "@base-ui/react": "^1.3.0",
+    "@iconify/react": "^6.0.2",
+    "class-variance-authority": "^0.7.1",
+    "@mdx-js/mdx": "^3.1.1",
+    "@mdx-js/react": "^3.1.1",
+    "@tanstack/react-virtual": "^3.14.2",
+    "clsx": "^2.1.1",
+    "gray-matter": "^4.0.3",
+    "js-yaml": "^4.1.0",
+    "lucide-react": "^1.18.0",
+    "motion": "^12.40.0",
+    "remark-gfm": "^4.0.1",
+    "shiki": "^3.23.0",
+    "tailwind-merge": "^3.6.0",
+    "zustand": "^5.0.0"
+  },
+  "peerDependencies": {
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "sonner": "^2.0.7",
+    "vite": "^5 || ^6 || ^7"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.4.6",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.10.0",
+    "@types/react": "^19.1.13",
+    "@types/react-dom": "^19.1.9",
+    "react": "^19.1.1",
+    "react-dom": "^19.1.1",
+    "tsup": "^8.3.5",
+    "typescript": "~5.8.3",
+    "vite": "^7.1.5",
+    "vitest": "^4.1.8",
+    "@atom63/biome-config": "0.1.0",
+    "@atom63/tsconfig": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check ."
+  }
+}

package/src/editor/styles.css

@@ -0,0 +1,206 @@
+/* @atom63/slides/editor — minimal editor chrome.
+ *
+ * Layout only: a two-pane split (preview | source) with a sized preview area
+ * (SlidesPlayer needs an explicit height). Visual theming of the slides
+ * themselves comes from @atom63/slides ("/styles" + "/theme-defaults"), imported
+ * by the host app — NOT here.
+ */
+
+.a63-editor {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) minmax(320px, 0.85fr);
+  gap: 0;
+  width: 100%;
+  height: 100%;
+  min-height: 0;
+  font-family:
+    ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+}
+
+@media (max-width: 880px) {
+  .a63-editor {
+    grid-template-columns: minmax(0, 1fr);
+    grid-template-rows: minmax(240px, 1fr) minmax(0, 1fr);
+  }
+}
+
+/* Preview pane — must give SlidesPlayer a sized container. */
+.a63-editor__preview {
+  position: relative;
+  min-width: 0;
+  min-height: 0;
+  overflow: hidden;
+  border-right: 1px solid rgba(127, 127, 127, 0.18);
+}
+
+.a63-editor__preview-stage {
+  position: absolute;
+  inset: 0;
+}
+
+.a63-editor__preview-empty {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  height: 100%;
+  padding: 2rem;
+  text-align: center;
+  font-size: 0.875rem;
+  opacity: 0.6;
+}
+
+/* Error banner — non-blocking; overlays the top of the preview. */
+.a63-editor__error {
+  position: absolute;
+  top: 0;
+  left: 0;
+  right: 0;
+  z-index: 5;
+  display: flex;
+  gap: 0.5rem;
+  align-items: flex-start;
+  padding: 0.5rem 0.75rem;
+  background: #b91c1c;
+  color: #fff;
+  font-size: 0.78rem;
+  line-height: 1.35;
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.25);
+}
+
+.a63-editor__error-tag {
+  flex: none;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+}
+
+.a63-editor__error-msg {
+  flex: 1;
+  min-width: 0;
+  white-space: pre-wrap;
+  word-break: break-word;
+}
+
+/* Source pane. */
+.a63-editor__source {
+  display: flex;
+  flex-direction: column;
+  min-width: 0;
+  min-height: 0;
+  background: #f6f6f7;
+  color: #1a1a1a;
+}
+
+.a63-editor__toolbar {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 0.75rem;
+  padding: 0.5rem 0.75rem;
+  border-bottom: 1px solid rgba(127, 127, 127, 0.18);
+  flex: none;
+}
+
+.a63-editor__title {
+  font-size: 0.8rem;
+  font-weight: 600;
+  letter-spacing: 0.01em;
+}
+
+.a63-editor__theme-toggle {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.4rem;
+  padding: 0.25rem 0.6rem;
+  border: 1px solid rgba(127, 127, 127, 0.4);
+  border-radius: 999px;
+  background: transparent;
+  color: inherit;
+  font-size: 0.72rem;
+  font-weight: 600;
+  cursor: pointer;
+}
+
+.a63-editor__theme-toggle:hover {
+  background: rgba(127, 127, 127, 0.12);
+}
+
+.a63-editor__textarea {
+  flex: 1;
+  min-height: 0;
+  width: 100%;
+  resize: none;
+  border: 0;
+  padding: 0.75rem;
+  background: transparent;
+  color: inherit;
+  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  font-size: 0.8rem;
+  line-height: 1.55;
+  tab-size: 2;
+  outline: none;
+}
+
+/* Template palette. */
+.a63-editor__palette {
+  flex: none;
+  max-height: 38%;
+  overflow-y: auto;
+  border-top: 1px solid rgba(127, 127, 127, 0.18);
+  padding: 0.5rem 0.75rem 0.75rem;
+}
+
+.a63-editor__palette-label {
+  font-size: 0.7rem;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: 0.06em;
+  opacity: 0.55;
+  margin-bottom: 0.5rem;
+}
+
+.a63-editor__palette-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(120px, 1fr));
+  gap: 0.4rem;
+}
+
+.a63-editor__chip {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 0.1rem;
+  padding: 0.4rem 0.55rem;
+  border: 1px solid rgba(127, 127, 127, 0.3);
+  border-radius: 0.5rem;
+  background: #fff;
+  color: inherit;
+  text-align: left;
+  cursor: pointer;
+  transition:
+    border-color 0.12s ease,
+    transform 0.12s ease;
+}
+
+.a63-editor__chip:hover {
+  border-color: rgba(59, 130, 246, 0.8);
+  transform: translateY(-1px);
+}
+
+.a63-editor__chip-name {
+  font-size: 0.72rem;
+  font-weight: 600;
+}
+
+.a63-editor__chip-meta {
+  font-size: 0.62rem;
+  opacity: 0.55;
+}
+
+.a63-editor__footnote {
+  margin-top: 0.6rem;
+  font-size: 0.62rem;
+  opacity: 0.5;
+  line-height: 1.4;
+}

package/src/editor/styles.d.ts

@@ -0,0 +1 @@
+export {}

package/src/styles/slides.css

@@ -0,0 +1,30 @@
+/* =============================================================================
+   SLIDE REVEAL ANIMATIONS
+   Opt-in entrance animation for slide content. Add class `reveal` and set
+   `--stagger-index` inline style on any element to animate it in when the
+   slide becomes visible. Replays on every slide navigation.
+   ============================================================================= */
+
+@keyframes slide-reveal {
+  from {
+    opacity: 0;
+    transform: translateY(18px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+.reveal {
+  animation: slide-reveal 0.5s cubic-bezier(0.34, 1.56, 0.64, 1) both;
+  animation-delay: calc(var(--stagger-index, 0) * 80ms);
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .reveal {
+    opacity: 1;
+    transform: none;
+    animation: none;
+  }
+}