@ykdz/template 0.0.38 → 0.0.41

package/node_modules/undici-types/websocket.d.ts

@@ -0,0 +1,188 @@
+/// <reference types="node" />
+
+import type { Blob } from 'node:buffer'
+import type { ReadableStream, WritableStream } from 'node:stream/web'
+import type { MessagePort } from 'node:worker_threads'
+import {
+  EventInit,
+  EventListenerOptions,
+  AddEventListenerOptions,
+  EventListenerOrEventListenerObject
+} from './patch'
+import Dispatcher from './dispatcher'
+import { HeadersInit } from './fetch'
+
+export type BinaryType = 'blob' | 'arraybuffer'
+
+interface WebSocketEventMap {
+  close: CloseEvent
+  error: ErrorEvent
+  message: MessageEvent
+  open: Event
+}
+
+interface WebSocket extends EventTarget {
+  binaryType: BinaryType
+
+  readonly bufferedAmount: number
+  readonly extensions: string
+
+  onclose: ((this: WebSocket, ev: WebSocketEventMap['close']) => any) | null
+  onerror: ((this: WebSocket, ev: WebSocketEventMap['error']) => any) | null
+  onmessage: ((this: WebSocket, ev: WebSocketEventMap['message']) => any) | null
+  onopen: ((this: WebSocket, ev: WebSocketEventMap['open']) => any) | null
+
+  readonly protocol: string
+  readonly readyState: number
+  readonly url: string
+
+  close(code?: number, reason?: string): void
+  send(data: string | ArrayBufferLike | Blob | ArrayBufferView): void
+
+  readonly CLOSED: number
+  readonly CLOSING: number
+  readonly CONNECTING: number
+  readonly OPEN: number
+
+  addEventListener<K extends keyof WebSocketEventMap>(
+    type: K,
+    listener: (this: WebSocket, ev: WebSocketEventMap[K]) => any,
+    options?: boolean | AddEventListenerOptions
+  ): void
+  addEventListener(
+    type: string,
+    listener: EventListenerOrEventListenerObject,
+    options?: boolean | AddEventListenerOptions
+  ): void
+  removeEventListener<K extends keyof WebSocketEventMap>(
+    type: K,
+    listener: (this: WebSocket, ev: WebSocketEventMap[K]) => any,
+    options?: boolean | EventListenerOptions
+  ): void
+  removeEventListener(
+    type: string,
+    listener: EventListenerOrEventListenerObject,
+    options?: boolean | EventListenerOptions
+  ): void
+}
+
+export declare const WebSocket: {
+  prototype: WebSocket
+  new (url: string | URL, protocols?: string | string[] | WebSocketInit): WebSocket
+  readonly CLOSED: number
+  readonly CLOSING: number
+  readonly CONNECTING: number
+  readonly OPEN: number
+}
+
+interface CloseEventInit extends EventInit {
+  code?: number
+  reason?: string
+  wasClean?: boolean
+}
+
+interface CloseEvent extends Event {
+  readonly code: number
+  readonly reason: string
+  readonly wasClean: boolean
+}
+
+export declare const CloseEvent: {
+  prototype: CloseEvent
+  new (type: string, eventInitDict?: CloseEventInit): CloseEvent
+}
+
+interface MessageEventInit<T = any> extends EventInit {
+  data?: T
+  lastEventId?: string
+  origin?: string
+  ports?: MessagePort[]
+  source?: MessagePort | null
+}
+
+interface MessageEvent<T = any> extends Event {
+  readonly data: T
+  readonly lastEventId: string
+  readonly origin: string
+  readonly ports: readonly MessagePort[]
+  readonly source: MessagePort | null
+  initMessageEvent(
+    type: string,
+    bubbles?: boolean,
+    cancelable?: boolean,
+    data?: any,
+    origin?: string,
+    lastEventId?: string,
+    source?: MessagePort | null,
+    ports?: MessagePort[]
+  ): void;
+}
+
+export declare const MessageEvent: {
+  prototype: MessageEvent
+  new<T>(type: string, eventInitDict?: MessageEventInit<T>): MessageEvent<T>
+}
+
+interface ErrorEventInit extends EventInit {
+  message?: string
+  filename?: string
+  lineno?: number
+  colno?: number
+  error?: any
+}
+
+interface ErrorEvent extends Event {
+  readonly message: string
+  readonly filename: string
+  readonly lineno: number
+  readonly colno: number
+  readonly error: Error
+}
+
+export declare const ErrorEvent: {
+  prototype: ErrorEvent
+  new (type: string, eventInitDict?: ErrorEventInit): ErrorEvent
+}
+
+interface WebSocketInit {
+  protocols?: string | string[],
+  dispatcher?: Dispatcher,
+  headers?: HeadersInit
+}
+
+interface WebSocketStreamOptions {
+  protocols?: string | string[]
+  signal?: AbortSignal
+}
+
+interface WebSocketCloseInfo {
+  closeCode: number
+  reason: string
+}
+
+interface WebSocketStream {
+  closed: Promise<WebSocketCloseInfo>
+  opened: Promise<{
+    extensions: string
+    protocol: string
+    readable: ReadableStream
+    writable: WritableStream
+  }>
+  url: string
+
+  close(options?: Partial<WebSocketCloseInfo>): void
+}
+
+export declare const WebSocketStream: {
+  prototype: WebSocketStream
+  new (url: string | URL, options?: WebSocketStreamOptions): WebSocketStream
+}
+
+interface WebSocketError extends Event, WebSocketCloseInfo {}
+
+export declare const WebSocketError: {
+  prototype: WebSocketError
+  new (type: string, init?: WebSocketCloseInfo): WebSocketError
+}
+
+export declare const ping: (ws: WebSocket, body?: Buffer) => void

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ykdz/template",
-  "version": "0.0.38",
+  "version": "0.0.41",
   "private": false,
   "description": "Project template generator for YKDZ starter projects.",
   "keywords": [
@@ -45,9 +45,10 @@
     "access": "public"
   },
   "dependencies": {
+    "@valibot/to-json-schema": "^1.8.0",
+    "@ykdz/cli-contract": "0.2.1",
     "@ykdz/template-builtin-presets": "0.0.0",
     "@ykdz/template-core": "0.0.0",
-    "commander": "^15.0.0",
     "hosted-git-info": "^10.0.0",
     "lru-cache": "^11.5.3",
     "node-diff3": "^3.2.1",
@@ -70,9 +71,10 @@
     "vitest": "^5.0.0"
   },
   "bundleDependencies": [
+    "@valibot/to-json-schema",
+    "@ykdz/cli-contract",
     "@ykdz/template-builtin-presets",
     "@ykdz/template-core",
-    "commander",
     "hosted-git-info",
     "lru-cache",
     "node-diff3",

package/dist/command-result.d.ts

@@ -1,9 +0,0 @@
-import { type BlueprintValidationCommandResult, type InitCommandResult, type PackageAdditionCommandResult, type PresetCatalogCommandResult } from "./application.ts";
-export type TemplateCommandResult = PresetCatalogCommandResult | BlueprintValidationCommandResult | InitCommandResult | PackageAdditionCommandResult;
-export type CommandPresentation = {
-    readonly destination: "stdout" | "stderr";
-    readonly text: string;
-    readonly exitCode: 0 | 1 | 2 | 64 | 65;
-};
-/** 纯投影；main 拥有身份前缀和实际流写入。 */
-export declare function projectCommandResult(result: TemplateCommandResult, json: boolean, cliVersion: string): CommandPresentation;

package/dist/command-result.js

@@ -1,231 +0,0 @@
-import {} from "./application.js";
-/** 纯投影；main 拥有身份前缀和实际流写入。 */
-export function projectCommandResult(result, json, cliVersion) {
-    const exitCode = exitCodeFor(result);
-    if (json) {
-        return {
-            destination: "stdout",
-            text: `${JSON.stringify({ ...result, cliVersion })}\n`,
-            exitCode,
-        };
-    }
-    return {
-        destination: exitCode === 0 ? "stdout" : "stderr",
-        text: `${formatHuman(result)}\n`,
-        exitCode,
-    };
-}
-function exitCodeFor(result) {
-    if (result.command === "presets")
-        return 0;
-    if (result.command === "blueprint validate") {
-        return result.status === "success"
-            ? 0
-            : result.status === "invalid"
-                ? 1
-                : 65;
-    }
-    switch (result.status) {
-        case "success":
-            return 0;
-        case "conflict":
-            return 1;
-        case "cancelled":
-            return 2;
-        case "usage-error":
-            return 64;
-        case "operation-failure":
-            return 65;
-    }
-}
-function formatHuman(result) {
-    if (result.command === "presets")
-        return formatPresets(result);
-    if (result.command === "blueprint validate")
-        return formatBlueprint(result);
-    if (result.command === "init")
-        return formatInit(result);
-    return formatAddition(result);
-}
-function formatInit(result) {
-    switch (result.status) {
-        case "success":
-            return [
-                result.dryRun ? "项目生成预览" : "已初始化项目",
-                "",
-                ...rows([
-                    ["预设", result.resolved.preset],
-                    ["名称", result.resolved.packages.map(({ name }) => name).join(", ")],
-                    ["路径", result.resolved.packages.map(({ path }) => path).join(", ")],
-                    ["Scope", result.resolved.scope],
-                    ["目标", result.targetDir],
-                ]),
-                ...(result.dryRun
-                    ? []
-                    : [
-                        "",
-                        "下一步",
-                        "",
-                        ...result.nextSteps.map((item, index) => `  ${index + 1}. ${item.display}`),
-                    ]),
-                ...(result.publicationSetup === null
-                    ? []
-                    : [
-                        "",
-                        "一次性 npm 发布设置",
-                        "",
-                        `  ${result.publicationSetup.command}`,
-                    ]),
-            ].join("\n");
-        case "cancelled":
-            return "已取消初始化；没有写入目标目录。";
-        case "usage-error":
-            return [
-                `错误 [${result.code}]: 初始化参数无效。`,
-                ...result.issues.map((issue) => `  ${initIssueMessage(issue.code)}`),
-                "建议: 修正上述输入后重新运行初始化。",
-            ].join("\n");
-        case "operation-failure":
-            return [
-                `错误 [${result.code}]: ${result.error.message}`,
-                `目标: ${result.targetDir}`,
-                `建议: ${result.error.suggestion}`,
-            ].join("\n");
-    }
-}
-function rows(items) {
-    const width = Math.max(...items.map(([label]) => `${label}:`.length));
-    return items.map(([label, value]) => `  ${`${label}:`.padEnd(width)} ${value}`);
-}
-function initIssueMessage(code) {
-    switch (code) {
-        case "PRESET_UNKNOWN":
-            return "--preset 必须指定一个已支持的内置预设。";
-        case "FIXED_TOPOLOGY_OVERRIDE":
-            return "该预设使用固定初始包拓扑，不能同时使用 --name 或 --path。";
-        case "INVALID_PACKAGE_NAME":
-            return "--name 必须是有效的无 scope 包叶名称。";
-        case "INVALID_PACKAGE_PATH":
-            return "--path 必须恰好包含两个安全路径段。";
-        case "RESERVED_PACKAGE_PATH":
-            return "--path 不能使用保留的工作区集合。";
-        case "INVALID_PACKAGE_SCOPE":
-            return "--scope 必须是不含空白字符的有效 npm scope。";
-        case "INVALID_REPOSITORY_SCOPE":
-            return "目标目录名不能作为默认包 scope；请传入有效的 --scope。";
-        case "CONFLICTING_PACKAGE_IDENTITY":
-            return "初始包身份不能与 Foundation 的 TypeScript 配置包冲突。";
-        case "NON_INTERACTIVE_CONFIRMATION_REQUIRED":
-            return "非交互式初始化必须显式传入 --yes 接受默认值。";
-    }
-}
-function formatPresets(result) {
-    const width = Math.max(...result.presets.map((preset) => `${preset.name}:`.length));
-    return [
-        "内置预设",
-        "",
-        ...result.presets.map((preset) => `  ${`${preset.name}:`.padEnd(width)} ${preset.title} - ${preset.description}`),
-    ].join("\n");
-}
-function formatBlueprint(result) {
-    switch (result.status) {
-        case "success":
-            return "蓝图有效。";
-        case "invalid":
-            return [
-                `错误 [BLUEPRINT_INVALID]: 蓝图无效。`,
-                "",
-                ...result.issues.map((issue) => `  ${issue.path}: 该位置的 Blueprint 定义不符合要求；请检查必填字段、数据类型和拓扑约束。`),
-                "",
-                "建议: 修正上述 Blueprint 问题后重新验证。",
-            ].join("\n");
-        case "operation-failure":
-            return [
-                `错误 [${result.code}]: ${result.error.message}`,
-                `路径: ${result.path}`,
-                `建议: ${result.error.suggestion}`,
-            ].join("\n");
-    }
-}
-function formatAddition(result) {
-    switch (result.status) {
-        case "success":
-            return [
-                result.dryRun ? "Package Addition 预览" : "已添加 Package",
-                "",
-                ...(result.actions.length === 0
-                    ? ["没有变更。"]
-                    : result.actions.map((action) => `  ${action.action} ${action.path} (${action.driver})`)),
-            ].join("\n");
-        case "conflict":
-            return [
-                "Package Addition 冲突",
-                "",
-                ...result.conflicts.flatMap((conflict) => "kind" in conflict
-                    ? [
-                        `  ${conflict.kind === "missing-link" ? "Package Link" : "Package Identity"}`,
-                        `    已有: ${conflict.existing.name} (${conflict.existing.path}, ${conflict.existing.role})`,
-                        `    请求: ${conflict.requested.name} (${conflict.requested.path}, ${conflict.requested.role})`,
-                        ...(conflict.missingLink === undefined
-                            ? []
-                            : [
-                                `    缺少链接: ${conflict.missingLink.consumerPackagePath} -> ${conflict.missingLink.providerPackagePath}`,
-                            ]),
-                    ]
-                    : [
-                        `  ${conflict.path} (${conflict.driver})`,
-                        ...(conflict.location === undefined
-                            ? []
-                            : [`    位置: ${conflict.location || "<文档根>"}`]),
-                        ...(conflict.region === undefined
-                            ? []
-                            : [
-                                `    区域: 生成前第 ${conflict.region.before.startLine} 行；当前第 ${conflict.region.current.startLine} 行；请求后第 ${conflict.region.after.startLine} 行`,
-                            ]),
-                        ...(conflict.attribute === undefined
-                            ? []
-                            : [`    属性: ${conflict.attribute}`]),
-                        `    原因: ${conflict.reason}`,
-                        `    生成前: ${conflict.context.before}`,
-                        `    当前: ${conflict.context.current}`,
-                        `    请求后: ${conflict.context.after}`,
-                    ]),
-                "",
-                "建议: 处理冲突后重试；命令没有写入工作区。",
-            ].join("\n");
-        case "usage-error":
-            return [
-                `错误 [${result.code}]: Package Addition 输入无效。`,
-                ...result.issues.map((issue) => `  ${additionIssueMessage(issue.code)}`),
-                "建议: 修正上述输入后重新运行。",
-            ].join("\n");
-        case "operation-failure":
-            return [
-                `错误 [${result.code}]: ${result.error.message}`,
-                `阶段: ${result.phase}`,
-                `建议: ${result.error.suggestion}`,
-            ].join("\n");
-    }
-}
-function additionIssueMessage(code) {
-    switch (code) {
-        case "PRESET_UNKNOWN":
-            return "未找到该预设；使用 template presets 查看可用预设。";
-        case "PRESET_NOT_ADDABLE":
-            return "该预设不支持添加 Package；选择支持 Package Addition 的预设。";
-        case "INVALID_PACKAGE_NAME":
-            return "Package 名称必须是有效的小写 npm 叶名称。";
-        case "INVALID_PACKAGE_PATH":
-            return "Package 路径必须是两段小写路径，例如 packages/example。";
-        case "RESERVED_PACKAGE_PATH":
-            return "Package 路径不能使用保留工作区目录。";
-        case "INVALID_LINK_FROM":
-            return "--link-from 必须是两段现有 Package 路径。";
-        case "RESERVED_LINK_FROM":
-            return "--link-from 不能使用保留工作区目录。";
-        case "UNKNOWN_LINK_FROM":
-            return "--link-from 指向的 consumer Package 不存在；选择 Blueprint 中已有的 Package 路径。";
-        case "UNSUPPORTED_LINK":
-            return "该 consumer 与 provider 不支持 Package Link；选择兼容的 Package 角色与公开接口。";
-    }
-}

package/node_modules/@ykdz/template-builtin-presets/templates/ts-cli/test/e2e/journeys/greet.journey.ts

@@ -1,46 +0,0 @@
-import assert from "node:assert/strict";
-import { readFile, writeFile } from "node:fs/promises";
-import path from "node:path";
-
-import type { CliJourney } from "../journey.ts";
-
-const journey: CliJourney = {
-  name: "greet",
-  modes: ["source", "distribution", "packed"],
-  async setup(context) {
-    await writeFile(
-      path.join(context.workDir, "journey-ready.txt"),
-      `${context.mode}\n`,
-    );
-  },
-  commands() {
-    return [
-      {
-        name: "valid greeting",
-        args: ["greet", "  Ada Lovelace  "],
-      },
-      {
-        name: "invalid greeting",
-        args: ["greet", "   "],
-      },
-    ];
-  },
-  async assertions({ context, results }) {
-    assert.equal(
-      await readFile(path.join(context.workDir, "journey-ready.txt"), "utf8"),
-      `${context.mode}\n`,
-    );
-    assert.deepEqual(results[0], {
-      commandName: "valid greeting",
-      exitCode: 0,
-      stdout: "Hello, Ada Lovelace\n",
-      stderr: "",
-    });
-    assert.equal(results[1]?.commandName, "invalid greeting");
-    assert.equal(results[1]?.exitCode, 1);
-    assert.equal(results[1]?.stdout, "");
-    assert.match(results[1]?.stderr ?? "", /error: Name must not be empty/u);
-  },
-};
-
-export default journey;

package/node_modules/@ykdz/template-builtin-presets/templates/ts-cli/test/unit/greet.test.ts

@@ -1,15 +0,0 @@
-import { describe, expect, it } from "vitest";
-
-import { greet } from "../../src/main.ts";
-
-describe("greet", () => {
-  it("normalizes a name and returns a deterministic greeting", () => {
-    expect(greet("  Ada Lovelace  ")).toEqual({
-      message: "Hello, Ada Lovelace",
-    });
-  });
-
-  it("rejects an empty normalized name", () => {
-    expect(() => greet("   ")).toThrow("Name must not be empty");
-  });
-});

package/node_modules/commander/LICENSE

@@ -1,22 +0,0 @@
-(The MIT License)
-
-Copyright (c) 2011 TJ Holowaychuk <tj@vision-media.ca>
-
-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.