@open-feishu-card/adapter 0.2.1 → 0.3.0

package/dist/raw-to-dsl.d.ts

@@ -1,8 +1,62 @@
-/** 未知/私有组件自动降级：包一层 unknown 节点，原始 RAW 保留在 fallback。 */
+/**
+ * RAW → 公开 DSL（JSON Schema 2.0）。
+ *
+ * 本文件完整移植自 `feishu-raw-card-to-dsl`（保持算法与行为一致）。
+ * monorepo 额外导出 `rawToDsl`（兼容本地 RAW / envelope）与可选的 `degradeUnknown`。
+ *
+ * Convert the editor-internal "raw_card_content" payload returned by
+ * `im.message.get?card_msg_content_type=raw_card_content` into the public
+ * JSON Schema 2.0 DSL we author and send.
+ *
+ * The raw payload differs from the public DSL in several ways:
+ *   1. Every node is wrapped as { id, tag, property: { ...real fields... } }.
+ *   2. Field names are camelCase (textAlign, backgroundStyle, imageID, ...).
+ *   3. Box fields (padding/margin) are objects { bottom:{type,value}, ... }
+ *      instead of "Tpx Rpx Bpx Lpx" strings; scalar pixels (corner_radius,
+ *      icon size) are similarly objectified.
+ *   4. Images carry imageID (numeric) which indexes into a separate
+ *      json_attachment.images table to recover the real img_key.
+ *   5. Markdown is split into per-segment children (plain_text / link / br /
+ *      at_all / person_v1 / text_tag / code_span / ...) under a wrapper
+ *      element with originTag:'markdown'; we re-stitch them back into a
+ *      single content string with inline markers.
+ *   6. Header is wrapped as `tag: 'card_header'` and its icon shows up as a
+ *      sibling `udIcon` wrapper around an inner `ud_icon` element.
+ *   7. Editor mirrors the same value twice — a coarse enum (width:'auto')
+ *      alongside a precise echo (widthValue:{type:'pixels',value:72}). We
+ *      project the precise echo back onto the enum when it disagrees.
+ *   8. Most nodes carry editor defaults (disabled:false, vertical_align:
+ *      'top', flex_mode:'none', background_style:'default') that the public
+ *      DSL omits. We strip them.
+ *   9. The whole thing is double-stringified into body.content as
+ *      { json_card: "<stringified card>", json_attachment: { images, at_users? } }.
+ *
+ * Why we do this: the documented user_card_content path drops fields whose
+ * values match a server-side default (notably `column.padding` on a column
+ * with `background_style`), which silently breaks layouts on round-trip.
+ * The raw payload preserves them. We project raw -> public DSL on the read
+ * path so downstream code (patch_lark_card, archives, the model's mental
+ * model) keeps working against the only format that has a public spec.
+ *
+ * No public spec exists for the raw payload. The mapping below is sample-
+ * driven, derived from diffing rawCardToDsl(raw) against archived public DSL
+ * for ~250 cards we previously sent. When the converter encounters something
+ * it does not recognize, it keeps the original key/value (snake-cased) so
+ * downstream sees an unknown field rather than silently losing data.
+ */
+export declare function isRawCardEnvelope(value: unknown): boolean;
+export declare function rawCardToDsl(envelope: unknown): unknown;
+/**
+ * Flexible entry used by this monorepo:
+ * - raw envelope (`json_card` + `card_schema`) → same as `rawCardToDsl`
+ * - already-parsed `{ json_card: object, json_attachment? }`
+ * - `{ card: ... }` / bare card (e.g. output of `dslToRaw`) → `convertRoot`
+ */
+export declare function rawToDsl(raw: unknown): unknown;
+/**
+ * Optional helper: wrap a private/unknown element as
+ * `{ tag: 'unknown', raw_tag, fallback }`.
+ * Not applied automatically by `rawToDsl` / `rawCardToDsl` (parity with upstream).
+ */
 export declare function degradeUnknown(el: Record<string, unknown>): Record<string, unknown>;
-/** RAW envelope（可能是 {json_card:{card}} / {card} / 直接 card）→ DSL 卡片对象 */
-export declare function rawToDsl(raw: unknown): Record<string, unknown>;
-/** DSL → RAW（重导出，统一入口） */
-export { dslToRaw } from './dsl-to-raw.js';
-export type { CardElement, ElementProperty, JsonCard } from './types.js';
 //# sourceMappingURL=raw-to-dsl.d.ts.map

package/dist/raw-to-dsl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"raw-to-dsl.d.ts","sourceRoot":"","sources":["../src/raw-to-dsl.ts"],"names":[],"mappings":"AAqDA,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGnF;AAED,wEAAwE;AACxE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiB9D;AAyGD,0BAA0B;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"raw-to-dsl.d.ts","sourceRoot":"","sources":["../src/raw-to-dsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAWH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIzD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAcvD;AAo9CD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CA8C9C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGnF"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@open-feishu-card/adapter",
-  "version": "0.2.1",
-  "description": "公开 DSL 与飞书内部 RAW JSON 的双向适配器，支持未知组件自动降级 (Fallback)",
+  "version": "0.3.0",
+  "description": "公开 DSL 与飞书内部 RAW JSON 的双向适配器；raw→DSL 对齐 feishu-raw-card-to-dsl",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -17,10 +17,11 @@
     "dist"
   ],
   "devDependencies": {
+    "@types/node": "^22.20.1",
     "tsup": "^8.3.5",
     "tsx": "^4.19.3",
     "typescript": "^7.0.2",
-    "@types/node": "^22.20.1"
+    "vitest": "^2.1.9"
   },
   "license": "MIT",
   "publishConfig": {
@@ -34,6 +35,6 @@
   "scripts": {
     "build": "tsup && tsc -p tsconfig.json --emitDeclarationOnly",
     "typecheck": "tsc --noEmit -p tsconfig.json",
-    "test": "tsx --test test/*.test.ts"
+    "test": "tsx --test test/adapter.test.ts && vitest run"
   }
 }