create-meith 0.21.2 → 0.22.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-meith",
-  "version": "0.21.2",
-  "description": "Scaffold a Meith board — npx create-meith <name> writes a workspace that depends on @meith/web and @meith/cli.",
+  "version": "0.22.0",
+  "description": "Scaffold a Meith board, plugin or theme — npx create-meith <name> writes a deployable board workspace; --plugin and --theme write extension workspaces built on the published kits.",
   "license": "MIT",
   "repository": {
     "type": "git",

package/src/bin.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { run } from './cli'
 
-const result = await run(process.argv.slice(2), '0.21.2')
+const result = await run(process.argv.slice(2), '0.22.0')
 for (const line of result.lines) {
   if (result.code === 0) console.log(line)
   else console.error(line)

package/src/cli.ts

@@ -4,6 +4,12 @@ import { dirname, join, resolve } from 'node:path'
 import { promisify } from 'node:util'
 
 import { DEFAULT_REPOSITORY_URL, nextSteps, scaffold, validateName } from './scaffold'
+import {
+  type ExtensionKind,
+  extensionNextSteps,
+  scaffoldExtension,
+  validateExtensionName,
+} from './scaffold-extension'
 
 const execFileAsync = promisify(execFile)
 
@@ -46,21 +52,37 @@ export async function run(argv: readonly string[], version: string): Promise<Cli
     return {
       code: 0,
       lines: [
-        'create-meith — scaffold a forum project.',
+        'create-meith — scaffold a forum project, a plugin or a theme.',
         '',
         '  npx create-meith <name> [--repo <url>] [--no-git]',
+        '  npx create-meith --plugin <name> [--repo <url>] [--no-git]',
+        '  npx create-meith --theme <name> [--repo <url>] [--no-git]',
         '',
-        'Writes package.json, community.config.ts, .env.example, .gitignore and',
-        'README.md into ./<name>, then tells you what to run.',
+        'The first form writes a deployable board into ./<name>, then tells you',
+        'what to run. --plugin and --theme write an extension workspace instead:',
+        'source and a passing test copied from the meith repository’s worked',
+        'examples, plus a README and a marketplace listing.json.',
         '',
         '--no-git skips initializing a git repository in the new directory.',
       ],
     }
   }
 
-  const invalid = validateName(name)
+  const wantsPlugin = argv.includes('--plugin')
+  const wantsTheme = argv.includes('--theme')
+  if (wantsPlugin && wantsTheme) {
+    return {
+      code: 1,
+      lines: ['create-meith: --plugin and --theme are two different scaffolds — pass one.'],
+    }
+  }
+  const kind: ExtensionKind | null = wantsPlugin ? 'plugin' : wantsTheme ? 'theme' : null
+  const usage =
+    kind === null ? 'Usage: npx create-meith <name>' : `Usage: npx create-meith --${kind} <name>`
+
+  const invalid = kind === null ? validateName(name) : validateExtensionName(name)
   if (invalid !== null) {
-    return { code: 1, lines: [`create-meith: ${invalid}`, '', 'Usage: npx create-meith <name>'] }
+    return { code: 1, lines: [`create-meith: ${invalid}`, '', usage] }
   }
 
   const repoIndex = argv.indexOf('--repo')
@@ -78,7 +100,14 @@ export async function run(argv: readonly string[], version: string): Promise<Cli
     }
   }
 
-  const files = scaffold({ name, version, repositoryUrl })
+  const files =
+    kind === null
+      ? scaffold({ name, version, repositoryUrl })
+      : scaffoldExtension(kind, {
+          name,
+          version,
+          repositoryUrl: repoIndex === -1 ? undefined : repositoryUrl,
+        })
   for (const [relative, contents] of files) {
     const path = join(target, relative)
     await mkdir(dirname(path), { recursive: true })
@@ -92,7 +121,7 @@ export async function run(argv: readonly string[], version: string): Promise<Cli
     lines: [
       `Created ${name} — ${files.size} files.`,
       '',
-      ...nextSteps(name).map((step) => `  ${step}`),
+      ...(kind === null ? nextSteps(name) : extensionNextSteps(name)).map((step) => `  ${step}`),
       '',
       ...(gitReady
         ? [
@@ -112,9 +141,16 @@ export async function run(argv: readonly string[], version: string): Promise<Cli
             '  git push -u origin main',
           ]),
       '',
-      'Then set DATABASE_URL, AUTH_SECRET and TICK_SECRET and deploy.',
-      'Something must run the tick every minute — the worker process, or',
-      '`community task:run`. Without it nothing catches up, and nothing errors.',
+      ...(kind === null
+        ? [
+            'Then set DATABASE_URL, AUTH_SECRET and TICK_SECRET and deploy.',
+            'Something must run the tick every minute — the worker process, or',
+            '`community task:run`. Without it nothing catches up, and nothing errors.',
+          ]
+        : [
+            `Then follow README.md — it walks through running the ${kind} inside a`,
+            'scaffolded board and submitting it to the meith.dev marketplace.',
+          ]),
     ],
   }
 }

package/src/extension-templates.ts

@@ -0,0 +1,43 @@
+// biome-ignore-all lint/suspicious/noTemplateCurlyInString: template contents are emitted into scaffolded files verbatim, never interpolated here
+import type { ExtensionTemplate } from './scaffold-extension'
+
+export const PLUGIN_TEMPLATES: readonly ExtensionTemplate[] = [
+  {
+    path: 'src/plugin.tsx',
+    contents:
+      "import { definePlugin } from '@meith/plugin-kit'\n\nexport const __MEITH_EXTENSION_CAMEL__Plugin = definePlugin({\n  key: '__MEITH_EXTENSION_KEY__',\n  name: '__MEITH_EXTENSION_TITLE__',\n  version: '0.1.0',\n  description:\n    'A plugin scaffolded by create-meith: a footer link, a greeting ' +\n    'on the board index, one setting, one migration, one task and an admin page.',\n  apiVersion: '0',\n\n  settings: [\n    {\n      key: 'greeting',\n      label: 'Greeting',\n      default: 'A greeting from the __MEITH_EXTENSION_TITLE__ plugin!',\n      description: 'Shown on the status page under Admin → Plugins → __MEITH_EXTENSION_TITLE__.',\n    },\n  ],\n\n  migrations: [\n    {\n      id: '0001_create_wave_table',\n      statements: [\n        `create table if not exists plugin___MEITH_EXTENSION_SNAKE___wave (\n           id integer generated by default as identity primary key,\n           waved_at timestamptz not null default now()\n         )`,\n      ],\n    },\n  ],\n\n  tasks: [\n    {\n      id: 'wave',\n      intervalSeconds: 3600,\n      run: (context) => {\n        context.logger.info('__MEITH_EXTENSION_KEY__ plugin: waving', {\n          greeting: context.settings.greeting,\n        })\n      },\n    },\n  ],\n\n  adminPages: [\n    {\n      path: 'status',\n      title: '__MEITH_EXTENSION_TITLE__ plugin',\n      render: (context) => (\n        <div className=\"flex flex-col gap-2 text-sm\">\n          <p>{String(context.settings.greeting)}</p>\n          <p className=\"text-muted-foreground\">\n            This page is rendered by the plugin itself. Edit the greeting on the plugin&rsquo;s\n            settings screen and reload to see the resolved value arrive in{' '}\n            <code className=\"text-xs\">context.settings</code>.\n          </p>\n        </div>\n      ),\n    },\n  ],\n\n  contributions: [\n    {\n      region: 'index.footer',\n      render: (context) => (\n        <p className=\"text-xs text-muted-foreground\" data-plugin=\"__MEITH_EXTENSION_KEY__\">\n          {context.viewer.isGuest\n            ? 'Greetings, guest — this line comes from the __MEITH_EXTENSION_TITLE__ plugin.'\n            : 'Greetings, member — this line comes from the __MEITH_EXTENSION_TITLE__ plugin.'}\n        </p>\n      ),\n    },\n  ],\n\n  hooks: {\n    'view.footer': (footer) => ({\n      ...footer,\n      links: [\n        ...footer.links,\n        {\n          label: '__MEITH_EXTENSION_TITLE__ plugin',\n          href: '__MEITH_EXTENSION_REPOSITORY__',\n        },\n      ],\n    }),\n\n    'post.created': () => {},\n  },\n})\n",
+  },
+  {
+    path: 'src/plugin.test.ts',
+    contents:
+      "import { describe, expect, it } from 'vitest'\n\nimport { type FilterHandler, unavailableHookRuntime } from '@meith/plugin-kit'\n\nimport { __MEITH_EXTENSION_CAMEL__Plugin } from './plugin'\n\ndescribe('the __MEITH_EXTENSION_KEY__ plugin', () => {\n  it('has a validated manifest (definePlugin threw at import time otherwise)', () => {\n    expect(__MEITH_EXTENSION_CAMEL__Plugin.key).toBe('__MEITH_EXTENSION_KEY__')\n    expect(__MEITH_EXTENSION_CAMEL__Plugin.version).toBe('0.1.0')\n  })\n\n  it('appends its footer link without disturbing the board’s own', () => {\n    const filter = __MEITH_EXTENSION_CAMEL__Plugin.hooks?.['view.footer'] as FilterHandler<'view.footer'>\n    const footer = {\n      boardTitle: 'A board',\n      links: [{ label: 'Contact', href: '/contact' }],\n      timezoneLabel: 'Europe/Dublin',\n    }\n\n    const filtered = filter(\n      footer,\n      { userId: null, isGuest: true, requestId: null },\n      unavailableHookRuntime('this test drives the filter directly'),\n    )\n\n    expect(filtered).toMatchObject({\n      boardTitle: 'A board',\n      links: [\n        { label: 'Contact', href: '/contact' },\n        { label: '__MEITH_EXTENSION_TITLE__ plugin', href: expect.stringContaining('__MEITH_EXTENSION_REPOSITORY__') },\n      ],\n    })\n    expect(footer.links).toHaveLength(1)\n  })\n})\n",
+  },
+]
+
+export const THEME_TEMPLATES: readonly ExtensionTemplate[] = [
+  {
+    path: 'src/index.ts',
+    contents:
+      "export { __MEITH_EXTENSION_CAMEL__Theme } from './theme'\nexport { BROWSER_THEME_COLOR, DARK_TOKENS, LIGHT_TOKENS } from './tokens'\n",
+  },
+  {
+    path: 'src/theme.ts',
+    contents:
+      "import { defaultTheme } from '@meith/theme-default'\nimport { defineTheme } from '@meith/theme-kit'\n\nimport { Footer } from './slots/footer'\n\nexport const __MEITH_EXTENSION_CAMEL__Theme = defineTheme({\n  key: '__MEITH_EXTENSION_KEY__',\n  title: '__MEITH_EXTENSION_TITLE__',\n  extends: defaultTheme,\n  slots: { Footer },\n})\n",
+  },
+  {
+    path: 'src/tokens.ts',
+    contents:
+      "import { DARK_TOKENS as DEFAULT_DARK, LIGHT_TOKENS as DEFAULT_LIGHT } from '@meith/theme-default'\n\nexport const LIGHT_TOKENS: Record<string, string> = {\n  ...DEFAULT_LIGHT,\n  primary: 'oklch(0.49 0.19 300)',\n  'primary-hover': 'oklch(0.42 0.17 300)',\n  ring: 'oklch(0.49 0.19 300)',\n}\n\nexport const DARK_TOKENS: Record<string, string> = {\n  ...DEFAULT_DARK,\n  primary: 'oklch(0.78 0.12 300)',\n  'primary-foreground': 'oklch(0.18 0.03 300)',\n  'primary-hover': 'oklch(0.84 0.11 300)',\n  ring: 'oklch(0.78 0.12 300)',\n}\n\nexport { BROWSER_THEME_COLOR } from '@meith/theme-default'\n",
+  },
+  {
+    path: 'src/slots/footer.tsx',
+    contents:
+      'import type { FooterModel } from \'@meith/theme-kit\'\n\nexport function Footer({ boardTitle, links, timezoneLabel, poweredBy }: FooterModel) {\n  return (\n    <footer className="mt-auto border-t-2 border-primary bg-card">\n      <div className="mx-auto flex w-full max-w-5xl flex-col items-center gap-2 px-4 py-6 text-center text-xs text-muted-foreground">\n        <span className="font-semibold uppercase tracking-widest text-foreground">\n          {boardTitle}\n        </span>\n\n        {links.length > 0 && (\n          <nav aria-label="Footer" className="flex flex-wrap justify-center gap-x-4 gap-y-1">\n            {links.map((link) => (\n              <a\n                key={link.href}\n                href={link.href}\n                className="underline decoration-primary underline-offset-2 hover:text-foreground"\n              >\n                {link.label}\n              </a>\n            ))}\n          </nav>\n        )}\n\n        <span>\n          Times are shown in {timezoneLabel}\n          {poweredBy && (\n            <>\n              {\' — \'}\n              <a\n                href={poweredBy.href}\n                className="underline decoration-primary underline-offset-2 hover:text-foreground"\n              >\n                {poweredBy.label}\n              </a>\n            </>\n          )}\n        </span>\n      </div>\n    </footer>\n  )\n}\n',
+  },
+  {
+    path: 'src/theme.test.ts',
+    contents:
+      "import { describe, expect, it } from 'vitest'\n\nimport { defaultTheme, TOKEN_NAMES } from '@meith/theme-default'\nimport { assertThemeContract, resolveTheme } from '@meith/theme-kit'\n\nimport { __MEITH_EXTENSION_CAMEL__Theme } from './theme'\nimport { DARK_TOKENS, LIGHT_TOKENS } from './tokens'\n\ndescribe('the __MEITH_EXTENSION_KEY__ theme', () => {\n  it('satisfies the theme-kit contract', () => {\n    expect(assertThemeContract(resolveTheme(__MEITH_EXTENSION_CAMEL__Theme)).missing).toEqual([])\n  })\n\n  it('inherits from the default theme rather than copying it', () => {\n    expect(resolveTheme(__MEITH_EXTENSION_CAMEL__Theme).chain).toEqual(['__MEITH_EXTENSION_KEY__', 'default'])\n  })\n\n  it('overrides exactly one slot: the footer', () => {\n    expect(Object.keys(__MEITH_EXTENSION_CAMEL__Theme.slots)).toEqual(['Footer'])\n    expect(__MEITH_EXTENSION_CAMEL__Theme.slots.Footer).not.toBe(defaultTheme.slots.Footer)\n  })\n\n  it('declares a value for every token the theme layer names', () => {\n    for (const name of TOKEN_NAMES) {\n      expect(LIGHT_TOKENS[name], `light ${name}`).toBeDefined()\n      expect(DARK_TOKENS[name], `dark ${name}`).toBeDefined()\n    }\n  })\n\n  it('recolours the brand group and nothing greyscale', () => {\n    expect(LIGHT_TOKENS.primary).not.toBe(DARK_TOKENS.primary)\n    expect(LIGHT_TOKENS.background).toBe('oklch(0.968 0 0)')\n    expect(DARK_TOKENS.background).toBe('oklch(0.15 0 0)')\n  })\n})\n",
+  },
+]

package/src/index.ts

@@ -14,3 +14,15 @@ export {
   VERCEL_PROMPTED_ENV,
   validateName,
 } from './scaffold'
+export {
+  EXTENSION_KEY_PATTERN,
+  type ExtensionKind,
+  type ExtensionScaffoldOptions,
+  type ExtensionTemplate,
+  extensionNextSteps,
+  meithRange,
+  scaffoldExtension,
+  scaffoldPlugin,
+  scaffoldTheme,
+  validateExtensionName,
+} from './scaffold-extension'

package/src/scaffold-extension.ts

@@ -0,0 +1,372 @@
+import { PLUGIN_TEMPLATES, THEME_TEMPLATES } from './extension-templates'
+
+export type ExtensionKind = 'plugin' | 'theme'
+
+export interface ExtensionTemplate {
+  readonly path: string
+  readonly contents: string
+}
+
+export interface ExtensionScaffoldOptions {
+  readonly name: string
+  readonly version: string
+  readonly repositoryUrl?: string | undefined
+}
+
+export const EXTENSION_KEY_PATTERN = /^[a-z][a-z0-9-]{1,39}$/
+
+export function validateExtensionName(name: string): string | null {
+  if (name === '') return 'An extension name is required.'
+  if (!EXTENSION_KEY_PATTERN.test(name)) {
+    return (
+      'Use lower-case letters, digits and hyphens, starting with a letter, 2 to 40 characters — ' +
+      'the name becomes the definePlugin/defineTheme key and the npm package name.'
+    )
+  }
+  return null
+}
+
+export function extensionTitle(name: string): string {
+  return name
+    .split('-')
+    .filter((word) => word !== '')
+    .map((word) => `${word[0]?.toUpperCase() ?? ''}${word.slice(1)}`)
+    .join(' ')
+}
+
+export function extensionCamel(name: string): string {
+  const words = name.split('-').filter((word) => word !== '')
+  const [head, ...rest] = words
+  return `${head ?? ''}${rest
+    .map((word) => `${word[0]?.toUpperCase() ?? ''}${word.slice(1)}`)
+    .join('')}`
+}
+
+export function extensionSnake(name: string): string {
+  return name.replace(/-/g, '_')
+}
+
+export function defaultExtensionRepositoryUrl(name: string): string {
+  return `https://github.com/your-name/${name}`
+}
+
+export function meithRange(version: string): string {
+  const [major = '0', minor = '0'] = version.split('.')
+  return `>=${major}.${minor} <${Number(major) + 1}`
+}
+
+function substitute(
+  contents: string,
+  values: { key: string; title: string; camel: string; snake: string; repositoryUrl: string },
+): string {
+  return contents
+    .replaceAll('__MEITH_EXTENSION_CAMEL__', values.camel)
+    .replaceAll('__MEITH_EXTENSION_SNAKE__', values.snake)
+    .replaceAll('__MEITH_EXTENSION_REPOSITORY__', values.repositoryUrl)
+    .replaceAll('__MEITH_EXTENSION_KEY__', values.key)
+    .replaceAll('__MEITH_EXTENSION_TITLE__', values.title)
+}
+
+function extensionManifest(
+  options: ExtensionScaffoldOptions,
+  repositoryUrl: string,
+  description: string,
+  dependencies: Record<string, string>,
+): string {
+  return `${JSON.stringify(
+    {
+      name: options.name,
+      version: '0.1.0',
+      description,
+      license: 'MIT',
+      repository: { type: 'git', url: repositoryUrl },
+      type: 'module',
+      main: './src/index.ts',
+      types: './src/index.ts',
+      files: ['src', '!src/**/*.test.*'],
+      scripts: { test: 'vitest run', typecheck: 'tsc --noEmit' },
+      dependencies,
+      peerDependencies: { react: '^19.2.0' },
+      devDependencies: {
+        '@types/node': '^26.2.0',
+        '@types/react': '^19.2.18',
+        react: '^19.2.0',
+        typescript: '^7.0.2',
+        vitest: '^4.1.10',
+      },
+      publishConfig: { access: 'public' },
+    },
+    null,
+    2,
+  )}\n`
+}
+
+function extensionTsconfig(): string {
+  return `${JSON.stringify(
+    {
+      compilerOptions: {
+        target: 'es2022',
+        lib: ['es2022', 'dom'],
+        module: 'esnext',
+        moduleResolution: 'bundler',
+        jsx: 'react-jsx',
+        strict: true,
+        resolveJsonModule: true,
+        skipLibCheck: true,
+        noEmit: true,
+      },
+      include: ['src'],
+    },
+    null,
+    2,
+  )}\n`
+}
+
+function extensionVitestConfig(): string {
+  return `import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: { environment: 'node' },
+})
+`
+}
+
+function extensionGitignore(): string {
+  return `node_modules
+*.log
+.DS_Store
+`
+}
+
+function listing(
+  options: ExtensionScaffoldOptions,
+  kind: ExtensionKind,
+  repositoryUrl: string,
+  description: string,
+): string {
+  return `${JSON.stringify(
+    {
+      key: options.name,
+      kind,
+      package: options.name,
+      name: extensionTitle(options.name),
+      description,
+      screenshots: [`${options.name}-light.png`],
+      version: '0.1.0',
+      apiVersion: 0,
+      meith: meithRange(options.version),
+      repository: repositoryUrl,
+      licence: 'MIT',
+    },
+    null,
+    2,
+  )}\n`
+}
+
+function pluginReadme(options: ExtensionScaffoldOptions, camel: string, title: string): string {
+  const { name } = options
+  return `# ${title}
+
+A Meith plugin, scaffolded by \`create-meith\` from the meith repository's
+\`examples/hello-plugin\`: a footer link, a greeting on the board index, one
+setting, one migration, one task and an admin page — every extension point
+exercised once, each easy to delete.
+
+## Develop
+
+    npm install
+    npm test
+
+\`src/plugin.tsx\` is the plugin. What a plugin may and may not do is
+documented in the meith repository under \`docs/customization/plugins.md\`;
+every hook and payload is listed in \`docs/reference/plugin-hooks.md\`.
+
+## Run it inside a board
+
+Scaffold a board next to this directory if you do not have one
+(\`npx create-meith my-board\`), then install this workspace into it by path:
+
+    cd ../my-board
+    npm install ../${name}
+
+npm installs a local directory as a symlink, so edits here are picked up by
+the board's next build without reinstalling.
+
+Register the plugin in the board's \`community.plugins.ts\` — the comment at
+the top of that file shows the shape:
+
+    import { messages as ${camel}Messages, plugin as ${camel}Plugin } from '${name}'
+
+    export const INSTALLED_PLUGINS: readonly InstalledPlugin[] = [
+      { key: '${name}', enabled: true, plugin: ${camel}Plugin, messages: ${camel}Messages },
+    ]
+
+and add the matching entry to \`board.plugins.json\`:
+
+    { "plugins": [{ "key": "${name}", "package": "${name}", "enabled": true }] }
+
+Rebuild the board (\`npm run build\`) and, because this plugin ships a
+migration, run \`npx community migrate\`. The plugin then appears under
+**Admin → Plugins**.
+
+## Publish and list it
+
+\`npm publish\` ships \`src/\` as TypeScript source, the way every
+\`@meith/*\` package ships. To offer the plugin on the meith.dev marketplace,
+finish \`listing.json\` (its \`repository\` field starts as a placeholder),
+add the screenshot it names, and open a pull request against the meith
+repository — the submission process and the review bar are documented there
+in \`docs/customization/marketplace.md\`.
+`
+}
+
+function themeReadme(options: ExtensionScaffoldOptions, camel: string, title: string): string {
+  const { name } = options
+  return `# ${title}
+
+A Meith theme, scaffolded by \`create-meith\` from the meith repository's
+\`examples/iris-theme\`: the default theme recoloured (one brand group of
+tokens) plus a single slot override, the footer.
+
+## Develop
+
+    npm install
+    npm test
+
+\`src/theme.ts\` declares the theme, \`src/tokens.ts\` carries the palette,
+and slots live in \`src/slots/\`. What a theme may and may not do is
+documented in the meith repository under \`docs/customization/themes.md\`;
+every slot and view model is listed in \`docs/reference/theme-slots.md\`.
+
+## Run it inside a board
+
+Scaffold a board next to this directory if you do not have one
+(\`npx create-meith my-board\`), then install this workspace into it by path:
+
+    cd ../my-board
+    npm install ../${name}
+
+npm installs a local directory as a symlink, so edits here are picked up by
+the board's next build without reinstalling.
+
+Register the theme in the board's \`community.config.ts\`, beside the
+default entry:
+
+    import { defaultMessages } from '@meith/theme-default'
+    import { BROWSER_THEME_COLOR, DARK_TOKENS, LIGHT_TOKENS, ${camel}Theme } from '${name}'
+
+    themes: {
+      '${name}': {
+        key: '${name}',
+        title: '${title}',
+        tokens: { light: LIGHT_TOKENS, dark: DARK_TOKENS },
+        browserThemeColor: BROWSER_THEME_COLOR,
+        theme: ${camel}Theme,
+        messages: defaultMessages,
+      },
+    },
+
+Rebuild the board (\`npm run build\`); the theme is then offered to members
+on the appearance screen and to administrators under **Admin → Themes**.
+
+## Publish and list it
+
+\`npm publish\` ships \`src/\` as TypeScript source, the way every
+\`@meith/*\` package ships. To offer the theme on the meith.dev marketplace,
+finish \`listing.json\` (its \`repository\` field starts as a placeholder),
+add the screenshot it names, and open a pull request against the meith
+repository — the submission process and the review bar are documented there
+in \`docs/customization/marketplace.md\`.
+`
+}
+
+export function scaffoldPlugin(options: ExtensionScaffoldOptions): ReadonlyMap<string, string> {
+  const key = options.name
+  const title = extensionTitle(key)
+  const camel = extensionCamel(key)
+  const snake = extensionSnake(key)
+  const repositoryUrl = options.repositoryUrl ?? defaultExtensionRepositoryUrl(key)
+  const description = `${title} — a Meith plugin.`
+
+  const files = new Map<string, string>()
+
+  files.set(
+    'package.json',
+    extensionManifest(options, repositoryUrl, description, {
+      '@meith/plugin-kit': options.version,
+    }),
+  )
+  files.set('tsconfig.json', extensionTsconfig())
+  files.set('vitest.config.ts', extensionVitestConfig())
+  files.set('.gitignore', extensionGitignore())
+  files.set('README.md', pluginReadme(options, camel, title))
+  files.set('listing.json', listing(options, 'plugin', repositoryUrl, description))
+
+  files.set(
+    'src/index.ts',
+    `export { ${camel}Plugin, ${camel}Plugin as plugin } from './plugin'
+export { ${camel}Messages, ${camel}Messages as messages } from './messages'
+`,
+  )
+  files.set(
+    'src/messages/index.ts',
+    `import en from './en.json'
+
+export const ${camel}Messages = { en }
+`,
+  )
+  files.set('src/messages/en.json', '{}\n')
+
+  for (const template of PLUGIN_TEMPLATES) {
+    files.set(
+      template.path,
+      substitute(template.contents, { key, title, camel, snake, repositoryUrl }),
+    )
+  }
+
+  return files
+}
+
+export function scaffoldTheme(options: ExtensionScaffoldOptions): ReadonlyMap<string, string> {
+  const key = options.name
+  const title = extensionTitle(key)
+  const camel = extensionCamel(key)
+  const snake = extensionSnake(key)
+  const repositoryUrl = options.repositoryUrl ?? defaultExtensionRepositoryUrl(key)
+  const description = `${title} — a Meith theme.`
+
+  const files = new Map<string, string>()
+
+  files.set(
+    'package.json',
+    extensionManifest(options, repositoryUrl, description, {
+      '@meith/theme-default': options.version,
+      '@meith/theme-kit': options.version,
+    }),
+  )
+  files.set('tsconfig.json', extensionTsconfig())
+  files.set('vitest.config.ts', extensionVitestConfig())
+  files.set('.gitignore', extensionGitignore())
+  files.set('README.md', themeReadme(options, camel, title))
+  files.set('listing.json', listing(options, 'theme', repositoryUrl, description))
+
+  for (const template of THEME_TEMPLATES) {
+    files.set(
+      template.path,
+      substitute(template.contents, { key, title, camel, snake, repositoryUrl }),
+    )
+  }
+
+  return files
+}
+
+export function scaffoldExtension(
+  kind: ExtensionKind,
+  options: ExtensionScaffoldOptions,
+): ReadonlyMap<string, string> {
+  return kind === 'plugin' ? scaffoldPlugin(options) : scaffoldTheme(options)
+}
+
+export function extensionNextSteps(name: string): readonly string[] {
+  return [`cd ${name}`, 'npm install', 'npm test']
+}