@tbox.cn/app-contracts 0.12.0 → 0.12.2

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 (2) hide show
  1. package/dist/cards.d.ts +15 -0
  2. package/package.json +1 -1
package/dist/cards.d.ts CHANGED
@@ -38,6 +38,14 @@ export interface CardMeta<TSchema extends ZodTypeAny = ZodTypeAny> {
38
38
  samples?: CardSample<zInfer<TSchema>>[];
39
39
  /** 卡片数据契约版本(一期启用;缺省视为 1) */
40
40
  schemaVersion?: number;
41
+ /**
42
+ * 不出卡标记(additive,缺席合法):当前不在任何出卡链路(工具暂停/下线、流水改文本事实等)。
43
+ * - 仅影响 dev 卡片预览目录(/_tbox/api/cards 默认过滤,?includeHidden=true 可见并携带徽标);
44
+ * - 注册态完整(dataSchema/动作/渲染器照常)——非 CardRegistry.disable(provider 能力边界,
45
+ * 物理不注册、破坏 doctor 一致性);与 CardAction.hidden(动作不进按钮条)语义无关;
46
+ * - 标记原因须写明类型:暂停型(工具恢复时移除标记)或永久型(注明决策出处)。
47
+ */
48
+ hidden?: boolean;
41
49
  /** 历史快照 schema 迁移:oldData → 新版本数据(001 §7.4) */
42
50
  migrate?: (oldData: unknown, oldVersion: number) => Record<string, unknown>;
43
51
  /**
@@ -73,6 +81,13 @@ export interface CardSample<T = unknown> {
73
81
  isHistory?: boolean;
74
82
  /** 令牌缺席形态(授权过期分支——预览页不铸 token,按钮置灰) */
75
83
  noTokens?: boolean;
84
+ /**
85
+ * 预览隐藏位(additive,缺席合法):样本保留真源,仅 dev 预览目录构建过滤不展示
86
+ * (buildCatalog 展示级过滤;shape/schema 质量检查仍全量巡走——「不删除」语义)。
87
+ * 与 CardMeta.hidden(卡不出卡标记)同名同构、作用域逐级——恢复 = 移除标记;
88
+ * 降噪等临时裁决与覆盖弃用的标记原因写进 note 或样本所属卡 meta 注释。
89
+ */
90
+ hidden?: boolean;
76
91
  }
77
92
  /** 信封通知(P1:时效/提示的结构化表达,替代正文夹带) */
78
93
  export interface CardNotice {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tbox.cn/app-contracts",
3
- "version": "0.12.0",
3
+ "version": "0.12.2",
4
4
  "type": "module",
5
5
  "description": "平台契约(TIER0,types-only 为主 + 协议常量运行时值):卡片协议 / SDK adapter / 平台 DTO。",
6
6
  "exports": {