@republicroad/seal-appshell 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RYefccd
+
+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,74 @@
+# @republicroad/jdm-appshell
+
+`@republicroad/jdm-editor`（内核）的参考消费者层：自定义节点托管、UI 槽位
+出现与换肤、持久化契约与认证适配。
+
+## 定位
+
+```
+宿主应用 (apps/*)
+  ├── @republicroad/jdm-appshell   → 观点性 shell Provider / 自定义节点 / UI kit / 持久化
+        └── @republicroad/jdm-editor   → 编辑器内核（peer）
+              └── react >= 18 (peer)
+```
+
+- **内核**只提供编辑器界面/主题/导入契约，不持有任何宿主观点。
+- **appshell** 承载业务侧自定义节点、皮肤系统（按 kind 出现/替换节点 UI，
+  配合 `JdmConfigProvider seeds` 一键换肤）与图持久化契约。
+
+## 五大职责域
+
+| 职责域               | 位置                                                   | 内容                                                                                                                   |
+| -------------------- | ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- |
+| **Custom node 宿主** | `components/custom-node/`、`hooks/useCustomNodes.ts`   | 六节点（http-request / query-list / crypto / json-path / template / current-date）+ KeyValueEditor + LockedCornerBadge |
+| **Registry 与协议**  | `lib/`                                                 | custom-node-registry（schema→节点，内置兜底）、协议库（http-request / json-path / crypto）、user-resolver、storage-key |
+| **组合 Hook**        | `hooks/useCustomNodes.ts`                              | 基础节点 + schema 拉取节点（优雅回退）+ 皮肤覆盖 → `customNodes` 数组                                                  |
+| **Skin 皮肤系统**    | `skin/`、`context/theme.provider`                      | `applyNodeOverrides` 按 kind 覆盖 renderTab/renderNode                                                                 |
+| **持久化契约**       | `shell/persistence.ts`、`shell/graphs-http-adapter.ts` | `GraphPersistenceAdapter`：宿主实现，乐观锁 + 404 语义 + 版本历史                                                      |
+
+在线文档：https://republicroad.github.io/jdm-editor/docs/
+
+完整说明见仓库文档 [`docs/appshell.md`](../../docs/appshell.md)（在线站点
+Docs 区同文）。
+
+## 宿主接线
+
+```tsx
+import { DecisionGraph } from '@republicroad/jdm-editor';
+import { useCustomNodes } from '@republicroad/jdm-appshell';
+
+// 六个自定义节点开箱即用；schema 拉取失败时自动回退内置定义
+const { customNodes, ready } = useCustomNodes();
+
+// 完整壳：用户解析（better-auth 或匿名）+ 持久化适配器由宿主实现
+<DecisionGraph customNodes={customNodes} userResolver={...} />
+```
+
+## 消费方式
+
+- **monorepo 内部**：源码直连——`main`/`types` 直指 `src/index.ts`，
+  vite/bun 直接吃源码；路径别名见根 `tsconfig.json`
+  （`@republicroad/jdm-appshell` / `@republicroad/jdm-appshell/*`）。
+- **外部（npm）**：`publishConfig` 于发布时切换到 `dist/`
+  （`bun run build` 产出 `index.js` + `index.d.ts` + `style.css`）。
+
+## 开发
+
+```bash
+pnpm --filter @republicroad/jdm-appshell typecheck   # tsc --noEmit
+pnpm --filter @republicroad/jdm-appshell test        # vitest（8 套件 / 67 用例）
+pnpm --filter @republicroad/jdm-appshell build       # dist + style.css
+pnpm --filter @republicroad/jdm-appshell test:npm-smoke
+```
+
+## 运行要求
+
+- React >= 18；`@republicroad/jdm-editor` >= 0.3；monaco-editor 需显式安装
+- Tailwind v4 + shadcn 语义 token（`--background`/`--foreground`/... 参考
+  `src/main.css`）；内核侧 `--grl-*` 变量由 `JdmConfigProvider` 自动注入
+
+## 发布契约
+
+**dist 是唯一的发布工件**（npm 安装即 `dist/`）；monorepo 内部消费源码直连
+（`main/types → src/index.ts`），便于本仓库内的快速迭代与外部仓库的稳定性
+隔离。

package/dist/assets/custom-node-schema.json.d.ts

@@ -0,0 +1,549 @@
+declare const _default: [
+  {
+    "type": "namespace",
+    "title": "crypto",
+    "name": "crypto",
+    "description": "",
+    "tools": [
+      {
+        "name": "crypto",
+        "title": "crypto",
+        "type": "function",
+        "description": "计算字符串摘要或 HMAC 签名，返回摘要字符串. algorithm 支持 md5/sha1/sha256/sha512(非法值回退 sha256)，secret 非空时启用 HMAC 模式，encoding 支持 hex/base64/base64url(非法值回退 hex)，upper 仅对 hex 生效(大写输出).",
+        "parameters": {
+          "properties": {
+            "input": {
+              "type": "string",
+              "title": "Input",
+              "description": "待摘要内容"
+            },
+            "algorithm": {
+              "type": "string",
+              "title": "Algorithm",
+              "description": "摘要算法(md5/sha1/sha256/sha512)，默认 sha256，非法值回退 sha256",
+              "default": "sha256"
+            },
+            "secret": {
+              "type": "string",
+              "title": "Secret",
+              "description": "HMAC 密钥，非空启用 HMAC 模式，留空则为普通摘要",
+              "default": ""
+            },
+            "encoding": {
+              "type": "string",
+              "title": "Encoding",
+              "description": "输出编码(hex/base64/base64url)，默认 hex，非法值回退 hex",
+              "default": "hex"
+            },
+            "upper": {
+              "type": "boolean",
+              "title": "Upper",
+              "description": "hex 输出转大写(仅 encoding=hex 时生效)，默认 false",
+              "default": false
+            }
+          },
+          "required": ["input"],
+          "title": "crypto",
+          "type": "object"
+        },
+        "returns": {
+          "type": "string",
+          "title": "crypto 函数返回",
+          "properties": {}
+        },
+        "namespace": "crypto",
+        "kind": "crypto",
+        "semantics": "query"
+      }
+    ]
+  },
+  {
+    "type": "namespace",
+    "title": "custom-list-query",
+    "name": "custom-list-query",
+    "description": "",
+    "tools": [
+      {
+        "name": "custom_list_query",
+        "title": "custom_list_query",
+        "type": "function",
+        "description": "旧域重建·名单查询：在服务端指定名单中查询某个值是否存在，返回 {result}。",
+        "parameters": {
+          "properties": {
+            "list_name": {
+              "type": "string",
+              "title": "名单名称",
+              "description": "服务端名单名称"
+            },
+            "value": {
+              "type": "string",
+              "title": "查询值",
+              "description": "待查询的值"
+            }
+          },
+          "required": ["list_name", "value"],
+          "title": "custom_list_query",
+          "type": "object"
+        },
+        "returns": {
+          "type": "object",
+          "title": "custom_list_query_result",
+          "properties": {
+            "result": {
+              "type": "boolean",
+              "title": "Result"
+            }
+          },
+          "required": ["result"]
+        },
+        "namespace": "custom-list-query",
+        "kind": "custom-list-query",
+        "semantics": "query"
+      }
+    ]
+  },
+  {
+    "type": "namespace",
+    "title": "debug",
+    "name": "debug",
+    "description": "",
+    "tools": [
+      {
+        "name": "inout",
+        "title": "inout",
+        "type": "function",
+        "description": "Docstring for inout\n自定义函数测试, 返回值返回入参, 用于调试.",
+        "parameters": {
+          "properties": {
+            "b": {
+              "description": "参数 b",
+              "title": "B",
+              "type": "integer"
+            },
+            "a": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "integer"
+                }
+              ],
+              "description": "参数 a",
+              "title": "A"
+            },
+            "c": {
+              "description": "参数 c",
+              "title": "C",
+              "type": "null"
+            }
+          },
+          "required": ["b", "a", "c"],
+          "title": "inout",
+          "type": "object"
+        },
+        "returns": {
+          "type": "string",
+          "title": "inout 函数返回",
+          "properties": {}
+        },
+        "namespace": "debug",
+        "kind": "debug",
+        "semantics": "query"
+      },
+      {
+        "name": "func_without_args",
+        "title": "func_without_args",
+        "type": "function",
+        "description": "Docstring for func_without_args\n无参数函数, 用于自定义函数测试",
+        "parameters": {
+          "properties": {},
+          "title": "func_without_args",
+          "type": "object"
+        },
+        "returns": {
+          "type": "string",
+          "title": "func_without_args 函数返回",
+          "properties": {}
+        },
+        "namespace": "debug",
+        "kind": "debug",
+        "semantics": "query"
+      }
+    ]
+  },
+  {
+    "type": "namespace",
+    "title": "debugui",
+    "name": "debugui",
+    "description": "",
+    "tools": [
+      {
+        "name": "current_date",
+        "title": "current_date",
+        "type": "function",
+        "description": "返回服务器当前日期(本地时区，YYYY-MM-DD 格式)，无参数.",
+        "parameters": {
+          "properties": {},
+          "title": "current_date",
+          "type": "object"
+        },
+        "returns": {
+          "type": "string",
+          "title": "current_date 函数返回",
+          "properties": {}
+        },
+        "namespace": "debugui",
+        "kind": "debugui",
+        "semantics": "query"
+      }
+    ]
+  },
+  {
+    "type": "namespace",
+    "title": "http",
+    "name": "http",
+    "description": "",
+    "tools": [
+      {
+        "name": "http_request",
+        "title": "http_request",
+        "type": "function",
+        "description": "发起 HTTP 请求, 返回响应结果 { status, headers, body }. 支持 params 查询参数合并、timeout 单次超时(默认 10s, 上限 60s)、retry 重试(仅网络异常/超时/5xx/429, 指数退避)与 auth 认证({ type: \"basic\", username, password } 或 { type: \"bearer\", token }, headers 显式 Authorization 优先). 失败返回结构化错误 { status: 0, error }, 不抛出异常.",
+        "parameters": {
+          "properties": {
+            "url": {
+              "type": "string",
+              "title": "URL",
+              "description": "请求地址"
+            },
+            "method": {
+              "type": "string",
+              "title": "Method",
+              "description": "HTTP 方法(GET/POST/PUT/PATCH/DELETE/HEAD/OPTIONS)，默认 GET",
+              "default": "GET"
+            },
+            "headers": {
+              "type": "object",
+              "title": "Headers",
+              "description": "请求头键值对对象，默认无",
+              "default": null
+            },
+            "body": {
+              "type": "object",
+              "title": "Body",
+              "description": "请求体对象(自动 JSON 序列化并补充 content-type: application/json)，GET/HEAD 忽略，空对象视为无请求体",
+              "default": null
+            },
+            "params": {
+              "type": "object",
+              "title": "Params",
+              "description": "查询参数键值对对象，合并到 URL 查询串(URL 已有同名参数时覆盖)，默认无",
+              "default": null
+            },
+            "timeout": {
+              "type": "integer",
+              "title": "Timeout",
+              "description": "单次请求超时毫秒数(100–60000)，默认 10000",
+              "default": 10000
+            },
+            "retry": {
+              "type": "integer",
+              "title": "Retry",
+              "description": "失败重试次数(0–5)，仅网络异常/超时/5xx/429 触发，指数退避，默认 0",
+              "default": 0
+            },
+            "auth": {
+              "type": "object",
+              "title": "Auth",
+              "description": "认证配置。Basic: { type: 'basic', username, password }；Bearer: { type: 'bearer', token }。headers 显式 Authorization 优先，默认无",
+              "default": null
+            }
+          },
+          "required": ["url"],
+          "title": "http_request",
+          "type": "object"
+        },
+        "returns": {
+          "type": "object",
+          "title": "http_request 函数返回",
+          "properties": {}
+        },
+        "namespace": "http",
+        "kind": "http",
+        "semantics": "query"
+      }
+    ]
+  },
+  {
+    "type": "namespace",
+    "title": "ip-location",
+    "name": "ip-location",
+    "description": "",
+    "tools": [
+      {
+        "name": "ip_location",
+        "title": "ip_location",
+        "type": "function",
+        "description": "旧域重建·IP 属地解析：按最长前缀匹配数据集（env IP_LOCATION_DATASET 指向 JSON）返回 country/province/city/isp；未命中返回空字段。",
+        "parameters": {
+          "properties": {
+            "ip": {
+              "type": "string",
+              "title": "IP",
+              "description": "待解析的 IP 地址"
+            }
+          }
+        },
+        "returns": {
+          "type": "object",
+          "title": "ip_location_result",
+          "properties": {
+            "country": {
+              "type": "string",
+              "title": "Country"
+            },
+            "province": {
+              "type": "string",
+              "title": "Province"
+            },
+            "city": {
+              "type": "string",
+              "title": "City"
+            },
+            "isp": {
+              "type": "string",
+              "title": "Isp"
+            },
+            "ip": {
+              "type": "string",
+              "title": "Ip"
+            }
+          },
+          "required": ["country", "province", "city", "isp", "ip"]
+        },
+        "namespace": "ip-location",
+        "kind": "ip-location",
+        "semantics": "query"
+      }
+    ]
+  },
+  {
+    "type": "namespace",
+    "title": "rate-window",
+    "name": "rate-window",
+    "description": "",
+    "tools": [
+      {
+        "name": "rate_1h",
+        "title": "rate_1h",
+        "type": "function",
+        "description": "旧域重建·频次统计：记录实体事件并返回其 1 小时滑动窗口内的事件计数。",
+        "parameters": {
+          "properties": {
+            "entity": {
+              "type": "string",
+              "title": "实体",
+              "description": "计数实体（如 ip、phone）"
+            }
+          }
+        },
+        "returns": {
+          "type": "object",
+          "title": "RateCommonResult",
+          "properties": {
+            "counter": {
+              "type": "integer",
+              "title": "Counter",
+              "default": 0
+            },
+            "v": {
+              "type": "string",
+              "title": "V",
+              "default": ""
+            },
+            "idle": {
+              "type": "integer",
+              "title": "Idle",
+              "default": 0
+            },
+            "timestamp": {
+              "type": "string",
+              "title": "Timestamp",
+              "default": ""
+            }
+          }
+        },
+        "namespace": "rate-window",
+        "kind": "rate-window",
+        "semantics": "observe"
+      },
+      {
+        "name": "group_distinct_1h",
+        "title": "group_distinct_1h",
+        "type": "function",
+        "description": "旧域重建·组去重统计：记录 (组, 值) 事件并返回 1 小时滑动窗口内组事件数(pv)与去重值数(uv)。",
+        "parameters": {
+          "properties": {
+            "group": {
+              "type": "string",
+              "title": "组",
+              "description": "分组键（如 ip）"
+            },
+            "value": {
+              "type": "string",
+              "title": "值",
+              "description": "组内观测值（如 phone）"
+            }
+          }
+        },
+        "returns": {
+          "type": "object",
+          "title": "GroupDistinctCommonResult",
+          "properties": {
+            "idle": {
+              "type": "integer",
+              "title": "Idle",
+              "default": 0
+            },
+            "pv": {
+              "type": "integer",
+              "title": "Pv",
+              "default": 0
+            },
+            "uv": {
+              "type": "integer",
+              "title": "Uv",
+              "default": 0
+            },
+            "gidle": {
+              "type": "integer",
+              "title": "Gidle",
+              "default": 0
+            },
+            "vidle": {
+              "type": "integer",
+              "title": "Vidle",
+              "default": 0
+            },
+            "group": {
+              "type": "string",
+              "title": "Group",
+              "default": ""
+            },
+            "v": {
+              "type": "string",
+              "title": "V",
+              "default": ""
+            },
+            "timestamp": {
+              "type": "string",
+              "title": "Timestamp",
+              "default": ""
+            }
+          }
+        },
+        "namespace": "rate-window",
+        "kind": "rate-window",
+        "semantics": "observe"
+      }
+    ]
+  },
+  {
+    "type": "namespace",
+    "title": "roster",
+    "name": "roster",
+    "description": "",
+    "tools": [
+      {
+        "name": "roster",
+        "title": "roster",
+        "type": "function",
+        "description": "查询名单：在服务端指定名单中查询某个值是否存在，返回命中结果.",
+        "parameters": {
+          "properties": {
+            "roster": {
+              "type": "string",
+              "title": "名单",
+              "description": "服务端名单名称(从名单下拉中动态选择)"
+            },
+            "value": {
+              "type": "string",
+              "title": "查询值",
+              "description": "待查询的值"
+            }
+          },
+          "required": ["roster", "value"],
+          "title": "roster",
+          "type": "object"
+        },
+        "returns": {
+          "type": "object",
+          "title": "roster 函数返回",
+          "properties": {}
+        },
+        "namespace": "roster",
+        "kind": "roster",
+        "semantics": "query"
+      }
+    ]
+  },
+  {
+    "type": "namespace",
+    "title": "notify",
+    "name": "notify",
+    "description": "IM 机器人文本通知（飞书/钉钉/企业微信/Slack）",
+    "tools": [
+      {
+        "name": "webhook",
+        "title": "webhook",
+        "type": "function",
+        "description": "向 IM 机器人 webhook 发送文本通知, 返回 { ok, status, body }. channel 支持 feishu/dingtalk/wecom/slack; 带 title 时按渠道转 markdown 形态. webhook 地址支持 ${secret:名称} 引用(按租户解析, 群机器人地址含凭证, 推荐走密钥), timeout/retry 语义与 http_request 一致. ok 仅表示 HTTP 2xx; 部分平台(如钉钉)限流/错参仍回 200, 业务错误码在 body.errcode. 失败返回结构化错误, 不抛出异常.",
+        "parameters": {
+          "properties": {
+            "channel": {
+              "type": "string",
+              "title": "Channel",
+              "description": "通知渠道(feishu/dingtalk/wecom/slack), 决定 payload 形状, 默认 feishu",
+              "default": "feishu"
+            },
+            "webhook": {
+              "type": "string",
+              "title": "Webhook URL",
+              "description": "机器人 webhook 地址, 支持 ${secret:名称} 引用(推荐, 地址含凭证不应落图)"
+            },
+            "message": {
+              "type": "string",
+              "title": "Message",
+              "description": "通知正文(纯文本/markdown, ≤16KB)"
+            },
+            "title": {
+              "type": "string",
+              "title": "Title",
+              "description": "可选标题; 提供时 feishu 拼接首行, dingtalk/wecom/slack 转对应 markdown 形态",
+              "default": null
+            },
+            "timeout": {
+              "type": "integer",
+              "title": "Timeout",
+              "description": "单次请求超时毫秒数(100–60000), 默认 10000",
+              "default": 10000
+            },
+            "retry": {
+              "type": "integer",
+              "title": "Retry",
+              "description": "失败重试次数(0–5), 仅网络异常/超时/5xx/429 触发, 指数退避, 默认 0",
+              "default": 0
+            }
+          },
+          "required": ["webhook", "message"],
+          "title": "notify_webhook",
+          "type": "object"
+        }
+      }
+    ]
+  }
+]
+;
+
+export default _default;

package/dist/components/__tests__/skinned-decision-graph.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/__tests__/skinned-header.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/__tests__/skinned-panels.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/__tests__/skinned-simulator-panel.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/__tests__/skinned-simulator.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/custom-node/__tests__/custom-node-button.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/custom-node/__tests__/schema-container-tab.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/custom-node/crypto-node.d.ts

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+export declare const CryptoTab: React.FC<{
+    id: string;
+}>;
+export declare const cryptoNode: import('../..').CustomNodeSpec;

package/dist/components/custom-node/current-date-node.d.ts

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+type CurrentDateTabProps = {
+    id: string;
+};
+/** 专属页面：输出 key 可由客户输入 + 仿真结果回显 */
+export declare const CurrentDateTab: React.FC<CurrentDateTabProps>;
+export declare const currentDateNode: import('../..').CustomNodeSpec;
+export {};