@pactor-app/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pactor 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,44 @@
+# @pactor-app/core
+
+[Pactor](https://github.com/426-330/pactor) 的核心协议包：DSL 类型定义与通用 Registry。零运行时依赖，与 React 无关，可用于浏览器、Node 与构建工具等任意环境。
+
+## 安装
+
+```bash
+npm install @pactor-app/core
+# 或
+pnpm add @pactor-app/core
+```
+
+## 包含内容
+
+- **DSL 节点类型**：`DslNode`、`ActionConfig`、`ConditionConfig`、`PermissionConfig`、`EventMap`
+- **DSL 文档结构类型**：`PageDsl`、`FragmentDsl`、`ApplicationDsl`、`DataSourceConfig`、`LifecycleConfig`、`RequiresConfig`
+- **`Registry<T>`**：通用注册表（register / get / has / unregister / list），Component / Action / Service / Capability / Expression Function 等 Registry 的共同基座
+- **`RUNTIME_SCOPES`**：运行时作用域层级常量（global → app → page → overlay → form → component → row → event）
+
+## 示例
+
+```ts
+import { Registry, type DslNode, type PageDsl } from '@pactor-app/core';
+
+const node: DslNode = {
+  type: 'Button',
+  props: { text: '保存' },
+  events: { onClick: { action: 'submit' } },
+  when: "${state.status == 'ACTIVE'}",
+};
+
+const components = new Registry<unknown>('ComponentRegistry');
+components.register('Button', ButtonRenderer);
+components.get('Button'); // ButtonRenderer
+components.get('Missing'); // undefined（不抛错）
+```
+
+## 文档
+
+完整文档见 <https://github.com/426-330/pactor/tree/main/docs>（`pnpm docs:dev` 本地启动文档站）。
+
+## License
+
+[MIT](../../LICENSE)

package/dist/index.cjs

@@ -0,0 +1,127 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  RUNTIME_SCOPES: () => RUNTIME_SCOPES,
+  Registry: () => Registry,
+  createI18nContext: () => createI18nContext
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/scope.ts
+var RUNTIME_SCOPES = [
+  "global",
+  "app",
+  "page",
+  "overlay",
+  "form",
+  "component",
+  "row",
+  "event"
+];
+
+// src/registry.ts
+var Registry = class {
+  /**
+   * @param label 用于错误信息中标识 Registry 用途，如 "ComponentRegistry"
+   */
+  constructor(label = "Registry") {
+    this.label = label;
+    this.items = /* @__PURE__ */ new Map();
+  }
+  /** 注册条目；重复注册同名条目抛出错误 */
+  register(name, item) {
+    if (this.items.has(name)) {
+      throw new Error(`[${this.label}] duplicate registration: "${name}"`);
+    }
+    this.items.set(name, item);
+  }
+  /** 获取条目；未注册时返回 undefined，不抛错 */
+  get(name) {
+    return this.items.get(name);
+  }
+  has(name) {
+    return this.items.has(name);
+  }
+  /** 注销条目；返回是否存在并被移除 */
+  unregister(name) {
+    return this.items.delete(name);
+  }
+  /** 全部已注册名称 */
+  list() {
+    return [...this.items.keys()];
+  }
+};
+
+// src/i18n.ts
+function interpolate(template, params) {
+  return template.replace(/\{\{(\w+)\}\}/g, (_, name) => {
+    const value = params[name];
+    return value === void 0 || value === null ? "" : String(value);
+  });
+}
+function isStringMap(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  return Object.values(value).every((v) => typeof v === "string");
+}
+function createI18nContext(options = {}) {
+  const locale = options.locale ?? "zh-CN";
+  const defaultLocale = options.defaultLocale ?? "zh-CN";
+  const messages = options.messages ?? {};
+  const t = (key, params) => {
+    let template;
+    const currentLocaleMessages = messages[locale];
+    if (isStringMap(currentLocaleMessages)) {
+      const value = currentLocaleMessages[key];
+      if (typeof value === "string") {
+        template = value;
+      }
+    }
+    if (template === void 0) {
+      const flatValue = messages[key];
+      if (typeof flatValue === "string") {
+        template = flatValue;
+      }
+    }
+    if (template === void 0 && locale !== defaultLocale) {
+      const defaultLocaleMessages = messages[defaultLocale];
+      if (isStringMap(defaultLocaleMessages)) {
+        const value = defaultLocaleMessages[key];
+        if (typeof value === "string") {
+          template = value;
+        }
+      }
+    }
+    if (template === void 0) {
+      return key;
+    }
+    return params ? interpolate(template, params) : template;
+  };
+  return { locale, defaultLocale, t };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RUNTIME_SCOPES,
+  Registry,
+  createI18nContext
+});

package/dist/index.d.cts

@@ -0,0 +1,217 @@
+/**
+ * DSL 核心节点（设计文档第 11 节）。
+ */
+/** 受控表达式字符串，如 "${state.count}" */
+type ExpressionString = string;
+/** 条件配置：表达式字符串，或显式对象形式 */
+type ConditionConfig = ExpressionString | {
+    expression: ExpressionString;
+};
+/** 无权限时的组件处理策略（设计文档第 41 节） */
+type PermissionDeniedStrategy = 'hidden' | 'disabled' | 'readonly';
+/**
+ * 权限配置：权限码或权限码数组（任一命中即可，由权限运行时解释），
+ * 或对象形式（`code` 判定权限，`denied` 指定无权限时的组件处理策略，
+ * 缺省为 `'hidden'`）
+ */
+type PermissionConfig = string | string[] | {
+    code: string | string[];
+    denied?: PermissionDeniedStrategy;
+};
+/** 动作配置（设计文档第 17 节） */
+interface ActionConfig {
+    /**
+     * 命名动作 id（设计文档第 48 节）：声明后，动作执行结果写入
+     * 表达式作用域 `actions.<id>`（成功时为结果数据，失败时为
+     * `{ ok: false, error }`），供后续动作引用，如
+     * `${actions.editResult.success}`；缺省时行为不变
+     */
+    id?: string;
+    /** 动作名，对应 Action Registry 中的注册名，如 "navigate"、"risk.calculate" */
+    action: string;
+    /** 动作参数，值可含表达式字符串 */
+    params?: Record<string, unknown>;
+    /** 条件执行 */
+    condition?: ConditionConfig;
+    /** 执行权限 */
+    permission?: PermissionConfig;
+}
+/** 事件映射：事件名 → 单个或多个动作 */
+type EventMap = Record<string, ActionConfig | ActionConfig[]>;
+/** UI DSL 树基础节点 */
+interface DslNode {
+    id?: string;
+    /** 组件类型，对应 Component Registry 中的注册名 */
+    type: string;
+    props?: Record<string, unknown>;
+    children?: DslNode[];
+    events?: EventMap;
+    permission?: PermissionConfig;
+    /** 条件渲染 */
+    when?: ConditionConfig;
+}
+
+/**
+ * DSL 文档结构（设计文档第 9、10、37 节）。
+ */
+/** DSL Specification Version 字符串，如 "1.0" */
+type DslVersion = string;
+/** 能力声明：DSL 对 Runtime / 组件版本的要求（第 37 节） */
+interface RequiresConfig {
+    /** Runtime 版本范围（semver range），如 ">=1.0.0" */
+    runtime?: string;
+    /** 组件 API 版本要求：组件名 → semver range */
+    components?: Record<string, string>;
+}
+/** 页面元信息 */
+interface PageMeta {
+    id: string;
+    title?: string;
+    /** 页面类型 / Page Pattern，如 "list"、"detail"、"form" */
+    type?: string;
+    permission?: PermissionConfig;
+}
+/** DataSource 类型（第 19 节） */
+type DataSourceType = 'http' | 'service' | 'static' | 'computed' | 'resource';
+/** DataSource 配置 */
+interface DataSourceConfig {
+    type: DataSourceType;
+    /** type 为 service 时的服务名，如 "customer.list" */
+    service?: string;
+    autoLoad?: boolean;
+    /** 调用参数，值可含表达式字符串 */
+    params?: Record<string, unknown>;
+    /** type 为 http 时的请求描述 */
+    request?: {
+        method?: string;
+        url: string;
+        params?: Record<string, unknown>;
+        headers?: Record<string, string>;
+        body?: unknown;
+    };
+    /** 分页参数映射，值可含表达式字符串 */
+    pagination?: {
+        page?: unknown;
+        pageSize?: unknown;
+    };
+    /** type 为 static 时的静态数据 */
+    value?: unknown;
+}
+/** 业务语义生命周期事件名（第 20 节） */
+type LifecycleEventName = 'onInit' | 'onLoad' | 'onReady' | 'onShow' | 'onHide' | 'onDestroy';
+/** 生命周期配置：事件名 → 单个或多个动作 */
+type LifecycleConfig = Partial<Record<LifecycleEventName, ActionConfig | ActionConfig[]>>;
+/** Page DSL 根结构（第 10 节） */
+interface PageDsl {
+    /** DSL Specification Version，必填 */
+    dsl: DslVersion;
+    requires?: RequiresConfig;
+    page: PageMeta;
+    /** 页面初始状态 */
+    state?: Record<string, unknown>;
+    dataSources?: Record<string, DataSourceConfig>;
+    lifecycle?: LifecycleConfig;
+    /** UI 树根 */
+    body?: DslNode;
+}
+/** Fragment DSL（第 50 节）：可复用的 UI 片段 */
+interface FragmentDsl {
+    dsl: DslVersion;
+    requires?: RequiresConfig;
+    fragment: {
+        id: string;
+        title?: string;
+    };
+    body: DslNode;
+}
+/** Application DSL（第 9.1 节） */
+interface ApplicationDsl {
+    dsl: DslVersion;
+    requires?: RequiresConfig;
+    application: {
+        id: string;
+        layout?: {
+            type: string;
+        };
+        theme?: {
+            name: string;
+        };
+        navigation?: {
+            mode: string;
+        };
+    };
+}
+
+/**
+ * 运行时作用域层级（设计文档第 15 节），自外向内排列。
+ */
+declare const RUNTIME_SCOPES: readonly ["global", "app", "page", "overlay", "form", "component", "row", "event"];
+type RuntimeScope = (typeof RUNTIME_SCOPES)[number];
+
+/**
+ * 通用 Registry（设计文档第 3.3、12、17、18 节）。
+ *
+ * Component / Action / Service / Capability / Expression Function 等
+ * 具体 Registry 的共同基座：名称 → 条目。
+ */
+declare class Registry<T> {
+    private readonly label;
+    private readonly items;
+    /**
+     * @param label 用于错误信息中标识 Registry 用途，如 "ComponentRegistry"
+     */
+    constructor(label?: string);
+    /** 注册条目；重复注册同名条目抛出错误 */
+    register(name: string, item: T): void;
+    /** 获取条目；未注册时返回 undefined，不抛错 */
+    get(name: string): T | undefined;
+    has(name: string): boolean;
+    /** 注销条目；返回是否存在并被移除 */
+    unregister(name: string): boolean;
+    /** 全部已注册名称 */
+    list(): string[];
+}
+
+/**
+ * 国际化（i18n）基础类型定义与翻译工具。
+ *
+ * 翻译模型为扁平键值对：key 支持点路径嵌套（如 `menu.home`），
+ * value 为对应语言的文案，可包含 `{{name}}` 占位符用于参数插值。
+ */
+/** 语言代码，如 'zh-CN'、'en-US' */
+type Locale = string;
+/** 翻译消息表：key → 文案，或 locale → key → 文案 */
+type I18nMessages = Record<string, string | Record<string, string>>;
+/** 参数插值值 */
+type I18nParams = Record<string, unknown>;
+/**
+ * i18n 上下文：暴露给 RuntimeContext 与表达式引擎。
+ * `t` 为翻译函数，支持参数插值与回退。
+ */
+interface I18nContext {
+    /** 当前生效的语言代码 */
+    locale: Locale;
+    /** 回退语言代码（缺省 'zh-CN'） */
+    defaultLocale: Locale;
+    /** 翻译函数 */
+    t(key: string, params?: I18nParams): string;
+}
+/** 创建 i18n 上下文时的配置 */
+interface CreateI18nOptions {
+    locale?: Locale;
+    defaultLocale?: Locale;
+    messages?: I18nMessages;
+}
+/**
+ * 创建翻译函数。
+ *
+ * messages 支持两种结构：
+ * - 扁平：`{ 'menu.home': '首页' }`（当前 locale 直接使用）
+ * - 按语言：`{ 'zh-CN': { 'menu.home': '首页' }, 'en-US': { 'menu.home': 'Home' } }`
+ *
+ * 回退顺序：当前 locale → defaultLocale → key 本身。
+ * 支持 `{{name}}` 参数插值。
+ */
+declare function createI18nContext(options?: CreateI18nOptions): I18nContext;
+
+export { type ActionConfig, type ApplicationDsl, type ConditionConfig, type CreateI18nOptions, type DataSourceConfig, type DataSourceType, type DslNode, type DslVersion, type EventMap, type ExpressionString, type FragmentDsl, type I18nContext, type I18nMessages, type I18nParams, type LifecycleConfig, type LifecycleEventName, type Locale, type PageDsl, type PageMeta, type PermissionConfig, type PermissionDeniedStrategy, RUNTIME_SCOPES, Registry, type RequiresConfig, type RuntimeScope, createI18nContext };

package/dist/index.d.ts

@@ -0,0 +1,217 @@
+/**
+ * DSL 核心节点（设计文档第 11 节）。
+ */
+/** 受控表达式字符串，如 "${state.count}" */
+type ExpressionString = string;
+/** 条件配置：表达式字符串，或显式对象形式 */
+type ConditionConfig = ExpressionString | {
+    expression: ExpressionString;
+};
+/** 无权限时的组件处理策略（设计文档第 41 节） */
+type PermissionDeniedStrategy = 'hidden' | 'disabled' | 'readonly';
+/**
+ * 权限配置：权限码或权限码数组（任一命中即可，由权限运行时解释），
+ * 或对象形式（`code` 判定权限，`denied` 指定无权限时的组件处理策略，
+ * 缺省为 `'hidden'`）
+ */
+type PermissionConfig = string | string[] | {
+    code: string | string[];
+    denied?: PermissionDeniedStrategy;
+};
+/** 动作配置（设计文档第 17 节） */
+interface ActionConfig {
+    /**
+     * 命名动作 id（设计文档第 48 节）：声明后，动作执行结果写入
+     * 表达式作用域 `actions.<id>`（成功时为结果数据，失败时为
+     * `{ ok: false, error }`），供后续动作引用，如
+     * `${actions.editResult.success}`；缺省时行为不变
+     */
+    id?: string;
+    /** 动作名，对应 Action Registry 中的注册名，如 "navigate"、"risk.calculate" */
+    action: string;
+    /** 动作参数，值可含表达式字符串 */
+    params?: Record<string, unknown>;
+    /** 条件执行 */
+    condition?: ConditionConfig;
+    /** 执行权限 */
+    permission?: PermissionConfig;
+}
+/** 事件映射：事件名 → 单个或多个动作 */
+type EventMap = Record<string, ActionConfig | ActionConfig[]>;
+/** UI DSL 树基础节点 */
+interface DslNode {
+    id?: string;
+    /** 组件类型，对应 Component Registry 中的注册名 */
+    type: string;
+    props?: Record<string, unknown>;
+    children?: DslNode[];
+    events?: EventMap;
+    permission?: PermissionConfig;
+    /** 条件渲染 */
+    when?: ConditionConfig;
+}
+
+/**
+ * DSL 文档结构（设计文档第 9、10、37 节）。
+ */
+/** DSL Specification Version 字符串，如 "1.0" */
+type DslVersion = string;
+/** 能力声明：DSL 对 Runtime / 组件版本的要求（第 37 节） */
+interface RequiresConfig {
+    /** Runtime 版本范围（semver range），如 ">=1.0.0" */
+    runtime?: string;
+    /** 组件 API 版本要求：组件名 → semver range */
+    components?: Record<string, string>;
+}
+/** 页面元信息 */
+interface PageMeta {
+    id: string;
+    title?: string;
+    /** 页面类型 / Page Pattern，如 "list"、"detail"、"form" */
+    type?: string;
+    permission?: PermissionConfig;
+}
+/** DataSource 类型（第 19 节） */
+type DataSourceType = 'http' | 'service' | 'static' | 'computed' | 'resource';
+/** DataSource 配置 */
+interface DataSourceConfig {
+    type: DataSourceType;
+    /** type 为 service 时的服务名，如 "customer.list" */
+    service?: string;
+    autoLoad?: boolean;
+    /** 调用参数，值可含表达式字符串 */
+    params?: Record<string, unknown>;
+    /** type 为 http 时的请求描述 */
+    request?: {
+        method?: string;
+        url: string;
+        params?: Record<string, unknown>;
+        headers?: Record<string, string>;
+        body?: unknown;
+    };
+    /** 分页参数映射，值可含表达式字符串 */
+    pagination?: {
+        page?: unknown;
+        pageSize?: unknown;
+    };
+    /** type 为 static 时的静态数据 */
+    value?: unknown;
+}
+/** 业务语义生命周期事件名（第 20 节） */
+type LifecycleEventName = 'onInit' | 'onLoad' | 'onReady' | 'onShow' | 'onHide' | 'onDestroy';
+/** 生命周期配置：事件名 → 单个或多个动作 */
+type LifecycleConfig = Partial<Record<LifecycleEventName, ActionConfig | ActionConfig[]>>;
+/** Page DSL 根结构（第 10 节） */
+interface PageDsl {
+    /** DSL Specification Version，必填 */
+    dsl: DslVersion;
+    requires?: RequiresConfig;
+    page: PageMeta;
+    /** 页面初始状态 */
+    state?: Record<string, unknown>;
+    dataSources?: Record<string, DataSourceConfig>;
+    lifecycle?: LifecycleConfig;
+    /** UI 树根 */
+    body?: DslNode;
+}
+/** Fragment DSL（第 50 节）：可复用的 UI 片段 */
+interface FragmentDsl {
+    dsl: DslVersion;
+    requires?: RequiresConfig;
+    fragment: {
+        id: string;
+        title?: string;
+    };
+    body: DslNode;
+}
+/** Application DSL（第 9.1 节） */
+interface ApplicationDsl {
+    dsl: DslVersion;
+    requires?: RequiresConfig;
+    application: {
+        id: string;
+        layout?: {
+            type: string;
+        };
+        theme?: {
+            name: string;
+        };
+        navigation?: {
+            mode: string;
+        };
+    };
+}
+
+/**
+ * 运行时作用域层级（设计文档第 15 节），自外向内排列。
+ */
+declare const RUNTIME_SCOPES: readonly ["global", "app", "page", "overlay", "form", "component", "row", "event"];
+type RuntimeScope = (typeof RUNTIME_SCOPES)[number];
+
+/**
+ * 通用 Registry（设计文档第 3.3、12、17、18 节）。
+ *
+ * Component / Action / Service / Capability / Expression Function 等
+ * 具体 Registry 的共同基座：名称 → 条目。
+ */
+declare class Registry<T> {
+    private readonly label;
+    private readonly items;
+    /**
+     * @param label 用于错误信息中标识 Registry 用途，如 "ComponentRegistry"
+     */
+    constructor(label?: string);
+    /** 注册条目；重复注册同名条目抛出错误 */
+    register(name: string, item: T): void;
+    /** 获取条目；未注册时返回 undefined，不抛错 */
+    get(name: string): T | undefined;
+    has(name: string): boolean;
+    /** 注销条目；返回是否存在并被移除 */
+    unregister(name: string): boolean;
+    /** 全部已注册名称 */
+    list(): string[];
+}
+
+/**
+ * 国际化（i18n）基础类型定义与翻译工具。
+ *
+ * 翻译模型为扁平键值对：key 支持点路径嵌套（如 `menu.home`），
+ * value 为对应语言的文案，可包含 `{{name}}` 占位符用于参数插值。
+ */
+/** 语言代码，如 'zh-CN'、'en-US' */
+type Locale = string;
+/** 翻译消息表：key → 文案，或 locale → key → 文案 */
+type I18nMessages = Record<string, string | Record<string, string>>;
+/** 参数插值值 */
+type I18nParams = Record<string, unknown>;
+/**
+ * i18n 上下文：暴露给 RuntimeContext 与表达式引擎。
+ * `t` 为翻译函数，支持参数插值与回退。
+ */
+interface I18nContext {
+    /** 当前生效的语言代码 */
+    locale: Locale;
+    /** 回退语言代码（缺省 'zh-CN'） */
+    defaultLocale: Locale;
+    /** 翻译函数 */
+    t(key: string, params?: I18nParams): string;
+}
+/** 创建 i18n 上下文时的配置 */
+interface CreateI18nOptions {
+    locale?: Locale;
+    defaultLocale?: Locale;
+    messages?: I18nMessages;
+}
+/**
+ * 创建翻译函数。
+ *
+ * messages 支持两种结构：
+ * - 扁平：`{ 'menu.home': '首页' }`（当前 locale 直接使用）
+ * - 按语言：`{ 'zh-CN': { 'menu.home': '首页' }, 'en-US': { 'menu.home': 'Home' } }`
+ *
+ * 回退顺序：当前 locale → defaultLocale → key 本身。
+ * 支持 `{{name}}` 参数插值。
+ */
+declare function createI18nContext(options?: CreateI18nOptions): I18nContext;
+
+export { type ActionConfig, type ApplicationDsl, type ConditionConfig, type CreateI18nOptions, type DataSourceConfig, type DataSourceType, type DslNode, type DslVersion, type EventMap, type ExpressionString, type FragmentDsl, type I18nContext, type I18nMessages, type I18nParams, type LifecycleConfig, type LifecycleEventName, type Locale, type PageDsl, type PageMeta, type PermissionConfig, type PermissionDeniedStrategy, RUNTIME_SCOPES, Registry, type RequiresConfig, type RuntimeScope, createI18nContext };

package/dist/index.js

@@ -0,0 +1,98 @@
+// src/scope.ts
+var RUNTIME_SCOPES = [
+  "global",
+  "app",
+  "page",
+  "overlay",
+  "form",
+  "component",
+  "row",
+  "event"
+];
+
+// src/registry.ts
+var Registry = class {
+  /**
+   * @param label 用于错误信息中标识 Registry 用途，如 "ComponentRegistry"
+   */
+  constructor(label = "Registry") {
+    this.label = label;
+    this.items = /* @__PURE__ */ new Map();
+  }
+  /** 注册条目；重复注册同名条目抛出错误 */
+  register(name, item) {
+    if (this.items.has(name)) {
+      throw new Error(`[${this.label}] duplicate registration: "${name}"`);
+    }
+    this.items.set(name, item);
+  }
+  /** 获取条目；未注册时返回 undefined，不抛错 */
+  get(name) {
+    return this.items.get(name);
+  }
+  has(name) {
+    return this.items.has(name);
+  }
+  /** 注销条目；返回是否存在并被移除 */
+  unregister(name) {
+    return this.items.delete(name);
+  }
+  /** 全部已注册名称 */
+  list() {
+    return [...this.items.keys()];
+  }
+};
+
+// src/i18n.ts
+function interpolate(template, params) {
+  return template.replace(/\{\{(\w+)\}\}/g, (_, name) => {
+    const value = params[name];
+    return value === void 0 || value === null ? "" : String(value);
+  });
+}
+function isStringMap(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  return Object.values(value).every((v) => typeof v === "string");
+}
+function createI18nContext(options = {}) {
+  const locale = options.locale ?? "zh-CN";
+  const defaultLocale = options.defaultLocale ?? "zh-CN";
+  const messages = options.messages ?? {};
+  const t = (key, params) => {
+    let template;
+    const currentLocaleMessages = messages[locale];
+    if (isStringMap(currentLocaleMessages)) {
+      const value = currentLocaleMessages[key];
+      if (typeof value === "string") {
+        template = value;
+      }
+    }
+    if (template === void 0) {
+      const flatValue = messages[key];
+      if (typeof flatValue === "string") {
+        template = flatValue;
+      }
+    }
+    if (template === void 0 && locale !== defaultLocale) {
+      const defaultLocaleMessages = messages[defaultLocale];
+      if (isStringMap(defaultLocaleMessages)) {
+        const value = defaultLocaleMessages[key];
+        if (typeof value === "string") {
+          template = value;
+        }
+      }
+    }
+    if (template === void 0) {
+      return key;
+    }
+    return params ? interpolate(template, params) : template;
+  };
+  return { locale, defaultLocale, t };
+}
+export {
+  RUNTIME_SCOPES,
+  Registry,
+  createI18nContext
+};

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@pactor-app/core",
+  "version": "0.1.0",
+  "description": "Pactor core: DSL protocol types and generic Registry (React-free, zero dependencies)",
+  "keywords": [
+    "pactor",
+    "dsl",
+    "server-driven-ui",
+    "dynamic-ui",
+    "protocol",
+    "registry"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/426-330/pactor.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/426-330/pactor/tree/main/packages/core",
+  "bugs": "https://github.com/426-330/pactor/issues",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}