create-coffer-plugin 1.1.0

package/bin/index.mjs

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+/** create-coffer-plugin — scaffold standalone schema-плагіна. Usage: npm create coffer-plugin <name> */
+import { mkdirSync, writeFileSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { join, dirname, relative } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const raw = process.argv[2];
+if (!raw) {
+  console.error('usage: npm create coffer-plugin <name>');
+  process.exit(1);
+}
+const name = raw.replace(/^coffer-plugin-/, '');
+const pkgName = `coffer-plugin-${name}`;
+const dest = join(process.cwd(), pkgName);
+const tplDir = join(dirname(fileURLToPath(import.meta.url)), '..', 'templates');
+
+/** Рекурсивний обхід темплейтів (без залежності від readdirSync recursive). */
+function walk(dir) {
+  const out = [];
+  for (const e of readdirSync(dir)) {
+    const p = join(dir, e);
+    if (statSync(p).isDirectory()) out.push(...walk(p));
+    else out.push(p);
+  }
+  return out;
+}
+
+for (const abs of walk(tplDir)) {
+  const rel = relative(tplDir, abs);
+  const outRel = rel.replace(/\.tpl$/, '').replace(/(^|\/)_/g, '$1.');
+  const out = join(dest, outRel);
+  const body = readFileSync(abs, 'utf8').replaceAll('__NAME__', name).replaceAll('__PKG__', pkgName);
+  mkdirSync(dirname(out), { recursive: true });
+  writeFileSync(out, body);
+}
+console.log(`✓ ${pkgName} створено. Далі:\n  cd ${pkgName} && npm install && npm run build`);

package/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "create-coffer-plugin",
+  "version": "1.1.0",
+  "type": "module",
+  "files": [
+    "bin",
+    "templates"
+  ],
+  "bin": {
+    "create-coffer-plugin": "./bin/index.mjs"
+  }
+}

package/templates/README.md.tpl

@@ -0,0 +1,5 @@
+# __PKG__
+
+Coffer plugin. Build: `npm run build`. Publish: `npm publish` (runs prepack/postpack).
+
+Edit `src/index.ts` — default-export a `PluginManifest`.

package/templates/_gitignore

@@ -0,0 +1,3 @@
+node_modules/
+dist/
+.package.json.orig

package/templates/package.json.tpl

@@ -0,0 +1,17 @@
+{
+  "name": "__PKG__",
+  "version": "0.1.0",
+  "type": "module",
+  "files": ["dist"],
+  "coffer": { "schema": "dist/index.js", "web": "dist/web.js", "css": "dist/web.css" },
+  "exports": { ".": "./src/index.ts" },
+  "distExports": { ".": { "types": "./dist/index.d.ts", "default": "./dist/index.js" } },
+  "scripts": {
+    "build": "coffer-plugin build",
+    "prepack": "coffer-plugin prepack",
+    "postpack": "coffer-plugin postpack"
+  },
+  "dependencies": { "@coffer-org/sdk": "^1.0.0" },
+  "peerDependencies": { "@coffer-org/web-sdk": "^1.0.0", "react": ">=19" },
+  "devDependencies": { "@coffer-org/devkit": "^1.0.0", "@coffer-org/web-sdk": "^1.0.0", "react": "^19", "typescript": "^5" }
+}

package/templates/src/index.css.tpl

@@ -0,0 +1 @@
+@import 'tailwindcss';

package/templates/src/index.ts.tpl

@@ -0,0 +1,28 @@
+import { defineModule, defineVault, field } from '@coffer-org/sdk';
+import type { PluginManifest } from '@coffer-org/sdk/plugin';
+
+/** Приклад модуля. Заміни на свій домен. */
+const note = defineModule({
+  module: 'note',
+  vault: '__NAME__',
+  label: '__NAME__.note.label',
+  views: { table: ['body'] },
+  fields: [
+    field.title({ key: 'name', label: 'core.fields.name' }),
+    field.text({ key: 'body', label: '__NAME__.note.fields.body', max: 2000 }),
+  ],
+});
+
+const manifest: PluginManifest = {
+  id: '__NAME__',
+  version: '0.1.0',
+  dependsOn: [],
+  vaults: [
+    {
+      meta: defineVault({ id: '__NAME__', label: '__NAME__.vault.label', icon: 'lucide:puzzle' }),
+      modules: [note],
+    },
+  ],
+};
+
+export default manifest;

package/templates/src/ui.tsx.tpl

@@ -0,0 +1,9 @@
+import { defineModuleUI } from '@coffer-org/web-sdk';
+import './index.css'; // Tailwind entry → emitted as dist/web.css (host injects it)
+
+// The plugin's web bundle default-exports its ModuleUIBundle (or an array).
+// The host federation loader registers RecordView / renderers / translations.
+// Signature: defineModuleUI(vault, module, { RecordView?, renderers?, translations? }).
+export default defineModuleUI('__NAME__', 'note', {
+  translations: { en: { '__NAME__.hello': 'Hello from __NAME__' } },
+});

package/templates/tsconfig.build.json.tpl

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "declaration": true,
+    "strict": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "skipLibCheck": true,
+    "verbatimModuleSyntax": false
+  },
+  "include": ["src"],
+  "exclude": ["src/**/*.test.ts", "src/**/*.test.tsx", "src/**/ui.tsx", "src/**/actions.ts"]
+}