@soeditor/plugin-tools 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SoEditor contributors
+
+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,13 @@
+# @soeditor/plugin-tools
+
+Public 1.0 offline plugin scaffolding and package audit tools.
+
+```bash
+soeditor-plugin create ./my-plugin --name @example/my-plugin --id example.my-plugin
+soeditor-plugin check ./my-plugin --packed
+```
+
+The checker reads source and metadata without importing plugin code. Packed
+inspection uses `npm pack --dry-run --ignore-scripts`.
+
+See [`docs/plugin-tooling.md`](../../docs/plugin-tooling.md).

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+import { argv, stdout, stderr } from "node:process";
+import { s as scaffoldPluginPackage, c as checkPluginPackage } from "./scaffold-BD62-b7s.js";
+try {
+  const [command, target, ...flags] = argv.slice(2);
+  if (command === "create" && target !== void 0) {
+    const packageName = flag(flags, "--name");
+    const pluginId = flag(flags, "--id");
+    const directory = await scaffoldPluginPackage({
+      directory: target,
+      packageName,
+      pluginId
+    });
+    stdout.write(`Created SoEditor plugin package at ${directory}.
+`);
+  } else if (command === "check" && target !== void 0) {
+    const report = await checkPluginPackage(target, {
+      packed: flags.includes("--packed")
+    });
+    for (const issue of report.issues) {
+      stderr.write(`[${issue.code}] ${issue.message}
+`);
+    }
+    stdout.write(
+      `${report.valid ? "Valid" : "Invalid"} SoEditor plugin package${report.packageName === void 0 ? "" : ` ${report.packageName}`}.
+`
+    );
+    if (!report.valid) process.exitCode = 1;
+  } else {
+    throw new Error(
+      "Usage: soeditor-plugin create <directory> --name <package> --id <plugin-id> | check <directory> [--packed]"
+    );
+  }
+} catch (error) {
+  stderr.write(`${error instanceof Error ? error.message : String(error)}
+`);
+  process.exitCode = 1;
+}
+function flag(values, name) {
+  const index = values.indexOf(name);
+  const value = index < 0 ? void 0 : values[index + 1];
+  if (value === void 0) throw new Error(`Missing ${name}.`);
+  return value;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { argv, stderr, stdout } from 'node:process';\n\nimport { checkPluginPackage } from './plugin-check.js';\nimport { scaffoldPluginPackage } from './scaffold.js';\n\ntry {\n    const [command, target, ...flags] = argv.slice(2);\n    if (command === 'create' && target !== undefined) {\n        const packageName = flag(flags, '--name');\n        const pluginId = flag(flags, '--id');\n        const directory = await scaffoldPluginPackage({\n            directory: target,\n            packageName,\n            pluginId,\n        });\n        stdout.write(`Created SoEditor plugin package at ${directory}.\\n`);\n    } else if (command === 'check' && target !== undefined) {\n        const report = await checkPluginPackage(target, {\n            packed: flags.includes('--packed'),\n        });\n        for (const issue of report.issues) {\n            stderr.write(`[${issue.code}] ${issue.message}\\n`);\n        }\n        stdout.write(\n            `${report.valid ? 'Valid' : 'Invalid'} SoEditor plugin package${report.packageName === undefined ? '' : ` ${report.packageName}`}.\\n`,\n        );\n        if (!report.valid) process.exitCode = 1;\n    } else {\n        throw new Error(\n            'Usage: soeditor-plugin create <directory> --name <package> --id <plugin-id> | check <directory> [--packed]',\n        );\n    }\n} catch (error: unknown) {\n    stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`);\n    process.exitCode = 1;\n}\n\nfunction flag(values: string[], name: string): string {\n    const index = values.indexOf(name);\n    const value = index < 0 ? undefined : values[index + 1];\n    if (value === undefined) throw new Error(`Missing ${name}.`);\n    return value;\n}\n"],"names":[],"mappings":";;;AAMA,IAAI;AACA,QAAM,CAAC,SAAS,QAAQ,GAAG,KAAK,IAAI,KAAK,MAAM,CAAC;AAChD,MAAI,YAAY,YAAY,WAAW,QAAW;AAC9C,UAAM,cAAc,KAAK,OAAO,QAAQ;AACxC,UAAM,WAAW,KAAK,OAAO,MAAM;AACnC,UAAM,YAAY,MAAM,sBAAsB;AAAA,MAC1C,WAAW;AAAA,MACX;AAAA,MACA;AAAA,IAAA,CACH;AACD,WAAO,MAAM,sCAAsC,SAAS;AAAA,CAAK;AAAA,EACrE,WAAW,YAAY,WAAW,WAAW,QAAW;AACpD,UAAM,SAAS,MAAM,mBAAmB,QAAQ;AAAA,MAC5C,QAAQ,MAAM,SAAS,UAAU;AAAA,IAAA,CACpC;AACD,eAAW,SAAS,OAAO,QAAQ;AAC/B,aAAO,MAAM,IAAI,MAAM,IAAI,KAAK,MAAM,OAAO;AAAA,CAAI;AAAA,IACrD;AACA,WAAO;AAAA,MACH,GAAG,OAAO,QAAQ,UAAU,SAAS,2BAA2B,OAAO,gBAAgB,SAAY,KAAK,IAAI,OAAO,WAAW,EAAE;AAAA;AAAA,IAAA;AAEpI,QAAI,CAAC,OAAO,MAAO,SAAQ,WAAW;AAAA,EAC1C,OAAO;AACH,UAAM,IAAI;AAAA,MACN;AAAA,IAAA;AAAA,EAER;AACJ,SAAS,OAAgB;AACrB,SAAO,MAAM,GAAG,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,CAAI;AAC1E,UAAQ,WAAW;AACvB;AAEA,SAAS,KAAK,QAAkB,MAAsB;AAClD,QAAM,QAAQ,OAAO,QAAQ,IAAI;AACjC,QAAM,QAAQ,QAAQ,IAAI,SAAY,OAAO,QAAQ,CAAC;AACtD,MAAI,UAAU,OAAW,OAAM,IAAI,MAAM,WAAW,IAAI,GAAG;AAC3D,SAAO;AACX;"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { checkPluginPackage } from './plugin-check.js';
+export { scaffoldPluginPackage } from './scaffold.js';
+export type { PluginCheckIssue, PluginCheckOptions, PluginCheckReport, } from './plugin-check.js';
+export type { ScaffoldPluginOptions } from './scaffold.js';
+export declare const pluginTemplateVersion = 2;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,YAAY,EACR,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,eAAO,MAAM,qBAAqB,IAAI,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+import { c, s } from "./scaffold-BD62-b7s.js";
+const pluginTemplateVersion = 2;
+export {
+  c as checkPluginPackage,
+  pluginTemplateVersion,
+  s as scaffoldPluginPackage
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["export { checkPluginPackage } from './plugin-check.js';\nexport { scaffoldPluginPackage } from './scaffold.js';\nexport type {\n    PluginCheckIssue,\n    PluginCheckOptions,\n    PluginCheckReport,\n} from './plugin-check.js';\nexport type { ScaffoldPluginOptions } from './scaffold.js';\n\nexport const pluginTemplateVersion = 2;\n"],"names":[],"mappings":";AASO,MAAM,wBAAwB;"}

package/dist/plugin-check.d.ts

@@ -0,0 +1,16 @@
+export interface PluginCheckOptions {
+    readonly packed?: boolean;
+}
+export interface PluginCheckIssue {
+    readonly code: string;
+    readonly message: string;
+}
+export interface PluginCheckReport {
+    readonly issues: readonly PluginCheckIssue[];
+    readonly packageName: string | undefined;
+    readonly pluginIds: readonly string[];
+    readonly valid: boolean;
+}
+/** Audits a plugin package without importing or executing its source. */
+export declare function checkPluginPackage(directory: string, options?: PluginCheckOptions): Promise<PluginCheckReport>;
+//# sourceMappingURL=plugin-check.d.ts.map

package/dist/plugin-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-check.d.ts","sourceRoot":"","sources":["../src/plugin-check.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CAC3B;AAED,yEAAyE;AACzE,wBAAsB,kBAAkB,CACpC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,kBAAuB,GACjC,OAAO,CAAC,iBAAiB,CAAC,CAuF5B"}

package/dist/scaffold-BD62-b7s.js

@@ -0,0 +1,360 @@
+import { execFile } from "node:child_process";
+import { readFile, readdir, mkdir, writeFile } from "node:fs/promises";
+import { resolve, basename } from "node:path";
+import { promisify } from "node:util";
+const execute = promisify(execFile);
+async function checkPluginPackage(directory, options = {}) {
+  const root = resolve(directory);
+  const issues = [];
+  const manifest2 = await jsonRecord(resolve(root, "package.json"), issues);
+  checkManifest(manifest2, issues);
+  const sourceFiles = await sourcePaths(resolve(root, "src"));
+  const sources = await Promise.all(
+    sourceFiles.map(async (path) => ({
+      path,
+      source: await readFile(path, "utf8")
+    }))
+  );
+  const pluginIds = sources.flatMap(
+    ({ source }) => [
+      ...source.matchAll(
+        /static\s+readonly\s+id\s*=\s*['"]([^'"]+)['"]/gu
+      )
+    ].map((match) => match[1])
+  );
+  if (pluginIds.length === 0) {
+    issue(
+      issues,
+      "PLUGIN_ID_MISSING",
+      "No static readonly plugin ID was found."
+    );
+  }
+  const duplicates = pluginIds.filter(
+    (id, index) => pluginIds.indexOf(id) !== index
+  );
+  for (const id of pluginIds) {
+    if (!/^[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?$/u.test(id)) {
+      issue(
+        issues,
+        "PLUGIN_ID_FORMAT",
+        `Plugin ID "${id}" must use lowercase letters, numbers, dots, underscores, or hyphens.`
+      );
+    }
+  }
+  for (const id of new Set(duplicates)) {
+    issue(
+      issues,
+      "PLUGIN_ID_DUPLICATE",
+      `Plugin ID "${id}" is duplicated.`
+    );
+  }
+  for (const { path, source } of sources) {
+    if (/['"]@soeditor\/[^/'"]+\/(?:src|dist|internal)(?:\/[^'"]*)?['"]/u.test(
+      source
+    )) {
+      issue(
+        issues,
+        "INTERNAL_IMPORT",
+        `${path} imports an unsupported SoEditor internal path.`
+      );
+    }
+  }
+  if (!sources.some(
+    ({ source }) => /from\s+['"]@soeditor\/plugin-sdk['"]/u.test(source)
+  )) {
+    issue(
+      issues,
+      "SDK_CONTRIBUTION_MISSING",
+      "Plugin source must consume contributions from the public @soeditor/plugin-sdk root."
+    );
+  }
+  const rootSource = sources.find(
+    ({ path }) => path.endsWith("/src/index.ts")
+  )?.source;
+  if (rootSource === void 0 || !/export\s+\{/u.test(rootSource)) {
+    issue(
+      issues,
+      "ROOT_EXPORT_MISSING",
+      "src/index.ts must explicitly export the plugin contribution."
+    );
+  }
+  if (options.packed === true) await checkPacked(root, issues);
+  return Object.freeze({
+    issues: Object.freeze(issues.map((value) => Object.freeze(value))),
+    packageName: typeof manifest2.name === "string" ? manifest2.name : void 0,
+    pluginIds: Object.freeze(pluginIds),
+    valid: issues.length === 0
+  });
+}
+function checkManifest(manifest2, issues) {
+  if (typeof manifest2.name !== "string" || manifest2.name.length === 0) {
+    issue(issues, "MANIFEST_NAME", "package.json requires a package name.");
+  }
+  if (typeof manifest2.version !== "string" || !/^\d+\.\d+\.\d+(?:-|$)/u.test(manifest2.version)) {
+    issue(
+      issues,
+      "MANIFEST_VERSION",
+      "package.json requires a SemVer version."
+    );
+  }
+  if (manifest2.type !== "module") {
+    issue(issues, "ESM_REQUIRED", "Plugin packages must use type: module.");
+  }
+  if (manifest2.sideEffects !== false) {
+    issue(
+      issues,
+      "TREE_SHAKING",
+      "Plugin packages must declare sideEffects: false."
+    );
+  }
+  const exports = record(manifest2.exports);
+  const rootExport = record(exports["."]);
+  if (typeof rootExport.import !== "string" || !rootExport.import.startsWith("./dist/") || typeof rootExport.types !== "string" || !rootExport.types.startsWith("./dist/")) {
+    issue(
+      issues,
+      "EXPORT_MAP",
+      "The package root must expose dist import and types entries."
+    );
+  }
+  const peers = record(manifest2.peerDependencies);
+  const sdkRange = peers["@soeditor/plugin-sdk"];
+  if (typeof sdkRange !== "string" || !/(?:\^1\.|>=\s*1\.)/u.test(sdkRange)) {
+    issue(
+      issues,
+      "SDK_PEER_RANGE",
+      "Declare @soeditor/plugin-sdk as a compatible peer dependency."
+    );
+  }
+}
+async function checkPacked(root, issues) {
+  try {
+    const { stdout } = await execute(
+      "npm",
+      ["pack", "--dry-run", "--ignore-scripts", "--json"],
+      { cwd: root, encoding: "utf8", maxBuffer: 2e6 }
+    );
+    const result = JSON.parse(stdout);
+    const entry = Array.isArray(result) ? record(result[0]) : {};
+    const files = Array.isArray(entry.files) ? entry.files.flatMap((value) => {
+      const path = record(value).path;
+      return typeof path === "string" ? [path] : [];
+    }) : [];
+    for (const required of [
+      "dist/index.js",
+      "dist/index.d.ts",
+      "package.json"
+    ]) {
+      if (!files.includes(required)) {
+        issue(
+          issues,
+          "PACKED_FILE_MISSING",
+          `Packed artifact is missing ${required}.`
+        );
+      }
+    }
+    if (files.some((path) => path.startsWith("src/"))) {
+      issue(
+        issues,
+        "PACKED_SOURCE",
+        "Packed artifact must not expose src files."
+      );
+    }
+  } catch (error) {
+    issue(
+      issues,
+      "PACK_FAILED",
+      `Unable to inspect packed artifact: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+}
+async function sourcePaths(directory) {
+  let entries;
+  try {
+    entries = await readdir(directory, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+  const paths = await Promise.all(
+    entries.map(async (entry) => {
+      const path = resolve(directory, entry.name);
+      return entry.isDirectory() ? sourcePaths(path) : /\.[cm]?tsx?$/u.test(entry.name) ? [path] : [];
+    })
+  );
+  return paths.flat().sort();
+}
+async function jsonRecord(path, issues) {
+  try {
+    return record(JSON.parse(await readFile(path, "utf8")));
+  } catch (error) {
+    issue(
+      issues,
+      "MANIFEST_READ",
+      `Unable to read package.json: ${error instanceof Error ? error.message : String(error)}`
+    );
+    return {};
+  }
+}
+function record(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return {};
+  }
+  const result = {};
+  for (const key of Object.keys(value)) result[key] = Reflect.get(value, key);
+  return result;
+}
+function issue(issues, code, message) {
+  issues.push(Object.freeze({ code, message }));
+}
+async function scaffoldPluginPackage(options) {
+  const directory = resolve(nonEmpty(options.directory, "directory"));
+  const packageName = packageValue(options.packageName);
+  const pluginId = pluginIdValue(options.pluginId);
+  await mkdir(directory);
+  await mkdir(resolve(directory, "src"));
+  await mkdir(resolve(directory, "tests"));
+  const className = classNameFrom(packageName);
+  await Promise.all([
+    write(directory, "package.json", manifest(packageName)),
+    write(directory, "tsconfig.json", tsconfig()),
+    write(directory, "vite.config.ts", viteConfig()),
+    write(
+      directory,
+      "pnpm-workspace.yaml",
+      "allowBuilds:\n    esbuild: true\n\nonlyBuiltDependencies:\n    - esbuild\n"
+    ),
+    write(
+      directory,
+      "README.md",
+      `# ${packageName}
+
+SoEditor plugin package.
+`
+    ),
+    write(
+      directory,
+      "src/index.ts",
+      `export { ${className} } from './plugin.js';
+`
+    ),
+    write(
+      directory,
+      "src/plugin.ts",
+      `import { Plugin } from '@soeditor/plugin-sdk';
+
+export class ${className} extends Plugin {
+    static readonly id = '${escapeSingle(pluginId)}';
+}
+`
+    )
+  ]);
+  return directory;
+}
+function manifest(name) {
+  return `${JSON.stringify(
+    {
+      name,
+      version: "0.1.0",
+      license: "MIT",
+      packageManager: "pnpm@11.20.0",
+      type: "module",
+      sideEffects: false,
+      files: ["dist"],
+      exports: {
+        ".": { types: "./dist/index.d.ts", import: "./dist/index.js" }
+      },
+      scripts: {
+        build: "vite build && tsc -p tsconfig.json --emitDeclarationOnly --declaration --outDir dist",
+        check: "soeditor-plugin check . --packed"
+      },
+      peerDependencies: { "@soeditor/plugin-sdk": "^1.0.0" },
+      devDependencies: {
+        "@soeditor/comments": "^1.0.0",
+        "@soeditor/core": "^1.0.0",
+        "@soeditor/engine": "^1.0.0",
+        "@soeditor/file-manager": "^1.0.0",
+        "@soeditor/html-tools": "^1.0.0",
+        "@soeditor/html": "^1.0.0",
+        "@soeditor/layout": "^1.0.0",
+        "@soeditor/plugin-sdk": "^1.0.0",
+        "@soeditor/plugin-tools": "^1.0.0",
+        "@soeditor/projections": "^1.0.0",
+        "@soeditor/revisions": "^1.0.0",
+        "@soeditor/rich-text": "^1.0.0",
+        "@soeditor/ui": "^1.0.0",
+        typescript: "^5.9.0",
+        vite: "^7.0.0"
+      }
+    },
+    void 0,
+    4
+  )}
+`;
+}
+function tsconfig() {
+  return `${JSON.stringify(
+    {
+      compilerOptions: {
+        declaration: true,
+        declarationMap: true,
+        emitDeclarationOnly: true,
+        exactOptionalPropertyTypes: true,
+        module: "ESNext",
+        moduleResolution: "Bundler",
+        outDir: "dist",
+        strict: true,
+        target: "ES2022"
+      },
+      include: ["src/**/*.ts"]
+    },
+    void 0,
+    4
+  )}
+`;
+}
+function viteConfig() {
+  return "import { defineConfig } from 'vite';\n\nexport default defineConfig({\n    build: {\n        lib: { entry: 'src/index.ts', formats: ['es'], fileName: 'index' },\n        rollupOptions: { external: ['@soeditor/plugin-sdk'] },\n        sourcemap: true,\n    },\n});\n";
+}
+async function write(root, path, source) {
+  await writeFile(resolve(root, path), source, {
+    encoding: "utf8",
+    flag: "wx"
+  });
+}
+function packageValue(value) {
+  const name = nonEmpty(value, "package name");
+  if (!/^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/u.test(name)) {
+    throw new TypeError(`Invalid npm package name "${name}".`);
+  }
+  return name;
+}
+function pluginIdValue(value) {
+  const id = nonEmpty(value, "plugin ID");
+  if (!/^[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?$/u.test(id)) {
+    throw new TypeError(
+      `Invalid plugin ID "${id}"; use lowercase letters, numbers, dots, underscores, or hyphens.`
+    );
+  }
+  return id;
+}
+function classNameFrom(name) {
+  const stem = basename(name).replace(
+    /[^a-zA-Z0-9]+(.)/gu,
+    (_match, next) => next.toUpperCase()
+  );
+  const normalized = stem.replace(/^[^a-zA-Z]+/u, "");
+  return `${normalized.length === 0 ? "SoEditor" : normalized[0].toUpperCase() + normalized.slice(1)}Plugin`;
+}
+function nonEmpty(value, label) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new TypeError(`Plugin ${label} must be a non-empty string.`);
+  }
+  return value.trim();
+}
+function escapeSingle(value) {
+  return value.replaceAll("\\", "\\\\").replaceAll("'", "\\'");
+}
+export {
+  checkPluginPackage as c,
+  scaffoldPluginPackage as s
+};
+//# sourceMappingURL=scaffold-BD62-b7s.js.map

package/dist/scaffold-BD62-b7s.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-BD62-b7s.js","sources":["../src/plugin-check.ts","../src/scaffold.ts"],"sourcesContent":["import { execFile } from 'node:child_process';\nimport { readFile, readdir } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport { promisify } from 'node:util';\n\nconst execute = promisify(execFile);\n\nexport interface PluginCheckOptions {\n    readonly packed?: boolean;\n}\n\nexport interface PluginCheckIssue {\n    readonly code: string;\n    readonly message: string;\n}\n\nexport interface PluginCheckReport {\n    readonly issues: readonly PluginCheckIssue[];\n    readonly packageName: string | undefined;\n    readonly pluginIds: readonly string[];\n    readonly valid: boolean;\n}\n\n/** Audits a plugin package without importing or executing its source. */\nexport async function checkPluginPackage(\n    directory: string,\n    options: PluginCheckOptions = {},\n): Promise<PluginCheckReport> {\n    const root = resolve(directory);\n    const issues: PluginCheckIssue[] = [];\n    const manifest = await jsonRecord(resolve(root, 'package.json'), issues);\n    checkManifest(manifest, issues);\n    const sourceFiles = await sourcePaths(resolve(root, 'src'));\n    const sources = await Promise.all(\n        sourceFiles.map(async (path) => ({\n            path,\n            source: await readFile(path, 'utf8'),\n        })),\n    );\n    const pluginIds = sources.flatMap(({ source }) =>\n        [\n            ...source.matchAll(\n                /static\\s+readonly\\s+id\\s*=\\s*['\"]([^'\"]+)['\"]/gu,\n            ),\n        ].map((match) => match[1]!),\n    );\n    if (pluginIds.length === 0) {\n        issue(\n            issues,\n            'PLUGIN_ID_MISSING',\n            'No static readonly plugin ID was found.',\n        );\n    }\n    const duplicates = pluginIds.filter(\n        (id, index) => pluginIds.indexOf(id) !== index,\n    );\n    for (const id of pluginIds) {\n        if (!/^[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?$/u.test(id)) {\n            issue(\n                issues,\n                'PLUGIN_ID_FORMAT',\n                `Plugin ID \"${id}\" must use lowercase letters, numbers, dots, underscores, or hyphens.`,\n            );\n        }\n    }\n    for (const id of new Set(duplicates)) {\n        issue(\n            issues,\n            'PLUGIN_ID_DUPLICATE',\n            `Plugin ID \"${id}\" is duplicated.`,\n        );\n    }\n    for (const { path, source } of sources) {\n        if (\n            /['\"]@soeditor\\/[^/'\"]+\\/(?:src|dist|internal)(?:\\/[^'\"]*)?['\"]/u.test(\n                source,\n            )\n        ) {\n            issue(\n                issues,\n                'INTERNAL_IMPORT',\n                `${path} imports an unsupported SoEditor internal path.`,\n            );\n        }\n    }\n    if (\n        !sources.some(({ source }) =>\n            /from\\s+['\"]@soeditor\\/plugin-sdk['\"]/u.test(source),\n        )\n    ) {\n        issue(\n            issues,\n            'SDK_CONTRIBUTION_MISSING',\n            'Plugin source must consume contributions from the public @soeditor/plugin-sdk root.',\n        );\n    }\n    const rootSource = sources.find(({ path }) =>\n        path.endsWith('/src/index.ts'),\n    )?.source;\n    if (rootSource === undefined || !/export\\s+\\{/u.test(rootSource)) {\n        issue(\n            issues,\n            'ROOT_EXPORT_MISSING',\n            'src/index.ts must explicitly export the plugin contribution.',\n        );\n    }\n    if (options.packed === true) await checkPacked(root, issues);\n    return Object.freeze({\n        issues: Object.freeze(issues.map((value) => Object.freeze(value))),\n        packageName:\n            typeof manifest.name === 'string' ? manifest.name : undefined,\n        pluginIds: Object.freeze(pluginIds),\n        valid: issues.length === 0,\n    });\n}\n\nfunction checkManifest(\n    manifest: Record<string, unknown>,\n    issues: PluginCheckIssue[],\n): void {\n    if (typeof manifest.name !== 'string' || manifest.name.length === 0) {\n        issue(issues, 'MANIFEST_NAME', 'package.json requires a package name.');\n    }\n    if (\n        typeof manifest.version !== 'string' ||\n        !/^\\d+\\.\\d+\\.\\d+(?:-|$)/u.test(manifest.version)\n    ) {\n        issue(\n            issues,\n            'MANIFEST_VERSION',\n            'package.json requires a SemVer version.',\n        );\n    }\n    if (manifest.type !== 'module') {\n        issue(issues, 'ESM_REQUIRED', 'Plugin packages must use type: module.');\n    }\n    if (manifest.sideEffects !== false) {\n        issue(\n            issues,\n            'TREE_SHAKING',\n            'Plugin packages must declare sideEffects: false.',\n        );\n    }\n    const exports = record(manifest.exports);\n    const rootExport = record(exports['.']);\n    if (\n        typeof rootExport.import !== 'string' ||\n        !rootExport.import.startsWith('./dist/') ||\n        typeof rootExport.types !== 'string' ||\n        !rootExport.types.startsWith('./dist/')\n    ) {\n        issue(\n            issues,\n            'EXPORT_MAP',\n            'The package root must expose dist import and types entries.',\n        );\n    }\n    const peers = record(manifest.peerDependencies);\n    const sdkRange = peers['@soeditor/plugin-sdk'];\n    if (typeof sdkRange !== 'string' || !/(?:\\^1\\.|>=\\s*1\\.)/u.test(sdkRange)) {\n        issue(\n            issues,\n            'SDK_PEER_RANGE',\n            'Declare @soeditor/plugin-sdk as a compatible peer dependency.',\n        );\n    }\n}\n\nasync function checkPacked(\n    root: string,\n    issues: PluginCheckIssue[],\n): Promise<void> {\n    try {\n        const { stdout } = await execute(\n            'npm',\n            ['pack', '--dry-run', '--ignore-scripts', '--json'],\n            { cwd: root, encoding: 'utf8', maxBuffer: 2_000_000 },\n        );\n        const result: unknown = JSON.parse(stdout);\n        const entry = Array.isArray(result) ? record(result[0]) : {};\n        const files = Array.isArray(entry.files)\n            ? entry.files.flatMap((value) => {\n                  const path = record(value).path;\n                  return typeof path === 'string' ? [path] : [];\n              })\n            : [];\n        for (const required of [\n            'dist/index.js',\n            'dist/index.d.ts',\n            'package.json',\n        ]) {\n            if (!files.includes(required)) {\n                issue(\n                    issues,\n                    'PACKED_FILE_MISSING',\n                    `Packed artifact is missing ${required}.`,\n                );\n            }\n        }\n        if (files.some((path) => path.startsWith('src/'))) {\n            issue(\n                issues,\n                'PACKED_SOURCE',\n                'Packed artifact must not expose src files.',\n            );\n        }\n    } catch (error: unknown) {\n        issue(\n            issues,\n            'PACK_FAILED',\n            `Unable to inspect packed artifact: ${error instanceof Error ? error.message : String(error)}`,\n        );\n    }\n}\n\nasync function sourcePaths(directory: string): Promise<string[]> {\n    let entries;\n    try {\n        entries = await readdir(directory, { withFileTypes: true });\n    } catch {\n        return [];\n    }\n    const paths = await Promise.all(\n        entries.map(async (entry) => {\n            const path = resolve(directory, entry.name);\n            return entry.isDirectory()\n                ? sourcePaths(path)\n                : /\\.[cm]?tsx?$/u.test(entry.name)\n                  ? [path]\n                  : [];\n        }),\n    );\n    return paths.flat().sort();\n}\n\nasync function jsonRecord(\n    path: string,\n    issues: PluginCheckIssue[],\n): Promise<Record<string, unknown>> {\n    try {\n        return record(JSON.parse(await readFile(path, 'utf8')));\n    } catch (error: unknown) {\n        issue(\n            issues,\n            'MANIFEST_READ',\n            `Unable to read package.json: ${error instanceof Error ? error.message : String(error)}`,\n        );\n        return {};\n    }\n}\n\nfunction record(value: unknown): Record<string, unknown> {\n    if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n        return {};\n    }\n    const result: Record<string, unknown> = {};\n    for (const key of Object.keys(value)) result[key] = Reflect.get(value, key);\n    return result;\n}\n\nfunction issue(\n    issues: PluginCheckIssue[],\n    code: string,\n    message: string,\n): void {\n    issues.push(Object.freeze({ code, message }));\n}\n","import { mkdir, writeFile } from 'node:fs/promises';\nimport { basename, resolve } from 'node:path';\n\nexport interface ScaffoldPluginOptions {\n    readonly directory: string;\n    readonly packageName: string;\n    readonly pluginId: string;\n}\n\n/** Creates a versioned, strict plugin package without overwriting a directory. */\nexport async function scaffoldPluginPackage(\n    options: ScaffoldPluginOptions,\n): Promise<string> {\n    const directory = resolve(nonEmpty(options.directory, 'directory'));\n    const packageName = packageValue(options.packageName);\n    const pluginId = pluginIdValue(options.pluginId);\n    await mkdir(directory);\n    await mkdir(resolve(directory, 'src'));\n    await mkdir(resolve(directory, 'tests'));\n    const className = classNameFrom(packageName);\n    await Promise.all([\n        write(directory, 'package.json', manifest(packageName)),\n        write(directory, 'tsconfig.json', tsconfig()),\n        write(directory, 'vite.config.ts', viteConfig()),\n        write(\n            directory,\n            'pnpm-workspace.yaml',\n            'allowBuilds:\\n    esbuild: true\\n\\nonlyBuiltDependencies:\\n    - esbuild\\n',\n        ),\n        write(\n            directory,\n            'README.md',\n            `# ${packageName}\\n\\nSoEditor plugin package.\\n`,\n        ),\n        write(\n            directory,\n            'src/index.ts',\n            `export { ${className} } from './plugin.js';\\n`,\n        ),\n        write(\n            directory,\n            'src/plugin.ts',\n            `import { Plugin } from '@soeditor/plugin-sdk';\\n\\nexport class ${className} extends Plugin {\\n    static readonly id = '${escapeSingle(pluginId)}';\\n}\\n`,\n        ),\n    ]);\n    return directory;\n}\n\nfunction manifest(name: string): string {\n    return `${JSON.stringify(\n        {\n            name,\n            version: '0.1.0',\n            license: 'MIT',\n            packageManager: 'pnpm@11.20.0',\n            type: 'module',\n            sideEffects: false,\n            files: ['dist'],\n            exports: {\n                '.': { types: './dist/index.d.ts', import: './dist/index.js' },\n            },\n            scripts: {\n                build: 'vite build && tsc -p tsconfig.json --emitDeclarationOnly --declaration --outDir dist',\n                check: 'soeditor-plugin check . --packed',\n            },\n            peerDependencies: { '@soeditor/plugin-sdk': '^1.0.0' },\n            devDependencies: {\n                '@soeditor/comments': '^1.0.0',\n                '@soeditor/core': '^1.0.0',\n                '@soeditor/engine': '^1.0.0',\n                '@soeditor/file-manager': '^1.0.0',\n                '@soeditor/html-tools': '^1.0.0',\n                '@soeditor/html': '^1.0.0',\n                '@soeditor/layout': '^1.0.0',\n                '@soeditor/plugin-sdk': '^1.0.0',\n                '@soeditor/plugin-tools': '^1.0.0',\n                '@soeditor/projections': '^1.0.0',\n                '@soeditor/revisions': '^1.0.0',\n                '@soeditor/rich-text': '^1.0.0',\n                '@soeditor/ui': '^1.0.0',\n                typescript: '^5.9.0',\n                vite: '^7.0.0',\n            },\n        },\n        undefined,\n        4,\n    )}\\n`;\n}\n\nfunction tsconfig(): string {\n    return `${JSON.stringify(\n        {\n            compilerOptions: {\n                declaration: true,\n                declarationMap: true,\n                emitDeclarationOnly: true,\n                exactOptionalPropertyTypes: true,\n                module: 'ESNext',\n                moduleResolution: 'Bundler',\n                outDir: 'dist',\n                strict: true,\n                target: 'ES2022',\n            },\n            include: ['src/**/*.ts'],\n        },\n        undefined,\n        4,\n    )}\\n`;\n}\n\nfunction viteConfig(): string {\n    return \"import { defineConfig } from 'vite';\\n\\nexport default defineConfig({\\n    build: {\\n        lib: { entry: 'src/index.ts', formats: ['es'], fileName: 'index' },\\n        rollupOptions: { external: ['@soeditor/plugin-sdk'] },\\n        sourcemap: true,\\n    },\\n});\\n\";\n}\n\nasync function write(\n    root: string,\n    path: string,\n    source: string,\n): Promise<void> {\n    await writeFile(resolve(root, path), source, {\n        encoding: 'utf8',\n        flag: 'wx',\n    });\n}\n\nfunction packageValue(value: string): string {\n    const name = nonEmpty(value, 'package name');\n    if (!/^(?:@[a-z0-9][a-z0-9._-]*\\/)?[a-z0-9][a-z0-9._-]*$/u.test(name)) {\n        throw new TypeError(`Invalid npm package name \"${name}\".`);\n    }\n    return name;\n}\n\nfunction pluginIdValue(value: string): string {\n    const id = nonEmpty(value, 'plugin ID');\n    if (!/^[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?$/u.test(id)) {\n        throw new TypeError(\n            `Invalid plugin ID \"${id}\"; use lowercase letters, numbers, dots, underscores, or hyphens.`,\n        );\n    }\n    return id;\n}\n\nfunction classNameFrom(name: string): string {\n    const stem = basename(name).replace(\n        /[^a-zA-Z0-9]+(.)/gu,\n        (_match, next: string) => next.toUpperCase(),\n    );\n    const normalized = stem.replace(/^[^a-zA-Z]+/u, '');\n    return `${normalized.length === 0 ? 'SoEditor' : normalized[0]!.toUpperCase() + normalized.slice(1)}Plugin`;\n}\n\nfunction nonEmpty(value: unknown, label: string): string {\n    if (typeof value !== 'string' || value.trim().length === 0) {\n        throw new TypeError(`Plugin ${label} must be a non-empty string.`);\n    }\n    return value.trim();\n}\n\nfunction escapeSingle(value: string): string {\n    return value.replaceAll('\\\\', '\\\\\\\\').replaceAll(\"'\", \"\\\\'\");\n}\n"],"names":["manifest"],"mappings":"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"}

package/dist/scaffold.d.ts

@@ -0,0 +1,8 @@
+export interface ScaffoldPluginOptions {
+    readonly directory: string;
+    readonly packageName: string;
+    readonly pluginId: string;
+}
+/** Creates a versioned, strict plugin package without overwriting a directory. */
+export declare function scaffoldPluginPackage(options: ScaffoldPluginOptions): Promise<string>;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,qBAAqB;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC7B;AAED,kFAAkF;AAClF,wBAAsB,qBAAqB,CACvC,OAAO,EAAE,qBAAqB,GAC/B,OAAO,CAAC,MAAM,CAAC,CAkCjB"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@soeditor/plugin-tools",
+  "version": "1.0.0",
+  "license": "MIT",
+  "description": "Offline plugin scaffolding and package checks for SoEditor.",
+  "keywords": [
+    "content-editor",
+    "plugin",
+    "typescript"
+  ],
+  "homepage": "https://github.com/sohophp/soeditor#readme",
+  "bugs": {
+    "url": "https://github.com/sohophp/soeditor/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sohophp/soeditor.git",
+    "directory": "packages/plugin-tools"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "registry": "https://registry.npmjs.org/"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "soeditor-plugin": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "engines": {
+    "node": ">=22.14.0 <23"
+  },
+  "devDependencies": {
+    "@types/node": "^22.18.0"
+  },
+  "scripts": {
+    "build": "vite build && tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json"
+  }
+}