@hoardodile/create-plugin 0.0.0

package/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2026 Wooloo <ayan0312000@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
+LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,34 @@
+# @hoardodile/create-plugin
+
+Interactive scaffolder for hoardodile content plugins. Copies the
+embedded template (kept in sync with `plugins/template` — CI checks for
+drift), rewrites the manifest with a fresh UUID, rewires dependency
+specs, installs, validates the result, and prints the dev-loop entry
+points.
+
+## Usage
+
+```bash
+# installs the published @hoardodile/* SDK packages from npm
+create-hoardodile-plugin my-plugin
+
+# pre-release / offline: consume the packed tarballs instead
+create-hoardodile-plugin my-plugin --tarballs ../hoardodile/tmp/sdks
+```
+
+## What you get
+
+A complete plugin directory: `manifest.json` (fresh UUID — never ship
+the template's id), `src/main.ts` (`definePlugin` with `detect` +
+`sourceMeta`), `src/render.tsx` (`createPluginRoot` + typed API pair),
+`src/shared.ts` (the `PluginSchema` declared once), `testdata/` and
+Vitest unit tests against `createResourceAPIFixture`.
+
+```bash
+cd my-plugin
+pnpm dev      # watch-build + workbench at http://127.0.0.1:5199
+pnpm test     # unit tests against the fixture API
+pnpm build    # dist/ — zip its contents (manifest at the zip root) and upload
+```
+
+MIT License.

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+declare function main(): Promise<void>;
+
+export { main };

package/dist/index.js

@@ -0,0 +1,236 @@
+#!/usr/bin/env node
+import { spawn } from 'child_process';
+import { readFileSync, existsSync, readdirSync, mkdirSync, cpSync, writeFileSync } from 'fs';
+import { resolve, dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { log, intro, text, isCancel, cancel, confirm, outro } from '@clack/prompts';
+import { pluginManifest } from '@hoardodile/sdk-types/schema';
+
+// src/sdk-deps.gen.ts
+var SDK_DEP_NAMES = [
+  "@hoardodile/cli",
+  "@hoardodile/host",
+  "@hoardodile/host-web",
+  "@hoardodile/i18n",
+  "@hoardodile/sdk-react",
+  "@hoardodile/sdk-server",
+  "@hoardodile/sdk-types",
+  "@hoardodile/sdk-web",
+  "@hoardodile/ui",
+  "@hoardodile/workbench"
+];
+
+// src/rewrite.ts
+var THIRD_PARTY_VERSIONS = {
+  "@types/node": "^26.2.0",
+  "@types/react": "^19.2.18",
+  "@types/react-dom": "^19.2.4",
+  jsdom: "^30.0.1",
+  react: "^19.2.8",
+  "react-dom": "^19.2.8",
+  typescript: "^7.0.2",
+  vite: "^8.2.2",
+  vitest: "^4.1.11"
+};
+function rewriteManifest(manifest, pluginName) {
+  manifest.id = crypto.randomUUID();
+  manifest.name = pluginName;
+  manifest.description = `Content plugin: ${pluginName}`;
+  if (manifest.i18n?.name !== void 0) {
+    manifest.i18n.name.en = pluginName;
+  }
+  if (manifest.i18n?.description !== void 0) {
+    manifest.i18n.description.en = `Content plugin: ${pluginName}`;
+  }
+  manifest.version = "0.0.1";
+  return manifest;
+}
+function tarballSpec(tarballsDir, dep, version) {
+  const fileName = dep.replace("@", "").replace("/", "-");
+  return `file:${join(tarballsDir, `${fileName}-${version}.tgz`).replaceAll("\\", "/")}`;
+}
+function rewriteDepBlock(deps, tarballsDir, sdkVersion) {
+  const out = { ...deps };
+  for (const [dep, spec] of Object.entries(out)) {
+    if (SDK_DEP_NAMES.includes(dep)) {
+      out[dep] = tarballsDir !== void 0 ? tarballSpec(tarballsDir, dep, sdkVersion) : (
+        // `^0.2.0-alpha.3` would never match the 0.2.0 stable
+        // release (semver keeps prereleases out of plain ranges),
+        // so npm specs drop the prerelease suffix.
+        `^${sdkVersion.split("-")[0]}`
+      );
+    } else if (spec === "catalog:") {
+      const version = THIRD_PARTY_VERSIONS[dep];
+      if (version === void 0) {
+        throw new Error(
+          `template dependency "${dep}" has no concrete version mapping`
+        );
+      }
+      out[dep] = version;
+    }
+  }
+  return out;
+}
+function rewritePackageJson(pkg, pluginName, opts) {
+  pkg.name = pluginName;
+  delete pkg.version;
+  pkg.version = "0.0.1";
+  if (pkg.dependencies !== void 0) {
+    pkg.dependencies = rewriteDepBlock(
+      pkg.dependencies,
+      opts.tarballsDir,
+      opts.sdkVersion
+    );
+  }
+  if (pkg.devDependencies !== void 0) {
+    pkg.devDependencies = rewriteDepBlock(
+      pkg.devDependencies,
+      opts.tarballsDir,
+      opts.sdkVersion
+    );
+  }
+  return pkg;
+}
+var ALLOWED_BUILDS = [
+  "@derhuerst/ffprobe-static",
+  "@hoardodile/7z-bin",
+  "ffmpeg-static"
+];
+function tarballOverridesYaml(tarballsDir, sdkVersion) {
+  const lines = SDK_DEP_NAMES.map(
+    (dep) => `  '${dep}': '${tarballSpec(tarballsDir, dep, sdkVersion)}'`
+  ).join("\n");
+  const builds = ALLOWED_BUILDS.map((dep) => `  '${dep}': true`).join("\n");
+  return [
+    "# Redirect the cross-SDK 0.0.0 specs packed into the tarballs to the",
+    "# sibling tarballs in this workspace; approve the install scripts of",
+    "# host's optional binaries (ffmpeg/ffprobe/7-Zip) so pnpm runs them.",
+    "overrides:",
+    lines,
+    "allowBuilds:",
+    builds,
+    ""
+  ].join("\n");
+}
+
+// src/index.ts
+var ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+var TEMPLATE_DIR = resolve(
+  dirname(fileURLToPath(import.meta.url)),
+  "template"
+);
+var SELF_VERSION = JSON.parse(
+  readFileSync(join(ROOT, "package.json"), "utf8")
+).version;
+function writeJson(path, value) {
+  writeFileSync(path, `${JSON.stringify(value, null, "	")}
+`);
+}
+function writeTarballOverrides(targetDir, tarballsDir) {
+  writeFileSync(
+    join(targetDir, "pnpm-workspace.yaml"),
+    tarballOverridesYaml(tarballsDir, SELF_VERSION)
+  );
+}
+async function runInstall(targetDir) {
+  log.step("Installing dependencies (pnpm install)");
+  return new Promise((resolveDone, reject) => {
+    const child = spawn("pnpm", ["install"], {
+      cwd: targetDir,
+      stdio: "inherit",
+      shell: process.platform === "win32"
+    });
+    child.on("error", reject);
+    child.on(
+      "exit",
+      (code) => code === 0 ? resolveDone() : reject(new Error(`pnpm install exited ${code}`))
+    );
+  });
+}
+async function main() {
+  const positional = process.argv.slice(2).filter((a) => !a.startsWith("--"));
+  const tarballsFlag = process.argv.indexOf("--tarballs");
+  const tarballsDir = tarballsFlag !== -1 ? resolve(process.argv[tarballsFlag + 1] ?? "") : void 0;
+  intro("hoardodile plugin scaffold");
+  const providedName = positional[0];
+  const pluginName = providedName ?? await text({
+    message: "Plugin name (also the directory name, npm-style):",
+    validate: (v) => /^[a-z0-9][a-z0-9-]*$/.test(v ?? "") ? void 0 : "lowercase letters, digits and dashes only"
+  });
+  if (isCancel(pluginName)) {
+    cancel("scaffold cancelled");
+    process.exit(1);
+  }
+  const targetDir = resolve(pluginName);
+  if (existsSync(targetDir) && readdirSync(targetDir).length > 0) {
+    const proceed = await confirm({
+      message: `${targetDir} is not empty \u2014 scaffold into it anyway?`,
+      initialValue: false
+    });
+    if (isCancel(proceed) || !proceed) {
+      cancel("scaffold cancelled");
+      process.exit(1);
+    }
+  }
+  log.step(`Copying template into ${targetDir}`);
+  mkdirSync(targetDir, { recursive: true });
+  cpSync(TEMPLATE_DIR, targetDir, { recursive: true });
+  log.step("Rewriting manifest and package.json");
+  const manifestPath = join(targetDir, "manifest.json");
+  const pkgPath = join(targetDir, "package.json");
+  writeJson(
+    manifestPath,
+    rewriteManifest(JSON.parse(readFileSync(manifestPath, "utf8")), pluginName)
+  );
+  writeJson(
+    pkgPath,
+    rewritePackageJson(JSON.parse(readFileSync(pkgPath, "utf8")), pluginName, {
+      tarballsDir,
+      sdkVersion: SELF_VERSION
+    })
+  );
+  const parsed = pluginManifest.safeParse(
+    JSON.parse(readFileSync(manifestPath, "utf8"))
+  );
+  if (!parsed.success) {
+    process.exitCode = 1;
+    log.error(`generated manifest is invalid: ${parsed.error.message}`);
+    return;
+  }
+  if (tarballsDir !== void 0) {
+    log.step(`Rewiring SDK deps to tarballs in ${tarballsDir}`);
+    writeTarballOverrides(targetDir, tarballsDir);
+  }
+  try {
+    await runInstall(targetDir);
+  } catch (err) {
+    process.exitCode = 1;
+    log.error(
+      `install failed: ${err instanceof Error ? err.message : String(err)}`
+    );
+    return;
+  }
+  outro("Plugin scaffolded. Next steps:");
+  console.log(`  cd ${targetDir}`);
+  console.log(
+    "  pnpm build          # build dist/ (client + server bundle + manifest)"
+  );
+  console.log(
+    "  pnpm dev            # watch-build + serve the workbench (http://127.0.0.1:5199)"
+  );
+  console.log("  pnpm test           # unit tests against the fixture API");
+  console.log("  hoardodile plugin run detect testdata --plugin-dir dist");
+  console.log(
+    "  # Replace the manifest id? No \u2014 it was generated fresh. Zip dist/ contents and upload in Settings \u2192 Plugins."
+  );
+}
+if (process.argv[1] !== void 0 && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  main().catch((err) => {
+    log.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  });
+}
+
+export { main };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sdk-deps.gen.ts","../src/rewrite.ts","../src/index.ts"],"names":["join"],"mappings":"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","file":"index.js","sourcesContent":["// GENERATED by scripts/gen-sdk-deps.mjs — never hand-edit.\n// The published SDK closure a scaffolded plugin can depend on; kept in\n// lockstep with scripts/lib/sdk-closure.mjs (see sdks:pack).\nexport const SDK_DEP_NAMES: readonly string[] = [\n\t\"@hoardodile/cli\",\n\t\"@hoardodile/host\",\n\t\"@hoardodile/host-web\",\n\t\"@hoardodile/i18n\",\n\t\"@hoardodile/sdk-react\",\n\t\"@hoardodile/sdk-server\",\n\t\"@hoardodile/sdk-types\",\n\t\"@hoardodile/sdk-web\",\n\t\"@hoardodile/ui\",\n\t\"@hoardodile/workbench\",\n]\n","/**\n * Scaffold-time rewrites applied to the embedded template copy: fresh\n * manifest identity and concrete dependency specs (the template uses\n * `workspace:*` / `catalog:` which only resolve inside the monorepo).\n */\nimport { join } from \"node:path\"\nimport { SDK_DEP_NAMES } from \"./sdk-deps.gen.ts\"\n\n/** Concrete versions for the catalog: specs the template uses. */\nexport const THIRD_PARTY_VERSIONS: Readonly<Record<string, string>> = {\n\t\"@types/node\": \"^26.2.0\",\n\t\"@types/react\": \"^19.2.18\",\n\t\"@types/react-dom\": \"^19.2.4\",\n\tjsdom: \"^30.0.1\",\n\treact: \"^19.2.8\",\n\t\"react-dom\": \"^19.2.8\",\n\ttypescript: \"^7.0.2\",\n\tvite: \"^8.2.2\",\n\tvitest: \"^4.1.11\",\n}\n\nexport type ManifestShape = {\n\tid: string\n\tname: string\n\tdescription: string\n\tversion: string\n\ti18n?: {\n\t\tname?: Record<string, string>\n\t\tdescription?: Record<string, string>\n\t}\n}\n\nexport function rewriteManifest(\n\tmanifest: ManifestShape,\n\tpluginName: string,\n): ManifestShape {\n\tmanifest.id = crypto.randomUUID()\n\tmanifest.name = pluginName\n\tmanifest.description = `Content plugin: ${pluginName}`\n\tif (manifest.i18n?.name !== undefined) {\n\t\tmanifest.i18n.name.en = pluginName\n\t}\n\tif (manifest.i18n?.description !== undefined) {\n\t\tmanifest.i18n.description.en = `Content plugin: ${pluginName}`\n\t}\n\tmanifest.version = \"0.0.1\"\n\treturn manifest\n}\n\nexport type PackageJson = {\n\tname: string\n\tversion?: string\n\tdependencies?: Record<string, string>\n\tdevDependencies?: Record<string, string>\n}\n\nexport function tarballSpec(\n\ttarballsDir: string,\n\tdep: string,\n\tversion: string,\n): string {\n\tconst fileName = dep.replace(\"@\", \"\").replace(\"/\", \"-\")\n\treturn `file:${join(tarballsDir, `${fileName}-${version}.tgz`).replaceAll(\"\\\\\", \"/\")}`\n}\n\nfunction rewriteDepBlock(\n\tdeps: Record<string, string> | undefined,\n\ttarballsDir: string | undefined,\n\tsdkVersion: string,\n): Record<string, string> {\n\tconst out = { ...deps }\n\tfor (const [dep, spec] of Object.entries(out)) {\n\t\tif (SDK_DEP_NAMES.includes(dep)) {\n\t\t\tout[dep] =\n\t\t\t\ttarballsDir !== undefined\n\t\t\t\t\t? tarballSpec(tarballsDir, dep, sdkVersion)\n\t\t\t\t\t: // `^0.2.0-alpha.3` would never match the 0.2.0 stable\n\t\t\t\t\t\t// release (semver keeps prereleases out of plain ranges),\n\t\t\t\t\t\t// so npm specs drop the prerelease suffix.\n\t\t\t\t\t\t`^${sdkVersion.split(\"-\")[0]}`\n\t\t} else if (spec === \"catalog:\") {\n\t\t\tconst version = THIRD_PARTY_VERSIONS[dep]\n\t\t\tif (version === undefined) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`template dependency \"${dep}\" has no concrete version mapping`,\n\t\t\t\t)\n\t\t\t}\n\t\t\tout[dep] = version\n\t\t}\n\t}\n\treturn out\n}\n\nexport function rewritePackageJson(\n\tpkg: PackageJson,\n\tpluginName: string,\n\topts: { readonly tarballsDir?: string; readonly sdkVersion: string },\n): PackageJson {\n\tpkg.name = pluginName\n\tdelete pkg.version\n\tpkg.version = \"0.0.1\"\n\tif (pkg.dependencies !== undefined) {\n\t\tpkg.dependencies = rewriteDepBlock(\n\t\t\tpkg.dependencies,\n\t\t\topts.tarballsDir,\n\t\t\topts.sdkVersion,\n\t\t)\n\t}\n\tif (pkg.devDependencies !== undefined) {\n\t\tpkg.devDependencies = rewriteDepBlock(\n\t\t\tpkg.devDependencies,\n\t\t\topts.tarballsDir,\n\t\t\topts.sdkVersion,\n\t\t)\n\t}\n\treturn pkg\n}\n\n/**\n * Install-script dependencies that land in a scaffolded plugin through\n * host's optionalDependencies (the same names as the root workspace's\n * allowBuilds). pnpm refuses to run their build scripts without an\n * explicit approval, so the generated workspace approves them up front.\n */\nconst ALLOWED_BUILDS = [\n\t\"@derhuerst/ffprobe-static\",\n\t\"@hoardodile/7z-bin\",\n\t\"ffmpeg-static\",\n]\n\nexport function tarballOverridesYaml(\n\ttarballsDir: string,\n\tsdkVersion: string,\n): string {\n\tconst lines = SDK_DEP_NAMES.map(\n\t\t(dep) => `  '${dep}': '${tarballSpec(tarballsDir, dep, sdkVersion)}'`,\n\t).join(\"\\n\")\n\tconst builds = ALLOWED_BUILDS.map((dep) => `  '${dep}': true`).join(\"\\n\")\n\treturn [\n\t\t\"# Redirect the cross-SDK 0.0.0 specs packed into the tarballs to the\",\n\t\t\"# sibling tarballs in this workspace; approve the install scripts of\",\n\t\t\"# host's optional binaries (ffmpeg/ffprobe/7-Zip) so pnpm runs them.\",\n\t\t\"overrides:\",\n\t\tlines,\n\t\t\"allowBuilds:\",\n\t\tbuilds,\n\t\t\"\",\n\t].join(\"\\n\")\n}\n","#!/usr/bin/env node\n/**\n * `create-hoardodile-plugin` — scaffold a new content plugin from the\n * embedded template copy (`src/template/`, kept in sync with\n * `plugins/template` by scripts/sync-template.mjs).\n *\n * Flow: interactive prompts (name, id auto-generated) → copy template →\n * rewrite manifest + package.json → install dependencies → validate the\n * manifest → print the dev loop entry points.\n *\n *   create-hoardodile-plugin my-plugin\n *   create-hoardodile-plugin my-plugin --tarballs ../hoardodile/tmp/sdks\n *\n * `--tarballs <dir>` rewires the SDK deps to packed tarballs plus a\n * pnpm-workspace.yaml with the cross-package overrides — the supported\n * way to consume the SDK before (and instead of) npm publication.\n */\nimport { spawn } from \"node:child_process\"\nimport {\n\tcpSync,\n\texistsSync,\n\tmkdirSync,\n\treaddirSync,\n\treadFileSync,\n\twriteFileSync,\n} from \"node:fs\"\nimport { dirname, join, resolve } from \"node:path\"\nimport { fileURLToPath } from \"node:url\"\nimport {\n\tcancel,\n\tconfirm,\n\tintro,\n\tisCancel,\n\tlog,\n\toutro,\n\ttext,\n} from \"@clack/prompts\"\nimport { pluginManifest } from \"@hoardodile/sdk-types/schema\"\nimport {\n\trewriteManifest,\n\trewritePackageJson,\n\ttarballOverridesYaml,\n} from \"./rewrite.ts\"\n\nconst ROOT = resolve(dirname(fileURLToPath(import.meta.url)), \"..\")\n// The template ships inside dist (dist/template) — the bin always runs\n// from the built artifact, so resolve relative to this module.\nconst TEMPLATE_DIR = resolve(\n\tdirname(fileURLToPath(import.meta.url)),\n\t\"template\",\n)\nconst SELF_VERSION = JSON.parse(\n\treadFileSync(join(ROOT, \"package.json\"), \"utf8\"),\n).version\n\nfunction writeJson(path: string, value: unknown): void {\n\twriteFileSync(path, `${JSON.stringify(value, null, \"\\t\")}\\n`)\n}\n\nfunction writeTarballOverrides(targetDir: string, tarballsDir: string): void {\n\twriteFileSync(\n\t\tjoin(targetDir, \"pnpm-workspace.yaml\"),\n\t\ttarballOverridesYaml(tarballsDir, SELF_VERSION),\n\t)\n}\n\nasync function runInstall(targetDir: string): Promise<void> {\n\tlog.step(\"Installing dependencies (pnpm install)\")\n\treturn new Promise<void>((resolveDone, reject) => {\n\t\tconst child = spawn(\"pnpm\", [\"install\"], {\n\t\t\tcwd: targetDir,\n\t\t\tstdio: \"inherit\",\n\t\t\tshell: process.platform === \"win32\",\n\t\t})\n\t\tchild.on(\"error\", reject)\n\t\tchild.on(\"exit\", (code) =>\n\t\t\tcode === 0\n\t\t\t\t? resolveDone()\n\t\t\t\t: reject(new Error(`pnpm install exited ${code}`)),\n\t\t)\n\t})\n}\n\nexport async function main() {\n\tconst positional = process.argv.slice(2).filter((a) => !a.startsWith(\"--\"))\n\tconst tarballsFlag = process.argv.indexOf(\"--tarballs\")\n\tconst tarballsDir =\n\t\ttarballsFlag !== -1\n\t\t\t? resolve(process.argv[tarballsFlag + 1] ?? \"\")\n\t\t\t: undefined\n\n\tintro(\"hoardodile plugin scaffold\")\n\n\tconst providedName = positional[0]\n\tconst pluginName =\n\t\tprovidedName ??\n\t\t(await text({\n\t\t\tmessage: \"Plugin name (also the directory name, npm-style):\",\n\t\t\tvalidate: (v) =>\n\t\t\t\t/^[a-z0-9][a-z0-9-]*$/.test(v ?? \"\")\n\t\t\t\t\t? undefined\n\t\t\t\t\t: \"lowercase letters, digits and dashes only\",\n\t\t}))\n\tif (isCancel(pluginName)) {\n\t\tcancel(\"scaffold cancelled\")\n\t\tprocess.exit(1)\n\t}\n\n\tconst targetDir = resolve(pluginName)\n\tif (existsSync(targetDir) && readdirSync(targetDir).length > 0) {\n\t\tconst proceed = await confirm({\n\t\t\tmessage: `${targetDir} is not empty — scaffold into it anyway?`,\n\t\t\tinitialValue: false,\n\t\t})\n\t\tif (isCancel(proceed) || !proceed) {\n\t\t\tcancel(\"scaffold cancelled\")\n\t\t\tprocess.exit(1)\n\t\t}\n\t}\n\n\tlog.step(`Copying template into ${targetDir}`)\n\tmkdirSync(targetDir, { recursive: true })\n\t// dist/template is a build artifact (already filtered when copied in);\n\t// copy it wholesale so template source dirs inside it survive.\n\tcpSync(TEMPLATE_DIR, targetDir, { recursive: true })\n\n\tlog.step(\"Rewriting manifest and package.json\")\n\tconst manifestPath = join(targetDir, \"manifest.json\")\n\tconst pkgPath = join(targetDir, \"package.json\")\n\twriteJson(\n\t\tmanifestPath,\n\t\trewriteManifest(JSON.parse(readFileSync(manifestPath, \"utf8\")), pluginName),\n\t)\n\twriteJson(\n\t\tpkgPath,\n\t\trewritePackageJson(JSON.parse(readFileSync(pkgPath, \"utf8\")), pluginName, {\n\t\t\ttarballsDir,\n\t\t\tsdkVersion: SELF_VERSION,\n\t\t}),\n\t)\n\n\tconst parsed = pluginManifest.safeParse(\n\t\tJSON.parse(readFileSync(manifestPath, \"utf8\")),\n\t)\n\tif (!parsed.success) {\n\t\tprocess.exitCode = 1\n\t\tlog.error(`generated manifest is invalid: ${parsed.error.message}`)\n\t\treturn\n\t}\n\n\tif (tarballsDir !== undefined) {\n\t\tlog.step(`Rewiring SDK deps to tarballs in ${tarballsDir}`)\n\t\twriteTarballOverrides(targetDir, tarballsDir)\n\t}\n\n\ttry {\n\t\tawait runInstall(targetDir)\n\t} catch (err) {\n\t\tprocess.exitCode = 1\n\t\tlog.error(\n\t\t\t`install failed: ${err instanceof Error ? err.message : String(err)}`,\n\t\t)\n\t\treturn\n\t}\n\n\toutro(\"Plugin scaffolded. Next steps:\")\n\tconsole.log(`  cd ${targetDir}`)\n\tconsole.log(\n\t\t\"  pnpm build          # build dist/ (client + server bundle + manifest)\",\n\t)\n\tconsole.log(\n\t\t\"  pnpm dev            # watch-build + serve the workbench (http://127.0.0.1:5199)\",\n\t)\n\tconsole.log(\"  pnpm test           # unit tests against the fixture API\")\n\tconsole.log(\"  hoardodile plugin run detect testdata --plugin-dir dist\")\n\tconsole.log(\n\t\t\"  # Replace the manifest id? No — it was generated fresh. Zip dist/ contents and upload in Settings → Plugins.\",\n\t)\n}\n\nif (\n\tprocess.argv[1] !== undefined &&\n\tresolve(process.argv[1]) === fileURLToPath(import.meta.url)\n) {\n\tmain().catch((err) => {\n\t\tlog.error(err instanceof Error ? err.message : String(err))\n\t\tprocess.exit(1)\n\t})\n}\n"]}

package/dist/template/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2026 Wooloo <ayan0312000@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
+LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/template/README.md

@@ -0,0 +1,52 @@
+# hoardodile plugin template
+
+Minimal end-to-end content plugin: `detect` → `sourceMeta` → iframe render.
+Copy this directory to start your own plugin.
+
+## Quick start
+
+```bash
+# 1. Copy the template (never edit it in place — CI compiles this copy)
+cp -r plugins/template my-plugin
+
+# 2. Generate a fresh manifest UUID — never ship the template's id
+node -e "console.log(crypto.randomUUID())"
+
+# 3. Build and validate
+pnpm install
+pnpm build
+
+# 4. Open the workbench (watch-build + serve at http://127.0.0.1:5199,
+#    data from testdata/, plus one sandboxed detect on startup)
+pnpm dev
+```
+
+## What's inside
+
+- `src/main.ts` — the server-side plugin definition (`definePlugin`):
+  `detect` claims resources containing `.hdtpl` files, `sourceMeta`
+  lists them. Composable detectors and probe helpers live in
+  `@hoardodile/sdk-server`.
+- `src/render.tsx` — the iframe client via `@hoardodile/sdk-react`
+  (`createPluginRoot`), reading files through the typed API pair in
+  `src/hooks.ts`.
+- `src/shared.ts` — the plugin schema (`PluginSchema`) typed once and
+  shared between the server and client sides.
+- `testdata/` — sample data for `pnpm dev`.
+- `__tests__/` — Vitest unit tests against `createResourceAPIFixture`.
+
+## Testing
+
+```bash
+pnpm test              # unit tests (in-memory fixture API)
+pnpm run detect:smoke  # sandboxed detect against testdata (needs a build first)
+```
+
+`hoardodile plugin run` runs hooks through the same worker sandbox the
+server uses — the exact production execution path.
+
+## Deploying
+
+Zip the contents of `dist/` (with `manifest.json` at the zip root) and
+upload in **Settings → Plugins**. The app validates the manifest,
+installs it, and rescans.

package/dist/template/index.html

@@ -0,0 +1,2 @@
+<div id="root"></div>
+<script type="module" src="./src/render.tsx"></script>

package/dist/template/manifest.json

@@ -0,0 +1,22 @@
+{
+	"id": "6bc0c75e-5fca-4525-84f1-cfdd98661630",
+	"name": "Template",
+	"description": "Template plugin — copy this directory to start your own plugin",
+	"version": "0.0.0",
+	"permissions": {
+		"sourceMeta": true,
+		"searchMeta": false,
+		"danmaku": false,
+		"message": false
+	},
+	"i18n": {
+		"name": {
+			"en": "Template",
+			"zh": "模板"
+		},
+		"description": {
+			"en": "Template plugin — copy this directory to start your own plugin",
+			"zh": "模板插件——复制此目录作为你自己插件的起点"
+		}
+	}
+}

package/dist/template/package.json

@@ -0,0 +1,34 @@
+{
+	"name": "@hoardodile/plugin-template",
+	"version": "0.0.0",
+	"private": true,
+	"license": "MIT",
+	"type": "module",
+	"scripts": {
+		"dev": "hoardodile plugin dev",
+		"build": "hoardodile plugin build",
+		"watch": "hoardodile plugin build --watch",
+		"detect:smoke": "hoardodile plugin run detect testdata --plugin-dir dist",
+		"lint": "tsc --noEmit",
+		"test": "vitest run"
+	},
+	"dependencies": {
+		"@hoardodile/sdk-react": "workspace:*",
+		"@hoardodile/sdk-server": "workspace:*",
+		"@hoardodile/sdk-types": "workspace:*",
+		"react": "catalog:",
+		"react-dom": "catalog:"
+	},
+	"devDependencies": {
+		"@hoardodile/cli": "workspace:*",
+		"@hoardodile/host": "workspace:*",
+		"@hoardodile/workbench": "workspace:*",
+		"@types/node": "catalog:",
+		"@types/react": "catalog:",
+		"@types/react-dom": "catalog:",
+		"jsdom": "catalog:",
+		"typescript": "catalog:",
+		"vite": "catalog:",
+		"vitest": "catalog:"
+	}
+}

package/dist/template/src/TemplateView.tsx

@@ -0,0 +1,29 @@
+import { usePluginAPI } from "./hooks"
+
+export function TemplateView() {
+	const api = usePluginAPI()
+	const files = api.resource.sourceMeta?.files ?? []
+	const hdtplCount = api.resource.sourceMeta?.hdtplCount
+
+	return (
+		<div className="flex h-full flex-col gap-3 overflow-auto p-4 font-sans text-sm text-gray-800 dark:text-gray-100">
+			<header>
+				<h1 className="text-lg font-semibold">{api.resource.name}</h1>
+				<p className="text-gray-500 dark:text-gray-400">
+					Rendered by the template plugin. Edit src/TemplateView.tsx to make it
+					your own.
+				</p>
+			</header>
+			<p>
+				{hdtplCount !== undefined
+					? `${hdtplCount} .hdtpl file(s) — classified once by detect.`
+					: "No sourceMeta yet."}
+			</p>
+			<ul className="list-inside list-disc">
+				{files.map((file) => (
+					<li key={file}>{file}</li>
+				))}
+			</ul>
+		</div>
+	)
+}

package/dist/template/src/__tests__/main.test.ts

@@ -0,0 +1,64 @@
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs"
+import { tmpdir } from "node:os"
+import { join } from "node:path"
+import { createDirectoryResourceAPI } from "@hoardodile/host"
+import { createResourceAPIFixture } from "@hoardodile/sdk-server"
+import plugin from "../main"
+import type { TemplateSchema } from "../shared"
+
+describe("template plugin", () => {
+	it("detects resources containing a .hdtpl file, carrying the classification", async () => {
+		const { api } = createResourceAPIFixture<TemplateSchema>({
+			files: ["notes.hdtpl"],
+		})
+		const result = await plugin.detect(api)
+		expect(result).toEqual({ ok: true, hdtplCount: 1 })
+	})
+
+	it("misses resources without .hdtpl files", async () => {
+		const { api } = createResourceAPIFixture<TemplateSchema>({
+			files: ["photo.jpg"],
+		})
+		const result = await plugin.detect(api)
+		expect(result.ok).toBe(false)
+	})
+
+	it("lists only .hdtpl files in sourceMeta", async () => {
+		const { api } = createResourceAPIFixture<TemplateSchema>({
+			files: ["a.hdtpl", "photo.jpg", "b.hdtpl"],
+		})
+		const meta = await plugin.sourceMeta?.(api)
+		expect(meta).toEqual({ files: ["a.hdtpl", "b.hdtpl"], hdtplCount: 2 })
+	})
+
+	it("sourceMeta reuses the detect payload via api.context", async () => {
+		const { api } = createResourceAPIFixture<TemplateSchema>({
+			files: ["a.hdtpl", "b.hdtpl"],
+			context: { detect: { hdtplCount: 2 } },
+		})
+		const meta = await plugin.sourceMeta?.(api)
+		expect(meta).toEqual({ files: ["a.hdtpl", "b.hdtpl"], hdtplCount: 2 })
+	})
+})
+
+// Layer 2 (see "Testing" in the plugin development docs): run the hooks
+// against real files on disk. `createDirectoryResourceAPI` has import-time
+// semantics — probes return undefined, so probe-dependent hooks need layer 3.
+describe("against real files", () => {
+	let dir: string
+
+	afterEach(() => {
+		rmSync(dir, { recursive: true, force: true })
+	})
+
+	it("detects a directory containing a .hdtpl file", async () => {
+		dir = mkdtempSync(join(tmpdir(), "hdtpl-test-"))
+		writeFileSync(join(dir, "notes.hdtpl"), "template contents")
+		writeFileSync(join(dir, "photo.jpg"), "not a template")
+		const api = createDirectoryResourceAPI<TemplateSchema>(dir)
+		const result = await plugin.detect(api)
+		expect(result).toEqual({ ok: true, hdtplCount: 1 })
+		const meta = await plugin.sourceMeta?.(api)
+		expect(meta).toEqual({ files: ["notes.hdtpl"], hdtplCount: 1 })
+	})
+})

package/dist/template/src/hooks.ts

@@ -0,0 +1,5 @@
+import { definePluginAPI } from "@hoardodile/sdk-react"
+import type { TemplateSchema } from "./shared"
+
+export const { PluginAPIProvider, usePluginAPI } =
+	definePluginAPI<TemplateSchema>()

package/dist/template/src/index.css

@@ -0,0 +1,9 @@
+@import "tailwindcss";
+
+#root {
+	height: 100%;
+	width: 100%;
+	margin: 0;
+	padding: 0;
+	overflow: hidden;
+}

package/dist/template/src/main.ts

@@ -0,0 +1,37 @@
+import type { ResourceAPI } from "@hoardodile/sdk-server"
+import { definePlugin } from "@hoardodile/sdk-server"
+import { extname } from "@hoardodile/sdk-server/helpers"
+import type { TemplateSchema, TemplateSourceMeta } from "./shared"
+
+/**
+ * The template claims every resource that contains at least one `.hdtpl`
+ * file. Replace this with your own detection logic — see the composable
+ * detectors (`hasExt`, `hasName`, `minFiles`, `all`, `any`, `not`).
+ */
+const TEMPLATE_EXTS = new Set([".hdtpl"])
+
+export default definePlugin<TemplateSchema>({
+	detect: async (api) => {
+		const files = await api.listFileNames()
+		const hdtpl = files.filter((name) => TEMPLATE_EXTS.has(extname(name)))
+		return hdtpl.length === 0
+			? { ok: false, reasons: ["no .hdtpl file"] }
+			: // The classification rides on the match: the host keeps it
+				// and exposes it to the other hooks as `api.context.detect`,
+				// so sourceMeta never rescans.
+				{ ok: true, hdtplCount: hdtpl.length }
+	},
+	sourceMeta: buildSourceMeta,
+})
+
+async function buildSourceMeta(
+	api: ResourceAPI<TemplateSchema>,
+): Promise<TemplateSourceMeta> {
+	const files = (await api.listFileNames()).filter((name) =>
+		TEMPLATE_EXTS.has(extname(name)),
+	)
+	// `api.context.detect` is typed via the schema's `detect` slot, but
+	// may be undefined on a fresh worker — fall back to re-deriving.
+	const hdtplCount = api.context.detect?.hdtplCount ?? files.length
+	return { files, hdtplCount }
+}

package/dist/template/src/render.tsx

@@ -0,0 +1,7 @@
+import "./index.css"
+
+import { createPluginRoot } from "@hoardodile/sdk-react"
+import { PluginAPIProvider } from "./hooks"
+import { TemplateView } from "./TemplateView"
+
+createPluginRoot({ provider: PluginAPIProvider, render: TemplateView })

package/dist/template/src/shared.ts

@@ -0,0 +1,26 @@
+import type { PluginSchema } from "@hoardodile/sdk-types"
+
+export type TemplateFile = {
+	readonly filename: string
+}
+
+export type TemplateSourceMeta = {
+	readonly files: readonly string[]
+	/** Number of `.hdtpl` files — classified once by `detect`, reused by
+	 *  `sourceMeta` via `api.context.detect`. */
+	readonly hdtplCount: number
+}
+
+/**
+ * Declared once and shared between the server definition (`definePlugin`)
+ * and the web API (`definePluginAPI`) so both sides stay in sync.
+ */
+export interface TemplateSchema extends PluginSchema {
+	readonly file: TemplateFile
+	readonly sourceMeta: TemplateSourceMeta
+	/**
+	 * The classification `detect` spreads onto its match. Declaring the
+	 * slot types `api.context.detect` for the other hooks.
+	 */
+	readonly detect: { readonly hdtplCount: number }
+}

package/dist/template/testdata/README.md

@@ -0,0 +1,8 @@
+# Test data
+
+This directory is the default data root for `hoardodile plugin dev` (the
+dev CLI mounts it at `/data` and runs a sandboxed `detect` against it on
+startup).
+
+`sample.hdtpl` matches the template's detector (`.hdtpl` files) — drop
+your own fixture files here as your detection logic evolves.

package/dist/template/testdata/sample.hdtpl

@@ -0,0 +1 @@
+Sample content for the template plugin's detection logic.

package/dist/template/tsconfig.json

@@ -0,0 +1,28 @@
+{
+	// Standalone on purpose: this file works both inside the hoardodile
+	// workspace and copied into an external plugin repository.
+	"compilerOptions": {
+		"lib": ["ESNext", "DOM", "DOM.Iterable"],
+		"target": "ESNext",
+		"module": "Preserve",
+		"moduleDetection": "force",
+		"moduleResolution": "bundler",
+		"allowImportingTsExtensions": true,
+		"verbatimModuleSyntax": true,
+		"noEmit": true,
+		"strict": true,
+		"skipLibCheck": true,
+		"noFallthroughCasesInSwitch": true,
+		"noUncheckedIndexedAccess": true,
+		"noImplicitOverride": true,
+		"noUnusedLocals": true,
+		"noUnusedParameters": true,
+		"esModuleInterop": true,
+		"resolveJsonModule": true,
+		"isolatedModules": true,
+		"jsx": "react-jsx",
+		"types": ["vite/client", "vitest/globals", "node"]
+	},
+	"include": ["src/**/*.ts", "src/**/*.tsx"],
+	"exclude": ["node_modules"]
+}

package/dist/template/vitest.config.ts

@@ -0,0 +1,13 @@
+import { defineConfig } from "vitest/config"
+
+export default defineConfig({
+	test: {
+		environment: "jsdom",
+		globals: true,
+		css: false,
+		include: ["src/**/*.test.{ts,tsx}"],
+		// Default is cores-1 workers; turbo runs several packages' tests in
+		// parallel, so cap each vitest run to keep the machine responsive.
+		maxWorkers: 2,
+	},
+})

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@hoardodile/create-plugin",
+  "version": "0.0.0",
+  "license": "MIT",
+  "description": "Scaffold a hoardodile content plugin.",
+  "keywords": [
+    "hoardodile",
+    "plugin",
+    "scaffold",
+    "cli"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hoardodile/hoardodile.git",
+    "directory": "plugins/create-plugin"
+  },
+  "type": "module",
+  "bin": {
+    "create-hoardodile-plugin": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.7.0",
+    "zod": "^4.4.3",
+    "@hoardodile/sdk-types": "0.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.2.0",
+    "tsup": "^8.5.1",
+    "typescript": "5.9.3",
+    "vitest": "^4.1.11"
+  },
+  "scripts": {
+    "build": "node scripts/sync-template.mjs && tsup && node scripts/copy-template.mjs",
+    "lint": "tsc --noEmit",
+    "test": "vitest run",
+    "template:check": "node scripts/sync-template.mjs --check"
+  }
+}