@chenzy-design/svelte 0.1.0

package/dist/resize-observer/ResizeObserver.svelte

@@ -0,0 +1,169 @@
+<!--
+  ResizeObserver — see specs/components/other/ResizeObserver.spec.md
+  Renderless 工具组件：渲染一个无样式包裹元素作为观测容器，
+  通过 @chenzy-design/core 的 createResizeObserver 监听其尺寸，
+  slot 暴露归一化的 width/height/entry。
+
+  盒模型：content-box / border-box / device-pixel-content-box，
+  单目标 + 多目标（multiple）+ throttle/debounce 节流去抖，包裹元素标签可经 tag 自定义。
+  fallbackToWindow 降级（原生不可用或显式开启时监听 window.resize 近似重测），
+  onResizeStart/onResizeEnd 边界事件（连续变化首帧 / 静默结束，core 纯状态机驱动）。
+
+  ⚠️ 死循环红线：
+    - 红线 #1：无受控回写，尺寸只向 slot / 回调单向分发。
+    - 红线 #3：observer 在 $effect 内命令式创建 + observe，
+      cleanup 时 disconnect；不使用响应式 attachment 读 DOM 几何。
+    - 包裹元素必须有真实盒子（默认 display:block），
+      绝不用 display:contents —— 该元素不生成盒子，ResizeObserver 无法观测其尺寸。
+-->
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+  import {
+    createResizeObserver,
+    type CDResizeEntry,
+    type ResizeBox,
+  } from '@chenzy-design/core';
+
+  interface Props {
+    /** 观测盒模型，默认 'content-box'（另支持 border-box / device-pixel-content-box） */
+    box?: ResizeBox;
+    /** 暂停尺寸分发，默认 false（observer 仍在监听，仅不向外通知） */
+    disabled?: boolean;
+    /**
+     * 节流间隔(ms)，leading+trailing，默认 0 即原生即时回调。
+     * 与 debounce 互斥（同时 >0 时 debounce 优先）。
+     */
+    throttle?: number;
+    /** 防抖等待(ms)，trailing-only，默认 0 关闭。与 throttle 互斥（优先）。 */
+    debounce?: number;
+    /**
+     * 多目标：true 时观测包裹元素内所有直接子元素（而非包裹元素本身），
+     * onResize 逐个抛出，用 entry.target 区分。默认 false（观测包裹元素）。
+     * 注意：多目标模式下 slot 的 width/height 反映最后一次变化的目标。
+     */
+    multiple?: boolean;
+    /** 挂载后立即测量一次，默认 true（ResizeObserver 原生在 observe 时触发首次回调，天然满足） */
+    observeOnMount?: boolean;
+    /** 包裹元素标签，默认 'div'。须为可生成盒子的元素（勿用 display:contents 类标签）。 */
+    tag?: string;
+    /**
+     * 原生 ResizeObserver 不可用（SSR/老环境）或显式开启时，降级监听 window.resize，
+     * 用 getBoundingClientRect 近似重测（精度较低）。默认 false：不支持环境静默降级。
+     */
+    fallbackToWindow?: boolean;
+    /** 尺寸变化回调（归一化 entry） */
+    onResize?: (entry: CDResizeEntry) => void;
+    /** 首次测量回调 */
+    onFirstMeasure?: (entry: CDResizeEntry) => void;
+    /** 一段连续尺寸变化的首帧触发（"调整中"态） */
+    onResizeStart?: (entry: CDResizeEntry) => void;
+    /** 连续变化结束后（静默一段时间）触发，payload 为最后一帧（"调整完成"） */
+    onResizeEnd?: (entry: CDResizeEntry) => void;
+    /** slot 作用域参数：{ width, height, entry } */
+    children?: Snippet<
+      [{ width: number; height: number; entry: CDResizeEntry | null }]
+    >;
+    class?: string;
+  }
+
+  let {
+    box = 'content-box',
+    disabled = false,
+    throttle = 0,
+    debounce = 0,
+    multiple = false,
+    observeOnMount = true,
+    tag = 'div',
+    fallbackToWindow = false,
+    onResize,
+    onFirstMeasure,
+    onResizeStart,
+    onResizeEnd,
+    children,
+    class: className,
+  }: Props = $props();
+
+  // 包裹元素普通引用（bind:this），即被观测对象。
+  let el = $state<HTMLElement | null>(null);
+
+  // 本地响应式状态：仅由 observer 回调（非 render 期）写入，render 期只读以驱动 slot。
+  let width = $state(0);
+  let height = $state(0);
+  let entry = $state<CDResizeEntry | null>(null);
+
+  // 普通（非响应式）变量：标记是否已触发首次测量。
+  let firstFired = false;
+
+  // observer 命令式创建 + observe + cleanup disconnect（红线 #3）。
+  // 依赖 el + box + throttle + debounce + multiple：变更时重建 observer。
+  // disabled 不进依赖（避免暂停/恢复时丢失监听重建）——在回调内读最新 prop 值。
+  $effect(() => {
+    if (!el) return;
+
+    const node = el;
+    const ro = createResizeObserver({
+      box,
+      throttle,
+      debounce,
+      fallbackToWindow,
+      // 仅在使用方监听时挂 start/end，避免无谓的静默计时器（向后兼容）。
+      onResizeStart: onResizeStart
+        ? (e) => {
+            if (disabled) return;
+            onResizeStart?.(e);
+          }
+        : undefined,
+      onResizeEnd: onResizeEnd
+        ? (e) => {
+            if (disabled) return;
+            onResizeEnd?.(e);
+          }
+        : undefined,
+      onResize: (e) => {
+        // disabled 在回调内读 prop 最新值（Svelte 5 解构 prop 在闭包内访问是响应式最新值）。
+        if (disabled) return;
+        width = e.width;
+        height = e.height;
+        entry = e;
+        if (!firstFired) {
+          firstFired = true;
+          onFirstMeasure?.(e);
+        }
+        onResize?.(e);
+      },
+    });
+
+    // SSR / 无原生 RO 且未开启 window 降级：静默不监听。
+    // 降级模式 supported 仍为 false，但内部已挂 window.resize，故需放行。
+    if (!ro.supported && !fallbackToWindow) return;
+
+    if (multiple) {
+      // 多目标：观测包裹元素的所有直接子元素（同一 observer 实例复用）。
+      const targets = Array.from(node.children);
+      for (const child of targets) ro.observe(child);
+    } else {
+      ro.observe(node);
+    }
+
+    return () => ro.disconnect();
+  });
+
+  const cls = $derived(
+    ['cd-resize-observer', className].filter(Boolean).join(' '),
+  );
+</script>
+
+<svelte:element this={tag} class={cls} bind:this={el}>
+  {#if children}{@render children({ width, height, entry })}{/if}
+</svelte:element>
+
+<style>
+  /*
+    必须有真实盒子供 ResizeObserver 观测 —— 不可用 display:contents。
+    无任何视觉样式（无 padding/border/background），仅作透明观测容器；
+    使用方可通过 class/style 控制其尺寸。
+  */
+  .cd-resize-observer {
+    display: block;
+  }
+</style>

package/dist/resize-observer/ResizeObserver.svelte.d.ts

@@ -0,0 +1,51 @@
+import type { Snippet } from 'svelte';
+import { type CDResizeEntry, type ResizeBox } from '@chenzy-design/core';
+interface Props {
+    /** 观测盒模型，默认 'content-box'（另支持 border-box / device-pixel-content-box） */
+    box?: ResizeBox;
+    /** 暂停尺寸分发，默认 false（observer 仍在监听，仅不向外通知） */
+    disabled?: boolean;
+    /**
+     * 节流间隔(ms)，leading+trailing，默认 0 即原生即时回调。
+     * 与 debounce 互斥（同时 >0 时 debounce 优先）。
+     */
+    throttle?: number;
+    /** 防抖等待(ms)，trailing-only，默认 0 关闭。与 throttle 互斥（优先）。 */
+    debounce?: number;
+    /**
+     * 多目标：true 时观测包裹元素内所有直接子元素（而非包裹元素本身），
+     * onResize 逐个抛出，用 entry.target 区分。默认 false（观测包裹元素）。
+     * 注意：多目标模式下 slot 的 width/height 反映最后一次变化的目标。
+     */
+    multiple?: boolean;
+    /** 挂载后立即测量一次，默认 true（ResizeObserver 原生在 observe 时触发首次回调，天然满足） */
+    observeOnMount?: boolean;
+    /** 包裹元素标签，默认 'div'。须为可生成盒子的元素（勿用 display:contents 类标签）。 */
+    tag?: string;
+    /**
+     * 原生 ResizeObserver 不可用（SSR/老环境）或显式开启时，降级监听 window.resize，
+     * 用 getBoundingClientRect 近似重测（精度较低）。默认 false：不支持环境静默降级。
+     */
+    fallbackToWindow?: boolean;
+    /** 尺寸变化回调（归一化 entry） */
+    onResize?: (entry: CDResizeEntry) => void;
+    /** 首次测量回调 */
+    onFirstMeasure?: (entry: CDResizeEntry) => void;
+    /** 一段连续尺寸变化的首帧触发（"调整中"态） */
+    onResizeStart?: (entry: CDResizeEntry) => void;
+    /** 连续变化结束后（静默一段时间）触发，payload 为最后一帧（"调整完成"） */
+    onResizeEnd?: (entry: CDResizeEntry) => void;
+    /** slot 作用域参数：{ width, height, entry } */
+    children?: Snippet<[
+        {
+            width: number;
+            height: number;
+            entry: CDResizeEntry | null;
+        }
+    ]>;
+    class?: string;
+}
+declare const ResizeObserver: import("svelte").Component<Props, {}, "">;
+type ResizeObserver = ReturnType<typeof ResizeObserver>;
+export default ResizeObserver;
+//# sourceMappingURL=ResizeObserver.svelte.d.ts.map

package/dist/resize-observer/ResizeObserver.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResizeObserver.svelte.d.ts","sourceRoot":"","sources":["../../src/resize-observer/ResizeObserver.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAEH,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,qBAAqB,CAAC;AAG7B,UAAU,KAAK;IACb,wEAAwE;IACxE,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iEAAiE;IACjE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,wBAAwB;IACxB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC1C,aAAa;IACb,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAChD,4BAA4B;IAC5B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC/C,8CAA8C;IAC9C,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC7C,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAChB;QAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAA;SAAE;KAAC,CACjE,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAsGH,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/resize-observer/action.d.ts

@@ -0,0 +1,29 @@
+/**
+ * resize — Svelte action 轻量用法，供 `<div use:resize={{ box, onResize }}>`。
+ * 复用 @chenzy-design/core 的 createResizeObserver，命令式 observe + destroy disconnect。
+ * box / throttle / debounce 变化时重建 observer（先 disconnect 旧的，红线 #3）；
+ * 仅 onResize 变化则原地更新（回调在闭包内读最新值，无需重建）。
+ */
+import { type ResizeBox, type CDResizeEntry } from '@chenzy-design/core';
+import type { Action } from 'svelte/action';
+export interface ResizeActionParams {
+    /** 观测盒模型，默认 'content-box'。变化时重建 observer。 */
+    box?: ResizeBox;
+    /** 节流间隔(ms)，leading+trailing，默认 0 即时。与 debounce 互斥。变化时重建 observer。 */
+    throttle?: number;
+    /** 防抖等待(ms)，trailing-only，默认 0 关闭。优先于 throttle。变化时重建 observer。 */
+    debounce?: number;
+    /**
+     * 原生不可用（SSR/老环境）或显式开启时降级监听 window.resize 近似重测。
+     * 变化时重建 observer。默认 false。
+     */
+    fallbackToWindow?: boolean;
+    /** 尺寸变化回调（归一化 entry）。变化时原地更新，不重建。 */
+    onResize?: (entry: CDResizeEntry) => void;
+    /** 一段连续变化的首帧触发。变化时原地更新，不重建。 */
+    onResizeStart?: (entry: CDResizeEntry) => void;
+    /** 连续变化静默结束后触发（最后一帧）。变化时原地更新，不重建。 */
+    onResizeEnd?: (entry: CDResizeEntry) => void;
+}
+export declare const resize: Action<HTMLElement, ResizeActionParams | undefined>;
+//# sourceMappingURL=action.d.ts.map

package/dist/resize-observer/action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../src/resize-observer/action.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,qCAAqC;IACrC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC1C,+BAA+B;IAC/B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC/C,qCAAqC;IACrC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;CAC9C;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,kBAAkB,GAAG,SAAS,CA8CtE,CAAC"}

package/dist/resize-observer/action.js

@@ -0,0 +1,47 @@
+/**
+ * resize — Svelte action 轻量用法，供 `<div use:resize={{ box, onResize }}>`。
+ * 复用 @chenzy-design/core 的 createResizeObserver，命令式 observe + destroy disconnect。
+ * box / throttle / debounce 变化时重建 observer（先 disconnect 旧的，红线 #3）；
+ * 仅 onResize 变化则原地更新（回调在闭包内读最新值，无需重建）。
+ */
+import { createResizeObserver, } from '@chenzy-design/core';
+export const resize = (node, params) => {
+    let current = params;
+    let ro;
+    // 命令式创建 + observe；回调在闭包内读 current 最新值（onResize 变化无需重建）。
+    function build() {
+        const wantBoundary = !!current?.onResizeStart || !!current?.onResizeEnd;
+        ro = createResizeObserver({
+            box: current?.box ?? 'content-box',
+            throttle: current?.throttle ?? 0,
+            debounce: current?.debounce ?? 0,
+            fallbackToWindow: current?.fallbackToWindow ?? false,
+            onResize: (e) => current?.onResize?.(e),
+            // 仅在监听时挂 start/end（闭包内读 current 最新回调，无需重建）。
+            onResizeStart: wantBoundary ? (e) => current?.onResizeStart?.(e) : undefined,
+            onResizeEnd: wantBoundary ? (e) => current?.onResizeEnd?.(e) : undefined,
+        });
+        // SSR / 无原生 RO 且未开启 window 降级时 supported=false 不监听；
+        // 降级模式下 observe 内部已挂 window.resize，需放行。
+        if (ro.supported || (current?.fallbackToWindow ?? false))
+            ro.observe(node);
+    }
+    build();
+    return {
+        update(next) {
+            const prev = current;
+            current = next;
+            // 仅 box / throttle / debounce / fallbackToWindow 变化才重建（先 disconnect 旧的，红线 #3）。
+            if ((prev?.box ?? 'content-box') !== (next?.box ?? 'content-box') ||
+                (prev?.throttle ?? 0) !== (next?.throttle ?? 0) ||
+                (prev?.debounce ?? 0) !== (next?.debounce ?? 0) ||
+                (prev?.fallbackToWindow ?? false) !== (next?.fallbackToWindow ?? false)) {
+                ro.disconnect();
+                build();
+            }
+        },
+        destroy() {
+            ro.disconnect();
+        },
+    };
+};

package/dist/resize-observer/index.d.ts

@@ -0,0 +1,5 @@
+export { default as ResizeObserver } from './ResizeObserver.svelte';
+export { resize, type ResizeActionParams } from './action.js';
+export { meta as resizeObserverMeta } from './meta.js';
+export { createResizeObserver, getGlobalResizeObserver, type CDResizeEntry, type ResizeBox, } from '@chenzy-design/core';
+//# sourceMappingURL=index.d.ts.map

package/dist/resize-observer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resize-observer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,IAAI,IAAI,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,KAAK,aAAa,EAClB,KAAK,SAAS,GACf,MAAM,qBAAqB,CAAC"}

package/dist/resize-observer/index.js

@@ -0,0 +1,4 @@
+export { default as ResizeObserver } from './ResizeObserver.svelte';
+export { resize } from './action.js';
+export { meta as resizeObserverMeta } from './meta.js';
+export { createResizeObserver, getGlobalResizeObserver, } from '@chenzy-design/core';

package/dist/resize-observer/meta.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * ResizeObserver — see specs/components/other/ResizeObserver.spec.md
+ */
+export declare const meta: {
+    readonly name: "ResizeObserver";
+    readonly category: "other";
+    readonly renderless: true;
+    readonly description: "尺寸监听工具组件，封装原生 ResizeObserver（经 @chenzy-design/core 归一化），渲染一个无视觉样式的包裹元素作为观测容器，slot 暴露 width/height/entry，onResize 分发归一化尺寸事件；内置 throttle/debounce 节流去抖与 multiple 多目标观测；SSR/老浏览器静默降级，fallbackToWindow 可降级为 window.resize 近似监听；onResizeStart/onResizeEnd 暴露连续变化的首帧与静默结束边界事件；另导出 resize action 供轻量 use:resize 用法、getGlobalResizeObserver 单例池供大列表共享。盒模型支持 content-box/border-box/device-pixel-content-box，包裹元素标签可经 tag 自定义。";
+    readonly exports: readonly ["ResizeObserver", "resize", "createResizeObserver", "getGlobalResizeObserver"];
+    readonly props: readonly [{
+        readonly name: "box";
+        readonly type: "'content-box'|'border-box'|'device-pixel-content-box'";
+        readonly default: "'content-box'";
+        readonly desc: "观测盒模型：content-box 仅内容区，border-box 含 padding+border，device-pixel-content-box 物理像素内容盒（含 DPR；不支持时回退 content-box）";
+    }, {
+        readonly name: "disabled";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "暂停尺寸分发，observer 仍监听但不向 slot/回调通知";
+    }, {
+        readonly name: "throttle";
+        readonly type: "number";
+        readonly default: "0";
+        readonly desc: "节流间隔(ms)，leading+trailing，0 即原生即时。与 debounce 互斥（同时 >0 时 debounce 优先）";
+    }, {
+        readonly name: "debounce";
+        readonly type: "number";
+        readonly default: "0";
+        readonly desc: "防抖等待(ms)，trailing-only，0 关闭。与 throttle 互斥（优先于 throttle）";
+    }, {
+        readonly name: "multiple";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "多目标：观测包裹元素的所有直接子元素，onResize 逐个抛出，用 entry.target 区分";
+    }, {
+        readonly name: "observeOnMount";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "挂载后立即测量一次（ResizeObserver 原生在 observe 时即触发首次回调，天然满足）";
+    }, {
+        readonly name: "tag";
+        readonly type: "string";
+        readonly default: "'div'";
+        readonly desc: "包裹元素标签，经 svelte:element 渲染；须为可生成盒子的元素（勿用 display:contents 类标签）";
+    }, {
+        readonly name: "fallbackToWindow";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "原生 ResizeObserver 不可用（SSR/老环境）或显式开启时，降级监听 window.resize 并用 getBoundingClientRect 近似重测（精度较低）";
+    }];
+    readonly events: readonly [{
+        readonly name: "onResize";
+        readonly desc: "尺寸变化时分发归一化 entry（受控，不回写）";
+    }, {
+        readonly name: "onFirstMeasure";
+        readonly desc: "首次测量完成时分发归一化 entry";
+    }, {
+        readonly name: "onResizeStart";
+        readonly desc: "一段连续尺寸变化的首帧触发（\"调整中\"态）";
+    }, {
+        readonly name: "onResizeEnd";
+        readonly desc: "连续变化静默结束后触发，payload 为最后一帧（\"调整完成\"）";
+    }];
+    readonly slots: readonly [{
+        readonly name: "children";
+        readonly desc: "作用域参数 { width, height, entry }，entry 首次测量前为 null";
+    }];
+    readonly a11y: {
+        readonly hasRole: false;
+        readonly note: "包裹元素不设 role/aria，透明容器不进 a11y 树、不可聚焦、不移动焦点。";
+    };
+    readonly tokens: readonly [];
+    readonly responsive: false;
+    readonly examples: readonly [{
+        readonly title: "slot 测量";
+        readonly code: "<ResizeObserver>{#snippet children({ width, height })}{width} × {height}{/snippet}</ResizeObserver>";
+    }, {
+        readonly title: "use:resize action 轻量用法";
+        readonly code: "<div use:resize={{ onResize: (e) => console.log(e.width, e.height) }}>...</div>";
+    }, {
+        readonly title: "border-box 观测";
+        readonly code: "<ResizeObserver box=\"border-box\" onResize={(e) => (size = e)}>{@render content()}</ResizeObserver>";
+    }];
+};
+//# sourceMappingURL=meta.d.ts.map

package/dist/resize-observer/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/resize-observer/meta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiGP,CAAC"}

package/dist/resize-observer/meta.js

@@ -0,0 +1,101 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * ResizeObserver — see specs/components/other/ResizeObserver.spec.md
+ */
+export const meta = {
+    name: 'ResizeObserver',
+    category: 'other',
+    renderless: true,
+    description: '尺寸监听工具组件，封装原生 ResizeObserver（经 @chenzy-design/core 归一化），渲染一个无视觉样式的包裹元素作为观测容器，slot 暴露 width/height/entry，onResize 分发归一化尺寸事件；内置 throttle/debounce 节流去抖与 multiple 多目标观测；SSR/老浏览器静默降级，fallbackToWindow 可降级为 window.resize 近似监听；onResizeStart/onResizeEnd 暴露连续变化的首帧与静默结束边界事件；另导出 resize action 供轻量 use:resize 用法、getGlobalResizeObserver 单例池供大列表共享。盒模型支持 content-box/border-box/device-pixel-content-box，包裹元素标签可经 tag 自定义。',
+    exports: [
+        'ResizeObserver',
+        'resize',
+        'createResizeObserver',
+        'getGlobalResizeObserver',
+    ],
+    props: [
+        {
+            name: 'box',
+            type: "'content-box'|'border-box'|'device-pixel-content-box'",
+            default: "'content-box'",
+            desc: '观测盒模型：content-box 仅内容区，border-box 含 padding+border，device-pixel-content-box 物理像素内容盒（含 DPR；不支持时回退 content-box）',
+        },
+        {
+            name: 'disabled',
+            type: 'boolean',
+            default: 'false',
+            desc: '暂停尺寸分发，observer 仍监听但不向 slot/回调通知',
+        },
+        {
+            name: 'throttle',
+            type: 'number',
+            default: '0',
+            desc: '节流间隔(ms)，leading+trailing，0 即原生即时。与 debounce 互斥（同时 >0 时 debounce 优先）',
+        },
+        {
+            name: 'debounce',
+            type: 'number',
+            default: '0',
+            desc: '防抖等待(ms)，trailing-only，0 关闭。与 throttle 互斥（优先于 throttle）',
+        },
+        {
+            name: 'multiple',
+            type: 'boolean',
+            default: 'false',
+            desc: '多目标：观测包裹元素的所有直接子元素，onResize 逐个抛出，用 entry.target 区分',
+        },
+        {
+            name: 'observeOnMount',
+            type: 'boolean',
+            default: 'true',
+            desc: '挂载后立即测量一次（ResizeObserver 原生在 observe 时即触发首次回调，天然满足）',
+        },
+        {
+            name: 'tag',
+            type: 'string',
+            default: "'div'",
+            desc: '包裹元素标签，经 svelte:element 渲染；须为可生成盒子的元素（勿用 display:contents 类标签）',
+        },
+        {
+            name: 'fallbackToWindow',
+            type: 'boolean',
+            default: 'false',
+            desc: '原生 ResizeObserver 不可用（SSR/老环境）或显式开启时，降级监听 window.resize 并用 getBoundingClientRect 近似重测（精度较低）',
+        },
+    ],
+    events: [
+        { name: 'onResize', desc: '尺寸变化时分发归一化 entry（受控，不回写）' },
+        { name: 'onFirstMeasure', desc: '首次测量完成时分发归一化 entry' },
+        { name: 'onResizeStart', desc: '一段连续尺寸变化的首帧触发（"调整中"态）' },
+        {
+            name: 'onResizeEnd',
+            desc: '连续变化静默结束后触发，payload 为最后一帧（"调整完成"）',
+        },
+    ],
+    slots: [
+        {
+            name: 'children',
+            desc: '作用域参数 { width, height, entry }，entry 首次测量前为 null',
+        },
+    ],
+    a11y: {
+        hasRole: false,
+        note: '包裹元素不设 role/aria，透明容器不进 a11y 树、不可聚焦、不移动焦点。',
+    },
+    tokens: [],
+    responsive: false,
+    examples: [
+        {
+            title: 'slot 测量',
+            code: '<ResizeObserver>{#snippet children({ width, height })}{width} × {height}{/snippet}</ResizeObserver>',
+        },
+        {
+            title: 'use:resize action 轻量用法',
+            code: '<div use:resize={{ onResize: (e) => console.log(e.width, e.height) }}>...</div>',
+        },
+        {
+            title: 'border-box 观测',
+            code: '<ResizeObserver box="border-box" onResize={(e) => (size = e)}>{@render content()}</ResizeObserver>',
+        },
+    ],
+};