@chenzy-design/core 0.2.1 → 0.4.0

package/dist/config-provider.js

@@ -1,49 +1,124 @@
 /**
- * createConfigProvider helpers — framework-agnostic config merge logic.
- * Pure functions only: shallow-merge a child config over a parent so that
- * `undefined` fields inherit from the parent (nearest-wins). The svelte layer
- * owns context injection. See specs/components/other/ConfigProvider.spec.md §3.
+ * ConfigProvider helpers — framework-agnostic config merge + responsive utils.
+ *
+ * 严格对齐 Semi ConfigProvider（packages/semi-ui/configProvider）：ConfigProvider 是
+ * 纯逻辑组件，仅下发 direction / timeZone / getPopupContainer 等跨组件公共配置，并提供
+ * 响应式断点订阅能力。locale 维度由 svelte 层的 locale context 承担（不进 core 纯配置）。
+ *
+ * 纯函数 / 纯类型：context 注入与 matchMedia 生命周期由 svelte 层拥有；此处仅提供
+ * 可测的合并逻辑、断点常量与 registerMediaQuery 工具（对齐 semi `_utils`）。
  */
+/** 各断点的 min-width（px）。xs 为 0（基础层无媒体查询）。对齐 Semi 断点尺寸。 */
+export const BREAKPOINTS = {
+    xs: 0,
+    sm: 576,
+    md: 768,
+    lg: 992,
+    xl: 1200,
+    xxl: 1600,
+};
+/**
+ * 默认断点配置。对齐 Semi defaultResponsiveMap，可经
+ * `ConfigProvider.defaultResponsiveMap` 获取。
+ */
+export const defaultResponsiveMap = {
+    xs: '(max-width: 575px)',
+    sm: '(min-width: 576px)',
+    md: '(min-width: 768px)',
+    lg: '(min-width: 992px)',
+    xl: '(min-width: 1200px)',
+    xxl: '(min-width: 1600px)',
+};
+/** 全部断点均未命中的初值。 */
+export const EMPTY_SCREENS = {
+    xs: false,
+    sm: false,
+    md: false,
+    lg: false,
+    xl: false,
+    xxl: false,
+};
+/** 默认配置。对齐 Semi defaultProps（direction: 'ltr'）。 */
 export const DEFAULT_CONFIG = {
-    theme: 'light',
-    dir: 'ltr',
-    size: 'default',
-    zIndexBase: 1000,
-    transition: true,
-    reducedMotion: 'auto',
+    direction: 'ltr',
+    timeZone: undefined,
 };
 /**
- * Shallow-merge a child config over a resolved parent: each field of `child`
- * overrides the parent only when explicitly provided (not undefined), so
- * omitting a field inherits the parent's value.
+ * 把子配置浅合并到已解析的父配置：子字段仅在显式提供（非 undefined）时覆盖父级，
+ * 省略字段继承父级值（就近 wins）。对齐 Semi 嵌套 Context 的继承语义。
  */
 export function mergeConfig(parent, child) {
     return {
-        theme: child.theme ?? parent.theme,
-        dir: child.dir ?? parent.dir,
-        size: child.size ?? parent.size,
-        zIndexBase: child.zIndexBase ?? parent.zIndexBase,
-        transition: child.transition ?? parent.transition,
-        reducedMotion: child.reducedMotion ?? parent.reducedMotion,
+        direction: child.direction ?? parent.direction,
+        timeZone: child.timeZone ?? parent.timeZone,
     };
 }
+// --- 时区值层偏移（对齐 Semi utcToZonedTime 语义；不依赖 date-fns，不碰原生 Intl 时区）---
+// Semi 的 timeZone 不是在显示层给格式化器附加 timeZone，而是在【值层】用 date-fns-tz 的
+// utcToZonedTime 把绝对时刻（UTC）转成「目标时区墙上时间」对应的一个 Date，随后底层一律用
+// date-fns format 按该 Date 的本地字段序列化。本库刻意不依赖 date-fns，故用纯偏移换算复刻
+// 该语义：对固定偏移（数字小时 / 'GMT±HH:mm'）精确等价；具名 IANA（含夏令时）不支持，
+// 因为无 tz 数据库无从判定，属有意的能力边界（demo 仅用 GMT± / 数字，与 Semi demo 一致）。
+const GMT_STRING_REG = /^GMT([-+])(\d{2}):(\d{2})$/;
+/**
+ * 把 timeZone（数字=距 UTC 的小时偏移 | 'GMT±HH:mm'）解析成「分钟偏移」；无法解析（含具名
+ * IANA 标识、非法串）返回 undefined，调用方据此回退到不做时区转换（用本地时区）。
+ */
+export function parseTimeZoneOffsetMinutes(tz) {
+    if (typeof tz === 'number') {
+        return Number.isFinite(tz) ? Math.round(tz * 60) : undefined;
+    }
+    const matches = tz.match(GMT_STRING_REG);
+    if (!matches)
+        return undefined;
+    const sign = matches[1] === '-' ? -1 : 1;
+    const hours = parseInt(matches[2] ?? '0', 10);
+    const minutes = parseInt(matches[3] ?? '0', 10);
+    return sign * (hours * 60 + minutes);
+}
 /**
- * 把配置主题解析为实际落到 DOM 的主题：'auto' 时跟随系统是否偏好暗色，
- * 其余原样返回。纯函数（红线 #2），不读 window，系统态由调用方注入。
+ * 把一个绝对时刻（Date）转成「目标时区墙上时间」对应的 Date —— 该 Date 的本地字段
+ * (getHours/getFullYear…) 即目标时区的墙上时间。对齐 Semi utcToZonedTime（固定偏移场景）：
+ * 消费方随后用现有的本地字段序列化（getHours 等 / Intl 不传 timeZone）即得到该时区的显示文案。
+ * timeZone 无法解析（具名 IANA / 非法）时原样返回入参 Date，等价于不做时区转换。
  */
-export function resolveAppliedTheme(theme, systemPrefersDark) {
-    if (theme === 'auto')
-        return systemPrefersDark ? 'dark' : 'light';
-    return theme;
+export function zonedWallTime(date, tz) {
+    if (tz == null)
+        return date;
+    const offsetMinutes = parseTimeZoneOffsetMinutes(tz);
+    if (offsetMinutes === undefined)
+        return date;
+    // date.getTime() 是 UTC 毫秒；加上目标时区偏移，再用「负本地偏移」抵消，使得读出的
+    // 本地字段恰好等于目标时区墙上时间。等价于 date-fns-tz utcToZonedTime 的固定偏移分支。
+    const localOffsetMinutes = date.getTimezoneOffset(); // 本地相对 UTC，东区为负
+    const deltaMinutes = offsetMinutes + localOffsetMinutes;
+    return new Date(date.getTime() + deltaMinutes * 60_000);
 }
 /**
- * 解析最终是否降级动画：显式 boolean 优先，'auto' 跟随系统
- * prefers-reduced-motion。纯函数（红线 #2），系统态由调用方注入。
- * 返回 true 表示应降级（reduce）。
+ * 注册 media query 的 match/unmatch 回调，返回注销函数。
+ * 逐字对齐 Semi `_utils` 的 registerMediaQuery：SSR（无 window）返回 noop；
+ * 优先 addEventListener，回退老浏览器 addListener；callInInit 默认立即回调一次。
  */
-export function resolveReducedMotion(input, systemReduced) {
-    if (typeof input === 'boolean')
-        return input;
-    return systemReduced;
+export function registerMediaQuery(media, { match, unmatch, callInInit = true }) {
+    if (typeof window !== 'undefined' && typeof window.matchMedia === 'function') {
+        const mediaQueryList = window.matchMedia(media);
+        const handlerMediaChange = (e) => {
+            if (e.matches) {
+                match?.(e);
+            }
+            else {
+                unmatch?.(e);
+            }
+        };
+        if (callInInit)
+            handlerMediaChange(mediaQueryList);
+        if (Object.prototype.hasOwnProperty.call(mediaQueryList, 'addEventListener')) {
+            mediaQueryList.addEventListener('change', handlerMediaChange);
+            return () => mediaQueryList.removeEventListener('change', handlerMediaChange);
+        }
+        mediaQueryList.addListener(handlerMediaChange);
+        return () => mediaQueryList.removeListener(handlerMediaChange);
+    }
+    return () => undefined;
 }
 //# sourceMappingURL=config-provider.js.map

package/dist/config-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-provider.js","sourceRoot":"","sources":["../src/config-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqCH,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,SAAS;IACf,UAAU,EAAE,IAAI;IAChB,UAAU,EAAE,IAAI;IAChB,aAAa,EAAE,MAAM;CACtB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,MAAsB,EAAE,KAAkB;IACpE,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK;QAClC,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI;QAC/B,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU;QACjD,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU;QACjD,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,MAAM,CAAC,aAAa;KAC3D,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAkB,EAAE,iBAA0B;IAChF,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAClE,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAyB,EAAE,aAAsB;IACpF,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,OAAO,aAAa,CAAC;AACvB,CAAC"}
+{"version":3,"file":"config-provider.js","sourceRoot":"","sources":["../src/config-provider.ts"],"names":[],"mappings":"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"}

package/dist/config-provider.test.js

@@ -1,76 +1,139 @@
-import { describe, expect, it } from 'vitest';
-import { mergeConfig, DEFAULT_CONFIG, resolveAppliedTheme, resolveReducedMotion, } from './config-provider.js';
+import { describe, expect, it, vi, beforeEach, afterEach } from 'vitest';
+import { mergeConfig, DEFAULT_CONFIG, defaultResponsiveMap, EMPTY_SCREENS, registerMediaQuery, zonedWallTime, parseTimeZoneOffsetMinutes, } from './config-provider.js';
 describe('mergeConfig', () => {
     it('returns parent values when child provides nothing', () => {
         expect(mergeConfig(DEFAULT_CONFIG, {})).toEqual(DEFAULT_CONFIG);
     });
     it('overrides only explicitly-provided fields', () => {
-        const merged = mergeConfig(DEFAULT_CONFIG, { theme: 'dark' });
-        expect(merged.theme).toBe('dark');
-        expect(merged.dir).toBe('ltr'); // inherited
-        expect(merged.size).toBe('default'); // inherited
+        const merged = mergeConfig(DEFAULT_CONFIG, { direction: 'rtl' });
+        expect(merged.direction).toBe('rtl');
+        expect(merged.timeZone).toBeUndefined(); // inherited
     });
     it('omitted fields inherit the parent (not overwritten)', () => {
-        const parent = { ...DEFAULT_CONFIG, theme: 'dark', size: 'large' };
-        // child omits theme/size entirely → they inherit
-        const merged = mergeConfig(parent, { dir: 'rtl' });
-        expect(merged.theme).toBe('dark'); // inherited
-        expect(merged.dir).toBe('rtl'); // overridden
-        expect(merged.size).toBe('large'); // inherited
-    });
-    it('nested merge: inner only overrides dir, keeps outer theme/locale-adjacent fields', () => {
-        const outer = mergeConfig(DEFAULT_CONFIG, { theme: 'dark', size: 'small' });
-        const inner = mergeConfig(outer, { dir: 'rtl' });
-        expect(inner).toEqual({
-            theme: 'dark',
-            dir: 'rtl',
-            size: 'small',
-            zIndexBase: 1000,
-            transition: true,
-            reducedMotion: 'auto',
-        });
+        const parent = { ...DEFAULT_CONFIG, direction: 'rtl', timeZone: 'Asia/Shanghai' };
+        // child omits both → they inherit
+        const merged = mergeConfig(parent, {});
+        expect(merged.direction).toBe('rtl');
+        expect(merged.timeZone).toBe('Asia/Shanghai');
+    });
+    it('nested merge: inner only overrides timeZone, keeps outer direction', () => {
+        const outer = mergeConfig(DEFAULT_CONFIG, { direction: 'rtl' });
+        const inner = mergeConfig(outer, { timeZone: 'GMT+08:00' });
+        expect(inner).toEqual({ direction: 'rtl', timeZone: 'GMT+08:00' });
+    });
+    it('accepts numeric timeZone', () => {
+        expect(mergeConfig(DEFAULT_CONFIG, { timeZone: -9.5 }).timeZone).toBe(-9.5);
     });
-    it('merges numeric and boolean fields', () => {
-        const merged = mergeConfig(DEFAULT_CONFIG, { zIndexBase: 2000, transition: false });
-        expect(merged.zIndexBase).toBe(2000);
-        expect(merged.transition).toBe(false);
-        // transition:false must override (not be treated as "missing" by ??)
-        expect(mergeConfig({ ...DEFAULT_CONFIG, transition: false }, {}).transition).toBe(false);
-    });
-    it('default reducedMotion is auto; inherits and overrides', () => {
-        expect(DEFAULT_CONFIG.reducedMotion).toBe('auto');
-        expect(mergeConfig(DEFAULT_CONFIG, {}).reducedMotion).toBe('auto');
-        expect(mergeConfig(DEFAULT_CONFIG, { reducedMotion: true }).reducedMotion).toBe(true);
-        // reducedMotion:false must override auto (not be treated as missing by ??)
-        expect(mergeConfig({ ...DEFAULT_CONFIG, reducedMotion: 'auto' }, { reducedMotion: false }).reducedMotion).toBe(false);
-    });
-    it('theme=auto inherits/overrides like other fields', () => {
-        expect(mergeConfig(DEFAULT_CONFIG, { theme: 'auto' }).theme).toBe('auto');
-        // inner auto over outer dark wins (nearest)
-        const outer = mergeConfig(DEFAULT_CONFIG, { theme: 'dark' });
-        expect(mergeConfig(outer, { theme: 'auto' }).theme).toBe('auto');
+    it('default direction is ltr', () => {
+        expect(DEFAULT_CONFIG.direction).toBe('ltr');
     });
 });
-describe('resolveAppliedTheme', () => {
-    it('passes through light/dark regardless of system', () => {
-        expect(resolveAppliedTheme('light', true)).toBe('light');
-        expect(resolveAppliedTheme('light', false)).toBe('light');
-        expect(resolveAppliedTheme('dark', false)).toBe('dark');
-        expect(resolveAppliedTheme('dark', true)).toBe('dark');
+describe('parseTimeZoneOffsetMinutes', () => {
+    it('数字小时偏移 → 分钟', () => {
+        expect(parseTimeZoneOffsetMinutes(8)).toBe(480);
+        expect(parseTimeZoneOffsetMinutes(-5)).toBe(-300);
+        expect(parseTimeZoneOffsetMinutes(0)).toBe(0);
+        expect(parseTimeZoneOffsetMinutes(5.5)).toBe(330);
     });
-    it('auto follows system prefers-color-scheme', () => {
-        expect(resolveAppliedTheme('auto', true)).toBe('dark');
-        expect(resolveAppliedTheme('auto', false)).toBe('light');
+    it("'GMT±HH:mm' → 分钟", () => {
+        expect(parseTimeZoneOffsetMinutes('GMT+08:00')).toBe(480);
+        expect(parseTimeZoneOffsetMinutes('GMT-08:00')).toBe(-480);
+        expect(parseTimeZoneOffsetMinutes('GMT+05:30')).toBe(330);
+        expect(parseTimeZoneOffsetMinutes('GMT+00:00')).toBe(0);
+    });
+    it('具名 IANA / 非法串 → undefined（回退不转换）', () => {
+        expect(parseTimeZoneOffsetMinutes('Asia/Shanghai')).toBeUndefined();
+        expect(parseTimeZoneOffsetMinutes('UTC')).toBeUndefined();
+        expect(parseTimeZoneOffsetMinutes('nonsense')).toBeUndefined();
+        expect(parseTimeZoneOffsetMinutes(Number.NaN)).toBeUndefined();
     });
 });
-describe('resolveReducedMotion', () => {
-    it('explicit boolean wins over system', () => {
-        expect(resolveReducedMotion(true, false)).toBe(true);
-        expect(resolveReducedMotion(false, true)).toBe(false);
-    });
-    it('auto follows system prefers-reduced-motion', () => {
-        expect(resolveReducedMotion('auto', true)).toBe(true);
-        expect(resolveReducedMotion('auto', false)).toBe(false);
+describe('zonedWallTime', () => {
+    it('墙上时间字段等于目标时区当地时间（东八区与西八区相差 16h）', () => {
+        // 2020-02-13T13:08:25.265Z（UTC）
+        const utc = new Date(1581599305265);
+        const east8 = zonedWallTime(utc, 'GMT+08:00');
+        const west8 = zonedWallTime(utc, 'GMT-08:00');
+        // 东八区当地 = UTC+8 = 21:08:25；西八区 = UTC-8 = 05:08:25
+        expect(east8.getHours() - west8.getHours()).toBe(16);
+        // 用 UTC 字段读回：east8 读出的 UTC 字段即东八区墙上时间
+        expect(east8.getTime() - west8.getTime()).toBe(16 * 60 * 60 * 1000);
+    });
+    it('无法解析的时区原样返回入参（不做转换）', () => {
+        const d = new Date(1581599305265);
+        expect(zonedWallTime(d, 'Asia/Shanghai')).toBe(d);
+        expect(zonedWallTime(d, undefined)).toBe(d);
+    });
+});
+describe('defaultResponsiveMap', () => {
+    it('mirrors Semi breakpoints', () => {
+        expect(defaultResponsiveMap).toEqual({
+            xs: '(max-width: 575px)',
+            sm: '(min-width: 576px)',
+            md: '(min-width: 768px)',
+            lg: '(min-width: 992px)',
+            xl: '(min-width: 1200px)',
+            xxl: '(min-width: 1600px)',
+        });
+    });
+    it('EMPTY_SCREENS all false', () => {
+        expect(Object.values(EMPTY_SCREENS).every((v) => v === false)).toBe(true);
+    });
+});
+describe('registerMediaQuery', () => {
+    let listeners;
+    let matchesValue;
+    let addSpy;
+    let removeSpy;
+    beforeEach(() => {
+        listeners = [];
+        matchesValue = false;
+        addSpy = vi.fn((_type, cb) => listeners.push(cb));
+        removeSpy = vi.fn();
+        // registerMediaQuery 读的是 window.matchMedia；core 单测在 node 环境无 window，
+        // 显式注入一个带 matchMedia 的 window（无 addListener，走 addEventListener 分支）。
+        vi.stubGlobal('window', {
+            matchMedia: vi.fn((_media) => ({
+                get matches() {
+                    return matchesValue;
+                },
+                addEventListener: addSpy,
+                removeEventListener: removeSpy,
+            })),
+        });
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+    });
+    it('callInInit fires immediately with current state', () => {
+        const match = vi.fn();
+        const unmatch = vi.fn();
+        matchesValue = true;
+        registerMediaQuery('(min-width: 768px)', { match, unmatch });
+        expect(match).toHaveBeenCalledTimes(1);
+        expect(unmatch).not.toHaveBeenCalled();
+    });
+    it('callInInit=false does not fire on register', () => {
+        const match = vi.fn();
+        registerMediaQuery('(min-width: 768px)', { match, callInInit: false });
+        expect(match).not.toHaveBeenCalled();
+    });
+    it('change event dispatches match/unmatch and unregister removes listener', () => {
+        const match = vi.fn();
+        const unmatch = vi.fn();
+        const off = registerMediaQuery('(min-width: 768px)', { match, unmatch, callInInit: false });
+        listeners.forEach((cb) => cb({ matches: true }));
+        expect(match).toHaveBeenCalledTimes(1);
+        listeners.forEach((cb) => cb({ matches: false }));
+        expect(unmatch).toHaveBeenCalledTimes(1);
+        off();
+        expect(removeSpy).toHaveBeenCalledTimes(1);
+    });
+    it('SSR-safe: no window returns noop', () => {
+        vi.stubGlobal('window', undefined);
+        const off = registerMediaQuery('(min-width: 768px)', { match: vi.fn() });
+        expect(typeof off).toBe('function');
+        expect(() => off()).not.toThrow();
     });
 });
 //# sourceMappingURL=config-provider.test.js.map

package/dist/config-provider.test.js.map

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

package/dist/cropper.d.ts

@@ -0,0 +1,164 @@
+/**
+ * createCropper — framework-agnostic geometry engine for the Cropper component.
+ * Ported 逐行 from Semi 的 semi-foundation/cropper/foundation.js (CropperFoundation).
+ * See specs/components/show/Cropper.spec.md §3.
+ *
+ * 纯几何/状态：容器/图片/裁切框坐标换算、8 角点 resize（自由 + aspectRatio 约束）、
+ * 裁切框拖拽、图片拖拽、滚轮缩放（min/maxZoom 钳制）、resize 重排、坐标→canvas。
+ * 所有 DOM 读取（container/img 尺寸、bounding rect）经 adapter 注入，
+ * document 级 mousemove/mouseup 绑定由 svelte 渲染层负责；本模块只算不碰 DOM 监听。
+ *
+ * 坐标系：以裁切容器左上角为原点，x 向右、y 向下。centerPoint 存的是几何中心。
+ */
+/** 2D 点。 */
+export interface Point {
+    x: number;
+    y: number;
+}
+/** 图片的固有信息（原始像素尺寸 + 初始适配缩放）。 */
+export interface CropperImageData {
+    originalWidth: number;
+    originalHeight: number;
+    /** 图片加载后为适配容器所做的初始缩放（naturalWidth * scale = 显示宽）。 */
+    scale: number;
+}
+/** 图片当前的显示态（显示宽高 + 中心点，随缩放/拖拽/旋转变化）。 */
+export interface CropperImageState {
+    width: number;
+    height: number;
+    centerPoint: Point;
+}
+/** 裁切框当前态。 */
+export interface CropperBox {
+    width: number;
+    height: number;
+    centerPoint: Point;
+}
+/** 容器尺寸。 */
+export interface ContainerData {
+    width: number;
+    height: number;
+}
+/** 角点方向：4 角 + 4 边中点。 */
+export type CropperCorner = 'tl' | 'tm' | 'tr' | 'ml' | 'mr' | 'bl' | 'bm' | 'br';
+/** 裁切框形状。 */
+export type CropperShape = 'rect' | 'round' | 'roundRect';
+/** 角点全集与圆形（round）时仅保留的 4 个边中点角点。 */
+export declare const CROPPER_CORNERS: readonly CropperCorner[];
+export declare const CROPPER_ROUND_CORNERS: readonly CropperCorner[];
+export declare const CROPPER_SHAPES: readonly CropperShape[];
+/** adapter：渲染层注入的 DOM 读取 + 变更通知。core 只调、不持有 DOM 引用。 */
+export interface CropperAdapter {
+    /** 返回裁切容器元素（读 clientWidth/clientHeight/getBoundingClientRect）。 */
+    getContainer: () => {
+        clientWidth: number;
+        clientHeight: number;
+        getBoundingClientRect: () => DOMRect;
+    } | null;
+    /** 返回原始 <img> 元素（getCropperCanvas 绘制时用）。 */
+    getImg: () => HTMLImageElement | null;
+    /** zoom 变化通知（映射 onZoomChange）。 */
+    notifyZoomChange: (zoom: number) => void;
+}
+/** core 需消费的 props（默认值语义对齐 Semi defaultProps）。 */
+export interface CropperFoundationProps {
+    src?: string | undefined;
+    /** 受控裁切比例。设置后角点 resize 走 aspect 约束分支。 */
+    aspectRatio?: number | undefined;
+    /** 图片加载时裁切框初始比例，默认 1（仅 aspectRatio 未设时生效）。 */
+    defaultAspectRatio: number;
+    fill: string;
+    maxZoom: number;
+    minZoom: number;
+    zoomStep: number;
+}
+/** core 维护的响应式状态（渲染层订阅）。 */
+export interface CropperFoundationState {
+    imgData: CropperImageState;
+    cropperBox: CropperBox;
+    zoom: number;
+    rotate: number;
+    loaded: boolean;
+}
+/** getMiddle — 将 value 钳制到 [min, max]。（Semi cropper.utils.getMiddle） */
+export declare function getMiddle(value: number, [min, max]: [number, number]): number;
+/**
+ * getAspectHW — 在给定 (width, height) 外接框内取满足 aspect(=w/h) 的最大内接矩形宽高。
+ * （Semi cropper.utils.getAspectHW）
+ */
+export declare function getAspectHW(width: number, height: number, aspect: number): [number, number];
+/** 每个方向的 resize 参数（自由 resize 分支用）。 */
+export declare function getMoveParamByDir(dir: CropperCorner): {
+    paramX: number;
+    paramY: number;
+};
+/**
+ * createCropperFoundation — 构造几何引擎实例。
+ * 状态经 `getState()` 读、`setState()` 写（渲染层将其桥接到框架响应式）。
+ */
+export declare function createCropperFoundation(options: {
+    adapter: CropperAdapter;
+    getProps: () => Partial<CropperFoundationProps>;
+    getState: () => CropperFoundationState;
+    setState: (patch: Partial<CropperFoundationState>) => void;
+}): {
+    getContainerData: () => {
+        width: number;
+        height: number;
+    };
+    getImageMeta: () => {
+        originalWidth: number;
+        originalHeight: number;
+        /** 图片加载后为适配容器所做的初始缩放（naturalWidth * scale = 显示宽）。 */
+        scale: number;
+    };
+    getBoxMoveDir: () => "" | CropperCorner;
+    getRangeX: () => [number, number];
+    getRangeY: () => [number, number];
+    init: () => void;
+    handleResize: () => void;
+    getImgDataWhenResize: (ratio: number) => CropperImageState;
+    getCropperBoxWhenResize: (ratio: number, newContainerData: ContainerData) => CropperBox;
+    handleImageLoad: (target: {
+        naturalWidth: number;
+        naturalHeight: number;
+    }) => void;
+    handleWheel: (e: {
+        deltaY: number;
+        clientX: number;
+        clientY: number;
+        preventDefault?: () => void;
+    }) => void;
+    handleCornerMouseDown: (dir: CropperCorner) => void;
+    handleCornerMove: (clientX: number, clientY: number) => void;
+    handleCornerMouseUp: () => void;
+    getRangeForAspectChange: () => void;
+    handleCropperBoxMouseDown: (clientX: number, clientY: number) => void;
+    handleCropperBoxMouseMove: (clientX: number, clientY: number) => void;
+    handleCropperBoxMouseUp: () => void;
+    handleImgMoveStart: (clientX: number, clientY: number) => void;
+    handleImgMove: (clientX: number, clientY: number) => void;
+    handleImgMoveUp: () => void;
+    computeControlledImgData: (nextRotate: number, nextZoom: number) => CropperImageState;
+    getCropperCanvas: () => HTMLCanvasElement;
+    computePreview: (previewContainerInitSize: {
+        width: number;
+        height: number;
+    }, props: {
+        width: number;
+        height: number;
+        translateX: number;
+        translateY: number;
+        rotate: number;
+    }) => {
+        imgWidth: number;
+        imgHeight: number;
+        translateX: number;
+        translateY: number;
+        rotate: number;
+        containerWidth: number;
+        containerHeight: number;
+    };
+};
+export type CropperFoundation = ReturnType<typeof createCropperFoundation>;
+//# sourceMappingURL=cropper.d.ts.map

package/dist/cropper.d.ts.map

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