base-paint 0.1.0

package/dist/contract.d.ts

@@ -0,0 +1,26 @@
+/** base-paint/contract：渲染契约（版本化输入 Envelope→输出 HTML）。
+ *
+ * 缺失阻断不返空：data 缺席/版本不对即抛 RenderError，绝不输出静默空页。
+ * link-core 只做 typeof 级消费（import type），运行时零依赖红线不断。
+ */
+import type { Envelope } from 'base-link-core';
+import type { PageDescriptor } from './ui.js';
+export declare const RENDER_CONTRACT_VERSION: "0.1.0";
+/** 期望的 envelope 版本（与 link-core ENVELOPE_VERSION 同值，漂移由单测钉死）。 */
+export declare const RENDER_ENVELOPE_VERSION: "0.1.0";
+export interface RenderOutput {
+    readonly contractVersion: typeof RENDER_CONTRACT_VERSION;
+    readonly slotId: string;
+    readonly html: string;
+}
+export type RenderErrorCode = 'missing-data' | 'bad-envelope' | 'reco-only';
+export declare class RenderError extends Error {
+    readonly code: RenderErrorCode;
+    constructor(code: RenderErrorCode, message: string);
+}
+export declare function escapeHtml(s: string): string;
+/** 实页渲染：reco 描述子误入即抛；data 缺席即抛（不返空）。 */
+export declare function renderPage(page: PageDescriptor, env: Envelope): RenderOutput;
+/** 推荐安装占位渲染：显式 data-missing 标记，非静默空。 */
+export declare function renderReco(page: PageDescriptor): RenderOutput;
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9C,eAAO,MAAM,uBAAuB,EAAG,OAAgB,CAAC;AACxD,gEAAgE;AAChE,eAAO,MAAM,uBAAuB,EAAG,OAAgB,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,eAAe,EAAE,OAAO,uBAAuB,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,cAAc,GAAG,WAAW,CAAC;AAE5E,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;gBACnB,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM;CAKnD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAMD,wCAAwC;AACxC,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,QAAQ,GAAG,YAAY,CAO5E;AAED,wCAAwC;AACxC,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,YAAY,CAG7D"}

package/dist/contract.js

@@ -0,0 +1,37 @@
+import { cx } from './style.js';
+export const RENDER_CONTRACT_VERSION = '0.1.0';
+/** 期望的 envelope 版本（与 link-core ENVELOPE_VERSION 同值，漂移由单测钉死）。 */
+export const RENDER_ENVELOPE_VERSION = '0.1.0';
+export class RenderError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'RenderError';
+        this.code = code;
+    }
+}
+export function escapeHtml(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+function head(page) {
+    return '<section class="' + cx('page') + '" data-slot="' + escapeHtml(page.slotId) + '" data-skill="' + escapeHtml(page.skill) + '"><h1>' + escapeHtml(page.title) + '</h1>';
+}
+/** 实页渲染：reco 描述子误入即抛；data 缺席即抛（不返空）。 */
+export function renderPage(page, env) {
+    if (page.kind === 'reco')
+        throw new RenderError('reco-only', 'reco 描述子请走 renderReco：' + page.slotId);
+    if (!env || typeof env !== 'object')
+        throw new RenderError('bad-envelope', 'envelope 非对象');
+    if (env.version !== RENDER_ENVELOPE_VERSION)
+        throw new RenderError('bad-envelope', 'envelope 版本不符：' + String(env.version));
+    if (env.data === null || env.data === undefined)
+        throw new RenderError('missing-data', '缺失阻断取数，不返空：' + page.slotId);
+    const body = typeof env.data === 'string' ? escapeHtml(env.data) : escapeHtml(JSON.stringify(env.data));
+    return { contractVersion: RENDER_CONTRACT_VERSION, slotId: page.slotId, html: head(page) + '<div>' + body + '</div></section>' };
+}
+/** 推荐安装占位渲染：显式 data-missing 标记，非静默空。 */
+export function renderReco(page) {
+    const html = head(page) + '<div data-missing="1">未安装[' + escapeHtml(page.skill) + ']，请补装后使用。</div></section>';
+    return { contractVersion: RENDER_CONTRACT_VERSION, slotId: page.slotId, html };
+}
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AAEhC,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAgB,CAAC;AACxD,gEAAgE;AAChE,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAgB,CAAC;AAUxD,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAkB;IAC/B,YAAY,IAAqB,EAAE,OAAe;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACtG,CAAC;AAED,SAAS,IAAI,CAAC,IAAoB;IAChC,OAAO,kBAAkB,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,eAAe,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,gBAAgB,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;AAC/K,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,UAAU,CAAC,IAAoB,EAAE,GAAa;IAC5D,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;QAAE,MAAM,IAAI,WAAW,CAAC,WAAW,EAAE,wBAAwB,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IACrG,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,MAAM,IAAI,WAAW,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IAC3F,IAAI,GAAG,CAAC,OAAO,KAAK,uBAAuB;QAAE,MAAM,IAAI,WAAW,CAAC,cAAc,EAAE,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3H,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;QAAE,MAAM,IAAI,WAAW,CAAC,cAAc,EAAE,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IACpH,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACxG,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,GAAG,IAAI,GAAG,kBAAkB,EAAE,CAAC;AACnI,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,UAAU,CAAC,IAAoB;IAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,4BAA4B,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,2BAA2B,CAAC;IAC9G,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;AACjF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/** base-paint 入口：ui+style+injector+渲染契约统一出口。装配唯一 owner。 */
+export { createPageRegistry, pageOrReco, recoDescriptor } from './ui.js';
+export type { PageDescriptor, PageKind, PageRegistry } from './ui.js';
+export { STYLE_PREFIX, STYLE_TOKENS, STYLE_VERSION, cx, token } from './style.js';
+export type { StyleTokenName } from './style.js';
+export { RenderError, RENDER_CONTRACT_VERSION, RENDER_ENVELOPE_VERSION, escapeHtml, renderPage, renderReco } from './contract.js';
+export type { RenderErrorCode, RenderOutput } from './contract.js';
+export { INJECTOR_DEFAULT_MAX_RETRIES, INJECTOR_DEFAULT_RETRY_MS, mountInjector, openPage } from './injector.js';
+export type { MountHandle, MountOptions, SlotsPort, TabEntry, TabScope, TabSeed } from './injector.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAClF,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAClI,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,4BAA4B,EAAE,yBAAyB,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACjH,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+/** base-paint 入口：ui+style+injector+渲染契约统一出口。装配唯一 owner。 */
+export { createPageRegistry, pageOrReco, recoDescriptor } from './ui.js';
+export { STYLE_PREFIX, STYLE_TOKENS, STYLE_VERSION, cx, token } from './style.js';
+export { RenderError, RENDER_CONTRACT_VERSION, RENDER_ENVELOPE_VERSION, escapeHtml, renderPage, renderReco } from './contract.js';
+export { INJECTOR_DEFAULT_MAX_RETRIES, INJECTOR_DEFAULT_RETRY_MS, mountInjector, openPage } from './injector.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAElF,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAElI,OAAO,EAAE,4BAA4B,EAAE,yBAAyB,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/injector.d.ts

@@ -0,0 +1,47 @@
+/** base-paint/injector：装配唯一 owner（归一 render）。
+ *
+ * better-sidebar 槽位注册只许住这里：link-core/combos 禁止自装配
+ *（tooling/check-boundaries.mjs 可执行断言）。host 无关设计——
+ * 以 SlotsPort 注入真实服务，B 落地实测时接线，单测用假端口。
+ * 语义抄 matt 实证：幂等（disposer 非空即跳过）+ 有界重试（1s×10）+
+ * 卸载清理（ctx.effect 同构），成功后无轮询；openTab 走 path seed 内容型打开。
+ */
+import type { PageDescriptor } from './ui.js';
+export interface TabEntry {
+    readonly id: string;
+    readonly title: string;
+    readonly order: number;
+    readonly single: boolean;
+    readonly hidden?: boolean;
+    readonly component: unknown;
+}
+export interface TabSeed {
+    readonly type: string;
+    readonly path: string;
+}
+export interface TabScope {
+    readonly sessionId?: string;
+}
+export interface SlotsPort {
+    /** 能力探测（对应 ctx.get betterSidebar 存在且 registerTab 可用）。 */
+    hasTabs(): boolean;
+    registerTab(entry: TabEntry): () => void;
+    openTab(seed: TabSeed, scope?: TabScope): void;
+}
+export interface MountOptions {
+    readonly maxRetries?: number;
+    readonly retryMs?: number;
+}
+export interface MountHandle {
+    /** 仍在重试等待服务就绪。 */
+    pending(): boolean;
+    /** 停重试定时器 + 逐个调 tab disposer（幂等）。 */
+    dispose(): void;
+}
+export declare const INJECTOR_DEFAULT_MAX_RETRIES = 10;
+export declare const INJECTOR_DEFAULT_RETRY_MS = 1000;
+/** 挂载全部页面描述子（按 order 注册，ilife 星号 id）。幂等：同 slotId 不重复注册。 */
+export declare function mountInjector(port: SlotsPort, pages: readonly PageDescriptor[], opts?: MountOptions): MountHandle;
+/** 打开一页：path seed 内容型打开（折叠面板自动展开）；缺席直接返回，由调用方渲染 reco。 */
+export declare function openPage(port: SlotsPort, page: PageDescriptor, sessionId?: string): void;
+//# sourceMappingURL=injector.d.ts.map

package/dist/injector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injector.d.ts","sourceRoot":"","sources":["../src/injector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,yDAAyD;IACzD,OAAO,IAAI,OAAO,CAAC;IACnB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,IAAI,CAAC;IACzC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,kBAAkB;IAClB,OAAO,IAAI,OAAO,CAAC;IACnB,qCAAqC;IACrC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAC/C,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,cAAc,EAAE,EAAE,IAAI,GAAE,YAAiB,GAAG,WAAW,CAiDrH;AAED,yDAAyD;AACzD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAGxF"}

package/dist/injector.js

@@ -0,0 +1,63 @@
+export const INJECTOR_DEFAULT_MAX_RETRIES = 10;
+export const INJECTOR_DEFAULT_RETRY_MS = 1000;
+/** 挂载全部页面描述子（按 order 注册，ilife 星号 id）。幂等：同 slotId 不重复注册。 */
+export function mountInjector(port, pages, opts = {}) {
+    const maxRetries = opts.maxRetries ?? INJECTOR_DEFAULT_MAX_RETRIES;
+    const retryMs = opts.retryMs ?? INJECTOR_DEFAULT_RETRY_MS;
+    const disposers = new Map();
+    const wanted = new Set(pages.map((p) => p.slotId));
+    let timer = null;
+    let tries = 0;
+    let disposed = false;
+    const tryMount = () => {
+        if (disposed || !port.hasTabs())
+            return false;
+        const ordered = [...pages].sort((a, b) => a.order - b.order);
+        for (const p of ordered) {
+            if (disposers.has(p.slotId))
+                continue;
+            try {
+                const d = port.registerTab({ id: p.slotId, title: p.title, order: p.order, single: true, component: { skill: p.skill, kind: p.kind } });
+                disposers.set(p.slotId, d);
+            }
+            catch {
+                return false;
+            }
+        }
+        return disposers.size === wanted.size;
+    };
+    const stopTimer = () => {
+        if (timer !== null) {
+            clearInterval(timer);
+            timer = null;
+        }
+    };
+    if (!tryMount()) {
+        timer = setInterval(() => {
+            tries += 1;
+            if (tryMount() || tries >= maxRetries)
+                stopTimer();
+        }, retryMs);
+    }
+    return {
+        pending: () => timer !== null,
+        dispose: () => {
+            disposed = true;
+            stopTimer();
+            for (const d of disposers.values()) {
+                try {
+                    d();
+                }
+                catch { /* 忽略 */ }
+            }
+            disposers.clear();
+        },
+    };
+}
+/** 打开一页：path seed 内容型打开（折叠面板自动展开）；缺席直接返回，由调用方渲染 reco。 */
+export function openPage(port, page, sessionId) {
+    if (!port.hasTabs())
+        return;
+    port.openTab({ type: page.slotId, path: page.slotId }, sessionId ? { sessionId } : undefined);
+}
+//# sourceMappingURL=injector.js.map

package/dist/injector.js.map

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

package/dist/style.d.ts

@@ -0,0 +1,24 @@
+/** base-paint/style：样式唯一真相源。
+ *
+ * 红线：样式只抖 render——改样式只改本文件，link-core/combos/单品包
+ * 禁止自带样式常量。类名前缀统一 STYLE_PREFIX，token 表冻结。
+ */
+export declare const STYLE_PREFIX = "ilife-";
+export declare const STYLE_VERSION = "0.1.0";
+export declare const STYLE_TOKENS: Readonly<{
+    radius: 8;
+    gap: 8;
+    fontSize: 13;
+    fg: "#e6edf3";
+    muted: "#8b8b95";
+    accent: "#c084fc";
+    danger: "#f85149";
+    border: "#2a2d35";
+    bg: "#16181d";
+}>;
+export type StyleTokenName = keyof typeof STYLE_TOKENS;
+/** 类名拼接（自动加前缀，falsy 跳过）。 */
+export declare function cx(...names: Array<string | false | null | undefined>): string;
+/** 取 token（样式消费唯一入口，换肤时单点改）。 */
+export declare function token(name: StyleTokenName): string;
+//# sourceMappingURL=style.d.ts.map

package/dist/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../src/style.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,YAAY,WAAW,CAAC;AACrC,eAAO,MAAM,aAAa,UAAU,CAAC;AAErC,eAAO,MAAM,YAAY;;;;;;;;;;EAUvB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,YAAY,CAAC;AAEvD,4BAA4B;AAC5B,wBAAgB,EAAE,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,CAE7E;AAED,gCAAgC;AAChC,wBAAgB,KAAK,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAElD"}

package/dist/style.js

@@ -0,0 +1,27 @@
+/** base-paint/style：样式唯一真相源。
+ *
+ * 红线：样式只抖 render——改样式只改本文件，link-core/combos/单品包
+ * 禁止自带样式常量。类名前缀统一 STYLE_PREFIX，token 表冻结。
+ */
+export const STYLE_PREFIX = 'ilife-';
+export const STYLE_VERSION = '0.1.0';
+export const STYLE_TOKENS = Object.freeze({
+    radius: 8,
+    gap: 8,
+    fontSize: 13,
+    fg: '#e6edf3',
+    muted: '#8b8b95',
+    accent: '#c084fc',
+    danger: '#f85149',
+    border: '#2a2d35',
+    bg: '#16181d',
+});
+/** 类名拼接（自动加前缀，falsy 跳过）。 */
+export function cx(...names) {
+    return names.filter((n) => typeof n === 'string' && n.length > 0).map((n) => STYLE_PREFIX + n).join(' ');
+}
+/** 取 token（样式消费唯一入口，换肤时单点改）。 */
+export function token(name) {
+    return String(STYLE_TOKENS[name]);
+}
+//# sourceMappingURL=style.js.map

package/dist/style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.js","sourceRoot":"","sources":["../src/style.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC;AACrC,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC;AAErC,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;IACxC,MAAM,EAAE,CAAC;IACT,GAAG,EAAE,CAAC;IACN,QAAQ,EAAE,EAAE;IACZ,EAAE,EAAE,SAAS;IACb,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;IACjB,EAAE,EAAE,SAAS;CACd,CAAC,CAAC;AAIH,4BAA4B;AAC5B,MAAM,UAAU,EAAE,CAAC,GAAG,KAA+C;IACnE,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxH,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,KAAK,CAAC,IAAoB;IACxC,OAAO,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;AACpC,CAAC"}

package/dist/ui.d.ts

@@ -0,0 +1,31 @@
+/** base-paint/ui：单品页自注册描述层（纯数据，无 DOM、无 host、无运行时依赖）。
+ *
+ * 归一原则：单品包调用 registerPage 自注册；总管只消费注册表，
+ * 禁止 import 单品页组件（P7 #8 验收）。缺席走 pageOrReco 纯条件渲染，不轮询。
+ */
+export type PageKind = 'page' | 'reco';
+export interface PageDescriptor {
+    /** 所属技能，如 calorie。 */
+    readonly skill: string;
+    /** better-sidebar tab id，命名空间 ilife 星号，如 ilife:calorie。 */
+    readonly slotId: string;
+    /** tab 排序，70 段草案（P3 #4 实测前不定案）。 */
+    readonly order: number;
+    /** 展示标题。 */
+    readonly title: string;
+    /** page=单品实页，reco=推荐安装占位。 */
+    readonly kind: PageKind;
+}
+/** 推荐安装占位描述子（缺席时渲染它，而非空白）。 */
+export declare function recoDescriptor(skill: string, slotId: string, order: number, title: string): PageDescriptor;
+export interface PageRegistry {
+    /** 自注册；slotId 重复即抛（大声失败，不静默覆盖）。返回 disposer，幂等。 */
+    registerPage(desc: PageDescriptor): () => void;
+    /** 按 order 升序。 */
+    pages(): PageDescriptor[];
+    pageForSlot(slotId: string): PageDescriptor | undefined;
+}
+export declare function createPageRegistry(): PageRegistry;
+/** 缺席纯条件渲染：有页用页，无页用 reco 占位。不轮询、不返空。 */
+export declare function pageOrReco(reg: PageRegistry, reco: PageDescriptor): PageDescriptor;
+//# sourceMappingURL=ui.d.ts.map

package/dist/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvC,MAAM,WAAW,cAAc;IAC7B,sBAAsB;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,YAAY;IACZ,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAED,8BAA8B;AAC9B,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAE1G;AAED,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,IAAI,CAAC;IAC/C,kBAAkB;IAClB,KAAK,IAAI,cAAc,EAAE,CAAC;IAC1B,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;CACzD;AAED,wBAAgB,kBAAkB,IAAI,YAAY,CAoBjD;AAED,wCAAwC;AACxC,wBAAgB,UAAU,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,GAAG,cAAc,CAElF"}

package/dist/ui.js

@@ -0,0 +1,38 @@
+/** base-paint/ui：单品页自注册描述层（纯数据，无 DOM、无 host、无运行时依赖）。
+ *
+ * 归一原则：单品包调用 registerPage 自注册；总管只消费注册表，
+ * 禁止 import 单品页组件（P7 #8 验收）。缺席走 pageOrReco 纯条件渲染，不轮询。
+ */
+/** 推荐安装占位描述子（缺席时渲染它，而非空白）。 */
+export function recoDescriptor(skill, slotId, order, title) {
+    return { skill, slotId, order, title, kind: 'reco' };
+}
+export function createPageRegistry() {
+    const bySlot = new Map();
+    return {
+        registerPage(desc) {
+            if (bySlot.has(desc.slotId))
+                throw new Error('duplicate slotId: ' + desc.slotId);
+            bySlot.set(desc.slotId, desc);
+            let done = false;
+            return () => {
+                if (done)
+                    return;
+                done = true;
+                if (bySlot.get(desc.slotId) === desc)
+                    bySlot.delete(desc.slotId);
+            };
+        },
+        pages() {
+            return [...bySlot.values()].sort((a, b) => a.order - b.order);
+        },
+        pageForSlot(slotId) {
+            return bySlot.get(slotId);
+        },
+    };
+}
+/** 缺席纯条件渲染：有页用页，无页用 reco 占位。不轮询、不返空。 */
+export function pageOrReco(reg, reco) {
+    return reg.pageForSlot(reco.slotId) ?? reco;
+}
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH,8BAA8B;AAC9B,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,MAAc,EAAE,KAAa,EAAE,KAAa;IACxF,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACvD,CAAC;AAUD,MAAM,UAAU,kBAAkB;IAChC,MAAM,MAAM,GAAG,IAAI,GAAG,EAA0B,CAAC;IACjD,OAAO;QACL,YAAY,CAAC,IAAoB;YAC/B,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;YACjF,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC9B,IAAI,IAAI,GAAG,KAAK,CAAC;YACjB,OAAO,GAAG,EAAE;gBACV,IAAI,IAAI;oBAAE,OAAO;gBACjB,IAAI,GAAG,IAAI,CAAC;gBACZ,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI;oBAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACnE,CAAC,CAAC;QACJ,CAAC;QACD,KAAK;YACH,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAChE,CAAC;QACD,WAAW,CAAC,MAAc;YACxB,OAAO,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,UAAU,CAAC,GAAiB,EAAE,IAAoB;IAChE,OAAO,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;AAC9C,CAAC"}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "base-paint",
+  "version": "0.1.0",
+  "description": "渲染包：ui+style+injector+渲染契约，装配唯一 owner",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.13"
+  },
+  "devDependencies": {
+    "base-link-core": "workspace:^0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "node --test ../../test/scaffold.test.mjs"
+  }
+}