@picloom/create-plugin 0.1.0 → 0.1.1

package/README.md

@@ -6,7 +6,7 @@ checkout, Node.js or npm CLI is required.
 Create a project:
 
 ```sh
-bun create @picloom/plugin@0.1.0 ./my-plugin
+bun create @picloom/plugin@0.1.1 ./my-plugin
 ```
 
 The destination must not exist; its parent must exist. `--help` prints usage.
@@ -26,3 +26,7 @@ maintainers use [tool maintenance](https://github.com/llleixx/picloom/blob/main/
 
 目标目录必须不存在，父目录必须存在。工具只复制日期路径插件模板并提示下一步，
 不安装依赖、不启动服务、不发布代码。生成后按项目内 README 修改、构建和安装插件。
+
+Generated projects use `@picloom/plugin-sdk` for contracts and runtime helpers, and `@picloom/plugin-tools` for ZIP builds. No build script is copied. Use creator 0.1.1, tools 0.1.0 and plugin SDK 0.1.0.
+
+生成项目依赖 SDK 与开发工具包，不复制构建实现；使用脚手架 0.1.1、工具 0.1.0 和插件 SDK 0.1.0 的 npm 精确版本。

package/index.js

@@ -46,7 +46,7 @@ if (args.length === 1 && ["--help", "-h"].includes(args[0])) {
     pkg.name = name;
     await writeFile(packagePath, JSON.stringify(pkg, null, 2) + "\n");
     console.log(
-      `Created ${target}\n\nNext:\n  cd ${JSON.stringify(args[0])}\n  bun install\n  bun run build\n\nUpload dist/${manifest.id}-${manifest.version}.zip to Picloom.`,
+      `Created ${target}\n\nNext:\n  cd ${JSON.stringify(args[0])}\n  bun install\n  bun run typecheck\n  bun run build\n\nUpload dist/${manifest.id}-${manifest.version}.zip to Picloom.`,
     );
   } catch (error) {
     console.error(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@picloom/create-plugin",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Create a standalone Picloom plugin project",
   "license": "MIT",
   "type": "module",
@@ -18,7 +18,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/llleixx/picloom.git",
+    "url": "git+https://github.com/llleixx/picloom-tooling.git",
     "directory": "tools/create-plugin"
   },
   "publishConfig": {

package/template/README.md

@@ -8,11 +8,12 @@ Node.js and npm CLI are not required.
 
 ```sh
 bun install
+bun run typecheck
 bun run build
 ```
 
 Commit the generated `bun.lock`. To check types without building, run
-`bun run typecheck`. Both commands run TypeScript under Bun.
+`bun run typecheck`. Type checking and ZIP building are separate commands under Bun. Builds call `@picloom/plugin-tools`; no build implementation is copied into the project.
 
 - `plugin.json`: plugin ID, version, kind and API version. Replace the
   generated `example.*` ID with your own stable ID before sharing.
@@ -53,7 +54,7 @@ for retries, cancellation and instance lifecycle.
 
 本项目只需 Bun 1.4.3+。修改 `plugin.json` 的身份信息和 `src/index.ts` 的实现，
 执行 `bun install`、`bun run build`，将生成的 `bun.lock` 提交到自己的插件仓库。
-构建先检查类型，再输出 `dist/<插件ID>-<版本>.zip`，无需系统 `zip` 命令。
+类型检查单独运行 `bun run typecheck`；构建调用 `@picloom/plugin-tools` 输出 `dist/<插件ID>-<版本>.zip`，无需系统 `zip` 命令。
 
 用 Owner 账号在独立测试实例中安装 ZIP，确认加载成功后，在上传配置中选择插件并
 关联可用存储组。上传 PNG，确认日期路径和公开链接。改代码后增加清单版本，重新
@@ -65,3 +66,6 @@ for retries, cancellation and instance lifecycle.
 入口从清单读取身份字段；`package.json` 的版本不是插件版本。构建会加载入口，
 不要在模块顶层执行远端操作。Sharp 的开发依赖提供类型，运行时使用宿主实例。
 其他类型和完整接口见上方文档链接。
+
+The current creator/tool versions are not yet published; use their local tarballs for validation.
+当前脚手架和工具版本尚未发布，请使用本地压缩包验证。

package/template/package.json

@@ -5,14 +5,14 @@
   "type": "module",
   "scripts": {
     "typecheck": "bun run --bun tsc --noEmit",
-    "build": "bun run typecheck && bun scripts/build.ts"
+    "build": "bun --bun picloom-plugin build"
   },
   "devDependencies": {
     "@picloom/plugin-sdk": "0.1.0",
     "@types/bun": "1.3.10",
-    "fflate": "0.8.2",
     "sharp": "0.34.5",
-    "typescript": "5.9.3"
+    "typescript": "5.9.3",
+    "@picloom/plugin-tools": "0.1.0"
   },
   "engines": {
     "bun": ">=1.4.3"

package/template/tsconfig.json

@@ -8,8 +8,13 @@
     "noEmit": true,
     "resolveJsonModule": true,
     "esModuleInterop": true,
-    "types": ["bun"],
+    "types": [
+      "bun"
+    ],
     "skipLibCheck": false
   },
-  "include": ["src/**/*.ts", "scripts/**/*.ts", "plugin.json"]
+  "include": [
+    "src/**/*.ts",
+    "plugin.json"
+  ]
 }

package/template/scripts/build.ts

@@ -1,75 +0,0 @@
-import { mkdir } from "node:fs/promises";
-import { resolve } from "node:path";
-import { strToU8, zipSync } from "fflate";
-import manifest from "../plugin.json";
-
-if (
-  !/^[a-z][a-z0-9._-]{0,99}$/.test(manifest.id) ||
-  manifest.id.startsWith("builtin.") ||
-  !/^[0-9][a-zA-Z0-9.+-]{0,63}$/.test(manifest.version) ||
-  !["path", "storage", "processor"].includes(manifest.kind) ||
-  manifest.apiVersion !== 1 ||
-  manifest.entry !== "index.js"
-)
-  throw new Error(
-    "Invalid plugin.json: check id, version, kind, apiVersion and entry",
-  );
-
-const build = await Bun.build({
-  entrypoints: ["src/index.ts"],
-  target: "bun",
-  format: "esm",
-  naming: "index.js",
-  plugins: [
-    {
-      name: "host-sharp",
-      setup(builder) {
-        builder.onResolve({ filter: /^sharp(?:\/|$)/ }, () => {
-          throw new Error(
-            "Use services.images.sharp; do not import the Sharp runtime",
-          );
-        });
-      },
-    },
-  ],
-});
-if (!build.success) throw new Error(build.logs.join("\n"));
-if (build.outputs.length !== 1 || build.outputs[0]?.kind !== "entry-point")
-  throw new Error(
-    "This template packages one JavaScript entry only; additional assets need explicit packaging",
-  );
-const code = await build.outputs[0].text();
-// Bundling must leave only Bun/Node builtins. Do not ship unresolved packages/assets.
-const imports = new Bun.Transpiler({ loader: "js", target: "bun" }).scanImports(
-  code,
-);
-const { isBuiltin } = await import("node:module");
-for (const item of imports) {
-  if (
-    item.path !== "bun" &&
-    !item.path.startsWith("bun:") &&
-    !isBuiltin(item.path)
-  )
-    throw new Error(`Unbundled runtime import: ${item.path}`);
-}
-// Evaluate the developer's own entry to catch a mismatched/missing default export.
-// Keep plugin top-level code free of network requests and other side effects.
-const { default: definition } = await import(
-  `data:text/javascript;base64,${Buffer.from(code).toString("base64")}`
-);
-for (const field of ["id", "version", "kind", "apiVersion"] as const) {
-  if (definition?.[field] !== manifest[field])
-    throw new Error(
-      `Plugin default export does not match plugin.json: ${field}`,
-    );
-}
-const zip = zipSync({
-  "plugin.json": strToU8(JSON.stringify(manifest, null, 2) + "\n"),
-  "index.js": strToU8(code),
-});
-if (zip.byteLength > 20 * 1024 * 1024)
-  throw new Error("Plugin ZIP exceeds Picloom's 20 MiB upload limit");
-await mkdir("dist", { recursive: true });
-const output = resolve("dist", `${manifest.id}-${manifest.version}.zip`);
-await Bun.write(output, zip);
-console.log(output);