mn-ws 0.1.0 → 0.2.1

package/dist/runtime/spec.js

@@ -0,0 +1,180 @@
+// action 规格的解析、校验与文本生成。
+//
+// 一处声明，两端生效：CLI 的 `--flag` 与 HTTP 的 query/body 都走同一套强转与校验。
+// 这正是历史上 `parseInt(flags.depth, 10) || 3` 散落在各处的根源——两端各写一遍解析，
+// 迟早分叉。现在 depth 只在 action 声明里写一次 `{ type: 'number', default: 3 }`。
+import { readFileSync } from 'node:fs';
+import { badInput } from '../core/errors/index.js';
+import { APP_NAME } from '../core/paths.js';
+const TYPES = new Set(['string', 'number', 'boolean', 'array', 'json', 'kv']);
+// 取 action 的 CLI 路径列表。支持两种写法：
+//   单路径   cli: ['repo', 'list']
+//   多路径   cli: [['bundled','list'], ['skill','install','--list']]   ← 别名
+export function cliPathsOf(action) {
+    const cli = action.cli;
+    if (!cli || !cli.length)
+        return [];
+    const first = cli[0];
+    return Array.isArray(first) ? cli : [cli];
+}
+export function argSpecsOf(action) {
+    return (action.args || []).map((a) => typeof a === 'string'
+        ? { name: a, required: true }
+        : { ...a, required: a.required !== false });
+}
+export function flagSpecsOf(action) {
+    return Object.entries(action.flags || {}).map(([name, spec]) => ({ name, ...spec }));
+}
+// 该 action 里哪些 flag 是布尔型——CLI 解析据此决定要不要吃掉下一个 token 当值。
+// 少了这份信息，`skill install --force demo` 会把 force 解析成字符串 'demo'。
+export function booleanFlagNames(action) {
+    return new Set(flagSpecsOf(action)
+        .filter((f) => (f.type || 'string') === 'boolean')
+        .map((f) => f.name));
+}
+function coerceOne(name, spec, raw) {
+    const type = spec.type || 'string';
+    if (!TYPES.has(type))
+        throw new Error(`action 声明有误：flag "${name}" 的 type 非法 (${type})`);
+    if (raw === undefined || raw === null)
+        return undefined;
+    // 需要值的 flag 写在末尾时（`--depth` 后面没跟东西），解析器只能记成 true。
+    // 放任下去：Number(true) === 1 会静默变成「深度 1」这种另一个合法值，
+    // String(true) 则会让路径变成 'true'。宁可报错，也不要把笔误变成别的语义。
+    if (raw === true && type !== 'boolean') {
+        throw badInput(`参数 --${name} 需要提供值`);
+    }
+    if (type === 'boolean') {
+        if (typeof raw === 'boolean')
+            return raw;
+        const s = String(raw).toLowerCase();
+        return !(s === 'false' || s === '0' || s === 'no' || s === '');
+    }
+    if (type === 'number') {
+        const n = Number(raw);
+        if (!Number.isFinite(n))
+            throw badInput(`参数 ${name} 必须是数字，收到: ${raw}`);
+        return n;
+    }
+    if (type === 'array') {
+        if (Array.isArray(raw))
+            return raw.map((x) => String(x).trim()).filter(Boolean);
+        return String(raw).split(',').map((x) => x.trim()).filter(Boolean);
+    }
+    if (type === 'json') {
+        // HTTP 侧直接就是对象/数组；CLI 侧是字符串：`--groups '[{…}]'` 或 `--groups @groups.json`
+        if (typeof raw === 'object')
+            return raw;
+        const s = String(raw).trim();
+        if (s.startsWith('@')) {
+            const p = s.slice(1);
+            try {
+                return JSON.parse(readFileSync(p, 'utf8'));
+            }
+            catch (e) {
+                throw badInput(`参数 --${name} 读取文件失败: ${p}（${e.message}）`);
+            }
+        }
+        try {
+            return JSON.parse(s);
+        }
+        catch (e) {
+            throw badInput(`参数 --${name} 不是合法 JSON: ${e.message}`);
+        }
+    }
+    if (type === 'kv') {
+        // CLI：`--set name=值`（可重复，解析器会把同名 flag 收成数组）
+        // HTTP：`{set: {name: '值'}}` 或 `{set: ['name=值']}`
+        if (raw && typeof raw === 'object' && !Array.isArray(raw))
+            return { ...raw };
+        const list = Array.isArray(raw) ? raw : [raw];
+        const out = {};
+        for (const item of list) {
+            const s = String(item);
+            const eq = s.indexOf('=');
+            if (eq <= 0)
+                throw badInput(`参数 --${name} 需要 key=value 形式，收到 ${JSON.stringify(item)}`);
+            out[s.slice(0, eq).trim()] = s.slice(eq + 1);
+        }
+        return out;
+    }
+    return String(raw);
+}
+// 按声明校验并强转输入。未声明的键原样透传（HTTP body 可能带界面用的额外字段）。
+export function applySpec(action, raw) {
+    const out = { ...raw };
+    for (const spec of flagSpecsOf(action)) {
+        const v = coerceOne(spec.name, spec, raw[spec.name]);
+        if (v === undefined) {
+            if (spec.default !== undefined)
+                out[spec.name] = spec.default;
+            else if (spec.required)
+                throw inputError(action, `缺少参数 --${spec.name}`);
+            continue;
+        }
+        if (spec.enum && !spec.enum.includes(v)) {
+            throw inputError(action, `参数 --${spec.name} 只能是 ${spec.enum.join(' | ')}，收到: ${v}`);
+        }
+        out[spec.name] = v;
+    }
+    for (const spec of argSpecsOf(action)) {
+        const v = out[spec.name];
+        const empty = v === undefined || v === '' || (Array.isArray(v) && !v.length);
+        if (empty && spec.required)
+            throw inputError(action, `缺少参数 <${spec.name}>`);
+    }
+    return out;
+}
+const ROUTE_CACHE = new WeakMap();
+export function compileRoute(action) {
+    const cached = ROUTE_CACHE.get(action);
+    if (cached)
+        return cached;
+    const [method, pattern] = action.http;
+    const keys = [];
+    const body = pattern
+        .split('/')
+        .map((seg) => {
+        if (!seg.startsWith(':'))
+            return seg.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        keys.push(seg.slice(1));
+        return '([^/]+)';
+    })
+        .join('/');
+    const compiled = { method, keys, regex: new RegExp('^' + body + '$') };
+    ROUTE_CACHE.set(action, compiled);
+    return compiled;
+}
+// ---- 用法串生成：从声明反推，help 因此不可能与实际命令脱节 ----
+export function usageOf(action) {
+    const [path] = cliPathsOf(action);
+    const parts = [APP_NAME, ...(path || [])];
+    for (const a of argSpecsOf(action)) {
+        const label = a.rest ? `${a.name}...` : a.name;
+        parts.push(a.required ? `<${label}>` : `[${label}]`);
+    }
+    for (const f of flagSpecsOf(action)) {
+        let token;
+        if (f.type === 'boolean') {
+            token = `--${f.name}`;
+        }
+        else {
+            // 值的占位符优先用 enum 展开（--side <ours|theirs>），其次显式 hint，
+            // 最后才退回 flag 名——`--http <http>` 这种读起来没有信息量。
+            const hint = f.enum ? f.enum.join('|') : f.hint || f.name;
+            token = `--${f.name} <${hint}>`;
+        }
+        parts.push(f.required ? token : `[${token}]`);
+    }
+    // 开放式 action：可选项由数据驱动（模板的 option schema），
+    // 声明期无法枚举。用一句提示代替逐个列出，读者才知道还有别的开关。
+    if (action.openFlags)
+        parts.push('[--<选项> <值> ...]');
+    return parts.join(' ');
+}
+// 「用法:」前缀是**对外契约**：assets 文档教 agent 用错误文本里的「用法:」
+// 判定为参数错误并决定「停下来问人」。不能只写「缺少参数 X」，必须带完整用法串。
+function inputError(action, detail) {
+    return badInput(`用法: ${usageOf(action)} —— ${detail}`);
+}
+//# sourceMappingURL=spec.js.map

package/dist/runtime/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../src/runtime/spec.ts"],"names":[],"mappings":"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"}

package/dist/runtime/types/action.d.ts

@@ -0,0 +1,101 @@
+import type { ParamsCovered } from './http.js';
+export type FlagType = 'string' | 'number' | 'boolean' | 'array' | 'json' | 'kv';
+export interface FlagSpec {
+    type?: FlagType;
+    default?: unknown;
+    required?: boolean;
+    enum?: readonly unknown[];
+    hint?: string;
+}
+export type ArgEntry = string | {
+    name: string;
+    required?: boolean;
+    rest?: boolean;
+};
+export interface TransportMeta {
+    transport: 'cli' | 'http';
+}
+export type Err<Msg extends string> = {
+    readonly __error__: Msg;
+};
+export type Assert<Cond extends boolean, Msg extends string> = Cond extends true ? unknown : Err<Msg>;
+export type FlagValue<F> = F extends {
+    type: 'number';
+} ? number : F extends {
+    type: 'boolean';
+} ? boolean : F extends {
+    type: 'array';
+} ? string[] : F extends {
+    enum: infer E;
+} ? E extends readonly unknown[] ? E[number] : string : string;
+export type IsPresent<F> = F extends {
+    default: unknown;
+} ? true : F extends {
+    required: true;
+} ? true : false;
+export type CtxFlags<F> = unknown & {
+    [K in keyof F as IsPresent<F[K]> extends true ? K : never]: FlagValue<F[K]>;
+} & {
+    [K in keyof F as IsPresent<F[K]> extends true ? never : K]?: FlagValue<F[K]>;
+};
+export type UnionToIntersection<U> = (U extends unknown ? (x: U) => void : never) extends (x: infer I) => void ? I : never;
+export type CtxArgs<As> = UnionToIntersection<As extends readonly (infer A)[] ? A extends string ? {
+    [K in A]: string;
+} : A extends {
+    name: infer N extends string;
+} ? A extends {
+    required: false;
+} ? {
+    [K in N]?: A extends {
+        rest: true;
+    } ? string[] : string;
+} : {
+    [K in N]: A extends {
+        rest: true;
+    } ? string[] : string;
+} : never : never>;
+export type CtxOf<A> = unknown & (A extends {
+    flags: infer F;
+} ? CtxFlags<F> : unknown) & (A extends {
+    args: infer As;
+} ? CtxArgs<As> : unknown) & (A extends {
+    openFlags: true;
+} ? {
+    [k: string]: unknown;
+} : unknown);
+export interface ActionShape {
+    id: string;
+    cli: readonly string[] | readonly (readonly string[])[];
+    http?: readonly [string, string] | null;
+    /** 纯 CLI 的显式出口：http 必须同时为 null；表示「这个操作就是不给面板入口」 */
+    web?: boolean;
+    summary?: string;
+    args?: readonly ArgEntry[];
+    flags?: Record<string, FlagSpec>;
+    openFlags?: boolean;
+}
+type FlagsLegal<A> = A extends {
+    flags: infer F;
+} ? {
+    [K in keyof F]: F[K] extends {
+        type: infer T;
+    } ? T extends FlagType ? true : false : true;
+}[keyof F] extends true ? true : false : true;
+type HttpLegal<A> = A extends {
+    http: infer H;
+} ? H extends readonly [string, string] ? true : H extends null ? true : false : true;
+export type ValidateAction<A> = unknown & Assert<FlagsLegal<A>, 'flag 的 type 只能是 string | number | boolean | array'> & Assert<HttpLegal<A>, 'http 必须是 [METHOD, PATTERN] 或显式 null'> & Assert<ParamsCovered<A>, '路由 :param 与 args 名不一致（运行时会静默变 undefined）'>;
+export type RunResult<A> = A extends {
+    run: (...a: any[]) => infer R;
+} ? Awaited<R> : never;
+export interface ActionDefinition<A> extends ActionShape {
+    run: (ctx: CtxOf<A>, meta: TransportMeta) => unknown;
+    render?: (result: RunResult<A>, ctx: CtxOf<A>) => unknown;
+}
+export type TypedAction<S, R> = S & {
+    run: (ctx: CtxOf<S>, meta?: TransportMeta) => R;
+    render?: (result: Awaited<R>, ctx?: CtxOf<S>) => string | Promise<string>;
+};
+export declare function defineAction<const S>(spec: S & ActionShape & ValidateAction<S>): <R>(run: (ctx: CtxOf<S>, meta: TransportMeta) => R, render?: (result: Awaited<R>, ctx: CtxOf<S>) => string | Promise<string>) => TypedAction<S, Awaited<R>>;
+export {};
+//# sourceMappingURL=action.d.ts.map

package/dist/runtime/types/action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../src/runtime/types/action.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;AAEjF,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAGD,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN;IACE,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEN,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAID,MAAM,MAAM,GAAG,CAAC,GAAG,SAAS,MAAM,IAAI;IAAE,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAA;CAAE,CAAC;AAElE,MAAM,MAAM,MAAM,CAAC,IAAI,SAAS,OAAO,EAAE,GAAG,SAAS,MAAM,IAAI,IAAI,SAAS,IAAI,GAC5E,OAAO,GACP,GAAG,CAAC,GAAG,CAAC,CAAC;AAIb,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GACnD,MAAM,GACN,CAAC,SAAS;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAC3B,OAAO,GACP,CAAC,SAAS;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACzB,MAAM,EAAE,GACR,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,GACzB,CAAC,SAAS,SAAS,OAAO,EAAE,GAC1B,CAAC,CAAC,MAAM,CAAC,GACT,MAAM,GACR,MAAM,CAAC;AAGjB,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GACrD,IAAI,GACJ,CAAC,SAAS;IAAE,QAAQ,EAAE,IAAI,CAAA;CAAE,GAC1B,IAAI,GACJ,KAAK,CAAC;AAEZ,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,OAAO,GAAG;KAC/B,CAAC,IAAI,MAAM,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,GAAG,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC5E,GACC;KACC,CAAC,IAAI,MAAM,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC7E,CAAC;AAEJ,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,KAAK,CAAC,SAAS,CACxF,CAAC,EAAE,MAAM,CAAC,KACP,IAAI,GACL,CAAC,GACD,KAAK,CAAC;AAEV,MAAM,MAAM,OAAO,CAAC,EAAE,IAAI,mBAAmB,CAC3C,EAAE,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAC3B,CAAC,SAAS,MAAM,GACd;KAAG,CAAC,IAAI,CAAC,GAAG,MAAM;CAAE,GACpB,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,SAAS,MAAM,CAAA;CAAE,GACxC,CAAC,SAAS;IAAE,QAAQ,EAAE,KAAK,CAAA;CAAE,GAC3B;KAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,GAAG,MAAM,EAAE,GAAG,MAAM;CAAE,GAC3D;KAAG,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,GAAG,MAAM,EAAE,GAAG,MAAM;CAAE,GAC5D,KAAK,GACT,KAAK,CACV,CAAC;AAGF,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,GACnF,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,GACtD,CAAC,CAAC,SAAS;IAAE,SAAS,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,CAAC;AAIzE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;IACxD,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACxC,mDAAmD;IACnD,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAGD,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC,CAAA;CAAE,GAC7C;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC,CAAA;KAAE,GAC1C,CAAC,SAAS,QAAQ,GAChB,IAAI,GACJ,KAAK,GACP,IAAI;CACT,CAAC,MAAM,CAAC,CAAC,SAAS,IAAI,GACrB,IAAI,GACJ,KAAK,GACP,IAAI,CAAC;AAGT,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,GAC3C,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,IAAI,GACJ,CAAC,SAAS,IAAI,GACZ,IAAI,GACJ,KAAK,GACT,IAAI,CAAC;AAET,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,mDAAmD,CAAC,GAChH,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,qCAAqC,CAAC,GAC3D,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,0CAA0C,CAAC,CAAC;AAGzE,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AAG5F,MAAM,WAAW,gBAAgB,CAAC,CAAC,CAAE,SAAQ,WAAW;IACtD,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC;IACrD,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC;CAC3D;AAKD,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAClC,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,aAAa,KAAK,CAAC,CAAC;IAChD,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3E,CAAC;AASF,wBAAgB,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,WAAW,GAAG,cAAc,CAAC,CAAC,CAAC,IACrE,CAAC,EACP,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,KAAK,CAAC,EAC9C,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KACvE,WAAW,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAC9B"}

package/dist/runtime/types/action.js

@@ -0,0 +1,19 @@
+// action 类型系统的核心。
+//
+// 一份 action 声明字面量同时产出：
+//   运行时 —— spec.js 的强转/校验/help 派生（原样保留）
+//   编译期 —— CtxOf 推出 ctx 形状；run 返回值推出 render 参数与 API 响应类型
+//
+// 报错手法：Assert<条件, 消息> 在条件不成立时让参数类型长出 __error__ 字段，
+// 调用处对象缺该字段即报红，消息直接展示在错误信息里。
+// 唯一入口，两段式：
+//   第一段 defineAction(声明)：const 参数推断并保留字面量，执行声明级校验；
+//   第二段 (run, render?)：ctx 被 CtxOf<S> 精确上下文类型化，
+//                          render 参数由 run 返回值推出。
+//
+// 为什么不是单调用：自引用泛型（同对象内从 flags 推 run 的 ctx）在 TS 中会
+// 退化成 any/unknown（实测 TS 5.9 仍如此）；两段式把推断顺序显式化，零歧义。
+export function defineAction(spec) {
+    return (run, render) => ({ ...spec, run, render });
+}
+//# sourceMappingURL=action.js.map

package/dist/runtime/types/action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.js","sourceRoot":"","sources":["../../../src/runtime/types/action.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAClB,EAAE;AACF,uBAAuB;AACvB,wCAAwC;AACxC,yDAAyD;AACzD,EAAE;AACF,mDAAmD;AACnD,6BAA6B;AA+I7B,YAAY;AACZ,mDAAmD;AACnD,gDAAgD;AAChD,iDAAiD;AACjD,EAAE;AACF,iDAAiD;AACjD,kDAAkD;AAClD,MAAM,UAAU,YAAY,CAAU,IAAyC;IAC7E,OAAO,CACL,GAA8C,EAC9C,MAAwE,EAC5C,EAAE,CAAC,CAAC,EAAE,GAAI,IAAe,EAAE,GAAG,EAAE,MAAM,EAAiC,CAAA,CAAC;AACxG,CAAC"}

package/dist/runtime/types/client.d.ts

@@ -0,0 +1,39 @@
+import type { ArgEntry, FlagSpec } from './action.js';
+import type { ActionIds, AllActions } from './module.js';
+export type FindAction<AA extends readonly unknown[], Id> = AA extends readonly [
+    infer H,
+    ...infer R
+] ? H extends {
+    id: Id;
+} ? H : FindAction<R extends readonly unknown[] ? R : [], Id> : never;
+export type PatternParams<P extends string> = P extends `${string}:${infer K}/${infer Rest}` ? K | PatternParams<`/${Rest}`> : P extends `${string}:${infer K}` ? K : never;
+type FlagInputValue<F extends FlagSpec> = F['type'] extends 'boolean' ? boolean : F['type'] extends 'number' ? number : F['type'] extends 'array' ? string[] | string : F['enum'] extends readonly (infer E)[] ? E : string;
+type Empty = {};
+export type FlagInputOf<A> = A extends {
+    flags: infer F;
+} ? {
+    [K in keyof F]?: F[K] extends FlagSpec ? FlagInputValue<F[K]> : unknown;
+} : Empty;
+type ArgObjects<Args> = Extract<Args extends readonly unknown[] ? Args[number] : never, {
+    name: string;
+}>;
+type RequiredArgInput<Args extends readonly ArgEntry[]> = {
+    [E in ArgObjects<Args> as E['required'] extends true ? E['name'] : never]: E['rest'] extends true ? string[] : string | number;
+};
+type OptionalArgInput<Args extends readonly ArgEntry[]> = {
+    [E in ArgObjects<Args> as E['required'] extends true ? never : E['name']]?: E['rest'] extends true ? string[] : string | number;
+};
+export type ArgInputOf<A> = A extends {
+    args: infer Args;
+} ? Args extends readonly ArgEntry[] ? RequiredArgInput<Args> & OptionalArgInput<Args> : Empty : Empty;
+export type CallParams<A> = (A extends {
+    http: readonly [string, infer P extends string];
+} ? PatternParams<P> extends never ? Empty : Record<PatternParams<P>, string | number> : Empty) & ArgInputOf<A> & FlagInputOf<A>;
+export type CallResult<A> = A extends {
+    run: (...a: any[]) => infer R;
+} ? Awaited<R> : unknown;
+export type TypedClient<M extends readonly unknown[]> = ActionIds<AllActions<M>> extends infer Ids extends readonly string[] ? {
+    [Id in Ids[number]]: (params: CallParams<FindAction<AllActions<M>, Id>>) => Promise<CallResult<FindAction<AllActions<M>, Id>>>;
+} : Empty;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/runtime/types/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/runtime/types/client.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzD,MAAM,MAAM,UAAU,CAAC,EAAE,SAAS,SAAS,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,SAAS;IAC9E,MAAM,CAAC;IACP,GAAG,MAAM,CAAC;CACX,GACG,CAAC,SAAS;IAAE,EAAE,EAAE,EAAE,CAAA;CAAE,GAClB,CAAC,GACD,UAAU,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,GAAG,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,GACvD,KAAK,CAAC;AAGV,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,IAAI,MAAM,CAAC,IAAI,MAAM,IAAI,EAAE,GACxF,CAAC,GAAG,aAAa,CAAC,IAAI,IAAI,EAAE,CAAC,GAC7B,CAAC,SAAS,GAAG,MAAM,IAAI,MAAM,CAAC,EAAE,GAC9B,CAAC,GACD,KAAK,CAAC;AAGZ,KAAK,cAAc,CAAC,CAAC,SAAS,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,SAAS,GACjE,OAAO,GACP,CAAC,CAAC,MAAM,CAAC,SAAS,QAAQ,GACxB,MAAM,GACN,CAAC,CAAC,MAAM,CAAC,SAAS,OAAO,GACvB,MAAM,EAAE,GAAG,MAAM,GACjB,CAAC,CAAC,MAAM,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GACpC,CAAC,GACD,MAAM,CAAC;AAIjB,KAAK,KAAK,GAAG,EAAE,CAAC;AAGhB,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC,CAAA;CAAE,GACrD;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,QAAQ,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO;CAAE,GAC3E,KAAK,CAAC;AAOV,KAAK,UAAU,CAAC,IAAI,IAAI,OAAO,CAC7B,IAAI,SAAS,SAAS,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,KAAK,EACtD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CACjB,CAAC;AAEF,KAAK,gBAAgB,CAAC,IAAI,SAAS,SAAS,QAAQ,EAAE,IAAI;KACvD,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,SAAS,IAAI,GAC7F,MAAM,EAAE,GACR,MAAM,GAAG,MAAM;CACpB,CAAC;AACF,KAAK,gBAAgB,CAAC,IAAI,SAAS,SAAS,QAAQ,EAAE,IAAI;KACvD,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,SAAS,IAAI,GAC9F,MAAM,EAAE,GACR,MAAM,GAAG,MAAM;CACpB,CAAC;AACF,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,IAAI,CAAA;CAAE,GACtD,IAAI,SAAS,SAAS,QAAQ,EAAE,GAC9B,gBAAgB,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,GAC/C,KAAK,GACP,KAAK,CAAC;AAGV,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,MAAM,CAAC,CAAA;CAAE,GACtF,aAAa,CAAC,CAAC,CAAC,SAAS,KAAK,GAC5B,KAAK,GACL,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,GAC3C,KAAK,CAAC,GACR,UAAU,CAAC,CAAC,CAAC,GACb,WAAW,CAAC,CAAC,CAAC,CAAC;AAGjB,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;AAG/F,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,SACxF,SAAS,MAAM,EAAE,GACvB;KACG,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CACnB,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAC9C,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;CACxD,GACD,KAAK,CAAC"}

package/dist/runtime/types/client.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.js.map

package/dist/runtime/types/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/runtime/types/client.ts"],"names":[],"mappings":""}

package/dist/runtime/types/http.d.ts

@@ -0,0 +1,22 @@
+export type RouteParams<P extends string> = P extends `${string}:${infer Rest}` ? Rest extends `${infer Name}/${infer More}` ? Name | RouteParams<`/${More}`> : Rest : never;
+export type ArgNames<A> = A extends {
+    args: infer As;
+} ? As extends readonly unknown[] ? As[number] extends infer X ? X extends string ? X : X extends {
+    name: infer N;
+} ? N : never : never : never : never;
+type PatternOf<A> = A extends {
+    http: infer H;
+} ? H extends readonly [string, infer P] ? P : never : never;
+export type ParamsCovered<A> = [RouteParams<PatternOf<A>>] extends [never] ? true : RouteParams<PatternOf<A>> extends ArgNames<A> ? true : false;
+type Segs<P extends string> = P extends `${infer H}/${infer R}` ? [H, ...Segs<R>] : [P];
+type SegMatch<A extends string, B extends string> = A extends `:${string}` ? true : B extends `:${string}` ? true : A extends B ? true : false;
+type SameLenCompat<X extends readonly string[], Y extends readonly string[]> = X extends readonly [
+    infer XH extends string,
+    ...infer XR extends string[]
+] ? Y extends readonly [infer YH extends string, ...infer YR extends string[]] ? SegMatch<XH, YH> extends true ? SameLenCompat<XR, YR> : false : false : true;
+export type Overlap<P extends string, Q extends string> = Segs<P>['length'] extends Segs<Q>['length'] ? SameLenCompat<Segs<P>, Segs<Q>> : false;
+export type AmbiguousPairs<Ps extends readonly string[], I extends unknown[] = []> = I['length'] extends Ps['length'] ? never : Ps[I['length'] & number] extends infer P extends string ? {
+    [J in keyof Ps]: J extends `${I['length']}` ? never : Overlap<P, Ps[J] extends string ? Ps[J] : never> extends true ? `${P} ≈ ${Ps[J]}` : never;
+}[number] | AmbiguousPairs<Ps, [...I, 1]> : never;
+export {};
+//# sourceMappingURL=http.d.ts.map

package/dist/runtime/types/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/runtime/types/http.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,IAAI,MAAM,IAAI,EAAE,GAC3E,IAAI,SAAS,GAAG,MAAM,IAAI,IAAI,MAAM,IAAI,EAAE,GACxC,IAAI,GAAG,WAAW,CAAC,IAAI,IAAI,EAAE,CAAC,GAC9B,IAAI,GACN,KAAK,CAAC;AAEV,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAClD,EAAE,SAAS,SAAS,OAAO,EAAE,GAC3B,EAAE,CAAC,MAAM,CAAC,SAAS,MAAM,CAAC,GACxB,CAAC,SAAS,MAAM,GACd,CAAC,GACD,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,GACzB,CAAC,GACD,KAAK,GACT,KAAK,GACP,KAAK,GACP,KAAK,CAAC;AAEV,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,GAC3C,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAClC,CAAC,GACD,KAAK,GACP,KAAK,CAAC;AAIV,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GACtE,IAAI,GACJ,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,GAC3C,IAAI,GACJ,KAAK,CAAC;AAIZ,KAAK,IAAI,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAExF,KAAK,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,IAAI,MAAM,EAAE,GACtE,IAAI,GACJ,CAAC,SAAS,IAAI,MAAM,EAAE,GACpB,IAAI,GACJ,CAAC,SAAS,CAAC,GACT,IAAI,GACJ,KAAK,CAAC;AAEd,KAAK,aAAa,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE,EAAE,CAAC,SAAS,SAAS,MAAM,EAAE,IAAI,CAAC,SAAS,SAAS;IAChG,MAAM,EAAE,SAAS,MAAM;IACvB,GAAG,MAAM,EAAE,SAAS,MAAM,EAAE;CAC7B,GACG,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,GACxE,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,IAAI,GAC3B,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC,GACrB,KAAK,GACP,KAAK,GACP,IAAI,CAAC;AAGT,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GACjG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAC/B,KAAK,CAAC;AAGV,MAAM,MAAM,cAAc,CAAC,EAAE,SAAS,SAAS,MAAM,EAAE,EAAE,CAAC,SAAS,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,GACjH,KAAK,GACL,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,SAAS,MAAM,CAAC,SAAS,MAAM,GAEjD;KACG,CAAC,IAAI,MAAM,EAAE,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,GACvC,KAAK,GACL,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,SAAS,IAAI,GAC3D,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,GACjB,KAAK;CACZ,CAAC,MAAM,CAAC,GACT,cAAc,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GACjC,KAAK,CAAC"}

package/dist/runtime/types/http.js

@@ -0,0 +1,6 @@
+// 路由的类型层工具：
+//   - RouteParams：从 '/api/templates/:id' 里提取 :id（模板字面量递归）
+//   - ParamsCovered：断言路由参数全部在 args 中声明（否则运行时静默 undefined）
+//   - AmbiguousPairs：检测结构性歧义路由（如 /x/:a 与 /x/:b，任何排序都救不了）
+export {};
+//# sourceMappingURL=http.js.map

package/dist/runtime/types/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/runtime/types/http.ts"],"names":[],"mappings":"AAAA,YAAY;AACZ,0DAA0D;AAC1D,0DAA0D;AAC1D,yDAAyD"}

package/dist/runtime/types/module.d.ts

@@ -0,0 +1,72 @@
+import type { Assert, Err } from './action.js';
+import type { AmbiguousPairs } from './http.js';
+export interface ModuleShape<A extends readonly unknown[]> {
+    id: string;
+    title: string;
+    order?: number;
+    actions: A;
+}
+export interface AnyModule {
+    id: string;
+    title: string;
+    order?: number;
+    actions: readonly unknown[];
+}
+export declare function defineModule<const M>(m: M & {
+    id: string;
+    title: string;
+    actions: readonly unknown[];
+}): M;
+export type Includes<T extends readonly unknown[], V> = T extends readonly [infer H, ...infer R] ? [H] extends [V] ? [V] extends [H] ? true : Includes<R, V> : Includes<R, V> : false;
+export type Dup<T extends readonly unknown[], Seen extends readonly unknown[] = []> = T extends readonly [
+    infer H,
+    ...infer R
+] ? Includes<Seen, H> extends true ? H | Dup<R, Seen> : Dup<R, [...Seen, H]> : never;
+type JoinPath<T extends readonly string[]> = T extends readonly [infer H extends string] ? H : T extends readonly [infer H extends string, ...infer R extends readonly string[]] ? `${H} ${JoinPath<R>}` : '';
+export type CliKey<A> = A extends {
+    cli: infer C;
+} ? C extends readonly string[] ? C[0] extends string ? JoinPath<C> : C[number] extends infer P ? P extends readonly string[] ? JoinPath<P> : never : never : never : never;
+export type HttpKey<A> = A extends {
+    http: infer H;
+} ? H extends readonly [string, string] ? `${H[0]} ${H[1]}` : never : never;
+type ActionsOf<M> = M extends {
+    actions: infer A extends readonly unknown[];
+} ? A : [];
+export type AllActions<M extends readonly unknown[]> = M extends readonly [infer H, ...infer R] ? [...ActionsOf<H>, ...AllActions<R extends readonly unknown[] ? R : []>] : [];
+export type ModuleIds<M> = M extends readonly unknown[] ? {
+    [K in keyof M]: M[K] extends {
+        id: infer I;
+    } ? I : never;
+} : [];
+export type ActionIds<AA> = AA extends readonly unknown[] ? {
+    [K in keyof AA]: AA[K] extends {
+        id: infer I;
+    } ? I : never;
+} : [];
+export type ActionCliKeys<AA> = AA extends readonly unknown[] ? {
+    [K in keyof AA]: CliKey<AA[K]>;
+} : [];
+export type ActionHttpKeys<AA> = AA extends readonly unknown[] ? {
+    [K in keyof AA]: HttpKey<AA[K]>;
+} : [];
+export type FilterNever<T extends readonly unknown[]> = T extends readonly [infer H, ...infer R] ? [H] extends [never] ? FilterNever<R> : [H, ...FilterNever<R>] : [];
+export type ActionPatterns<AA> = FilterNever<AA extends readonly unknown[] ? {
+    [K in keyof AA]: AA[K] extends {
+        http: infer H;
+    } ? H extends readonly [infer M, infer P] ? M extends string ? P extends string ? `${M} ${P}` : never : never : never : never;
+} : []>;
+export type RegistryChecks<M extends readonly unknown[]> = unknown & Assert<[
+    Dup<ModuleIds<M>>
+] extends [never] ? true : false, '模块 id 重复'> & Assert<[
+    Dup<ActionIds<AllActions<M>>>
+] extends [never] ? true : false, 'action id 重复'> & Assert<[
+    Dup<ActionCliKeys<AllActions<M>>>
+] extends [never] ? true : false, 'CLI 命令路径重复'> & Assert<[
+    Dup<ActionHttpKeys<AllActions<M>>>
+] extends [never] ? true : false, 'HTTP 路由重复'> & Assert<[
+    AmbiguousPairs<ActionPatterns<AllActions<M>>>
+] extends [never] ? true : false, '存在结构性歧义的路由（不同模式匹配同一批 URL，任何排序都无法区分）'>;
+export declare function defineModules<const M extends readonly AnyModule[]>(modules: M & RegistryChecks<M>): M;
+export type CheckedModules<M extends readonly unknown[]> = M & RegistryChecks<M>;
+export type { Err };
+//# sourceMappingURL=module.d.ts.map

package/dist/runtime/types/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/runtime/types/module.ts"],"names":[],"mappings":"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"}

package/dist/runtime/types/module.js

@@ -0,0 +1,15 @@
+// 模块与注册表的类型系统。
+//
+// defineModule：约束单个模块形状（id/title/actions）。
+// defineModules：模块汇总处的"编译期装载检查"，把 registry.js 运行时循环
+// （重复模块 id / action id / CLI 路径 / HTTP 路由 + 路由歧义）前移成编译错误。
+// 用裸泛型 M 承接整个字面量：id/actions 的字面量形状原样保留，
+// 同时交叉类型保证必填字段存在。
+export function defineModule(m) {
+    return m;
+}
+// 汇总入口：运行时按 order 排序；类型层执行全部装载检查。
+export function defineModules(modules) {
+    return [...modules].sort((a, b) => (a.order ?? 100) - (b.order ?? 100));
+}
+//# sourceMappingURL=module.js.map

package/dist/runtime/types/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../src/runtime/types/module.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,EAAE;AACF,2CAA2C;AAC3C,oDAAoD;AACpD,0DAA0D;AAoB1D,wCAAwC;AACxC,kBAAkB;AAClB,MAAM,UAAU,YAAY,CAC1B,CAAiE;IAEjE,OAAO,CAAC,CAAC;AACX,CAAC;AA2HD,kCAAkC;AAClC,MAAM,UAAU,aAAa,CAC3B,OAA8B;IAE9B,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CAAiB,CAAC;AAC1F,CAAC"}

package/dist/web/public/assets/CliHints-BOxU-Duc.js

@@ -0,0 +1 @@
+import{u as c,j as s,r as t,C as m}from"./index-BTRKdMIW.js";function d({module:n}){const{boot:l}=c(),a=((l==null?void 0:l.commands)||[]).filter(e=>e.module===n);return a.length?s.jsxs("div",{className:"cli-hint",children:[s.jsx("span",{className:"cli-hint-label",children:"这个页面上的每个按钮都有一条同构的 CLI 命令"}),a.map((e,i)=>s.jsxs(t.Fragment,{children:[i>0&&s.jsx("span",{className:"cli-hint-sep",children:" · "}),s.jsx(m,{className:"cli-cmd",text:e.command,title:`点击复制：${e.usage}`,children:e.command})]},e.id)),s.jsxs("span",{className:"cli-hint-tail",children:["。加 ",s.jsx("code",{className:"cli-hint-flag",children:"--json"})," 得机器可读输出。"]})]}):null}export{d as C};