@363045841yyt/klinechart-core 0.7.3

package/dist/plugin/types.d.ts

@@ -0,0 +1,449 @@
+/**
+ * 插件系统核心类型定义
+ */
+import type { KLineData } from '../types/price';
+import type { CandleWebGLSurface, LineWebGLSurface } from '../engine/renderers/webgl/candleSurface';
+/** 插件生命周期状态 */
+export declare enum PluginState {
+    Registered = "registered",
+    Installed = "installed",
+    Error = "error"
+}
+/** 插件配置 */
+export interface PluginConfig {
+    enabled?: boolean;
+    priority?: number;
+    [key: string]: unknown;
+}
+/** 插件元信息 */
+export interface PluginMeta {
+    name: string;
+    version: string;
+    description?: string;
+    author?: string;
+}
+/** 插件接口 */
+export interface Plugin extends PluginMeta {
+    /** 安装插件 */
+    install(host: PluginHost, config?: Record<string, unknown>): void | Promise<void>;
+    /** 卸载插件 */
+    uninstall?(): void | Promise<void>;
+}
+/** 插件描述符（注册时使用） */
+export interface PluginDescriptor {
+    plugin: Plugin;
+    config?: PluginConfig;
+    state: PluginState;
+    error?: Error;
+}
+/** Hook 函数类型 */
+export type HookFn<T = unknown, R = unknown> = (context: T) => R | Promise<R>;
+/** Hook 调用选项 */
+export interface HookCallOptions {
+    throwOnError?: boolean;
+}
+/** Hook 描述符 */
+export interface HookDescriptor<T = unknown, R = unknown> {
+    name: string;
+    fn: HookFn<T, R>;
+    priority: number;
+}
+/** 事件处理器 */
+export type EventHandler<T = unknown> = (data: T) => void;
+/** 插件日志器 */
+export interface PluginLogger {
+    info(message?: unknown, ...optionalParams: unknown[]): void;
+    warn(message?: unknown, ...optionalParams: unknown[]): void;
+    error(message?: unknown, ...optionalParams: unknown[]): void;
+}
+/** 插件宿主接口（暴露给插件使用的 API） */
+export interface PluginHost {
+    /** 事件总线 */
+    readonly events: {
+        on<T = unknown>(event: string, handler: EventHandler<T>): void;
+        off<T = unknown>(event: string, handler: EventHandler<T>): void;
+        emit<T = unknown>(event: string, data: T): void;
+        once<T = unknown>(event: string, handler: EventHandler<T>): void;
+    };
+    /** Hook 系统 */
+    readonly hooks: {
+        tap<T = unknown, R = unknown>(hookName: string, fn: HookFn<T, R>, priority?: number): void;
+        untap(hookName: string, fn: HookFn): void;
+        call<T = unknown, R = unknown>(hookName: string, context: T, options?: HookCallOptions): Promise<R[]>;
+        callSync<T = unknown, R = unknown>(hookName: string, context: T, options?: HookCallOptions): R[];
+    };
+    /** 获取配置 */
+    getConfig<K = unknown>(pluginName: string, key: string, defaultValue?: K): K;
+    /** 设置配置 */
+    setConfig(pluginName: string, key: string, value: unknown): void;
+    /** 获取其他插件 */
+    getPlugin<T extends Plugin = Plugin>(name: string): T | undefined;
+    /** 日志工具 */
+    log(level: 'info' | 'warn' | 'error', message: string, ...args: unknown[]): void;
+    /** 设置共享状态 */
+    setSharedState<T extends BaseIndicatorState>(namespace: string, state: T, ownerId?: string): void;
+    /** 获取共享状态 */
+    getSharedState<T extends BaseIndicatorState>(namespace: string): T | undefined;
+    /** 清除共享状态 */
+    clearSharedState(namespace: string): void;
+    /** 注册状态拥有者 */
+    registerStateOwner(ownerId: string, namespaces: string[]): void;
+    /** 按拥有者清除状态 */
+    clearByOwner(ownerId: string): void;
+    /** 注册服务 */
+    registerService(name: string, service: unknown): void;
+    /** 获取已注册的服务 */
+    getService<T = unknown>(name: string): T | undefined;
+}
+/** Pane 角色 */
+export type PaneRole = 'price' | 'indicator' | 'auxiliary';
+/** Pane 能力开关 */
+export interface PaneCapabilities {
+    showPriceAxisTicks: boolean;
+    showCrosshairPriceLabel: boolean;
+    candleHitTest: boolean;
+    supportsPriceTranslate: boolean;
+}
+/** Pane 信息接口 */
+export interface PaneInfo {
+    id: string;
+    role: PaneRole;
+    capabilities: PaneCapabilities;
+    top: number;
+    height: number;
+    yAxis: {
+        priceToY(price: number): number;
+        yToPrice(y: number): number;
+        getPaddingTop(): number;
+        getPaddingBottom(): number;
+        getPriceOffset(): number;
+        getDisplayRange(baseRange?: {
+            maxPrice: number;
+            minPrice: number;
+        }): {
+            maxPrice: number;
+            minPrice: number;
+        };
+        getScaleType(): 'linear' | 'log';
+    };
+    priceRange: {
+        maxPrice: number;
+        minPrice: number;
+    };
+}
+/**
+ * 创建 PaneInfo 的只读包装
+ *
+ * 设计决策：
+ * - 使用 Readonly<T> 类型标注而非 Object.freeze，避免热路径上的运行时开销
+ * - yAxis 方法通过闭包包装，隔离原始函数引用
+ * - 依赖团队代码规范约束插件行为，而非运行时强制
+ */
+export declare function wrapPaneInfo(pane: {
+    id: string;
+    role: PaneRole;
+    capabilities: PaneCapabilities;
+    top: number;
+    height: number;
+    yAxis: PaneInfo['yAxis'];
+    priceRange: PaneInfo['priceRange'];
+}): Readonly<PaneInfo>;
+/** Y轴标签（价格标签） */
+export interface YAxisLabel {
+    /** 关联的数据索引 */
+    dataIndex: number;
+    /** 价格值 */
+    price: number;
+    /** 标签在轴上的Y坐标（世界坐标，相对pane） */
+    y: number;
+    /** 标签类型，用于区分不同渲染外观 */
+    type?: 'lastPrice' | 'extrema' | 'anchor' | string;
+    /** 标签样式覆盖 */
+    style?: {
+        bgColor?: string;
+        borderColor?: string;
+        textColor?: string;
+    };
+}
+/** X轴标签（时间标签） */
+export interface XAxisLabel {
+    /** 关联的数据索引 */
+    dataIndex: number;
+    /** 时间戳（毫秒） */
+    timestamp: number;
+    /** 标签在轴上的X坐标（世界坐标，未减去scrollLeft） */
+    x: number;
+    /** 标签样式覆盖 */
+    style?: {
+        bgColor?: string;
+        textColor?: string;
+    };
+}
+/** Y轴范围带（半透明填充区域） */
+export interface YAxisRange {
+    /** 范围上界Y坐标（相对pane，canvas方向：小值=上方） */
+    topY: number;
+    /** 范围下界Y坐标（相对pane，canvas方向：大值=下方） */
+    bottomY: number;
+    /** 填充颜色（hex 或 rgba） */
+    color: string;
+    /** 填充不透明度 */
+    opacity: number;
+}
+/** X轴范围带（半透明填充区域） */
+export interface XAxisRange {
+    /** 范围左界X坐标（世界坐标，未减去scrollLeft） */
+    leftX: number;
+    /** 范围右界X坐标（世界坐标，未减去scrollLeft） */
+    rightX: number;
+    /** 填充颜色（hex 或 rgba） */
+    color: string;
+    /** 填充不透明度 */
+    opacity: number;
+}
+/** 渲染上下文 */
+/** MarkerManager 接口（用于 RenderContext） */
+export interface MarkerManagerLike {
+    getCustomMarkers(): unknown[];
+    setCustomMarkerPosition(id: string, x: number, y: number, size: number, shape: string): void;
+}
+export interface RenderContext {
+    ctx: CanvasRenderingContext2D;
+    pane: PaneInfo;
+    data: unknown[];
+    range: {
+        start: number;
+        end: number;
+    };
+    scrollLeft: number;
+    kWidth: number;
+    kGap: number;
+    dpr: number;
+    paneWidth: number;
+    kLinePositions: number[];
+    /** 每根K线柱中心的X坐标（物理像素对齐后，逻辑像素） */
+    kLineCenters: number[];
+    /** 每根K线对应柱的X/宽度（物理像素对齐后，逻辑像素），供柱状图使用 */
+    kBarRects: Array<{
+        x: number;
+        width: number;
+    }>;
+    markerManager?: MarkerManagerLike;
+    /** 十字线指向的 K 线索引（无十字线时为 null） */
+    crosshairIndex?: number | null;
+    yAxisCtx?: CanvasRenderingContext2D;
+    xAxisCtx?: CanvasRenderingContext2D;
+    borderCtx?: CanvasRenderingContext2D;
+    /** 覆盖层 Canvas 上下文（用于十字线、Tooltip 等动态内容） */
+    overlayCtx?: CanvasRenderingContext2D;
+    /** price pane 可选的 WebGL candle surface */
+    candleWebGLSurface?: CandleWebGLSurface;
+    /** line indicator 可选的 WebGL line surface */
+    lineWebGLSurface?: LineWebGLSurface;
+    /** 当前缩放级别（1 ~ zoomLevels） */
+    zoomLevel?: number;
+    /** 总缩放级别数 */
+    zoomLevelCount?: number;
+    viewport?: {
+        scrollLeft: number;
+        plotWidth: number;
+        plotHeight: number;
+    };
+    /** 用户设置配置（渲染器只读） */
+    settings?: import('../config/chartSettings').ChartSettings;
+    /** 需要在Y轴上绘制的标签列表（由各类标记渲染器填充） */
+    yAxisLabels?: YAxisLabel[];
+    /** 需要在X轴上绘制的标签列表（由各类标记渲染器填充） */
+    xAxisLabels?: XAxisLabel[];
+    /** 需要在Y轴上绘制的范围带列表（由绘图渲染器填充，先于标签绘制） */
+    yAxisRanges?: YAxisRange[];
+    /** 需要在X轴上绘制的范围带列表（由绘图渲染器填充，先于标签绘制） */
+    xAxisRanges?: XAxisRange[];
+    /** 当前主题 */
+    theme: import('../engine/theme/colors').ChartTheme;
+}
+export type DrawingAnchor = {
+    id: string;
+    index: number;
+    time?: number | string;
+    price: number;
+};
+export type DrawingKind = 'trend-line' | 'ray' | 'extended-line' | 'horizontal-line' | 'horizontal-ray' | 'vertical-line' | 'cross-line' | 'info-line' | 'parallel-channel' | 'regression-channel' | 'flat-line' | 'disjoint-channel';
+export type DrawingStyle = {
+    stroke?: string;
+    strokeWidth?: number;
+    strokeStyle?: 'solid' | 'dashed' | 'dotted';
+    fill?: string;
+    fillOpacity?: number;
+    pointRadius?: number;
+    textColor?: string;
+    fontSize?: number;
+};
+export type DrawingObject<TParams = Record<string, unknown>> = {
+    id: string;
+    kind: DrawingKind;
+    paneId: string;
+    visible: boolean;
+    locked?: boolean;
+    zIndex?: number;
+    anchors: DrawingAnchor[];
+    params: TParams;
+    style: DrawingStyle;
+};
+export type ScreenPoint = {
+    x: number;
+    y: number;
+};
+export type PointPrimitive = {
+    kind: 'point';
+    point: ScreenPoint;
+    role?: 'anchor' | 'handle' | 'marker' | 'center';
+    style?: DrawingStyle;
+};
+export type LinePrimitive = {
+    kind: 'line';
+    a: ScreenPoint;
+    b: ScreenPoint;
+    extend?: 'none' | 'left' | 'right' | 'both';
+    showEndpoints?: boolean;
+    style?: DrawingStyle;
+};
+export type AreaPrimitive = {
+    kind: 'area';
+    points: ScreenPoint[];
+    closed: boolean;
+    style?: DrawingStyle;
+};
+export type TextPrimitive = {
+    kind: 'text';
+    point: ScreenPoint;
+    text: string;
+    align?: 'left' | 'center' | 'right';
+    baseline?: 'top' | 'middle' | 'bottom';
+    style?: DrawingStyle;
+};
+export type DrawingPrimitive = PointPrimitive | LinePrimitive | AreaPrimitive | TextPrimitive;
+export type DrawingGeometry = {
+    primitives: DrawingPrimitive[];
+    bounds?: {
+        left: number;
+        top: number;
+        right: number;
+        bottom: number;
+    };
+    meta?: Record<string, unknown>;
+    computedAnchors?: DrawingAnchor[];
+};
+export type DrawingComputeContext = {
+    pane: PaneInfo;
+    visibleData: KLineData[];
+    seriesData: KLineData[];
+    range: {
+        start: number;
+        end: number;
+    };
+    kLinePositions: number[];
+    kLineCenters: number[];
+    kBarRects: Array<{
+        x: number;
+        width: number;
+    }>;
+    kWidth: number;
+    kGap: number;
+    dpr: number;
+    paneWidth: number;
+    viewport: {
+        scrollLeft: number;
+        plotWidth: number;
+        plotHeight: number;
+    };
+    toScreen(anchor: DrawingAnchor): ScreenPoint;
+};
+export interface DrawingDefinition<TParams = Record<string, unknown>> {
+    kind: DrawingKind;
+    minAnchors: number;
+    maxAnchors: number;
+    compute(drawing: DrawingObject<TParams>, context: DrawingComputeContext): DrawingGeometry;
+}
+/** 全局 Pane ID（渲染到所有 pane） */
+export declare const GLOBAL_PANE_ID: unique symbol;
+/** 优先级推荐范围 */
+export declare const RENDERER_PRIORITY: {
+    readonly LAST_PRICE_LABEL: -25;
+    readonly SYSTEM_YAXIS: -20;
+    readonly SYSTEM_XAXIS: -20;
+    readonly BACKGROUND: 0;
+    readonly GRID: 10;
+    /**
+     * 指标渲染器（MACD, RSI 等）
+     * 所有指标渲染器必须使用此优先级或 ≤30 的值
+     */
+    readonly INDICATOR: 30;
+    readonly MAIN: 50;
+    /**
+     * 指标刻度渲染器（依赖于前方指标写入的共享状态）
+     * 必须晚于 INDICATOR 和 MAIN，确保每次绘制时先更新指标状态再绘制刻度。
+     */
+    readonly INDICATOR_SCALE: 55;
+    readonly OVERLAY: 80;
+    readonly FOREGROUND: 100;
+    readonly SYSTEM_BORDER: 120;
+    readonly SYSTEM_CROSSHAIR: 150;
+};
+/** 渲染器插件接口（独立定义，不继承 Plugin） */
+export interface RendererPlugin {
+    /** 唯一标识 */
+    readonly name: string;
+    /** 版本号 */
+    readonly version?: string;
+    /** 描述 */
+    readonly description?: string;
+    /** 调试用显示名称 */
+    readonly debugName?: string;
+    /** 渲染目标 pane（'main' | 'sub' | GLOBAL_PANE_ID 表示所有） */
+    paneId: string | symbol;
+    /** 渲染优先级（数字越大越后渲染） */
+    priority: number;
+    /** 是否启用（仅作为初始值，运行时状态由 Manager 管理） */
+    enabled?: boolean;
+    /**
+     * 是否为系统渲染器
+     * 系统渲染器不会通过 getRenderers() 返回，只能通过 renderPlugin() 单独渲染
+     * 用于时间轴、全局边框等需要单独控制渲染时机的场景
+     */
+    isSystem?: boolean;
+    /**
+     * 渲染器所属层，决定 UpdateLevel 过滤行为
+     * - 'main': 低频/静态内容，随主画布一起渲染
+     * - 'overlay': 高频/动态内容，可在 overlay-only 更新时独立重绘
+     * 未指定时默认为 'main'（向后兼容）
+     */
+    layer?: 'main' | 'overlay';
+    /** 渲染方法 */
+    draw(context: RenderContext): void;
+    /** 数据更新时回调 */
+    onDataUpdate?(data: unknown[], range: {
+        start: number;
+        end: number;
+    }): void;
+    /** 容器尺寸变化时回调 */
+    onResize?(pane: PaneInfo): void;
+    /** 获取配置 */
+    getConfig?(): Record<string, unknown>;
+    /** 设置配置 */
+    setConfig?(config: Record<string, unknown>): void;
+    /** 卸载时清理资源 */
+    onUninstall?(): void;
+}
+/** 带插件系统能力的渲染器（可选） */
+export interface RendererPluginWithHost extends RendererPlugin {
+    /** 安装时获取 PluginHost 访问权限 */
+    onInstall?(host: PluginHost): void;
+    /** 声明该渲染器所拥有的状态命名空间，卸载时框架会自动清理 */
+    getDeclaredNamespaces?(): string[];
+}
+/** 指标渲染器状态基类 */
+export interface BaseIndicatorState {
+    timestamp: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugin/types.d.ts.map

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

package/dist/plugin/types.js

@@ -0,0 +1,63 @@
+/**
+ * 插件系统核心类型定义
+ */
+/** 插件生命周期状态 */
+export var PluginState;
+(function (PluginState) {
+    PluginState["Registered"] = "registered";
+    PluginState["Installed"] = "installed";
+    PluginState["Error"] = "error";
+})(PluginState || (PluginState = {}));
+/**
+ * 创建 PaneInfo 的只读包装
+ *
+ * 设计决策：
+ * - 使用 Readonly<T> 类型标注而非 Object.freeze，避免热路径上的运行时开销
+ * - yAxis 方法通过闭包包装，隔离原始函数引用
+ * - 依赖团队代码规范约束插件行为，而非运行时强制
+ */
+export function wrapPaneInfo(pane) {
+    return {
+        id: pane.id,
+        role: pane.role,
+        capabilities: { ...pane.capabilities },
+        top: pane.top,
+        height: pane.height,
+        yAxis: {
+            priceToY: (price) => pane.yAxis.priceToY(price),
+            yToPrice: (y) => pane.yAxis.yToPrice(y),
+            getPaddingTop: () => pane.yAxis.getPaddingTop(),
+            getPaddingBottom: () => pane.yAxis.getPaddingBottom(),
+            getPriceOffset: () => pane.yAxis.getPriceOffset(),
+            getDisplayRange: (baseRange) => pane.yAxis.getDisplayRange(baseRange),
+            getScaleType: () => pane.yAxis.getScaleType(),
+        },
+        priceRange: pane.priceRange,
+    };
+}
+/** 全局 Pane ID（渲染到所有 pane） */
+export const GLOBAL_PANE_ID = Symbol('global-pane');
+/** 优先级推荐范围 */
+export const RENDERER_PRIORITY = {
+    LAST_PRICE_LABEL: -25, // 最新价格 label 注册（必须在 SYSTEM_YAXIS 之前）
+    SYSTEM_YAXIS: -20, // Y轴（系统级）
+    SYSTEM_XAXIS: -20, // X轴（系统级）
+    BACKGROUND: 0, // 背景层
+    GRID: 10, // 网格线
+    /**
+     * 指标渲染器（MACD, RSI 等）
+     * 所有指标渲染器必须使用此优先级或 ≤30 的值
+     */
+    INDICATOR: 30,
+    MAIN: 50, // 主图（K线）
+    /**
+     * 指标刻度渲染器（依赖于前方指标写入的共享状态）
+     * 必须晚于 INDICATOR 和 MAIN，确保每次绘制时先更新指标状态再绘制刻度。
+     */
+    INDICATOR_SCALE: 55,
+    OVERLAY: 80, // 叠加层（标记点）
+    FOREGROUND: 100, // 前景层（价格线）
+    SYSTEM_BORDER: 120, // 边框（系统级）
+    SYSTEM_CROSSHAIR: 150, // 十字线（系统级）
+};
+//# sourceMappingURL=types.js.map

package/dist/plugin/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/plugin/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,eAAe;AACf,MAAM,CAAN,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,wCAAyB,CAAA;IACzB,sCAAuB,CAAA;IACvB,8BAAe,CAAA;AACjB,CAAC,EAJW,WAAW,KAAX,WAAW,QAItB;AAuJD;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,IAQ5B;IACC,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,YAAY,EAAE,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE;QACtC,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE;YACL,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;YAC/C,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YACvC,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE;YAC/C,gBAAgB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,EAAE;YACrD,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE;YACjD,eAAe,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,SAAS,CAAC;YACrE,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE;SAC9C;QACD,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAA;AACH,CAAC;AAuOD,6BAA6B;AAC7B,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,aAAa,CAAC,CAAA;AAEnD,cAAc;AACd,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,gBAAgB,EAAE,CAAC,EAAE,EAAE,qCAAqC;IAC5D,YAAY,EAAE,CAAC,EAAE,EAAE,UAAU;IAC7B,YAAY,EAAE,CAAC,EAAE,EAAE,UAAU;IAC7B,UAAU,EAAE,CAAC,EAAE,MAAM;IACrB,IAAI,EAAE,EAAE,EAAE,MAAM;IAChB;;;OAGG;IACH,SAAS,EAAE,EAAE;IACb,IAAI,EAAE,EAAE,EAAE,SAAS;IACnB;;;OAGG;IACH,eAAe,EAAE,EAAE;IACnB,OAAO,EAAE,EAAE,EAAE,WAAW;IACxB,UAAU,EAAE,GAAG,EAAE,WAAW;IAC5B,aAAa,EAAE,GAAG,EAAE,UAAU;IAC9B,gBAAgB,EAAE,GAAG,EAAE,WAAW;CAC1B,CAAA"}

package/dist/reactivity/index.d.ts

@@ -0,0 +1,3 @@
+export { createSignal, computed, effect, batch } from './signal';
+export type { Signal, Computed } from './signal';
+//# sourceMappingURL=index.d.ts.map

package/dist/reactivity/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/reactivity/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAChE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA"}

package/dist/reactivity/index.js

@@ -0,0 +1,2 @@
+export { createSignal, computed, effect, batch } from './signal';
+//# sourceMappingURL=index.js.map

package/dist/reactivity/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/reactivity/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA"}

package/dist/reactivity/signal.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Tiny push-based reactivity primitive. Zero dependencies.
+ *
+ * Design constraints:
+ * - Synchronous notify on `set` (no microtask scheduling — adapters batch)
+ * - No proxy / no deep tracking — only top-level read/write
+ * - Equality short-circuits on `Object.is`
+ * - `subscribe` returns an unsubscribe; safe to call from React useSyncExternalStore,
+ *   Vue effect, Angular toSignal
+ * - `effect` re-runs whenever any signal read inside re-emits
+ */
+export type Signal<T> = {
+    /** read current value; tracked when called inside `effect` */
+    (): T;
+    /** read without tracking */
+    peek: () => T;
+    /** write new value; notifies subscribers if `Object.is` differs */
+    set: (next: T) => void;
+    /** subscribe; returns unsubscribe */
+    subscribe: (listener: () => void) => () => void;
+};
+export type Computed<T> = {
+    (): T;
+    peek: () => T;
+    subscribe: (listener: () => void) => () => void;
+};
+export declare function createSignal<T>(initial: T): Signal<T>;
+export declare function effect(fn: () => void): () => void;
+export declare function computed<T>(fn: () => T): Computed<T>;
+/**
+ * Batch multiple signal writes; subscribers fire once per signal after `fn` returns.
+ * Useful when controllers mutate several signals in a single transaction.
+ *
+ * Implementation note: current `set` is synchronous-notify; batch wraps writes
+ * by deferring notifications via a microtask queue per signal. For now we keep
+ * batch a no-op marker since signal writes are already coalesced via Object.is —
+ * adapters can wrap their own batching (React's automatic batching, Vue's nextTick).
+ */
+export declare function batch<T>(fn: () => T): T;
+//# sourceMappingURL=signal.d.ts.map

package/dist/reactivity/signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../src/reactivity/signal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI;IACpB,8DAA8D;IAC9D,IAAI,CAAC,CAAA;IACL,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC,CAAA;IACb,mEAAmE;IACnE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAA;IACtB,qCAAqC;IACrC,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;CAClD,CAAA;AAED,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;IACtB,IAAI,CAAC,CAAA;IACL,IAAI,EAAE,MAAM,CAAC,CAAA;IACb,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;CAClD,CAAA;AASD,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CA6BrD;AAED,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAqBjD;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAepD;AAED;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEvC"}