@longzai-intelligence-agent-ui-render/core 0.0.0-stage → 0.0.1

package/README.md

@@ -1,3 +1,12 @@
-# Temporary Holding Version
+# @longzai-intelligence-agent-ui-render/core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+渲染协议核心包。承载 json-render 策略的私有载荷协议即 Spec 扁平树、SpecStream 补丁与 Catalog 白名单的类型与 zod schema，自 agent-ui 仓 `packages/core` 渲染协议面迁入，运行时依赖仅 `zod`。
+
+## 导出面
+
+- 类型：`SpecElement`、`Spec`、`SpecStreamPatch`、`CatalogEntry`、`ActionDefinition`、`ValidatorDefinition`、`Catalog`
+- schema：`SpecElementSchema`、`SpecSchema`、`SpecStreamPatchSchema`、`CatalogEntrySchema`、`ActionDefinitionSchema`、`ValidatorDefinitionSchema`、`CatalogSchema`
+
+## 契约边界
+
+Spec 为扁平元素表加根元素引用加可选初始状态，补丁经类 JSON 指针路径描述单次变更。协议为 `json-render-spec` 策略私有面，跨策略公共面归装载容器仓的中立载荷模型。

package/dist/index.d.ts

@@ -0,0 +1,220 @@
+import "./rolldown-runtime-BqT_7tdF.js";
+import * as z from "zod";
+/**
+ * json-render 策略载荷协议类型
+ *
+ * Spec 扁平元素树、SpecStream 补丁与 Catalog 组件白名单，构成 `json-render-spec`
+ * 策略的私有载荷协议面，自 agent-ui 仓 `packages/core` 渲染协议面迁入
+ */
+/**
+ * Spec 扁平树中的单个元素
+ *
+ * @remarks
+ *   元素以 id 互引，父子关系经 `children` 标识列表表达
+ */
+type SpecElement = {
+  /**
+   * 元素唯一标识
+   */
+  id: string;
+  /**
+   * 组件类型名，按 Catalog 解析
+   */
+  type: string;
+  /**
+   * 元素 props 即以 prop 名为键
+   */
+  props?: Record<string, unknown>;
+  /**
+   * 子元素标识的有序列表
+   */
+  children?: string[];
+  /**
+   * 可见性表达式或字面量
+   */
+  visible?: unknown;
+  /**
+   * 响应状态变迁的 watch 绑定
+   */
+  watch?: Record<string, unknown>;
+};
+/**
+ * 完整 Spec 树
+ *
+ * @remarks
+ *   扁平元素表加根元素引用加可选初始状态快照
+ */
+type Spec = {
+  /**
+   * 根元素标识
+   */
+  root: string;
+  /**
+   * 元素标识到元素定义的扁平映射
+   */
+  elements: Record<string, SpecElement>;
+  /**
+   * 可选初始状态值
+   */
+  state?: Record<string, unknown>;
+};
+/**
+ * 流式 Spec 更新的单条补丁
+ *
+ * @remarks
+ *   每条补丁经类 JSON 指针路径描述对 Spec 树的一次变更
+ */
+type SpecStreamPatch = {
+  /**
+   * 变更操作类型
+   */
+  op: 'add' | 'update' | 'remove' | 'replace';
+  /**
+   * 类 JSON 指针路径
+   */
+  path: string;
+  /**
+   * 补丁载荷值
+   */
+  value: unknown;
+};
+/**
+ * Catalog 组件白名单条目
+ */
+type CatalogEntry = {
+  /**
+   * 组件名，与 Registry 键一致
+   */
+  name: string;
+  /**
+   * 组件的 props 契约
+   */
+  props?: Record<string, unknown>;
+  /**
+   * 组件暴露的具名插槽列表
+   */
+  slots?: string[];
+};
+/**
+ * Catalog 暴露的动作定义
+ */
+type ActionDefinition = {
+  /**
+   * 动作名，用于触发动作
+   */
+  name: string;
+  /**
+   * 动作参数契约
+   */
+  params?: Record<string, unknown>;
+};
+/**
+ * Catalog 暴露的校验器定义
+ */
+type ValidatorDefinition = {
+  /**
+   * 校验器名，用于引用校验器
+   */
+  name: string;
+  /**
+   * 校验器函数引用，运行时绑定
+   */
+  fn?: unknown;
+};
+/**
+ * Catalog 即生成与渲染管线可用的组件、动作与校验器白名单
+ */
+type Catalog = {
+  /**
+   * 组件名到目录条目的映射
+   */
+  components: Record<string, CatalogEntry>;
+  /**
+   * 动作名到动作定义的映射
+   */
+  actions?: Record<string, ActionDefinition>;
+  /**
+   * 校验器名到校验器定义的映射
+   */
+  validators?: Record<string, ValidatorDefinition>;
+};
+/**
+ * 单个 Spec 元素 schema
+ */
+declare const SpecElementSchema: z.ZodObject<{
+  id: z.ZodString;
+  type: z.ZodString;
+  props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  children: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  visible: z.ZodOptional<z.ZodUnknown>;
+  watch: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/**
+ * 完整 Spec 树 schema
+ */
+declare const SpecSchema: z.ZodObject<{
+  root: z.ZodString;
+  elements: z.ZodRecord<z.ZodString, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodString;
+    props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    children: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    visible: z.ZodOptional<z.ZodUnknown>;
+    watch: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  }, z.core.$strip>>;
+  state: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/**
+ * 流式 Spec 补丁 schema
+ */
+declare const SpecStreamPatchSchema: z.ZodObject<{
+  op: z.ZodEnum<{
+    add: "add";
+    remove: "remove";
+    replace: "replace";
+    update: "update";
+  }>;
+  path: z.ZodString;
+  value: z.ZodUnknown;
+}, z.core.$strip>;
+/**
+ * Catalog 组件条目 schema
+ */
+declare const CatalogEntrySchema: z.ZodObject<{
+  name: z.ZodString;
+  props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  slots: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Catalog 动作定义 schema
+ */
+declare const ActionDefinitionSchema: z.ZodObject<{
+  name: z.ZodString;
+  params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/**
+ * Catalog 校验器定义 schema
+ */
+declare const ValidatorDefinitionSchema: z.ZodObject<{
+  name: z.ZodString;
+  fn: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+/**
+ * Catalog 白名单 schema
+ */
+declare const CatalogSchema: z.ZodObject<{
+  components: z.ZodRecord<z.ZodString, z.ZodObject<{
+    name: z.ZodString;
+    props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    slots: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>;
+  actions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    name: z.ZodString;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  }, z.core.$strip>>>;
+  validators: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    name: z.ZodString;
+    fn: z.ZodOptional<z.ZodUnknown>;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+export { ActionDefinition, ActionDefinitionSchema, Catalog, CatalogEntry, CatalogEntrySchema, CatalogSchema, Spec, SpecElement, SpecElementSchema, SpecSchema, SpecStreamPatch, SpecStreamPatchSchema, ValidatorDefinition, ValidatorDefinitionSchema };

package/dist/index.js

@@ -0,0 +1 @@
+import"./rolldown-runtime-BqT_7tdF.js";import*as e from"zod";const t=e.object({id:e.string(),type:e.string(),props:e.record(e.string(),e.unknown()).optional(),children:e.array(e.string()).optional(),visible:e.unknown().optional(),watch:e.record(e.string(),e.unknown()).optional()}),n=e.object({root:e.string(),elements:e.record(e.string(),t),state:e.record(e.string(),e.unknown()).optional()}),r=e.object({op:e.enum([`add`,`update`,`remove`,`replace`]),path:e.string(),value:e.unknown()}),i=e.object({name:e.string(),props:e.record(e.string(),e.unknown()).optional(),slots:e.array(e.string()).optional()}),a=e.object({name:e.string(),params:e.record(e.string(),e.unknown()).optional()}),o=e.object({name:e.string(),fn:e.unknown().optional()}),s=e.object({components:e.record(e.string(),i),actions:e.record(e.string(),a).optional(),validators:e.record(e.string(),o).optional()});export{a as ActionDefinitionSchema,i as CatalogEntrySchema,s as CatalogSchema,t as SpecElementSchema,n as SpecSchema,r as SpecStreamPatchSchema,o as ValidatorDefinitionSchema};

package/dist/rolldown-runtime-BqT_7tdF.js

@@ -0,0 +1 @@
+import"node:module";export{};

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@longzai-intelligence-agent-ui-render/core",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1",
+  "description": "Longzai Intelligence Agent UI 渲染协议核心包",
+  "keywords": [
+    "agent-ui",
+    "core",
+    "longzai-intelligence",
+    "protocol",
+    "spec",
+    "zod"
+  ],
+  "license": "UNLICENSED",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "lzi-builder",
+    "build:prod": "NODE_ENV=production bun run build",
+    "prepublishOnly": "bun run build:prod",
+    "dev": "lzi-builder --watch",
+    "clean": "lzi-dev-tools clean",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "lzi-lint lint",
+    "lint:fix": "lzi-lint fix",
+    "typecheck": "bun run typecheck:app && bun run typecheck:node && bun run typecheck:test",
+    "typecheck:app": "lzi-tsgo typecheck tsconfig/app.json",
+    "typecheck:node": "lzi-tsgo typecheck tsconfig/node.json",
+    "typecheck:test": "lzi-tsgo typecheck tsconfig/test.json"
+  },
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@longzai-intelligence-testing/utils": "^0.0.3",
+    "@longzai-intelligence-vitest/config": "^0.0.12",
+    "vitest": "^4.1.4"
+  },
+  "packageManager": "bun@1.4.3"
+}