larkard 0.0.0-stage → 0.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (299) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +187 -2
  3. package/dist/adapter/custom-colors.d.ts +28 -0
  4. package/dist/adapter/custom-colors.d.ts.map +1 -0
  5. package/dist/adapter/dsl-to-raw.d.ts +20 -0
  6. package/dist/adapter/dsl-to-raw.d.ts.map +1 -0
  7. package/dist/adapter/expand-dsl-colors.d.ts +35 -0
  8. package/dist/adapter/expand-dsl-colors.d.ts.map +1 -0
  9. package/dist/adapter/index.cjs +80 -0
  10. package/dist/adapter/index.d.ts +18 -0
  11. package/dist/adapter/index.d.ts.map +1 -0
  12. package/dist/adapter/index.js +3 -0
  13. package/dist/adapter/md-parse.d.ts +24 -0
  14. package/dist/adapter/md-parse.d.ts.map +1 -0
  15. package/dist/adapter/normalize-stored-colors.d.ts +30 -0
  16. package/dist/adapter/normalize-stored-colors.d.ts.map +1 -0
  17. package/dist/adapter/raw-to-dsl.d.ts +80 -0
  18. package/dist/adapter/raw-to-dsl.d.ts.map +1 -0
  19. package/dist/adapter/types.d.ts +318 -0
  20. package/dist/adapter/types.d.ts.map +1 -0
  21. package/dist/chunk-2ICTWLIP.cjs +320 -0
  22. package/dist/chunk-33T4REBK.js +1862 -0
  23. package/dist/chunk-462CNCHD.js +470 -0
  24. package/dist/chunk-4FPYFHDV.cjs +5017 -0
  25. package/dist/chunk-4VLXPDHK.cjs +1980 -0
  26. package/dist/chunk-5YEHLPTT.js +5010 -0
  27. package/dist/chunk-ADPNWRSB.cjs +2499 -0
  28. package/dist/chunk-BI3SOQOF.cjs +3725 -0
  29. package/dist/chunk-BMD67L5A.js +1199 -0
  30. package/dist/chunk-CBMTSPGB.cjs +14 -0
  31. package/dist/chunk-DINOEQ4D.js +12 -0
  32. package/dist/chunk-DUJ37C7Q.cjs +49 -0
  33. package/dist/chunk-ETV4XYOV.cjs +7 -0
  34. package/dist/chunk-H4M2WTIP.cjs +16 -0
  35. package/dist/chunk-HSVVJUIC.cjs +190 -0
  36. package/dist/chunk-LFUKOODS.js +188 -0
  37. package/dist/chunk-M33JXCUC.js +152 -0
  38. package/dist/chunk-MM5UOOA2.cjs +160 -0
  39. package/dist/chunk-MOCZJJ5P.cjs +474 -0
  40. package/dist/chunk-NY4L4HPF.js +11 -0
  41. package/dist/chunk-OHQIQTRR.cjs +1226 -0
  42. package/dist/chunk-PBF3NXUI.js +5 -0
  43. package/dist/chunk-PKBMQBKP.js +5 -0
  44. package/dist/chunk-QFNUJSCP.cjs +8 -0
  45. package/dist/chunk-TVLU4TSE.js +39 -0
  46. package/dist/chunk-VFJ4QPRG.js +3696 -0
  47. package/dist/chunk-VQFDYCF4.js +34 -0
  48. package/dist/chunk-VYGAB4ZH.cjs +45 -0
  49. package/dist/chunk-XKJ2OLNJ.js +42 -0
  50. package/dist/chunk-ZC3PQI6F.js +305 -0
  51. package/dist/chunk-ZT3DMPV3.cjs +41 -0
  52. package/dist/chunk-ZX4N4AUP.js +2480 -0
  53. package/dist/cli-bin.cjs +14 -0
  54. package/dist/cli-bin.d.ts +3 -0
  55. package/dist/cli-bin.d.ts.map +1 -0
  56. package/dist/cli-bin.js +12 -0
  57. package/dist/cli.cjs +17 -0
  58. package/dist/cli.d.ts +2 -0
  59. package/dist/cli.d.ts.map +1 -0
  60. package/dist/cli.js +8 -0
  61. package/dist/components/action.d.ts +47 -0
  62. package/dist/components/action.d.ts.map +1 -0
  63. package/dist/components/components/index.d.ts +45 -0
  64. package/dist/components/components/index.d.ts.map +1 -0
  65. package/dist/components/index.cjs +1067 -0
  66. package/dist/components/index.d.ts +6 -0
  67. package/dist/components/index.d.ts.map +1 -0
  68. package/dist/components/index.js +997 -0
  69. package/dist/components/jsx-dev-runtime.cjs +23 -0
  70. package/dist/components/jsx-dev-runtime.d.ts +3 -0
  71. package/dist/components/jsx-dev-runtime.d.ts.map +1 -0
  72. package/dist/components/jsx-dev-runtime.js +2 -0
  73. package/dist/components/jsx-runtime.cjs +43 -0
  74. package/dist/components/jsx-runtime.d.ts +76 -0
  75. package/dist/components/jsx-runtime.d.ts.map +1 -0
  76. package/dist/components/jsx-runtime.js +2 -0
  77. package/dist/components/render-extra.d.ts +7 -0
  78. package/dist/components/render-extra.d.ts.map +1 -0
  79. package/dist/components/renderer.d.ts +5 -0
  80. package/dist/components/renderer.d.ts.map +1 -0
  81. package/dist/components/types/card.d.ts +198 -0
  82. package/dist/components/types/card.d.ts.map +1 -0
  83. package/dist/components/types/index.d.ts +4 -0
  84. package/dist/components/types/index.d.ts.map +1 -0
  85. package/dist/components/types/props.d.ts +489 -0
  86. package/dist/components/types/props.d.ts.map +1 -0
  87. package/dist/components/types/vnode.d.ts +15 -0
  88. package/dist/components/types/vnode.d.ts.map +1 -0
  89. package/dist/content/emoji/client-map.d.ts +6 -0
  90. package/dist/content/emoji/client-map.d.ts.map +1 -0
  91. package/dist/content/emoji/index.cjs +19 -0
  92. package/dist/content/emoji/index.d.ts +4 -0
  93. package/dist/content/emoji/index.d.ts.map +1 -0
  94. package/dist/content/emoji/index.js +2 -0
  95. package/dist/content/emoji/official-tokens.d.ts +14 -0
  96. package/dist/content/emoji/official-tokens.d.ts.map +1 -0
  97. package/dist/content/icons/catalog.d.ts +32 -0
  98. package/dist/content/icons/catalog.d.ts.map +1 -0
  99. package/dist/content/icons/client-codepoints.d.ts +6 -0
  100. package/dist/content/icons/client-codepoints.d.ts.map +1 -0
  101. package/dist/content/icons/index.cjs +31 -0
  102. package/dist/content/icons/index.d.ts +6 -0
  103. package/dist/content/icons/index.d.ts.map +1 -0
  104. package/dist/content/icons/index.js +2 -0
  105. package/dist/content/icons/official-tokens.d.ts +13 -0
  106. package/dist/content/icons/official-tokens.d.ts.map +1 -0
  107. package/dist/content/index.d.ts +12 -0
  108. package/dist/content/index.d.ts.map +1 -0
  109. package/dist/content/metrics.cjs +63 -0
  110. package/dist/content/metrics.d.ts +53 -0
  111. package/dist/content/metrics.d.ts.map +1 -0
  112. package/dist/content/metrics.js +2 -0
  113. package/dist/content/spacing.cjs +31 -0
  114. package/dist/content/spacing.d.ts +34 -0
  115. package/dist/content/spacing.d.ts.map +1 -0
  116. package/dist/content/spacing.js +2 -0
  117. package/dist/core/check-types.d.ts +57 -0
  118. package/dist/core/check-types.d.ts.map +1 -0
  119. package/dist/core/check.d.ts +22 -0
  120. package/dist/core/check.d.ts.map +1 -0
  121. package/dist/core/compile.d.ts +45 -0
  122. package/dist/core/compile.d.ts.map +1 -0
  123. package/dist/core/device.d.ts +69 -0
  124. package/dist/core/device.d.ts.map +1 -0
  125. package/dist/core/index.d.ts +19 -0
  126. package/dist/core/index.d.ts.map +1 -0
  127. package/dist/core/linter.d.ts +29 -0
  128. package/dist/core/linter.d.ts.map +1 -0
  129. package/dist/core/markdown-bold-space.d.ts +21 -0
  130. package/dist/core/markdown-bold-space.d.ts.map +1 -0
  131. package/dist/core/parser.d.ts +113 -0
  132. package/dist/core/parser.d.ts.map +1 -0
  133. package/dist/core/patch/apply.d.ts +29 -0
  134. package/dist/core/patch/apply.d.ts.map +1 -0
  135. package/dist/core/patch/index.d.ts +12 -0
  136. package/dist/core/patch/index.d.ts.map +1 -0
  137. package/dist/core/patch/types.d.ts +75 -0
  138. package/dist/core/patch/types.d.ts.map +1 -0
  139. package/dist/core/pointer.d.ts +7 -0
  140. package/dist/core/pointer.d.ts.map +1 -0
  141. package/dist/core/state/codec.d.ts +22 -0
  142. package/dist/core/state/codec.d.ts.map +1 -0
  143. package/dist/core/state/host.d.ts +54 -0
  144. package/dist/core/state/host.d.ts.map +1 -0
  145. package/dist/core/state/index.d.ts +26 -0
  146. package/dist/core/state/index.d.ts.map +1 -0
  147. package/dist/core/state/size.d.ts +5 -0
  148. package/dist/core/state/size.d.ts.map +1 -0
  149. package/dist/core/validator.d.ts +44 -0
  150. package/dist/core/validator.d.ts.map +1 -0
  151. package/dist/index.cjs +124 -0
  152. package/dist/index.d.ts +16 -0
  153. package/dist/index.d.ts.map +1 -0
  154. package/dist/index.js +7 -0
  155. package/dist/language-server/index.cjs +41 -0
  156. package/dist/language-server/index.d.ts +73 -0
  157. package/dist/language-server/index.d.ts.map +1 -0
  158. package/dist/language-server/index.js +8 -0
  159. package/dist/language-server/rpc.d.ts +29 -0
  160. package/dist/language-server/rpc.d.ts.map +1 -0
  161. package/dist/language-server/server.cjs +172 -0
  162. package/dist/language-server/server.d.ts +3 -0
  163. package/dist/language-server/server.d.ts.map +1 -0
  164. package/dist/language-server/server.js +170 -0
  165. package/dist/optimize/box.d.ts +29 -0
  166. package/dist/optimize/box.d.ts.map +1 -0
  167. package/dist/optimize/equalize.d.ts +13 -0
  168. package/dist/optimize/equalize.d.ts.map +1 -0
  169. package/dist/optimize/index.cjs +1574 -0
  170. package/dist/optimize/index.d.ts +23 -0
  171. package/dist/optimize/index.d.ts.map +1 -0
  172. package/dist/optimize/index.js +1524 -0
  173. package/dist/optimize/markdown.d.ts +43 -0
  174. package/dist/optimize/markdown.d.ts.map +1 -0
  175. package/dist/optimize/measure.d.ts +38 -0
  176. package/dist/optimize/measure.d.ts.map +1 -0
  177. package/dist/optimize/pad.d.ts +14 -0
  178. package/dist/optimize/pad.d.ts.map +1 -0
  179. package/dist/optimize/rich-text.d.ts +14 -0
  180. package/dist/optimize/rich-text.d.ts.map +1 -0
  181. package/dist/optimize/types.d.ts +228 -0
  182. package/dist/optimize/types.d.ts.map +1 -0
  183. package/dist/patch/index.cjs +279 -0
  184. package/dist/patch/index.js +274 -0
  185. package/dist/renderer/all.css +1775 -0
  186. package/dist/renderer/assets/all-css.d.ts +8 -0
  187. package/dist/renderer/assets/all-css.d.ts.map +1 -0
  188. package/dist/renderer/assets/base-styles.d.ts +10 -0
  189. package/dist/renderer/assets/base-styles.d.ts.map +1 -0
  190. package/dist/renderer/assets/emoji.d.ts +6 -0
  191. package/dist/renderer/assets/emoji.d.ts.map +1 -0
  192. package/dist/renderer/assets/header.d.ts +9 -0
  193. package/dist/renderer/assets/header.d.ts.map +1 -0
  194. package/dist/renderer/assets/icon-font.d.ts +18 -0
  195. package/dist/renderer/assets/icon-font.d.ts.map +1 -0
  196. package/dist/renderer/assets/index.cjs +37 -0
  197. package/dist/renderer/assets/index.d.ts +13 -0
  198. package/dist/renderer/assets/index.d.ts.map +1 -0
  199. package/dist/renderer/assets/index.js +4 -0
  200. package/dist/renderer/async.cjs +197 -0
  201. package/dist/renderer/async.d.ts +58 -0
  202. package/dist/renderer/async.d.ts.map +1 -0
  203. package/dist/renderer/async.js +188 -0
  204. package/dist/renderer/audio-hydrate.d.ts +43 -0
  205. package/dist/renderer/audio-hydrate.d.ts.map +1 -0
  206. package/dist/renderer/browser.cjs +177 -0
  207. package/dist/renderer/browser.d.ts +17 -0
  208. package/dist/renderer/browser.d.ts.map +1 -0
  209. package/dist/renderer/browser.js +66 -0
  210. package/dist/renderer/chart-hydrate.d.ts +40 -0
  211. package/dist/renderer/chart-hydrate.d.ts.map +1 -0
  212. package/dist/renderer/components.d.ts +3 -0
  213. package/dist/renderer/components.d.ts.map +1 -0
  214. package/dist/renderer/constants.d.ts +240 -0
  215. package/dist/renderer/constants.d.ts.map +1 -0
  216. package/dist/renderer/dom.d.ts +12 -0
  217. package/dist/renderer/dom.d.ts.map +1 -0
  218. package/dist/renderer/emoji.css +1 -0
  219. package/dist/renderer/icon-font.css +1 -0
  220. package/dist/renderer/index.cjs +51 -0
  221. package/dist/renderer/index.d.ts +18 -0
  222. package/dist/renderer/index.d.ts.map +1 -0
  223. package/dist/renderer/index.js +6 -0
  224. package/dist/renderer/registry.d.ts +182 -0
  225. package/dist/renderer/registry.d.ts.map +1 -0
  226. package/dist/renderer/render.d.ts +18 -0
  227. package/dist/renderer/render.d.ts.map +1 -0
  228. package/dist/renderer/styles.css +1771 -0
  229. package/dist/renderer/table-pager.d.ts +29 -0
  230. package/dist/renderer/table-pager.d.ts.map +1 -0
  231. package/dist/renderer/toast.d.ts +41 -0
  232. package/dist/renderer/toast.d.ts.map +1 -0
  233. package/dist/renderer/types.d.ts +232 -0
  234. package/dist/renderer/types.d.ts.map +1 -0
  235. package/dist/renderer/vnode.d.ts +14 -0
  236. package/dist/renderer/vnode.d.ts.map +1 -0
  237. package/dist/schema/card.d.ts +2822 -0
  238. package/dist/schema/card.d.ts.map +1 -0
  239. package/dist/schema/common/behavior.d.ts +83 -0
  240. package/dist/schema/common/behavior.d.ts.map +1 -0
  241. package/dist/schema/common/behaviors-context.d.ts +21 -0
  242. package/dist/schema/common/behaviors-context.d.ts.map +1 -0
  243. package/dist/schema/common/confirm.d.ts +18 -0
  244. package/dist/schema/common/confirm.d.ts.map +1 -0
  245. package/dist/schema/common/enums.d.ts +122 -0
  246. package/dist/schema/common/enums.d.ts.map +1 -0
  247. package/dist/schema/common/fallback.d.ts +17 -0
  248. package/dist/schema/common/fallback.d.ts.map +1 -0
  249. package/dist/schema/common/icon-tokens.d.ts +1180 -0
  250. package/dist/schema/common/icon-tokens.d.ts.map +1 -0
  251. package/dist/schema/common/icon.d.ts +3551 -0
  252. package/dist/schema/common/icon.d.ts.map +1 -0
  253. package/dist/schema/common/index.d.ts +9 -0
  254. package/dist/schema/common/index.d.ts.map +1 -0
  255. package/dist/schema/common/text.d.ts +1320 -0
  256. package/dist/schema/common/text.d.ts.map +1 -0
  257. package/dist/schema/common/url.d.ts +22 -0
  258. package/dist/schema/common/url.d.ts.map +1 -0
  259. package/dist/schema/config.d.ts +226 -0
  260. package/dist/schema/config.d.ts.map +1 -0
  261. package/dist/schema/containers/index.d.ts +3890 -0
  262. package/dist/schema/containers/index.d.ts.map +1 -0
  263. package/dist/schema/content/index.d.ts +12327 -0
  264. package/dist/schema/content/index.d.ts.map +1 -0
  265. package/dist/schema/element-ref.d.ts +6 -0
  266. package/dist/schema/element-ref.d.ts.map +1 -0
  267. package/dist/schema/element.d.ts +20369 -0
  268. package/dist/schema/element.d.ts.map +1 -0
  269. package/dist/schema/header.d.ts +1284 -0
  270. package/dist/schema/header.d.ts.map +1 -0
  271. package/dist/schema/index.cjs +485 -0
  272. package/dist/schema/index.d.ts +16 -0
  273. package/dist/schema/index.d.ts.map +1 -0
  274. package/dist/schema/index.js +4 -0
  275. package/dist/schema/interactive/index.d.ts +5570 -0
  276. package/dist/schema/interactive/index.d.ts.map +1 -0
  277. package/dist/schema/markdown/builders.d.ts +59 -0
  278. package/dist/schema/markdown/builders.d.ts.map +1 -0
  279. package/dist/schema/markdown/code-language.d.ts +78 -0
  280. package/dist/schema/markdown/code-language.d.ts.map +1 -0
  281. package/dist/schema/markdown/component.d.ts +2401 -0
  282. package/dist/schema/markdown/component.d.ts.map +1 -0
  283. package/dist/schema/markdown/emoji-tokens.d.ts +193 -0
  284. package/dist/schema/markdown/emoji-tokens.d.ts.map +1 -0
  285. package/dist/schema/markdown/enums.d.ts +51 -0
  286. package/dist/schema/markdown/enums.d.ts.map +1 -0
  287. package/dist/schema/markdown/escape.d.ts +8 -0
  288. package/dist/schema/markdown/escape.d.ts.map +1 -0
  289. package/dist/schema/markdown/index.d.ts +16 -0
  290. package/dist/schema/markdown/index.d.ts.map +1 -0
  291. package/dist/schema/markdown/tags.d.ts +1307 -0
  292. package/dist/schema/markdown/tags.d.ts.map +1 -0
  293. package/dist/schema/markdown/text-size.d.ts +60 -0
  294. package/dist/schema/markdown/text-size.d.ts.map +1 -0
  295. package/dist/schema/tags.d.ts +12 -0
  296. package/dist/schema/tags.d.ts.map +1 -0
  297. package/dist/state/index.cjs +306 -0
  298. package/dist/state/index.js +289 -0
  299. package/package.json +155 -4
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 赵天雄
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,188 @@
1
- # Temporary Holding Version
1
+ # larkard
2
2
 
3
- 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.
3
+ 飞书卡片(Feishu/Lark Card JSON 2.0)工具链:解析、校验、发送前检查、RAW ↔ DSL、渲染、TSX 创作、CLI 与 LSP。
4
+
5
+ 一个包,多个运行时入口。主入口是卡片模型层;渲染、资源、浏览器水合、飞书 API 等能力通过子路径按需引入。
6
+
7
+ ```bash
8
+ npm i larkard
9
+ ```
10
+
11
+ ## 入口
12
+
13
+ | 入口 | 内容 | 运行时 |
14
+ | --- | --- | --- |
15
+ | `larkard` | 解析、Schema 校验、lint、`checkCard` / `checkSource`、`sanitize` / `compile` | Universal |
16
+ | `larkard/schema` | Zod Schema 2.0、类型、`CARD_ELEMENT_TAGS` | Universal |
17
+ | `larkard/icons` | 官方图标 token / 分类目录 / 客户端字体码点 | Universal |
18
+ | `larkard/emoji` | 官方 emoji token / 客户端短码映射 | Universal |
19
+ | `larkard/metrics` | 字号枚举、行高表、heading 样式、字宽度量 | Universal |
20
+ | `larkard/spacing` | 横向 / 纵向间距枚举与解析 | Universal |
21
+ | `larkard/adapter` | RAW ↔ DSL、RAW 类型、Markdown tokenizer | Universal |
22
+ | `larkard/renderer` | RAW / DSL → HTML 字符串(SSR / 截图) | Node |
23
+ | `larkard/renderer/browser` | DOM 渲染 + 音频 / 图表 / 表格水合 + toast | Browser |
24
+ | `larkard/renderer/assets` | `ALL_CSS` / 图标字体 / emoji / 布局 CSS | 任意 |
25
+ | `larkard/renderer/async` | 按 access token 拉图 / 按 message_id 拉消息 | Node / Browser |
26
+ | `larkard/components` | TSX → 卡片 JSON | Universal |
27
+ | `larkard/jsx-runtime` | JSX 运行时(`jsxImportSource`) | Universal |
28
+ | `larkard/optimize` | 分栏等高、纯文本升级富文本 | Universal |
29
+ | `larkard/patch` | RFC 6902 JSON Patch | Universal |
30
+ | `larkard/state` | 把卡片 state 封印进空分栏 URL | Universal |
31
+ | `larkard/language-server` | LSP 核心(stdio 服务器为 `larkard-language-server` bin) | Node / WebWorker |
32
+ | `larkard/cli` | CLI 的 `run(argv)` | Node |
33
+
34
+ CLI bin:`larkard`;LSP bin:`larkard-language-server`。
35
+
36
+ ## 发送前检查
37
+
38
+ ```ts
39
+ import { checkCard } from 'larkard';
40
+
41
+ const { card, errors, hints } = checkCard(dsl); // 对象,或 JSON / JSONC 源码
42
+ if (errors.length > 0) {
43
+ for (const issue of errors) console.error(`${issue.path}: ${issue.message}`);
44
+ process.exit(1);
45
+ }
46
+ await sendMessage(card!); // 无 errors 时才是可发送的净化卡片
47
+ ```
48
+
49
+ 检查覆盖 Schema、最佳实践,以及 Schema 表达不了、但飞书会整卡拒绝的真机硬约束(间距值域、面板内边距、音视频字段等)。`{ fix: true }` 会先修复可机械修复的问题,并逐条返回 `fixes`。
50
+
51
+ 需要带行列号的诊断(CLI / LSP / 编辑器):
52
+
53
+ ```ts
54
+ import { checkSource } from 'larkard';
55
+
56
+ const { diagnostics, errors, card } = checkSource(source);
57
+ for (const d of diagnostics) {
58
+ console.log(`${d.range?.start.line}:${d.range?.start.column} ${d.severity} ${d.message}`);
59
+ }
60
+ ```
61
+
62
+ ## 编译与净化
63
+
64
+ ```ts
65
+ import { compile, sanitize } from 'larkard';
66
+
67
+ const { raw } = compile(dsl); // DSL → 渲染器 RAW
68
+ const { card, stripped } = sanitize(input, { mode: 'strip' });
69
+ ```
70
+
71
+ ## 渲染
72
+
73
+ ```ts
74
+ // Node / SSR / 截图
75
+ import { renderDslToString } from 'larkard/renderer';
76
+ const html = renderDslToString(dsl);
77
+
78
+ // 浏览器
79
+ import { renderDsl } from 'larkard/renderer/browser';
80
+ const node = renderDsl(dsl);
81
+
82
+ // 页面级样式(SSR 自行注入)
83
+ import { feishuCardStyleTag } from 'larkard/renderer/assets';
84
+ const page = `<html><head>${feishuCardStyleTag()}</head><body>${html}</body></html>`;
85
+
86
+ // 按 access token 拉图 / 拉消息
87
+ import { renderCardToStringAsync } from 'larkard/renderer/async';
88
+ ```
89
+
90
+ CSS 文件子路径:`larkard/renderer/styles.css`、`icon-font.css`、`emoji.css`、`all.css`。
91
+
92
+ ## 双向适配
93
+
94
+ ```ts
95
+ import { dslToRaw, rawToDsl, degradeUnknown } from 'larkard/adapter';
96
+
97
+ const raw = dslToRaw(dsl);
98
+ const back = rawToDsl(rawEnvelope);
99
+ const safe = degradeUnknown(element);
100
+ ```
101
+
102
+ ## TSX 创作
103
+
104
+ `tsconfig.json`:
105
+
106
+ ```json
107
+ {
108
+ "compilerOptions": {
109
+ "jsx": "react-jsx",
110
+ "jsxImportSource": "larkard"
111
+ }
112
+ }
113
+ ```
114
+
115
+ ```tsx
116
+ import { Button, Card, Header, bindAction, registerAction, renderToCard } from 'larkard/components';
117
+
118
+ function approve(requestId: string) {
119
+ return { requestId };
120
+ }
121
+ registerAction('approval.approve', approve);
122
+
123
+ const card = renderToCard(
124
+ <Card headerTheme="blue" config={{ update_multi: true }}>
125
+ <Header title="费用审批" />
126
+ <Button type="primary" action={bindAction(approve, 'REQ-42')}>同意</Button>
127
+ </Card>,
128
+ );
129
+ ```
130
+
131
+ ## 增量修改 / 卡片内嵌 state
132
+
133
+ ```ts
134
+ import { parsePatch, applyPatch } from 'larkard/patch';
135
+ import { sealCardState, readCardState } from 'larkard/state';
136
+
137
+ const next = applyPatch(dsl, parsePatch(params.json_patch));
138
+ const { card, errors } = checkCard(next);
139
+ ```
140
+
141
+ ## CLI
142
+
143
+ ```bash
144
+ larkard check <file...> # Schema + 真机硬约束 + 最佳实践
145
+ larkard check <file> --fix # 先修复再检查
146
+ larkard validate <file...> # 仅 Schema
147
+ larkard lint <file...> # Schema + 最佳实践
148
+ larkard compile <file> --out raw.json
149
+ larkard sanitize <file> --out clean.json
150
+ larkard format <file>
151
+ ```
152
+
153
+ ## LSP
154
+
155
+ ```bash
156
+ larkard-language-server
157
+ ```
158
+
159
+ 诊断来自 `checkSource`,包含 Schema、最佳实践与真机硬约束;组件补全来自 `larkard/schema` 的 `CARD_ELEMENT_TAGS`。
160
+
161
+ ## 设计约束
162
+
163
+ - **包边界按运行时 / 发布边界切**:一个包,多个显式子路径;根入口不引入 DOM、图标字体或 emoji 雪碧。
164
+ - **同一事实只有一个真源**:图标 / emoji / 字号行高 / 间距在内部 `content` 模块,公开为 `larkard/icons`、`larkard/emoji`、`larkard/metrics`、`larkard/spacing`;RAW 类型与 Markdown tokenizer 在内部 `adapter` 模块。
165
+ - **任务型 API**:CLI / LSP / 下游统一走 `checkCard` / `checkSource`,不各自 `parse → validate → lint`。
166
+ - **契约测试**:components 的输出直接喂给 `FeishuCardV2Schema`;图标字体 / emoji CSS 与数据做一致性校验。
167
+
168
+ ## 从 `@open-feishu-card/*` 迁移
169
+
170
+ | 旧包 | 新入口 |
171
+ | --- | --- |
172
+ | `@open-feishu-card/parser` | `larkard`(`parse` / `resolveCardDocument` / `serializeCardDocument`) |
173
+ | `@open-feishu-card/validator` | `larkard`(`validate` / `validateAst` / `validateData`) |
174
+ | `@open-feishu-card/linter` | `larkard`(`lint` / `lintAst`) |
175
+ | `@open-feishu-card/check` | `larkard`(`checkCard` / `checkSource` / `repairDeviceIssues`) |
176
+ | `@open-feishu-card/compiler` | `larkard`(`sanitize` / `compile`) |
177
+ | `@open-feishu-card/patch` | `larkard/patch` |
178
+ | `@open-feishu-card/store` | `larkard/state` |
179
+ | `@open-feishu-card/schema` | `larkard/schema` |
180
+ | `@open-feishu-card/schema/icon-catalog` | `larkard/icons`(`ICON_CATALOG` / `ICON_TOKENS`) |
181
+ | `@open-feishu-card/adapter` | `larkard/adapter` |
182
+ | `@open-feishu-card/renderer` | `larkard/renderer`;浏览器 / 资源 / 异步用 `/browser`、`/assets`、`/async` |
183
+ | `@open-feishu-card/components` | `larkard/components`;JSX 运行时用 `larkard/jsx-runtime` |
184
+ | `@open-feishu-card/optimize` | `larkard/optimize`;字号行高常量用 `larkard/metrics` |
185
+
186
+ ## License
187
+
188
+ MIT。Lark / 飞书是字节跳动的商标;本项目是社区工具链,与官方无隶属关系。
@@ -0,0 +1,28 @@
1
+ /**
2
+ * Feishu RAW editor fields for theme-aware custom colors:
3
+ * customBackgroundStyle / custom_background_style → column backgrounds
4
+ * textStyle.customColor / textStyle.custom_color → inline text color
5
+ *
6
+ * Public DSL stores custom colors in config.style.color (cus-accent / cus-bg-N …)
7
+ * and references them via <font color> in markdown content / background_style — not inline #hex.
8
+ */
9
+ import type { CustomColorEntry } from './normalize-stored-colors.js';
10
+ export type ThemeColorPair = {
11
+ light_mode?: string;
12
+ lightMode?: string;
13
+ dark_mode?: string;
14
+ darkMode?: string;
15
+ };
16
+ export declare function readThemeColorLight(pair: unknown): string | undefined;
17
+ export declare function readThemeColorDark(pair: unknown): string | undefined;
18
+ export declare function isCustomHexColor(color: string): boolean;
19
+ /** Enum `color` wins; else fall back to customColor light hex/rgba. */
20
+ export declare function resolveTextStyleColor(textStyle: unknown): string | undefined;
21
+ /** When text color comes from customColor (not enum), return the full light/dark pair. */
22
+ export declare function resolveTextStyleCustomColorPair(textStyle: unknown): ThemeColorPair | undefined;
23
+ export declare function themePairToColorEntry(pair: ThemeColorPair): CustomColorEntry | undefined;
24
+ /** Light hex/rgba from column (or container) custom background, if any. */
25
+ export declare function resolveCustomBackgroundLight(property: unknown): string | undefined;
26
+ /** Light hex/rgba from interactive_container custom border color, if any. */
27
+ export declare function resolveCustomBorderLight(property: unknown): string | undefined;
28
+ //# sourceMappingURL=custom-colors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"custom-colors.d.ts","sourceRoot":"","sources":["../../src/adapter/custom-colors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAGrE,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAOrE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAOpE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED,uEAAuE;AACvE,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAO5E;AAED,0FAA0F;AAC1F,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAQ9F;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,cAAc,GAAG,gBAAgB,GAAG,SAAS,CAQxF;AAED,2EAA2E;AAC3E,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAKlF;AAED,6EAA6E;AAC7E,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAK9E"}
@@ -0,0 +1,20 @@
1
+ /**
2
+ * 公开 DSL(JSON Schema 2.0 卡片)→ 本渲染器认得的 RAW 形态。
3
+ *
4
+ * 这是 feishu-raw-card-to-dsl 的**逆向**:那个库把飞书下发的 raw envelope 投影回公开
5
+ * DSL;本文件把开发者手写的公开 DSL 反投影成 RAW,喂给 renderCard* 直接渲染,
6
+ * 从而免去「真发一遍卡片再拉回来」的服务端回环。
7
+ *
8
+ * 关键前提:目标不是「飞书能接收的合法 raw envelope」,而是「本渲染器能画出来的形态」。
9
+ * 后者宽松得多——components.ts 里很多字段本就同时接受 camelCase / snake_case
10
+ * (如 column_set 的 flex_mode/flexMode、img 的 scale_type/scaleType)。因此这里只需处理
11
+ * 三类真实差异:
12
+ * 1. markdown 内容字符串 → 子元素树(交给 md-parse.ts);
13
+ * 2. 元素扁平字段 → 包进 property,文本叶子归一为 { tag:'plain_text', property:{content} };
14
+ * 3. 少数「渲染器只认 camelCase」的字段做 snake→camel 重命名,box 简写字符串 → 对象。
15
+ * 其余字段一律透传(与渲染器 warnOnUnknownTag、以及反向库 convertGeneric 同哲学)。
16
+ */
17
+ import type { JsonCard } from './types.js';
18
+ /** DSL 顶层 → JsonCard(渲染器输入)。 */
19
+ export declare function dslToRaw(dsl: unknown): JsonCard;
20
+ //# sourceMappingURL=dsl-to-raw.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dsl-to-raw.d.ts","sourceRoot":"","sources":["../../src/adapter/dsl-to-raw.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAgC,QAAQ,EAAE,MAAM,YAAY,CAAC;AAmDzE,gCAAgC;AAChC,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,QAAQ,CAW/C"}
@@ -0,0 +1,35 @@
1
+ /**
2
+ * DSL config.style.color 中的自定义色别名在 dslToRaw 时展开为渲染器已支持的
3
+ * customBackgroundStyle / textStyle.customColor(对齐飞书 RAW 真机字段)。
4
+ *
5
+ * 别名不限于编辑器默认的 cus-*:业务卡也常用 mm_* 等任意 token 名登记在
6
+ * config.style.color,真机按 registry 键查找;仅认 cus- 前缀会导致背景/描边丢失。
7
+ */
8
+ import type { CardElement, TextStyle } from './types.js';
9
+ export type CustomColorEntry = {
10
+ light_mode: string;
11
+ dark_mode: string;
12
+ };
13
+ export type ColorRegistry = Record<string, CustomColorEntry>;
14
+ export declare function readColorRegistry(card: Record<string, unknown>): ColorRegistry;
15
+ /** @deprecated 保留兼容;展开逻辑改为查 registry,不再依赖 cus- 前缀。 */
16
+ export declare function isCustomColorAlias(value: unknown): value is string;
17
+ /** 是否为 config.style.color 中已登记的别名(任意 token 名)。 */
18
+ export declare function isRegisteredColorAlias(value: unknown, registry: ColorRegistry): value is string;
19
+ /** column / column_set / interactive_container background_style → customBackgroundStyle */
20
+ export declare function expandBackgroundStyleAlias(style: unknown, registry: ColorRegistry): {
21
+ light_mode: string;
22
+ dark_mode: string;
23
+ } | undefined;
24
+ /** textStyle.color 登记别名 → customColor(去掉 color,避免被当成命名色) */
25
+ export declare function expandTextStyleColor(textStyle: TextStyle | undefined, registry: ColorRegistry): TextStyle | undefined;
26
+ /** border_color / background_style 等登记别名 → customBackgroundStyle 形态(供 RAW 渲染器读取) */
27
+ export declare function expandColorAlias(style: unknown, registry: ColorRegistry): {
28
+ light_mode: string;
29
+ dark_mode: string;
30
+ } | undefined;
31
+ /** 递归展开 markdown / list 子树里的 cus-* 文字色 */
32
+ export declare function expandMarkdownElements(elements: CardElement[] | undefined, registry: ColorRegistry): CardElement[] | undefined;
33
+ /** markdown.font_color 且 content 无 <font> 时,包一层 font 再解析 */
34
+ export declare function wrapMarkdownContentWithFontColor(content: string, fontColor: string | undefined): string;
35
+ //# sourceMappingURL=expand-dsl-colors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"expand-dsl-colors.d.ts","sourceRoot":"","sources":["../../src/adapter/expand-dsl-colors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,MAAM,gBAAgB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AACzE,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAE7D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAiB9E;AAED,sDAAsD;AACtD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAElE;AAED,kDAAkD;AAClD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,aAAa,GACtB,KAAK,IAAI,MAAM,CAEjB;AAED,2FAA2F;AAC3F,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,aAAa,GACtB;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAIvD;AAED,4DAA4D;AAC5D,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,QAAQ,EAAE,aAAa,GACtB,SAAS,GAAG,SAAS,CAUvB;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,aAAa,GACtB;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAEvD;AAED,0CAA0C;AAC1C,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,WAAW,EAAE,GAAG,SAAS,EACnC,QAAQ,EAAE,aAAa,GACtB,WAAW,EAAE,GAAG,SAAS,CAG3B;AAuCD,4DAA4D;AAC5D,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,MAAM,CAGR"}
@@ -0,0 +1,80 @@
1
+ 'use strict';
2
+
3
+ var chunkADPNWRSB_cjs = require('../chunk-ADPNWRSB.cjs');
4
+ require('../chunk-MOCZJJ5P.cjs');
5
+ require('../chunk-ETV4XYOV.cjs');
6
+
7
+
8
+
9
+ Object.defineProperty(exports, "createColorRegistry", {
10
+ enumerable: true,
11
+ get: function () { return chunkADPNWRSB_cjs.createColorRegistry; }
12
+ });
13
+ Object.defineProperty(exports, "degradeUnknown", {
14
+ enumerable: true,
15
+ get: function () { return chunkADPNWRSB_cjs.degradeUnknown; }
16
+ });
17
+ Object.defineProperty(exports, "dslToRaw", {
18
+ enumerable: true,
19
+ get: function () { return chunkADPNWRSB_cjs.dslToRaw; }
20
+ });
21
+ Object.defineProperty(exports, "isCustomHexColor", {
22
+ enumerable: true,
23
+ get: function () { return chunkADPNWRSB_cjs.isCustomHexColor; }
24
+ });
25
+ Object.defineProperty(exports, "isRawCardEnvelope", {
26
+ enumerable: true,
27
+ get: function () { return chunkADPNWRSB_cjs.isRawCardEnvelope; }
28
+ });
29
+ Object.defineProperty(exports, "normalizeStoredCardColors", {
30
+ enumerable: true,
31
+ get: function () { return chunkADPNWRSB_cjs.normalizeStoredCardColors; }
32
+ });
33
+ Object.defineProperty(exports, "parseInline", {
34
+ enumerable: true,
35
+ get: function () { return chunkADPNWRSB_cjs.parseInline; }
36
+ });
37
+ Object.defineProperty(exports, "parseMarkdown", {
38
+ enumerable: true,
39
+ get: function () { return chunkADPNWRSB_cjs.parseMarkdown; }
40
+ });
41
+ Object.defineProperty(exports, "rawCardToDsl", {
42
+ enumerable: true,
43
+ get: function () { return chunkADPNWRSB_cjs.rawCardToDsl; }
44
+ });
45
+ Object.defineProperty(exports, "rawToDsl", {
46
+ enumerable: true,
47
+ get: function () { return chunkADPNWRSB_cjs.rawToDsl; }
48
+ });
49
+ Object.defineProperty(exports, "readThemeColorDark", {
50
+ enumerable: true,
51
+ get: function () { return chunkADPNWRSB_cjs.readThemeColorDark; }
52
+ });
53
+ Object.defineProperty(exports, "readThemeColorLight", {
54
+ enumerable: true,
55
+ get: function () { return chunkADPNWRSB_cjs.readThemeColorLight; }
56
+ });
57
+ Object.defineProperty(exports, "registerColorEntry", {
58
+ enumerable: true,
59
+ get: function () { return chunkADPNWRSB_cjs.registerColorEntry; }
60
+ });
61
+ Object.defineProperty(exports, "resolveCustomBackgroundLight", {
62
+ enumerable: true,
63
+ get: function () { return chunkADPNWRSB_cjs.resolveCustomBackgroundLight; }
64
+ });
65
+ Object.defineProperty(exports, "resolveCustomBorderLight", {
66
+ enumerable: true,
67
+ get: function () { return chunkADPNWRSB_cjs.resolveCustomBorderLight; }
68
+ });
69
+ Object.defineProperty(exports, "resolveTextStyleColor", {
70
+ enumerable: true,
71
+ get: function () { return chunkADPNWRSB_cjs.resolveTextStyleColor; }
72
+ });
73
+ Object.defineProperty(exports, "resolveTextStyleCustomColorPair", {
74
+ enumerable: true,
75
+ get: function () { return chunkADPNWRSB_cjs.resolveTextStyleCustomColorPair; }
76
+ });
77
+ Object.defineProperty(exports, "themePairToColorEntry", {
78
+ enumerable: true,
79
+ get: function () { return chunkADPNWRSB_cjs.themePairToColorEntry; }
80
+ });
@@ -0,0 +1,18 @@
1
+ /**
2
+ * larkard/adapter
3
+ *
4
+ * 公开 DSL(JSON Schema 2.0)↔ 飞书内部 RAW JSON 的双向适配器。
5
+ * 目标:完全无损的双向转换(见 AGENTS.md)。
6
+ * - dslToRaw: 公开 DSL → 渲染器认得的 RAW 形态
7
+ * - rawToDsl / rawCardToDsl: RAW envelope → 公开 DSL
8
+ */
9
+ export { dslToRaw } from './dsl-to-raw.js';
10
+ export { rawToDsl, rawCardToDsl, isRawCardEnvelope, degradeUnknown, } from './raw-to-dsl.js';
11
+ export type { RawToDslOptions, RawToDslWarning } from './raw-to-dsl.js';
12
+ export { normalizeStoredCardColors, createColorRegistry, registerColorEntry } from './normalize-stored-colors.js';
13
+ export type { CustomColorEntry } from './normalize-stored-colors.js';
14
+ export { readThemeColorLight, readThemeColorDark, resolveCustomBackgroundLight, resolveCustomBorderLight, resolveTextStyleColor, resolveTextStyleCustomColorPair, themePairToColorEntry, isCustomHexColor, } from './custom-colors.js';
15
+ export type { ThemeColorPair } from './custom-colors.js';
16
+ export type * from './types.js';
17
+ export { parseMarkdown, parseInline } from './md-parse.js';
18
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapter/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClH,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,4BAA4B,EAC5B,wBAAwB,EACxB,qBAAqB,EACrB,+BAA+B,EAC/B,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,mBAAmB,YAAY,CAAC;AAEhC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}
@@ -0,0 +1,3 @@
1
+ export { createColorRegistry, degradeUnknown, dslToRaw, isCustomHexColor, isRawCardEnvelope, normalizeStoredCardColors, parseInline, parseMarkdown, rawCardToDsl, rawToDsl, readThemeColorDark, readThemeColorLight, registerColorEntry, resolveCustomBackgroundLight, resolveCustomBorderLight, resolveTextStyleColor, resolveTextStyleCustomColorPair, themePairToColorEntry } from '../chunk-ZX4N4AUP.js';
2
+ import '../chunk-462CNCHD.js';
3
+ import '../chunk-PKBMQBKP.js';
@@ -0,0 +1,24 @@
1
+ /**
2
+ * DSL 的 markdown「内容字符串」→ RAW 的「子元素树」。
3
+ *
4
+ * 公开 DSL 里 markdown 是一段字符串(`{ tag:'markdown', content:'**x** `y`' }`),
5
+ * 而本渲染器的 markdown 组件(components.ts)渲染的是 `property.elements`——
6
+ * 一组 `{ tag, property }` 内联/块级子元素。本文件把字符串解析成那棵子元素树,
7
+ * 正是 feishu-raw-card-to-dsl 里 rebuildMarkdown 的**逆运算**。
8
+ *
9
+ * 目标不是「飞书能接收的合法结构」,而是「本渲染器认得、能画出来的结构」——
10
+ * 后者宽松得多,故这里只需覆盖飞书 markdown 的常用子集,手写一个小 tokenizer 即可,
11
+ * 保持零依赖。支持:
12
+ * 行内:加粗 ** **、斜体 * */ import type { CardElement } from './types.js';
13
+ /**
14
+ * 把一段(可能含软换行 \n)行内文本解析成子元素数组。
15
+ * 逐字符扫描,维护加粗/斜体/删除线/颜色状态;状态切换或遇到特殊构造时,
16
+ * 把累积的纯文本冲刷为一个 plain_text 段(对称于 rebuildMarkdown 的分段模型)。
17
+ */
18
+ export declare function parseInline(text: string): CardElement[];
19
+ /**
20
+ * markdown 字符串 → 子元素数组(块级 + 行内)。
21
+ * 逐行扫描识别块构造;连续的普通文本行合并为一段,用 br 承载软换行。
22
+ */
23
+ export declare function parseMarkdown(content: string | undefined | null): CardElement[];
24
+ //# sourceMappingURL=md-parse.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"md-parse.d.ts","sourceRoot":"","sources":["../../src/adapter/md-parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;wBAWwB,CAOxB,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,YAAY,CAAC;AA+BzD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAgKvD;AAgFD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,WAAW,EAAE,CAqG/E"}
@@ -0,0 +1,30 @@
1
+ /**
2
+ * 飞书存储卡片时会将 config.style.color 的 cus-N 展开为 custom_background_style(#RRGGBBAA),
3
+ * 并丢弃 config.style 与 markdown 内联字色。回读底稿后须 normalize,否则 modify 再发会丢色。
4
+ * 公开 DSL 用 content 内 <font color='cus-N'> 表达字色(飞书发送接口不接受 markdown.font_color)。
5
+ *
6
+ * 原则:RAW↔DSL 双向无损(见 AGENTS.md)。显式字色/背景色只做 alias 登记,不得合并进语义 token。
7
+ */
8
+ export type CustomColorEntry = {
9
+ light_mode: string;
10
+ dark_mode: string;
11
+ };
12
+ export type ColorRegistry = {
13
+ entries: Record<string, CustomColorEntry>;
14
+ /** 背景/边框等同色复用 cus-bg-N,与文字 cus-text-N 分表,避免串 alias */
15
+ bgKeyToAlias: Map<string, string>;
16
+ textKeyToAlias: Map<string, string>;
17
+ bgSeq: number;
18
+ textSeq: number;
19
+ };
20
+ export declare function createColorRegistry(): ColorRegistry;
21
+ export declare function colorEntryKey(entry: CustomColorEntry): string;
22
+ export declare function registerColorEntry(registry: ColorRegistry, entry: CustomColorEntry, prefix: 'cus-bg' | 'cus-text'): string;
23
+ export declare function hexColorToRgba(hex: string): string | undefined;
24
+ /**
25
+ * 将飞书回读的 custom_background_style 还原为可再次发送的 background_style cus-N + config.style.color。
26
+ * 若 markdown 缺少内联字色,按 text_size / 加粗内容补 <font color='cus-accent'|'cus-muted'>(飞书回读会丢字色)。
27
+ * rawToDsl 可传入已登记的文字自定义色(preRegistered),与背景色一并写入 config.style.color。
28
+ */
29
+ export declare function normalizeStoredCardColors(dsl: Record<string, unknown>, preRegistered?: ColorRegistry): void;
30
+ //# sourceMappingURL=normalize-stored-colors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"normalize-stored-colors.d.ts","sourceRoot":"","sources":["../../src/adapter/normalize-stored-colors.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,MAAM,MAAM,gBAAgB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC1C,sDAAsD;IACtD,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAE7D;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,QAAQ,GAAG,UAAU,GAC5B,MAAM,CAWR;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAgB9D;AA8DD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,aAAa,CAAC,EAAE,aAAa,GAC5B,IAAI,CA0HN"}
@@ -0,0 +1,80 @@
1
+ /**
2
+ * RAW → 公开 DSL(JSON Schema 2.0)。
3
+ *
4
+ * 本文件完整移植自 `feishu-raw-card-to-dsl`(保持算法与行为一致)。
5
+ * monorepo 额外导出 `rawToDsl`(兼容本地 RAW / envelope)与可选的 `degradeUnknown`。
6
+ *
7
+ * Convert the editor-internal "raw_card_content" payload returned by
8
+ * `im.message.get?card_msg_content_type=raw_card_content` into the public
9
+ * JSON Schema 2.0 DSL we author and send.
10
+ *
11
+ * The raw payload differs from the public DSL in several ways:
12
+ * 1. Every node is wrapped as { id, tag, property: { ...real fields... } }.
13
+ * 2. Field names are camelCase (textAlign, backgroundStyle, imageID, ...).
14
+ * 3. Box fields (padding/margin) are objects { bottom:{type,value}, ... }
15
+ * instead of "Tpx Rpx Bpx Lpx" strings; scalar pixels (corner_radius,
16
+ * icon size) are similarly objectified.
17
+ * 4. Images carry imageID (numeric) which indexes into a separate
18
+ * json_attachment.images table to recover the real img_key.
19
+ * 5. Markdown is split into per-segment children (plain_text / link / br /
20
+ * at_all / person_v1 / text_tag / code_span / ...) under a wrapper
21
+ * element with originTag:'markdown'; we re-stitch them back into a
22
+ * single content string with inline markers.
23
+ * 6. Header is wrapped as `tag: 'card_header'` and its icon shows up as a
24
+ * sibling `udIcon` wrapper around an inner `ud_icon` element.
25
+ * 7. Editor mirrors the same value twice — a coarse enum (width:'auto')
26
+ * alongside a precise echo (widthValue:{type:'pixels',value:72}). We
27
+ * project the precise echo back onto the enum when it disagrees.
28
+ * 8. Most nodes carry editor defaults (disabled:false, vertical_align:
29
+ * 'top', flex_mode:'none', background_style:'default') that the public
30
+ * DSL omits. We strip them.
31
+ * 9. The whole thing is double-stringified into body.content as
32
+ * { json_card: "<stringified card>", json_attachment: { images, at_users? } }.
33
+ *
34
+ * Why we do this: the documented user_card_content path drops fields whose
35
+ * values match a server-side default (notably `column.padding` on a column
36
+ * with `background_style`), which silently breaks layouts on round-trip.
37
+ * The raw payload preserves them. We project raw -> public DSL on the read
38
+ * path so downstream code (patch_lark_card, archives, the model's mental
39
+ * model) keeps working against the only format that has a public spec.
40
+ *
41
+ * No public spec exists for the raw payload. The mapping below is sample-
42
+ * driven, derived from diffing rawCardToDsl(raw) against archived public DSL
43
+ * for ~250 cards we previously sent. When the converter encounters something
44
+ * it does not recognize, it keeps the original key/value (snake-cased) so
45
+ * downstream sees an unknown field rather than silently losing data.
46
+ */
47
+ export declare function isRawCardEnvelope(value: unknown): boolean;
48
+ export declare function rawCardToDsl(envelope: unknown, options?: RawToDslOptions): unknown;
49
+ /** rawToDsl 的诊断级别。默认静默:只有传了 onWarn 才会回调。 */
50
+ export interface RawToDslWarning {
51
+ /**
52
+ * unknown_action_type: action.type 不认识(已原样保留进 behaviors)
53
+ * callback_payload_cleared: 服务端把回调载荷换成了 actionID / 清空
54
+ * unrepresentable_action: 该宿主(column_set / column)的公开 schema 没有可放 action 的字段
55
+ */
56
+ code: "unknown_action_type" | "callback_payload_cleared" | "unrepresentable_action";
57
+ /** 可读诊断,中文 */
58
+ message: string;
59
+ /** 持有 actions 的元素 tag:button / interactive_container / column_set / column */
60
+ ownerTag?: string;
61
+ }
62
+ /** 诊断通道;不传则完全不打扰调用方。 */
63
+ export interface RawToDslOptions {
64
+ onWarn?: (warning: RawToDslWarning) => void;
65
+ }
66
+ /**
67
+ * Flexible entry used by this monorepo:
68
+ * - raw envelope (`json_card` + `card_schema`) → same as `rawCardToDsl`
69
+ * - already-parsed `{ json_card: object, json_attachment? }`
70
+ * - `{ card: ... }` / bare card (e.g. output of `dslToRaw`) → `convertRoot`
71
+ */
72
+ export declare function rawToDsl(raw: unknown, options?: RawToDslOptions): unknown;
73
+ /**
74
+ * Optional helper: wrap a private/unknown element as
75
+ * `{ tag: 'unknown', raw_tag, fallback }`.
76
+ * Not applied automatically by `degradeUnknown` (parity with upstream feishu-raw-card-to-dsl).
77
+ * `convertRoot` / `rawCardToDsl` always run `normalizeStoredCardColors` on output.
78
+ */
79
+ export declare function degradeUnknown(el: Record<string, unknown>): Record<string, unknown>;
80
+ //# sourceMappingURL=raw-to-dsl.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"raw-to-dsl.d.ts","sourceRoot":"","sources":["../../src/adapter/raw-to-dsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAwBH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIzD;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAeT;AAED,4CAA4C;AAC5C,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,IAAI,EAAE,qBAAqB,GAAG,0BAA0B,GAAG,wBAAwB,CAAC;IACpF,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAwB;AACxB,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;CAC7C;AAulED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CA+CzE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGnF"}