mp-taro-kit 0.0.3 → 0.0.4

package/dist/core/storage.js

@@ -0,0 +1,57 @@
+import { getConfig, getFaces } from './configure.js';
+function keyOf(key) {
+    return `${getConfig().storagePrefix}${key}`;
+}
+/** 平台异常 / 脏数据 / 过期都按「用户在场」兜底；未 configure() 由 getFaces 抛错。 */
+export function storageGet(key) {
+    const faces = getFaces();
+    try {
+        const raw = faces.getStorage(keyOf(key));
+        if (raw === undefined || raw === null || raw === '')
+            return undefined;
+        const parsed = typeof raw === 'string' ? JSON.parse(raw) : raw;
+        if (parsed === null || typeof parsed !== 'object' || !('v' in parsed))
+            return undefined;
+        const record = parsed;
+        if (record.e !== null && record.e !== undefined && record.e <= Date.now()) {
+            faces.removeStorage(keyOf(key));
+            return undefined;
+        }
+        return record.v;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 返回 false 表示平台写入失败，不静默、也不抛。 */
+export function storageSet(key, value, ttlMs) {
+    const faces = getFaces();
+    const record = { v: value, e: ttlMs === undefined ? null : Date.now() + ttlMs };
+    try {
+        faces.setStorage(keyOf(key), JSON.stringify(record));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function storageRemove(key) {
+    const faces = getFaces();
+    try {
+        faces.removeStorage(keyOf(key));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function storageClear() {
+    const faces = getFaces();
+    try {
+        faces.clearStorage();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/core/weapp.cjs

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.login = login;
+exports.scanCode = scanCode;
+exports.requestPayment = requestPayment;
+const configure_js_1 = require("./configure.cjs");
+/** 微信专有 API 的统一 Promise 化收口；平台失败返回兜底，不抛给页面。 */
+async function login() {
+    const faces = (0, configure_js_1.getFaces)();
+    try {
+        const result = await faces.login();
+        return result !== null && result !== undefined && typeof result.code === 'string' ? result : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function scanCode() {
+    const faces = (0, configure_js_1.getFaces)();
+    try {
+        const result = await faces.scanCode();
+        return typeof result?.result === 'string' ? result.result : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function requestPayment(options) {
+    const faces = (0, configure_js_1.getFaces)();
+    try {
+        await faces.requestPayment(options);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/core/weapp.d.ts

@@ -0,0 +1,7 @@
+import type { PaymentOptions } from './faces.js';
+/** 微信专有 API 的统一 Promise 化收口；平台失败返回兜底，不抛给页面。 */
+export declare function login(): Promise<{
+    code: string;
+} | undefined>;
+export declare function scanCode(): Promise<string | undefined>;
+export declare function requestPayment(options: PaymentOptions): Promise<boolean>;

package/dist/core/weapp.js

@@ -0,0 +1,32 @@
+import { getFaces } from './configure.js';
+/** 微信专有 API 的统一 Promise 化收口；平台失败返回兜底，不抛给页面。 */
+export async function login() {
+    const faces = getFaces();
+    try {
+        const result = await faces.login();
+        return result !== null && result !== undefined && typeof result.code === 'string' ? result : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function scanCode() {
+    const faces = getFaces();
+    try {
+        const result = await faces.scanCode();
+        return typeof result?.result === 'string' ? result.result : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function requestPayment(options) {
+    const faces = getFaces();
+    try {
+        await faces.requestPayment(options);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/design/tokens.css

@@ -1,10 +1,60 @@
-/* mp-taro-kit 对外样式变量入口。
-   token 清单与取值待能力清单定稿后补齐；此处只保留覆盖已定五类样式值的最小占位，
-   保证 ./styles/tokens 出口有实体、宿主可 import。 */
-:root {
-  --mp-color-primary: #1677ff;
-  --mp-radius-md: 8px;
-  --mp-space-md: 12px;
-  --mp-font-size-md: 14px;
-  --mp-duration-base: 200ms;
+/* mp-taro-kit 对外样式变量唯一真源。宿主 import 'mp-taro-kit/styles/tokens' 后覆盖同名变量即可整体换肤；
+   组件侧只写 var(--mptk-*)，不自带兜底值、不在别处复制数值。命名按 dsh-plugin-core 通用层对齐。
+   边框色沿用其 4% / 10% / 12% 档，写成 rgba 字面量以避开小程序端 8 位 hex 的兼容问题。
+   待实机验证：page 挂载与 px 单位在 Skyline / WebView 双端的实际表现，须宿主 demo 确认。 */
+page {
+  /* 文字 */
+  --mptk-fg: #1f2328;
+  --mptk-fg-2: #5c6370;
+  --mptk-fg-3: #767d87;
+  --mptk-fg-4: #9aa1ab;
+
+  /* 面 */
+  --mptk-surface-1: #fff;
+  --mptk-surface-2: #fff;
+  --mptk-surface-3: #fff;
+  --mptk-surface-base: #fff;
+
+  /* 描边 */
+  --mptk-border-faint: rgba(0, 0, 0, .04);
+  --mptk-border: rgba(0, 0, 0, .10);
+  --mptk-border-strong: rgba(0, 0, 0, .12);
+
+  /* 语义色 */
+  --mptk-business: #3b5bdb;
+  --mptk-success: #22c55e;
+  --mptk-warning: #f59e0b;
+  --mptk-danger: #ec1313;
+
+  /* 圆角 */
+  --mptk-radius-xs: 4px;
+  --mptk-radius-sm: 8px;
+  --mptk-radius-md: 12px;
+  --mptk-radius-lg: 16px;
+  --mptk-radius-xl: 20px;
+  --mptk-radius-pill: 999px;
+
+  /* 间距（4px 等差） */
+  --mptk-space-1: 4px;
+  --mptk-space-2: 8px;
+  --mptk-space-3: 12px;
+  --mptk-space-4: 16px;
+
+  /* 字号 / 行高成对 */
+  --mptk-font-xs: 11px;
+  --mptk-font-sm: 12px;
+  --mptk-font-md: 13px;
+  --mptk-font-lg: 14px;
+  --mptk-font-xl: 16px;
+  --mptk-line-xs: 14px;
+  --mptk-line-sm: 18px;
+  --mptk-line-md: 20px;
+  --mptk-line-lg: 22px;
+  --mptk-line-xl: 24px;
+
+  /* 动画 */
+  --mptk-dur: .2s;
+  --mptk-dur-fast: .12s;
+  --mptk-dur-run: 500ms;
+  --mptk-ease: cubic-bezier(.4, 0, .2, 1);
 }

package/dist/runtime/index.cjs

@@ -1,2 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLoadingSlot = exports.createNotifyCenter = exports.createOverlayStack = exports.createSingleton = exports.isSuccess = exports.isThenable = void 0;
+// runtime 层单点出口：只做具名 re-export，不含实现。
+var thenable_js_1 = require("./thenable.cjs");
+Object.defineProperty(exports, "isThenable", { enumerable: true, get: function () { return thenable_js_1.isThenable; } });
+Object.defineProperty(exports, "isSuccess", { enumerable: true, get: function () { return thenable_js_1.isSuccess; } });
+var singleton_js_1 = require("./singleton.cjs");
+Object.defineProperty(exports, "createSingleton", { enumerable: true, get: function () { return singleton_js_1.createSingleton; } });
+var overlay_stack_js_1 = require("./overlay-stack.cjs");
+Object.defineProperty(exports, "createOverlayStack", { enumerable: true, get: function () { return overlay_stack_js_1.createOverlayStack; } });
+var notify_js_1 = require("./notify.cjs");
+Object.defineProperty(exports, "createNotifyCenter", { enumerable: true, get: function () { return notify_js_1.createNotifyCenter; } });
+var loading_slot_js_1 = require("./loading-slot.cjs");
+Object.defineProperty(exports, "createLoadingSlot", { enumerable: true, get: function () { return loading_slot_js_1.createLoadingSlot; } });

package/dist/runtime/index.d.ts

@@ -1 +1,5 @@
-export {};
+export { isThenable, isSuccess } from './thenable.js';
+export { createSingleton } from './singleton.js';
+export { createOverlayStack, type OverlayEntry, type OverlayStack, } from './overlay-stack.js';
+export { createNotifyCenter, type Notice, type NoticeTone, type NotifyCenter, } from './notify.js';
+export { createLoadingSlot, type LoadingState, type LoadingSlot, } from './loading-slot.js';

package/dist/runtime/index.js

@@ -1 +1,6 @@
-export {};
+// runtime 层单点出口：只做具名 re-export，不含实现。
+export { isThenable, isSuccess } from './thenable.js';
+export { createSingleton } from './singleton.js';
+export { createOverlayStack, } from './overlay-stack.js';
+export { createNotifyCenter, } from './notify.js';
+export { createLoadingSlot, } from './loading-slot.js';

package/dist/runtime/loading-slot.cjs

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLoadingSlot = createLoadingSlot;
+/**
+ * 全局唯一 loading 槽：句柄 id 配对，重复 hide / 未知 id 返回 false 且不误关别人的。
+ * 计数归零才 inactive；状态真变了才通知，getSnapshot 引用稳定。
+ */
+function createLoadingSlot() {
+    const handles = new Set();
+    let seq = 0;
+    let snapshot = { active: false, count: 0 };
+    const listeners = new Set();
+    const refresh = () => {
+        const next = { active: handles.size > 0, count: handles.size };
+        if (next.active === snapshot.active && next.count === snapshot.count)
+            return;
+        snapshot = next;
+        for (const listener of listeners)
+            listener();
+    };
+    return {
+        show() {
+            const id = ++seq;
+            handles.add(id);
+            refresh();
+            return id;
+        },
+        hide(id) {
+            const removed = handles.delete(id);
+            if (removed)
+                refresh();
+            return removed;
+        },
+        getSnapshot() {
+            return snapshot;
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+    };
+}

package/dist/runtime/loading-slot.d.ts

@@ -0,0 +1,15 @@
+export interface LoadingState {
+    readonly active: boolean;
+    readonly count: number;
+}
+export interface LoadingSlot {
+    show(): number;
+    hide(id: number): boolean;
+    getSnapshot(): LoadingState;
+    subscribe(listener: () => void): () => void;
+}
+/**
+ * 全局唯一 loading 槽：句柄 id 配对，重复 hide / 未知 id 返回 false 且不误关别人的。
+ * 计数归零才 inactive；状态真变了才通知，getSnapshot 引用稳定。
+ */
+export declare function createLoadingSlot(): LoadingSlot;

package/dist/runtime/loading-slot.js

@@ -0,0 +1,41 @@
+/**
+ * 全局唯一 loading 槽：句柄 id 配对，重复 hide / 未知 id 返回 false 且不误关别人的。
+ * 计数归零才 inactive；状态真变了才通知，getSnapshot 引用稳定。
+ */
+export function createLoadingSlot() {
+    const handles = new Set();
+    let seq = 0;
+    let snapshot = { active: false, count: 0 };
+    const listeners = new Set();
+    const refresh = () => {
+        const next = { active: handles.size > 0, count: handles.size };
+        if (next.active === snapshot.active && next.count === snapshot.count)
+            return;
+        snapshot = next;
+        for (const listener of listeners)
+            listener();
+    };
+    return {
+        show() {
+            const id = ++seq;
+            handles.add(id);
+            refresh();
+            return id;
+        },
+        hide(id) {
+            const removed = handles.delete(id);
+            if (removed)
+                refresh();
+            return removed;
+        },
+        getSnapshot() {
+            return snapshot;
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+    };
+}

package/dist/runtime/notify.cjs

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNotifyCenter = createNotifyCenter;
+/**
+ * 通知队列：core 与 ui 共用同一份。超出 limit 挤掉最旧一条，
+ * 自动消失 / 动画交给 ui 层，本层不碰平台定时器。
+ */
+function createNotifyCenter(limit = 3) {
+    let notices = [];
+    let seq = 0;
+    const listeners = new Set();
+    const max = Number.isFinite(limit) && limit > 0 ? Math.floor(limit) : 3;
+    const notify = () => {
+        for (const listener of listeners)
+            listener();
+    };
+    return {
+        show(text, tone = 'info') {
+            const id = ++seq;
+            notices = [...notices, { id, text, tone }];
+            if (notices.length > max)
+                notices = notices.slice(notices.length - max);
+            notify();
+            return id;
+        },
+        dismiss(id) {
+            const exists = notices.some((notice) => notice.id === id);
+            if (!exists)
+                return false;
+            notices = notices.filter((notice) => notice.id !== id);
+            notify();
+            return true;
+        },
+        clear() {
+            if (notices.length === 0)
+                return [];
+            const removed = notices;
+            notices = [];
+            notify();
+            return removed;
+        },
+        getSnapshot() {
+            return notices;
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+    };
+}

package/dist/runtime/notify.d.ts

@@ -0,0 +1,19 @@
+export type NoticeTone = 'info' | 'success' | 'warn' | 'error';
+/** 文案由调用方传已翻译好的字符串；runtime 不做 i18n，也不做定时消失。 */
+export interface Notice {
+    readonly id: number;
+    readonly text: string;
+    readonly tone: NoticeTone;
+}
+export interface NotifyCenter {
+    show(text: string, tone?: NoticeTone): number;
+    dismiss(id: number): boolean;
+    clear(): Notice[];
+    getSnapshot(): readonly Notice[];
+    subscribe(listener: () => void): () => void;
+}
+/**
+ * 通知队列：core 与 ui 共用同一份。超出 limit 挤掉最旧一条，
+ * 自动消失 / 动画交给 ui 层，本层不碰平台定时器。
+ */
+export declare function createNotifyCenter(limit?: number): NotifyCenter;

package/dist/runtime/notify.js

@@ -0,0 +1,49 @@
+/**
+ * 通知队列：core 与 ui 共用同一份。超出 limit 挤掉最旧一条，
+ * 自动消失 / 动画交给 ui 层，本层不碰平台定时器。
+ */
+export function createNotifyCenter(limit = 3) {
+    let notices = [];
+    let seq = 0;
+    const listeners = new Set();
+    const max = Number.isFinite(limit) && limit > 0 ? Math.floor(limit) : 3;
+    const notify = () => {
+        for (const listener of listeners)
+            listener();
+    };
+    return {
+        show(text, tone = 'info') {
+            const id = ++seq;
+            notices = [...notices, { id, text, tone }];
+            if (notices.length > max)
+                notices = notices.slice(notices.length - max);
+            notify();
+            return id;
+        },
+        dismiss(id) {
+            const exists = notices.some((notice) => notice.id === id);
+            if (!exists)
+                return false;
+            notices = notices.filter((notice) => notice.id !== id);
+            notify();
+            return true;
+        },
+        clear() {
+            if (notices.length === 0)
+                return [];
+            const removed = notices;
+            notices = [];
+            notify();
+            return removed;
+        },
+        getSnapshot() {
+            return notices;
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+    };
+}

package/dist/runtime/overlay-stack.cjs

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOverlayStack = createOverlayStack;
+/**
+ * 栈用不可变替换维护：getSnapshot 返回稳定引用，可直接喂给 useSyncExternalStore。
+ * 只有状态真变了才通知订阅者；无效 id / 空栈 clear 返回兜底值且不抛。
+ */
+function createOverlayStack() {
+    let entries = [];
+    let seq = 0;
+    const listeners = new Set();
+    const notify = () => {
+        for (const listener of listeners)
+            listener();
+    };
+    return {
+        push(payload) {
+            const id = ++seq;
+            entries = [...entries, { id, payload }];
+            notify();
+            return id;
+        },
+        dismiss(id) {
+            const found = entries.find((entry) => entry.id === id);
+            if (found === undefined)
+                return undefined;
+            entries = entries.filter((entry) => entry.id !== id);
+            notify();
+            return found.payload;
+        },
+        clear() {
+            if (entries.length === 0)
+                return [];
+            const payloads = entries.map((entry) => entry.payload);
+            entries = [];
+            notify();
+            return payloads;
+        },
+        getSnapshot() {
+            return entries;
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+    };
+}

package/dist/runtime/overlay-stack.d.ts

@@ -0,0 +1,17 @@
+/** 浮层条目。栈只存 payload，不掺 resolve / 渲染器，那是 ui 层的事。 */
+export interface OverlayEntry<T> {
+    readonly id: number;
+    readonly payload: T;
+}
+export interface OverlayStack<T> {
+    push(payload: T): number;
+    dismiss(id: number): T | undefined;
+    clear(): T[];
+    getSnapshot(): readonly OverlayEntry<T>[];
+    subscribe(listener: () => void): () => void;
+}
+/**
+ * 栈用不可变替换维护：getSnapshot 返回稳定引用，可直接喂给 useSyncExternalStore。
+ * 只有状态真变了才通知订阅者；无效 id / 空栈 clear 返回兜底值且不抛。
+ */
+export declare function createOverlayStack<T>(): OverlayStack<T>;

package/dist/runtime/overlay-stack.js

@@ -0,0 +1,46 @@
+/**
+ * 栈用不可变替换维护：getSnapshot 返回稳定引用，可直接喂给 useSyncExternalStore。
+ * 只有状态真变了才通知订阅者；无效 id / 空栈 clear 返回兜底值且不抛。
+ */
+export function createOverlayStack() {
+    let entries = [];
+    let seq = 0;
+    const listeners = new Set();
+    const notify = () => {
+        for (const listener of listeners)
+            listener();
+    };
+    return {
+        push(payload) {
+            const id = ++seq;
+            entries = [...entries, { id, payload }];
+            notify();
+            return id;
+        },
+        dismiss(id) {
+            const found = entries.find((entry) => entry.id === id);
+            if (found === undefined)
+                return undefined;
+            entries = entries.filter((entry) => entry.id !== id);
+            notify();
+            return found.payload;
+        },
+        clear() {
+            if (entries.length === 0)
+                return [];
+            const payloads = entries.map((entry) => entry.payload);
+            entries = [];
+            notify();
+            return payloads;
+        },
+        getSnapshot() {
+            return entries;
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+    };
+}

package/dist/runtime/singleton.cjs

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSingleton = createSingleton;
+/**
+ * 跨副本单例：Symbol.for 挂在当前 JS 运行时的 globalThis 上，懒建、已存在直接返回。
+ * 解决的是「同一进程里库被打进两份」，不是持久化——冷启动后重新建一遍。
+ * key 统一带 mptk/ 前缀，避免与其他库撞符号。
+ */
+function createSingleton(key, create) {
+    const symbol = Symbol.for(`mptk/${key}`);
+    const registry = globalThis;
+    if (Reflect.has(registry, symbol))
+        return registry[symbol];
+    const created = create();
+    registry[symbol] = created;
+    return created;
+}

package/dist/runtime/singleton.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 跨副本单例：Symbol.for 挂在当前 JS 运行时的 globalThis 上，懒建、已存在直接返回。
+ * 解决的是「同一进程里库被打进两份」，不是持久化——冷启动后重新建一遍。
+ * key 统一带 mptk/ 前缀，避免与其他库撞符号。
+ */
+export declare function createSingleton<T>(key: string, create: () => T): T;

package/dist/runtime/singleton.js

@@ -0,0 +1,14 @@
+/**
+ * 跨副本单例：Symbol.for 挂在当前 JS 运行时的 globalThis 上，懒建、已存在直接返回。
+ * 解决的是「同一进程里库被打进两份」，不是持久化——冷启动后重新建一遍。
+ * key 统一带 mptk/ 前缀，避免与其他库撞符号。
+ */
+export function createSingleton(key, create) {
+    const symbol = Symbol.for(`mptk/${key}`);
+    const registry = globalThis;
+    if (Reflect.has(registry, symbol))
+        return registry[symbol];
+    const created = create();
+    registry[symbol] = created;
+    return created;
+}

package/dist/runtime/thenable.cjs

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isThenable = isThenable;
+exports.isSuccess = isSuccess;
+/** Promise 化交互的判定器：只判定，不 await、不吞错、不改原值。 */
+function isThenable(value) {
+    if (value === null || value === undefined)
+        return false;
+    return typeof value.then === 'function';
+}
+/**
+ * 回调的返回值算不算「这次成了」：仅显式 false 表示没成（弹窗据此保持不关、让人重试）。
+ * true / undefined / 其他值一律算成，消费方不必在调用点包 try/catch。
+ */
+function isSuccess(value) {
+    return value !== false;
+}

package/dist/runtime/thenable.d.ts

@@ -0,0 +1,7 @@
+/** Promise 化交互的判定器：只判定，不 await、不吞错、不改原值。 */
+export declare function isThenable(value: unknown): value is PromiseLike<unknown>;
+/**
+ * 回调的返回值算不算「这次成了」：仅显式 false 表示没成（弹窗据此保持不关、让人重试）。
+ * true / undefined / 其他值一律算成，消费方不必在调用点包 try/catch。
+ */
+export declare function isSuccess(value: unknown): boolean;

package/dist/runtime/thenable.js

@@ -0,0 +1,13 @@
+/** Promise 化交互的判定器：只判定，不 await、不吞错、不改原值。 */
+export function isThenable(value) {
+    if (value === null || value === undefined)
+        return false;
+    return typeof value.then === 'function';
+}
+/**
+ * 回调的返回值算不算「这次成了」：仅显式 false 表示没成（弹窗据此保持不关、让人重试）。
+ * true / undefined / 其他值一律算成，消费方不必在调用点包 try/catch。
+ */
+export function isSuccess(value) {
+    return value !== false;
+}