base-paint 0.3.15 → 0.3.16

package/dist/components/relation-picker/attrs.d.ts

@@ -0,0 +1,196 @@
+/** relation-picker · **标记契约**（渲染与运行时共用的唯一事实：类名／槽位／`data-*`／事件名／闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/新件/parts-交互与流程.mjs` 第 90 件，2026-09 用户裁定）
+ *  里**两档都过**的两个形态：
+ *   · **形态 `overlay`「浮层选一个」**（原型 A）：字段行一枚看得见的触发键，点开是一块顶层浮面——
+ *     搜一行 ＋「最近用过」一组 ＋「全部」一组 ＋ 末行「新建」；
+ *   · **形态 `inline`「行内展开选一个」**（原型 B）：不浮层，整块就在字段行下面推开——先选源
+ *     （最近一排 ＋ 可搜的列表 ＋ 末行「新建」），选完收成一行读得出的结果（✓ ＋ 选了什么 ＋ 一枚真按钮「换」）。
+ *  两档共用同一份选项表：`inline` 就是把 `overlay` 浮面里的那三组搬进行内。
+ *
+ *  它替掉的两种错法（原型墙那一格的原文）：①「下拉里几十个按拼音排，最常用的每次都得滚」；
+ *  ②「库里还没有的时候只能退出去先建好再回来选」。
+ *
+ *  **零键盘通路**：选一个实体**必须能用手点做完**——搜索框可打字，但每一行都是整行可点的 `<button>`，
+ *  不点键盘也选得完；标记与文案里没有一处键帽／键名／方向键（`:focus-visible` 只留给真实键盘用户，是地板不是通路）。
+ *
+ *  **形态键写在 `RELATION_PICKER_FORMS` 闭集**（`overlay`／`inline`，两个都是英文键，不许用 A/B 当键）；
+ *  闭集外的值一律 `badInput`（不静默降级：降级会让调用方以为自己拿到了另一种骨架）。
+ */
+/** 本件的类名根：全部槽位类名都是 `RELATION_PICKER_CLASS + '-' + 槽名`。 */
+export declare const RELATION_PICKER_CLASS = "ilife-block-relation-picker";
+/** 槽位闭集（标记契约的一部分：`render.ts`／`style.ts`／`runtime.ts` 与判据都用这里的名字拼类名）。 */
+export declare const RELATION_PICKER_SLOTS: readonly ["field", "label", "state", "box", "value", "caret", "panel", "inline", "in", "q", "clear", "colh", "col", "colr", "grp", "rows", "row", "mk", "tx", "name", "note", "reading", "pick", "hit", "quick", "chip", "tag", "gh", "count", "list", "new", "newlabel", "create", "empty", "foot", "err", "chosen", "tick", "result", "why", "change", "hint"];
+export type RelationPickerSlot = (typeof RELATION_PICKER_SLOTS)[number];
+/** 槽类的类名（唯一拼法：别处不许再写 `RELATION_PICKER_CLASS + '-' + …`）。 */
+export declare function relationPickerSlot(slot: RelationPickerSlot, prefix?: string): string;
+/** 形态闭集：`overlay`「浮层选一个」（原型 A）／`inline`「行内展开选一个」（原型 B）。 */
+export declare const RELATION_PICKER_FORMS: readonly ["overlay", "inline"];
+export type RelationPickerForm = (typeof RELATION_PICKER_FORMS)[number];
+/** 根（值＝机器键 `id`）。 */
+export declare const RELATION_PICKER_ATTR = "data-ilife-relation-picker";
+/** 形态（值是闭集内的那一个键，照实写进标记）。 */
+export declare const RELATION_PICKER_FORM_ATTR = "data-ilife-relation-form";
+/** 触发键（值＝`id`）：`overlay` 下运行时按它同步 `aria-expanded`。 */
+export declare const RELATION_PICKER_OPEN_ATTR = "data-ilife-relation-open";
+/** 浮面（值＝`id`；`overlay` 下是 `popover` 的 `id`）。 */
+export declare const RELATION_PICKER_PANEL_ATTR = "data-ilife-relation-panel";
+/** 行内那一块（值＝`id`）。 */
+export declare const RELATION_PICKER_INLINE_ATTR = "data-ilife-relation-inline";
+/** 搜索输入框（值＝`id`）。 */
+export declare const RELATION_PICKER_QUERY_ATTR = "data-ilife-relation-query";
+/** 清空搜索那枚键（值＝`id`）。 */
+export declare const RELATION_PICKER_CLEAR_ATTR = "data-ilife-relation-clear";
+/** 一行选项（值＝这一行的机器键）。 */
+export declare const RELATION_PICKER_ITEM_ATTR = "data-ilife-relation-item";
+/** 一行的**可搜底串**（小写；输入框里打的词在它里面找子串）。 */
+export declare const RELATION_PICKER_SEARCH_ATTR = "data-ilife-relation-search";
+/** 行的名字格（运行时按它重画命中词；它的 `textContent` 就是这一行的名字）。 */
+export declare const RELATION_PICKER_NAME_ATTR = "data-ilife-relation-name";
+/** 「最近用过」组里的那一行（值 `1`）。 */
+export declare const RELATION_PICKER_RECENT_ATTR = "data-ilife-relation-recent";
+/** 分组标题（值＝`recent`／`all`）。 */
+export declare const RELATION_PICKER_GROUP_ATTR = "data-ilife-relation-group";
+/** 空态那一行（值＝`id`）。 */
+export declare const RELATION_PICKER_EMPTY_ATTR = "data-ilife-relation-empty";
+/** 脚注行（值＝`id`）。 */
+export declare const RELATION_PICKER_FOOT_ATTR = "data-ilife-relation-foot";
+/** 命中词（`<mark>`，值 `1`）。 */
+export declare const RELATION_PICKER_HIT_ATTR = "data-ilife-relation-hit";
+/** 新建那枚键（值＝当前搜索词：点它就是把这个词建成新的）。 */
+export declare const RELATION_PICKER_CREATE_ATTR = "data-ilife-relation-create";
+/** 字段行里读当前值的那一格（运行时选中一变就重写它）。 */
+export declare const RELATION_PICKER_VALUE_ATTR = "data-ilife-relation-value";
+/** 选完那一行结果（值＝`id`；只在 `inline` 下有）。 */
+export declare const RELATION_PICKER_CHOSEN_ATTR = "data-ilife-relation-chosen";
+/** 「换」那枚键（值＝`id`：重新摊开行内那一块）。 */
+export declare const RELATION_PICKER_CHANGE_ATTR = "data-ilife-relation-change";
+/** 记账：这枚触发键已被运行时段接管（幂等读数，不是开关）。 */
+export declare const RELATION_PICKER_BOUND_ATTR = "data-ilife-relation-bound";
+/** 幂等开关：挂在 `<html>` 上（重复注入只绑一次）。 */
+export declare const RELATION_PICKER_RUNTIME_ATTR = "data-ilife-relation-runtime";
+/** 选中一行：`detail={id,key,title}`；`overlay` 下浮面此时已收起，`inline` 下行内那块已收成结果行。 */
+export declare const RELATION_PICKER_EVENT_SELECT = "ilife:relation-picker-select";
+/** 点了新建：`detail={id,value}`（`value`＝当前搜索词；本件不写库，只报「要建什么」）。 */
+export declare const RELATION_PICKER_EVENT_CREATE = "ilife:relation-picker-create";
+/** 输入即筛之后报一次真读数：`detail={id,query,hits}`（hits＝现在露着的行数）。 */
+export declare const RELATION_PICKER_EVENT_QUERY = "ilife:relation-picker-query";
+/** 触控地板：命中盒不小于这个数（px）。 */
+export declare const RELATION_PICKER_TOUCH_PX = 44;
+/** 一行选项的高度下限（px）：整行是命中区，比地板再宽裕一档。 */
+export declare const RELATION_PICKER_ROW_MIN_PX = 52;
+/** 相邻触控目标的缝（px）：行与行之间、独立控件之间都按它让开。 */
+export declare const RELATION_PICKER_GAP_PX = 8;
+/** 字段行与浮面的宽上限（px）：宽档下也不铺满屏（浮面是浮面，不是整页）。 */
+export declare const RELATION_PICKER_PANEL_MAX_PX = 460;
+/** 浮面离屏边至少留多少（px）。 */
+export declare const RELATION_PICKER_EDGE_PX = 14;
+/** 本件自己的**容器**名（`@container` 按它命中，不会跟别件的容器串味）。 */
+export declare const RELATION_PICKER_CONTAINER = "ilife-relation-picker";
+/** 窄档断点（px）：**本件自己**窄于它就收行内左右内边距与那两道缝。这是容器断点，不是视口断点。 */
+export declare const RELATION_PICKER_NARROW_PX = 560;
+/** 悬停只许是增强：这一段能力查询**样式段与运行时读同一个串**（两边必须说同一件事）。 */
+export declare const RELATION_PICKER_HOVER_QUERY = "(hover: hover) and (pointer: fine)";
+/** 浮面贴触发键的两条能力查询：**样式段与运行时段读同一个串**（两边对「这个引擎支不支持」必须说同一件事）。
+ *  支持 ⇒ CSS 锚定定位（`position-area` 贴触发键下沿，贴不下翻上去）；不支持 ⇒ 打开时运行时按触发键
+ *  的矩形算 `left`／`top`。口径同 `popover-menu`（`MENU_ANCHOR_QUERY`／`MENU_AREA_QUERY`）。 */
+export declare const RELATION_PICKER_ANCHOR_QUERY = "anchor-name: --a";
+export declare const RELATION_PICKER_AREA_QUERY = "position-area: bottom";
+/** 逐实例锚名的前缀（完整名＝前缀 ＋ 入参 `id`）：触发键写 `anchor-name`、浮面写 `position-anchor`，
+ *  两处写**同一个**名字——静态 CSS 认不出逐实例的名字（同 `popover-menu` 的 `--ilife-menu-<id>`）。 */
+export declare const RELATION_PICKER_ANCHOR_PREFIX = "--ilife-relation-picker-";
+/** 缺省文案与状态句（渲染期与运行时段**读同一份**，免得两处各写一句）。 */
+export declare const RELATION_PICKER_TEXT: Readonly<{
+    /** 还没选中时触发键里读的那一句。 */
+    readonly unpicked: "还没选";
+    /** 字段标签后面那句状态：正在选／已选。**选中一变这一句也要跟着换**——字段行读的是同一份事实
+     *  （运行时段里它跟值那一格一起重写；不然「已选的那一项」旁边还写着「正在选」）。 */
+    readonly stateLead: "— ";
+    readonly picking: "正在选";
+    readonly picked: "已选";
+    /** 分组标题两枚。 */
+    readonly recentGroup: "最近用过";
+    readonly allGroup: "全部";
+    /** 行尾那一枚：选中的写「已选」、其余写「选它」。 */
+    readonly pickedTag: "已选";
+    readonly pickTag: "选它";
+    /** 触发键右端那枚记号。 */
+    readonly caret: "▾";
+    /** 选中记号：✓ 选中／○ 没选。
+     *  未选态原来写中点 `·`（U+00B7）——那正是仓库分隔符门的 R1 命中（可见文本零豁免），
+     *  与 README 契约 13 自己写的「不出现 `·`」矛盾（2026-09 对抗审查读出：overlay 节点级 4 处／
+     *  inline 2 处，`separator-probe` exit=1）。改成空圆环 `○`：与 `radio-cards`／`wizard-shell` 的
+     *  「空圆环（未选）」、`goal-stairs` 的「还没开始 ○」同一套形语汇，且不是分隔符。 */
+    readonly tick: "✓";
+    readonly dot: "○";
+    /** 清空搜索那枚键的无障碍名（键上写的是 ✕）。 */
+    readonly clear: "清空搜索";
+    /** 末行新建排前面那句。 */
+    readonly newPrefix: "没找到？";
+    /** 新建那枚键的字（中间夹着当前搜索词；搜索词为空时退成下一句）。 */
+    readonly createPre: "新建「";
+    readonly createPost: "」";
+    readonly createEmpty: "新建一个";
+    /** 「换」那枚键的字。 */
+    readonly change: "换";
+    /** 选完那一行结果的前缀（运行时重写结果行时带上它，不丢「选好了」三字）。 */
+    readonly chosenPre: "选好了";
+    /** 空态：没有一条命中时写的那句话（中间夹着用户打的词）。 */
+    readonly emptyPre: "没有找到与「";
+    readonly emptyPost: "」相关的，去末行新建一个。";
+    /** 脚注三档：空输入列常用去处／命中几条／一条没中。 */
+    readonly footIdle: "「最近用过」排最前，点任意一行就选好。";
+    /** 没有 `recentKeys`（屏上没有「最近用过」这一组）时，空输入那一档的脚注。
+     *  **脚注跟着实际分区走**：缺了这一组还写「排最前」，就是一句屏上兑不出来的空许诺
+     *  （2026-09 对抗审查读出：无 `recentKeys` 的实例脚注仍写「「最近用过」排最前」，而分组只有 `all`）。 */
+    readonly footIdlePlain: "全部都在下面，点任意一行就选好。";
+    readonly footHitPre: "命中 ";
+    readonly footHitPost: " 条，点任意一行就选好。";
+    readonly footNone: "换个短一点的词试试，搜不到就去末行新建。";
+}>;
+/** 一个可选的实体（库里已经存在的那一个）。 */
+export interface RelationPickerOption {
+    /** 机器键（点这一行时原样送出）。**非空、只许标识符字符**，表内唯一。 */
+    readonly key: string;
+    /** 名字（如「招行储蓄卡」）。**非空**；命中词在这里标出来；许换行、不许 `…` 截断。 */
+    readonly title: string;
+    /** 副语（一行一句人话，如「上次 09-24，记了 3 笔」）。**这一串由调用方给**：本件自己的记号与文案
+     *  一律过仓库分隔符门（README 契约 13），调用方塞进来的 `·`／`；` 由调用方负责。 */
+    readonly note?: string;
+    /** 行右端读数（余额／件数，**已经是给人看的样子**：取整与千分位归调用方）。**永不 `…` 截断**。 */
+    readonly reading?: string;
+}
+/** 关系选择器入参。`id`／`label`／`options` 三样必填——没有 `id`，浮面的 `id` 与触发键就接不上。 */
+export interface RelationPickerInput {
+    /** 机器键（浮面 `id`、行内 `id` 与事件 `detail.id` 都拿它拼）。**非空、同页唯一、只许标识符字符**。 */
+    readonly id: string;
+    /** 字段标签（如「账户」／「物品放在哪儿」）。**非空**。 */
+    readonly label: string;
+    /** 全部选项（顺序＝「全部」组里的顺序；**至少一项**）。 */
+    readonly options: readonly RelationPickerOption[];
+    /** 「最近用过」那几项的机器键（子集，**至多 6 项**；顺序＝屏上顺序）。不给＝不出这一组。 */
+    readonly recentKeys?: readonly string[];
+    /** 当前选中的机器键（必须命中一项；给了＝字段行读它的名字、列表里那一行是选中态）。 */
+    readonly selectedKey?: string;
+    /** 搜索框里的初值（渲染期就按它筛一遍；不给＝空，列出全部）。首尾空白一律去掉。 */
+    readonly query?: string;
+    /** 「全部」组名的字（缺省按 `label` 拼：如「全部账户」；给了就用调用方的）。 */
+    readonly allLabel?: string;
+    /** 读数列的列头（缺省不出列头行；如「余额」）。给了＝`overlay` 下出列头行。 */
+    readonly readingLabel?: string;
+    /** 末行新建排前面那句（缺省「没找到？」）。 */
+    readonly newPrefix?: string;
+    /** 空态那句的定制版（不给就按搜索词现拼）。 */
+    readonly emptyText?: string;
+    /** 卡底那句提示。 */
+    readonly hint?: string;
+    /** 错态（写在输入框下边的那一句；给了就出这一行）。 */
+    readonly error?: string;
+    /** 行内那一块渲染时就摊开（只在 `inline` 下有意义；选中有值时缺省收起，给 `true`＝硬摊开）。 */
+    readonly open?: boolean;
+    /** 形态键（闭集，缺省 `overlay`）。 */
+    readonly form?: RelationPickerForm;
+    /** 附加类名（空格分隔；逐个过类名正则）。 */
+    readonly extraClass?: string;
+}
+//# sourceMappingURL=attrs.d.ts.map

package/dist/components/relation-picker/attrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.d.ts","sourceRoot":"","sources":["../../../src/components/relation-picker/attrs.ts"],"names":[],"mappings":"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"}

package/dist/components/relation-picker/attrs.js

@@ -0,0 +1,240 @@
+/** relation-picker · **标记契约**（渲染与运行时共用的唯一事实：类名／槽位／`data-*`／事件名／闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/新件/parts-交互与流程.mjs` 第 90 件，2026-09 用户裁定）
+ *  里**两档都过**的两个形态：
+ *   · **形态 `overlay`「浮层选一个」**（原型 A）：字段行一枚看得见的触发键，点开是一块顶层浮面——
+ *     搜一行 ＋「最近用过」一组 ＋「全部」一组 ＋ 末行「新建」；
+ *   · **形态 `inline`「行内展开选一个」**（原型 B）：不浮层，整块就在字段行下面推开——先选源
+ *     （最近一排 ＋ 可搜的列表 ＋ 末行「新建」），选完收成一行读得出的结果（✓ ＋ 选了什么 ＋ 一枚真按钮「换」）。
+ *  两档共用同一份选项表：`inline` 就是把 `overlay` 浮面里的那三组搬进行内。
+ *
+ *  它替掉的两种错法（原型墙那一格的原文）：①「下拉里几十个按拼音排，最常用的每次都得滚」；
+ *  ②「库里还没有的时候只能退出去先建好再回来选」。
+ *
+ *  **零键盘通路**：选一个实体**必须能用手点做完**——搜索框可打字，但每一行都是整行可点的 `<button>`，
+ *  不点键盘也选得完；标记与文案里没有一处键帽／键名／方向键（`:focus-visible` 只留给真实键盘用户，是地板不是通路）。
+ *
+ *  **形态键写在 `RELATION_PICKER_FORMS` 闭集**（`overlay`／`inline`，两个都是英文键，不许用 A/B 当键）；
+ *  闭集外的值一律 `badInput`（不静默降级：降级会让调用方以为自己拿到了另一种骨架）。
+ */
+/** 本件的类名根：全部槽位类名都是 `RELATION_PICKER_CLASS + '-' + 槽名`。 */
+export const RELATION_PICKER_CLASS = 'ilife-block-relation-picker';
+/** 槽位闭集（标记契约的一部分：`render.ts`／`style.ts`／`runtime.ts` 与判据都用这里的名字拼类名）。 */
+export const RELATION_PICKER_SLOTS = [
+    /** 字段行：标签 ＋ 触发键（读的是当前值）。 */
+    'field',
+    /** 字段标签（如「账户」，后面跟一句状态）。 */
+    'label',
+    /** 字段标签后面那句状态（「正在选」／「已选」）。 */
+    'state',
+    /** 触发键（`overlay` 下带 `popovertarget` 指浮面；`inline` 下是行内那块的开关）。 */
+    'box',
+    /** 触发键里读的当前值（选中的那一项的名字，没选＝还没选）。 */
+    'value',
+    /** 触发键右端那枚记号（纯装饰，`aria-hidden`）。 */
+    'caret',
+    /** 浮面本体（只在 `overlay` 下有；原生 `popover`，住顶层）。 */
+    'panel',
+    /** 行内展开那一块（只在 `inline` 下有；选完收起时 `hidden`）。 */
+    'inline',
+    /** 输入行（输入框 ＋ 清空键）。 */
+    'in',
+    /** 搜索输入框。 */
+    'q',
+    /** 清空搜索那枚键（44×44）。 */
+    'clear',
+    /** 列头行（`overlay` 下「 sources 名／读数名」那一行：两条列名与下面每行同一条内边距）。 */
+    'colh',
+    /** 列头左段（sources 名）。 */
+    'col',
+    /** 列头右段（读数名）。 */
+    'colr',
+    /** 一枚分组标题（最近用过／全部）。 */
+    'grp',
+    /** 一组的行容器（行与行之间留 8px 缝：相邻触控目标的地板）。 */
+    'rows',
+    /** 一行选项（**整行就是那颗按钮**）。 */
+    'row',
+    /** 行左那枚记号（✓ 选中／○ 没选；纯装饰，`aria-hidden`）。 */
+    'mk',
+    /** 行的文字格（名字 ＋ 副语）。 */
+    'tx',
+    /** 行名字（**许换行、不许 `…` 截断**）。 */
+    'name',
+    /** 行副语（一行一句人话：上次哪天、在哪一层）。 */
+    'note',
+    /** 行右端读数（余额／件数，已经是给人看的样子）——**永不 `…` 截断**。 */
+    'reading',
+    /** 行尾那一枚（选中的写「已选」、其余写「选它」——状态除颜色外还有字；只在 `inline` 列表里有）。 */
+    'pick',
+    /** 命中词（`<mark>`：形是下划线加粗，字是加粗 ⇒ 不只靠颜色）。 */
+    'hit',
+    /** 最近一排（`inline` 下横排换行的那一排）。 */
+    'quick',
+    /** 最近一排里的一枚（点它＝选中那一项）。 */
+    'chip',
+    /** 最近一枚上的「用过」小标（纯装饰）。 */
+    'tag',
+    /** 「全部」那一组的组头（组名 ＋ 几个）。 */
+    'gh',
+    /** 组头右端那句读数（`4 个`）。 */
+    'count',
+    /** 全部那一列（`inline` 下单列的列表容器）。 */
+    'list',
+    /** 末行「新建」那一排。 */
+    'new',
+    /** 新建排前面那句（「没找到？」）。 */
+    'newlabel',
+    /** 新建那枚键（把当前搜索词直接建成新的）。 */
+    'create',
+    /** 空态（一条都没命中时出来，`role="status"` 会念出来）。 */
+    'empty',
+    /** 脚注行（这一屏现在是什么状态：列的是常用去处／命中几条／换个词）。 */
+    'foot',
+    /** 错态那一行（写在输入框下边，并由输入框的 `aria-describedby` 指到它）。 */
+    'err',
+    /** 选完收成的那一行结果（✓ ＋ 选了什么 ＋ 一枚真按钮「换」；只在 `inline` 下有）。 */
+    'chosen',
+    /** 结果行左端那枚 ✓（纯装饰）。 */
+    'tick',
+    /** 结果行的文字格（选了什么 ＋ 底下那句交代）。 */
+    'result',
+    /** 结果行底下那句交代（字段行与这一行始终读的是同一个值）。 */
+    'why',
+    /** 「换」那枚键（44×44 真按钮：重新摊开行内那一块）。 */
+    'change',
+    /** 卡底那句提示。 */
+    'hint',
+];
+/** 槽类的类名（唯一拼法：别处不许再写 `RELATION_PICKER_CLASS + '-' + …`）。 */
+export function relationPickerSlot(slot, prefix = 'ilife-') {
+    return prefix + 'block-relation-picker-' + slot;
+}
+/** 形态闭集：`overlay`「浮层选一个」（原型 A）／`inline`「行内展开选一个」（原型 B）。 */
+export const RELATION_PICKER_FORMS = ['overlay', 'inline'];
+/* ── `data-*` 名（渲染与运行时共用的发现锚） ───────────────────────── */
+/** 根（值＝机器键 `id`）。 */
+export const RELATION_PICKER_ATTR = 'data-ilife-relation-picker';
+/** 形态（值是闭集内的那一个键，照实写进标记）。 */
+export const RELATION_PICKER_FORM_ATTR = 'data-ilife-relation-form';
+/** 触发键（值＝`id`）：`overlay` 下运行时按它同步 `aria-expanded`。 */
+export const RELATION_PICKER_OPEN_ATTR = 'data-ilife-relation-open';
+/** 浮面（值＝`id`；`overlay` 下是 `popover` 的 `id`）。 */
+export const RELATION_PICKER_PANEL_ATTR = 'data-ilife-relation-panel';
+/** 行内那一块（值＝`id`）。 */
+export const RELATION_PICKER_INLINE_ATTR = 'data-ilife-relation-inline';
+/** 搜索输入框（值＝`id`）。 */
+export const RELATION_PICKER_QUERY_ATTR = 'data-ilife-relation-query';
+/** 清空搜索那枚键（值＝`id`）。 */
+export const RELATION_PICKER_CLEAR_ATTR = 'data-ilife-relation-clear';
+/** 一行选项（值＝这一行的机器键）。 */
+export const RELATION_PICKER_ITEM_ATTR = 'data-ilife-relation-item';
+/** 一行的**可搜底串**（小写；输入框里打的词在它里面找子串）。 */
+export const RELATION_PICKER_SEARCH_ATTR = 'data-ilife-relation-search';
+/** 行的名字格（运行时按它重画命中词；它的 `textContent` 就是这一行的名字）。 */
+export const RELATION_PICKER_NAME_ATTR = 'data-ilife-relation-name';
+/** 「最近用过」组里的那一行（值 `1`）。 */
+export const RELATION_PICKER_RECENT_ATTR = 'data-ilife-relation-recent';
+/** 分组标题（值＝`recent`／`all`）。 */
+export const RELATION_PICKER_GROUP_ATTR = 'data-ilife-relation-group';
+/** 空态那一行（值＝`id`）。 */
+export const RELATION_PICKER_EMPTY_ATTR = 'data-ilife-relation-empty';
+/** 脚注行（值＝`id`）。 */
+export const RELATION_PICKER_FOOT_ATTR = 'data-ilife-relation-foot';
+/** 命中词（`<mark>`，值 `1`）。 */
+export const RELATION_PICKER_HIT_ATTR = 'data-ilife-relation-hit';
+/** 新建那枚键（值＝当前搜索词：点它就是把这个词建成新的）。 */
+export const RELATION_PICKER_CREATE_ATTR = 'data-ilife-relation-create';
+/** 字段行里读当前值的那一格（运行时选中一变就重写它）。 */
+export const RELATION_PICKER_VALUE_ATTR = 'data-ilife-relation-value';
+/** 选完那一行结果（值＝`id`；只在 `inline` 下有）。 */
+export const RELATION_PICKER_CHOSEN_ATTR = 'data-ilife-relation-chosen';
+/** 「换」那枚键（值＝`id`：重新摊开行内那一块）。 */
+export const RELATION_PICKER_CHANGE_ATTR = 'data-ilife-relation-change';
+/** 记账：这枚触发键已被运行时段接管（幂等读数，不是开关）。 */
+export const RELATION_PICKER_BOUND_ATTR = 'data-ilife-relation-bound';
+/** 幂等开关：挂在 `<html>` 上（重复注入只绑一次）。 */
+export const RELATION_PICKER_RUNTIME_ATTR = 'data-ilife-relation-runtime';
+/* ── 事件（冒泡 `CustomEvent`；`detail` 见 README 的「交互契约」） ────── */
+/** 选中一行：`detail={id,key,title}`；`overlay` 下浮面此时已收起，`inline` 下行内那块已收成结果行。 */
+export const RELATION_PICKER_EVENT_SELECT = 'ilife:relation-picker-select';
+/** 点了新建：`detail={id,value}`（`value`＝当前搜索词；本件不写库，只报「要建什么」）。 */
+export const RELATION_PICKER_EVENT_CREATE = 'ilife:relation-picker-create';
+/** 输入即筛之后报一次真读数：`detail={id,query,hits}`（hits＝现在露着的行数）。 */
+export const RELATION_PICKER_EVENT_QUERY = 'ilife:relation-picker-query';
+/* ── 几何与能力（判据与样式段读同一份常量） ─────────────────────── */
+/** 触控地板：命中盒不小于这个数（px）。 */
+export const RELATION_PICKER_TOUCH_PX = 44;
+/** 一行选项的高度下限（px）：整行是命中区，比地板再宽裕一档。 */
+export const RELATION_PICKER_ROW_MIN_PX = 52;
+/** 相邻触控目标的缝（px）：行与行之间、独立控件之间都按它让开。 */
+export const RELATION_PICKER_GAP_PX = 8;
+/** 字段行与浮面的宽上限（px）：宽档下也不铺满屏（浮面是浮面，不是整页）。 */
+export const RELATION_PICKER_PANEL_MAX_PX = 460;
+/** 浮面离屏边至少留多少（px）。 */
+export const RELATION_PICKER_EDGE_PX = 14;
+/** 本件自己的**容器**名（`@container` 按它命中，不会跟别件的容器串味）。 */
+export const RELATION_PICKER_CONTAINER = 'ilife-relation-picker';
+/** 窄档断点（px）：**本件自己**窄于它就收行内左右内边距与那两道缝。这是容器断点，不是视口断点。 */
+export const RELATION_PICKER_NARROW_PX = 560;
+/** 悬停只许是增强：这一段能力查询**样式段与运行时读同一个串**（两边必须说同一件事）。 */
+export const RELATION_PICKER_HOVER_QUERY = '(hover: hover) and (pointer: fine)';
+/** 浮面贴触发键的两条能力查询：**样式段与运行时段读同一个串**（两边对「这个引擎支不支持」必须说同一件事）。
+ *  支持 ⇒ CSS 锚定定位（`position-area` 贴触发键下沿，贴不下翻上去）；不支持 ⇒ 打开时运行时按触发键
+ *  的矩形算 `left`／`top`。口径同 `popover-menu`（`MENU_ANCHOR_QUERY`／`MENU_AREA_QUERY`）。 */
+export const RELATION_PICKER_ANCHOR_QUERY = 'anchor-name: --a';
+export const RELATION_PICKER_AREA_QUERY = 'position-area: bottom';
+/** 逐实例锚名的前缀（完整名＝前缀 ＋ 入参 `id`）：触发键写 `anchor-name`、浮面写 `position-anchor`，
+ *  两处写**同一个**名字——静态 CSS 认不出逐实例的名字（同 `popover-menu` 的 `--ilife-menu-<id>`）。 */
+export const RELATION_PICKER_ANCHOR_PREFIX = '--ilife-relation-picker-';
+/* ── 文案（缺省的那几句；调用方可以换，但语义别换） ─────────────────── */
+/** 缺省文案与状态句（渲染期与运行时段**读同一份**，免得两处各写一句）。 */
+export const RELATION_PICKER_TEXT = Object.freeze({
+    /** 还没选中时触发键里读的那一句。 */
+    unpicked: '还没选',
+    /** 字段标签后面那句状态：正在选／已选。**选中一变这一句也要跟着换**——字段行读的是同一份事实
+     *  （运行时段里它跟值那一格一起重写；不然「已选的那一项」旁边还写着「正在选」）。 */
+    stateLead: '— ',
+    picking: '正在选',
+    picked: '已选',
+    /** 分组标题两枚。 */
+    recentGroup: '最近用过',
+    allGroup: '全部',
+    /** 行尾那一枚：选中的写「已选」、其余写「选它」。 */
+    pickedTag: '已选',
+    pickTag: '选它',
+    /** 触发键右端那枚记号。 */
+    caret: '▾',
+    /** 选中记号：✓ 选中／○ 没选。
+     *  未选态原来写中点 `·`（U+00B7）——那正是仓库分隔符门的 R1 命中（可见文本零豁免），
+     *  与 README 契约 13 自己写的「不出现 `·`」矛盾（2026-09 对抗审查读出：overlay 节点级 4 处／
+     *  inline 2 处，`separator-probe` exit=1）。改成空圆环 `○`：与 `radio-cards`／`wizard-shell` 的
+     *  「空圆环（未选）」、`goal-stairs` 的「还没开始 ○」同一套形语汇，且不是分隔符。 */
+    tick: '✓',
+    dot: '○',
+    /** 清空搜索那枚键的无障碍名（键上写的是 ✕）。 */
+    clear: '清空搜索',
+    /** 末行新建排前面那句。 */
+    newPrefix: '没找到？',
+    /** 新建那枚键的字（中间夹着当前搜索词；搜索词为空时退成下一句）。 */
+    createPre: '新建「',
+    createPost: '」',
+    createEmpty: '新建一个',
+    /** 「换」那枚键的字。 */
+    change: '换',
+    /** 选完那一行结果的前缀（运行时重写结果行时带上它，不丢「选好了」三字）。 */
+    chosenPre: '选好了',
+    /** 空态：没有一条命中时写的那句话（中间夹着用户打的词）。 */
+    emptyPre: '没有找到与「',
+    emptyPost: '」相关的，去末行新建一个。',
+    /** 脚注三档：空输入列常用去处／命中几条／一条没中。 */
+    footIdle: '「最近用过」排最前，点任意一行就选好。',
+    /** 没有 `recentKeys`（屏上没有「最近用过」这一组）时，空输入那一档的脚注。
+     *  **脚注跟着实际分区走**：缺了这一组还写「排最前」，就是一句屏上兑不出来的空许诺
+     *  （2026-09 对抗审查读出：无 `recentKeys` 的实例脚注仍写「「最近用过」排最前」，而分组只有 `all`）。 */
+    footIdlePlain: '全部都在下面，点任意一行就选好。',
+    footHitPre: '命中 ',
+    footHitPost: ' 条，点任意一行就选好。',
+    footNone: '换个短一点的词试试，搜不到就去末行新建。',
+});
+//# sourceMappingURL=attrs.js.map

package/dist/components/relation-picker/attrs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.js","sourceRoot":"","sources":["../../../src/components/relation-picker/attrs.ts"],"names":[],"mappings":"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"}

package/dist/components/relation-picker/index.d.ts

@@ -0,0 +1,20 @@
+/** relation-picker · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  五件运行名：`renderRelationPicker(input)`（产标记，零 DOM）／`relationPickerCss()`（样式段）／
+ *  `buildRelationPickerJs()`（运行时段：输入即筛 ＋ 整行可点 ＋ 命中词重画 ＋ 就地新建 ＋ 「换」重选）。
+ *  标记契约（别的件／页面要按名字找元素时读它）：`RELATION_PICKER_CLASS`／`RELATION_PICKER_SLOTS`／
+ *  `relationPickerSlot()`／`RELATION_PICKER_PANEL_ATTR`／`RELATION_PICKER_ITEM_ATTR`／
+ *  `RELATION_PICKER_QUERY_ATTR`／`RELATION_PICKER_VALUE_ATTR`。
+ *  闭集与几何：`RELATION_PICKER_FORMS`（`overlay` 浮层选一个／`inline` 行内展开选一个）／
+ *  `RELATION_PICKER_TOUCH_PX`／`RELATION_PICKER_ROW_MIN_PX`／`RELATION_PICKER_GAP_PX`。
+ *  三条事件：`RELATION_PICKER_EVENT_SELECT`（选中一行）／`RELATION_PICKER_EVENT_CREATE`（点了新建）／
+ *  `RELATION_PICKER_EVENT_QUERY`（筛完的真读数）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { RELATION_PICKER_ATTR, RELATION_PICKER_BOUND_ATTR, RELATION_PICKER_CHANGE_ATTR, RELATION_PICKER_CHOSEN_ATTR, RELATION_PICKER_CLASS, RELATION_PICKER_CLEAR_ATTR, RELATION_PICKER_CONTAINER, RELATION_PICKER_CREATE_ATTR, RELATION_PICKER_EDGE_PX, RELATION_PICKER_EMPTY_ATTR, RELATION_PICKER_EVENT_CREATE, RELATION_PICKER_EVENT_QUERY, RELATION_PICKER_EVENT_SELECT, RELATION_PICKER_FOOT_ATTR, RELATION_PICKER_FORMS, RELATION_PICKER_FORM_ATTR, RELATION_PICKER_GAP_PX, RELATION_PICKER_GROUP_ATTR, RELATION_PICKER_HIT_ATTR, RELATION_PICKER_HOVER_QUERY, RELATION_PICKER_INLINE_ATTR, RELATION_PICKER_ITEM_ATTR, RELATION_PICKER_NAME_ATTR, RELATION_PICKER_NARROW_PX, RELATION_PICKER_OPEN_ATTR, RELATION_PICKER_PANEL_ATTR, RELATION_PICKER_PANEL_MAX_PX, RELATION_PICKER_QUERY_ATTR, RELATION_PICKER_RECENT_ATTR, RELATION_PICKER_ROW_MIN_PX, RELATION_PICKER_RUNTIME_ATTR, RELATION_PICKER_SEARCH_ATTR, RELATION_PICKER_SLOTS, RELATION_PICKER_TEXT, RELATION_PICKER_TOUCH_PX, RELATION_PICKER_VALUE_ATTR, relationPickerSlot, } from './attrs.js';
+export type { RelationPickerForm, RelationPickerInput, RelationPickerOption, RelationPickerSlot, } from './attrs.js';
+export { renderRelationPicker } from './render.js';
+export { relationPickerCss } from './style.js';
+export { buildRelationPickerJs } from './runtime.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/relation-picker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/relation-picker/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,EAC3B,uBAAuB,EACvB,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,EAC3B,4BAA4B,EAC5B,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,2BAA2B,EAC3B,2BAA2B,EAC3B,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}

package/dist/components/relation-picker/index.js

@@ -0,0 +1,19 @@
+/** relation-picker · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  五件运行名：`renderRelationPicker(input)`（产标记，零 DOM）／`relationPickerCss()`（样式段）／
+ *  `buildRelationPickerJs()`（运行时段：输入即筛 ＋ 整行可点 ＋ 命中词重画 ＋ 就地新建 ＋ 「换」重选）。
+ *  标记契约（别的件／页面要按名字找元素时读它）：`RELATION_PICKER_CLASS`／`RELATION_PICKER_SLOTS`／
+ *  `relationPickerSlot()`／`RELATION_PICKER_PANEL_ATTR`／`RELATION_PICKER_ITEM_ATTR`／
+ *  `RELATION_PICKER_QUERY_ATTR`／`RELATION_PICKER_VALUE_ATTR`。
+ *  闭集与几何：`RELATION_PICKER_FORMS`（`overlay` 浮层选一个／`inline` 行内展开选一个）／
+ *  `RELATION_PICKER_TOUCH_PX`／`RELATION_PICKER_ROW_MIN_PX`／`RELATION_PICKER_GAP_PX`。
+ *  三条事件：`RELATION_PICKER_EVENT_SELECT`（选中一行）／`RELATION_PICKER_EVENT_CREATE`（点了新建）／
+ *  `RELATION_PICKER_EVENT_QUERY`（筛完的真读数）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { RELATION_PICKER_ATTR, RELATION_PICKER_BOUND_ATTR, RELATION_PICKER_CHANGE_ATTR, RELATION_PICKER_CHOSEN_ATTR, RELATION_PICKER_CLASS, RELATION_PICKER_CLEAR_ATTR, RELATION_PICKER_CONTAINER, RELATION_PICKER_CREATE_ATTR, RELATION_PICKER_EDGE_PX, RELATION_PICKER_EMPTY_ATTR, RELATION_PICKER_EVENT_CREATE, RELATION_PICKER_EVENT_QUERY, RELATION_PICKER_EVENT_SELECT, RELATION_PICKER_FOOT_ATTR, RELATION_PICKER_FORMS, RELATION_PICKER_FORM_ATTR, RELATION_PICKER_GAP_PX, RELATION_PICKER_GROUP_ATTR, RELATION_PICKER_HIT_ATTR, RELATION_PICKER_HOVER_QUERY, RELATION_PICKER_INLINE_ATTR, RELATION_PICKER_ITEM_ATTR, RELATION_PICKER_NAME_ATTR, RELATION_PICKER_NARROW_PX, RELATION_PICKER_OPEN_ATTR, RELATION_PICKER_PANEL_ATTR, RELATION_PICKER_PANEL_MAX_PX, RELATION_PICKER_QUERY_ATTR, RELATION_PICKER_RECENT_ATTR, RELATION_PICKER_ROW_MIN_PX, RELATION_PICKER_RUNTIME_ATTR, RELATION_PICKER_SEARCH_ATTR, RELATION_PICKER_SLOTS, RELATION_PICKER_TEXT, RELATION_PICKER_TOUCH_PX, RELATION_PICKER_VALUE_ATTR, relationPickerSlot, } from './attrs.js';
+export { renderRelationPicker } from './render.js';
+export { relationPickerCss } from './style.js';
+export { buildRelationPickerJs } from './runtime.js';
+//# sourceMappingURL=index.js.map

package/dist/components/relation-picker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/relation-picker/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,EAC3B,uBAAuB,EACvB,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,EAC3B,4BAA4B,EAC5B,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,2BAA2B,EAC3B,2BAA2B,EAC3B,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAOpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}

package/dist/components/relation-picker/model.d.ts

@@ -0,0 +1,85 @@
+import { type RelationPickerForm } from './attrs.js';
+/** 归一化后的一行（每个字段都已校验；`haystack`／`hidden`／`recent`／`selected` 都是算出来的）。 */
+export interface RelationPickerRow {
+    readonly key: string;
+    readonly title: string;
+    readonly note?: string;
+    readonly reading?: string;
+    /** 可搜底串（小写）：名字 ＋ 副语 ＋ 读数，空格相连。 */
+    readonly haystack: string;
+    /** 渲染期按 `query` 判出来的「这一行现在露不露」；运行时段只改这一位。 */
+    readonly hidden: boolean;
+    /** 是不是「最近用过」组里的那一行。 */
+    readonly recent: boolean;
+    /** 是不是当前选中的那一行（字段行与结果行读的是同一项）。 */
+    readonly selected: boolean;
+}
+/** 内部类型：`render.ts` 只吃它，不再自己碰 `any`。 */
+export interface RelationPickerModel {
+    readonly form: RelationPickerForm;
+    readonly id: string;
+    readonly label: string;
+    readonly rows: readonly RelationPickerRow[];
+    /** 「最近用过」组里的行（按 `recentKeys` 的顺序）。 */
+    readonly recents: readonly RelationPickerRow[];
+    /** 「全部」组里的行（调用方给的顺序）。 */
+    readonly all: readonly RelationPickerRow[];
+    /** 「全部」组名的字。 */
+    readonly allLabel: string;
+    /** 读数列的列头（给了才出列头行）。 */
+    readonly readingLabel?: string;
+    /** 当前选中的那一行（没选＝`undefined`，字段行读「还没选」）。 */
+    readonly selected?: RelationPickerRow;
+    /** 上屏用的搜索词（已去首尾空白）。 */
+    readonly query: string;
+    /** 现在露着的行数（露着的才数）。 */
+    readonly hits: number;
+    /** 脚注那句：空输入列常用去处／命中几条／一条没中。 */
+    readonly foot: string;
+    /** 空态那句（没命中时上屏）。 */
+    readonly empty: string;
+    /** 新建那枚键上的字（把当前搜索词夹在中间；搜索词为空时退成「新建一个」）。 */
+    readonly createLabel: string;
+    /** 末行新建排前面那句。 */
+    readonly newPrefix: string;
+    readonly emptyText?: string;
+    readonly hint?: string;
+    readonly error?: string;
+    /** 行内那一块摊开还是收起（`inline` 下：没选＝摊开，有选＝`open===true` 才摊开）。 */
+    readonly expanded: boolean;
+    readonly extraClass?: string;
+}
+/** 脚注那几句的字面表：`RELATION_PICKER_TEXT` 满足它，运行时段自建的那份小表也满足它——
+ *  **同一个函数两处跑**（渲染期与运行时段），靠的就是这份形状。 */
+export interface RelationPickerFootText {
+    readonly footIdle: string;
+    readonly footIdlePlain: string;
+    readonly footHitPre: string;
+    readonly footHitPost: string;
+    readonly footNone: string;
+}
+/** **命中读数的唯一口径**：按机器键去重后数「露着的项」。
+ *
+ *  为什么必须去重：`overlay` 下「最近用过」与「全部」是**同一批选项的两处摆法**，同一个键在屏上出现两次
+ *  （`inline` 下还多一枚 chip）；不去重就会把同一个选项数两遍——2026-09 对抗审查读出的正是这个：
+ *  渲染期 hits 数「选项」（ov-a 2／in-a 1），运行时段 hits 数「DOM 节点」（4／2），同一个数两处走散。
+ *
+ *  **这一段是运行时段跑的那一段**：`buildRelationPickerJs()` 把它的 `toString()` 原样嵌进产出的 JS，
+ *  两处不是「抄得像」，是同一份源码。故函数体只许读**自己的入参**（不许碰模块作用域里的任何名字）。
+ */
+export declare function relationPickerHits(items: readonly RelationPickerHitItem[]): number;
+/** `relationPickerHits()` 吃的一项：只要「机器键 ＋ 露不露」两件事（模型里的行与屏上的元素都满足）。 */
+export interface RelationPickerHitItem {
+    readonly key: string | null;
+    readonly hidden: boolean;
+}
+/** **脚注那句的唯一口径**（空输入列哪儿／命中几条／一条没中）：渲染期与运行时段**跑同一个函数**
+ *  （`buildRelationPickerJs()` 嵌的就是它的 `toString()`）。
+ *
+ *  `hasRecent`＝这一份实例有没有「最近用过」这一组：**脚注跟着实际分区走**——没有这一组时还写「排最前」，
+ *  就是一句屏上兑不出来的空许诺。函数体只读自己的入参（理由同上）。
+ */
+export declare function relationPickerFoot(query: string, hits: number, hasRecent: boolean, text: RelationPickerFootText): string;
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `RelationPickerModel`。 */
+export declare function normalizeRelationPicker(input: unknown): RelationPickerModel;
+//# sourceMappingURL=model.d.ts.map

package/dist/components/relation-picker/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/components/relation-picker/model.ts"],"names":[],"mappings":"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"}