@gunkin/uiify 0.0.1-alpha

package/dist/elements/dialog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/elements/dialog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChF,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/elements/dialog/index.js

@@ -0,0 +1,8 @@
+import { Dialog, DialogClose, DialogContent, DialogTrigger } from "./Dialog.js";
+export {
+  Dialog,
+  DialogClose,
+  DialogContent,
+  DialogTrigger
+};
+//# sourceMappingURL=index.js.map

package/dist/elements/dialog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/elements/dialog/index.ts"],"sourcesContent":["export { Dialog, DialogClose, DialogContent, DialogTrigger } from \"./Dialog.js\";\nexport type {\n  DialogCloseOwnProps,\n  DialogCloseProps,\n  DialogContentNameProps,\n  DialogContentOwnProps,\n  DialogContentProps,\n  DialogTriggerOwnProps,\n  DialogTriggerProps,\n} from \"./types.js\";\n"],"mappings":"AAAA,SAAS,QAAQ,aAAa,eAAe,qBAAqB;","names":[]}

package/dist/elements/dialog/types.d.ts

@@ -0,0 +1,37 @@
+import type { ComponentPropsWithRef, ElementType, ReactNode } from "react";
+import type { NativeButtonProps } from "@gunkin/uiify/core/render";
+export interface DialogTriggerOwnProps {
+    readonly children?: ReactNode;
+    /** `id` of the `Dialog.Content` this button opens; the browser resolves it at click time. */
+    readonly target: string;
+}
+export type DialogTriggerProps<TAs extends ElementType = "button"> = NativeButtonProps<TAs, DialogTriggerOwnProps>;
+export interface DialogCloseOwnProps {
+    readonly children?: ReactNode;
+    /** `id` of the `Dialog.Content` this button closes. */
+    readonly target: string;
+}
+export type DialogCloseProps<TAs extends ElementType = "button"> = NativeButtonProps<TAs, DialogCloseOwnProps>;
+export interface DialogContentOwnProps {
+    readonly children?: ReactNode;
+    /** Unique id supplied by the consumer; referenced by trigger and close `target`. */
+    readonly id: string;
+}
+/**
+ * An unnamed `<dialog>` is an axe violation the browser has no fallback for, so the
+ * accessible name is a type error to omit — exactly one of `aria-labelledby` or
+ * `aria-label` is required.
+ */
+export type DialogContentNameProps = {
+    readonly "aria-labelledby": string;
+    readonly "aria-label"?: never;
+} | {
+    readonly "aria-label": string;
+    readonly "aria-labelledby"?: never;
+};
+/**
+ * A plain, initially closed `<dialog>`: `open` and `popover` are not part of the
+ * native contract, and the accessible name is required (see `DialogContentNameProps`).
+ */
+export type DialogContentProps = DialogContentOwnProps & DialogContentNameProps & Omit<ComponentPropsWithRef<"dialog">, keyof DialogContentOwnProps | "open" | "popover" | "aria-label" | "aria-labelledby">;
+//# sourceMappingURL=types.d.ts.map

package/dist/elements/dialog/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/elements/dialog/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,kBAAkB,CAAC,GAAG,SAAS,WAAW,GAAG,QAAQ,IAAI,iBAAiB,CACpF,GAAG,EACH,qBAAqB,CACtB,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,gBAAgB,CAAC,GAAG,SAAS,WAAW,GAAG,QAAQ,IAAI,iBAAiB,CAClF,GAAG,EACH,mBAAmB,CACpB,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B,oFAAoF;IACpF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAC9B;IAAE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK,CAAA;CAAE,GACrE;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAE1E;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,qBAAqB,GACpD,sBAAsB,GACtB,IAAI,CACF,qBAAqB,CAAC,QAAQ,CAAC,EAC/B,MAAM,qBAAqB,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,GAAG,iBAAiB,CACpF,CAAC"}

package/dist/elements/dialog/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/elements/dialog/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/elements/dialog.d.ts

@@ -0,0 +1 @@
+export * from "./dialog/index.js";

package/dist/elements/dialog.js

@@ -0,0 +1 @@
+export * from "./dialog/index.js";

package/dist/elements/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./invoker/index.js";
+export * from "./dialog/index.js";
+export * from "./popover/index.js";
+export * from "./details/index.js";
+export * from "./choice/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/elements/index.ts"],"names":[],"mappings":"AAEA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}

package/dist/elements/index.js

@@ -0,0 +1,6 @@
+export * from "./invoker/index.js";
+export * from "./dialog/index.js";
+export * from "./popover/index.js";
+export * from "./details/index.js";
+export * from "./choice/index.js";
+//# sourceMappingURL=index.js.map

package/dist/elements/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/elements/index.ts"],"sourcesContent":["// Native-mechanism layer barrel. Every export is 0 kB of client JavaScript:\n// no React hooks, no \"use client\", and no component-layer imports.\nexport * from \"./invoker/index.js\";\nexport * from \"./dialog/index.js\";\nexport * from \"./popover/index.js\";\nexport * from \"./details/index.js\";\nexport * from \"./choice/index.js\";\n"],"mappings":"AAEA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/dist/elements/invoker/Invoker.d.ts

@@ -0,0 +1,16 @@
+import type { ElementType, ReactElement } from "react";
+import type { InvokerProps } from "./types.js";
+/**
+ * Render a native invoker button. `command`/`commandfor` are lowercase HTML
+ * attributes that React 19.2 passes through untouched; @types/react 19.2 does
+ * not declare them and the lint rule react/no-unknown-property rejects them
+ * in JSX, so they travel as a props object through `createElement` rather
+ * than JSX. This is the one place that workaround is written — `Modal`,
+ * `AlertModal` and every other `command`/`commandfor` consumer builds on this
+ * element (or its `@gunkin/uiify/core/render` counterpart, `renderNativeInvoker`).
+ */
+export declare function Invoker<TAs extends ElementType = "button">(props: InvokerProps<TAs>): ReactElement;
+export declare namespace Invoker {
+    var displayName: string;
+}
+//# sourceMappingURL=Invoker.d.ts.map

package/dist/elements/invoker/Invoker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Invoker.d.ts","sourceRoot":"","sources":["../../../src/elements/invoker/Invoker.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,GAAG,SAAS,WAAW,GAAG,QAAQ,EACxD,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,GACvB,YAAY,CASd;yBAXe,OAAO"}

package/dist/elements/invoker/Invoker.js

@@ -0,0 +1,16 @@
+import { createElement } from "react";
+function Invoker(props) {
+  const { as, command, commandfor, ...consumerProps } = props;
+  return createElement(as ?? "button", {
+    ...consumerProps,
+    command,
+    commandfor,
+    "data-uiify-invoker": "",
+    type: "button"
+  });
+}
+Invoker.displayName = "Invoker";
+export {
+  Invoker
+};
+//# sourceMappingURL=Invoker.js.map

package/dist/elements/invoker/Invoker.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/elements/invoker/Invoker.tsx"],"sourcesContent":["import { createElement } from \"react\";\nimport type { ElementType, ReactElement } from \"react\";\nimport type { InvokerProps } from \"./types.js\";\n\n/**\n * Render a native invoker button. `command`/`commandfor` are lowercase HTML\n * attributes that React 19.2 passes through untouched; @types/react 19.2 does\n * not declare them and the lint rule react/no-unknown-property rejects them\n * in JSX, so they travel as a props object through `createElement` rather\n * than JSX. This is the one place that workaround is written — `Modal`,\n * `AlertModal` and every other `command`/`commandfor` consumer builds on this\n * element (or its `@gunkin/uiify/core/render` counterpart, `renderNativeInvoker`).\n */\nexport function Invoker<TAs extends ElementType = \"button\">(\n  props: InvokerProps<TAs>,\n): ReactElement {\n  const { as, command, commandfor, ...consumerProps } = props as InvokerProps<\"button\">;\n  return createElement(as ?? \"button\", {\n    ...consumerProps,\n    command,\n    commandfor,\n    \"data-uiify-invoker\": \"\",\n    type: \"button\",\n  });\n}\nInvoker.displayName = \"Invoker\";\n"],"mappings":"AAAA,SAAS,qBAAqB;AAavB,SAAS,QACd,OACc;AACd,QAAM,EAAE,IAAI,SAAS,YAAY,GAAG,cAAc,IAAI;AACtD,SAAO,cAAc,MAAM,UAAU;AAAA,IACnC,GAAG;AAAA,IACH;AAAA,IACA;AAAA,IACA,sBAAsB;AAAA,IACtB,MAAM;AAAA,EACR,CAAC;AACH;AACA,QAAQ,cAAc;","names":[]}

package/dist/elements/invoker/index.d.ts

@@ -0,0 +1,3 @@
+export { Invoker } from "./Invoker.js";
+export type { InvokerOwnProps, InvokerProps, NativeCommand } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/elements/invoker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/elements/invoker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/elements/invoker/index.js

@@ -0,0 +1,5 @@
+import { Invoker } from "./Invoker.js";
+export {
+  Invoker
+};
+//# sourceMappingURL=index.js.map

package/dist/elements/invoker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/elements/invoker/index.ts"],"sourcesContent":["export { Invoker } from \"./Invoker.js\";\nexport type { InvokerOwnProps, InvokerProps, NativeCommand } from \"./types.js\";\n"],"mappings":"AAAA,SAAS,eAAe;","names":[]}

package/dist/elements/invoker/types.d.ts

@@ -0,0 +1,23 @@
+import type { ElementType, ReactNode } from "react";
+import type { NativeButtonProps } from "@gunkin/uiify/core/render";
+/**
+ * The commands defined by the HTML Invoker Commands API, plus a consumer
+ * `--*` custom command (template literal type). A custom command needs its
+ * own JS listener on `commandfor`'s target — this element documents that
+ * contract, it does not implement one.
+ */
+export type NativeCommand = "show-modal" | "request-close" | "close" | "show-popover" | "hide-popover" | "toggle-popover" | `--${string}`;
+export interface InvokerOwnProps {
+    readonly children?: ReactNode;
+    /** The command to invoke on `commandfor` when this button is activated. */
+    readonly command: NativeCommand;
+    /** `id` of the element this button invokes a command on. */
+    readonly commandfor: string;
+}
+/**
+ * `as` defaults to `"button"`; intrinsic tags other than `"button"` are a type
+ * error — invoker commands only fire from a real button — and `type` is owned
+ * by the element (it is always `"button"`, never `"submit"`/`"reset"`).
+ */
+export type InvokerProps<TAs extends ElementType = "button"> = NativeButtonProps<TAs, InvokerOwnProps>;
+//# sourceMappingURL=types.d.ts.map

package/dist/elements/invoker/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/elements/invoker/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,eAAe,GACf,OAAO,GACP,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,KAAK,MAAM,EAAE,CAAC;AAElB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,GAAG,SAAS,WAAW,GAAG,QAAQ,IAAI,iBAAiB,CAC9E,GAAG,EACH,eAAe,CAChB,CAAC"}

package/dist/elements/invoker/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/elements/invoker/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/elements/invoker.d.ts

@@ -0,0 +1 @@
+export * from "./invoker/index.js";

package/dist/elements/invoker.js

@@ -0,0 +1 @@
+export * from "./invoker/index.js";

package/dist/elements/popover/Popover.d.ts

@@ -0,0 +1,40 @@
+import type { ElementType, ReactElement } from "react";
+import type { PopoverCloseProps, PopoverSurfaceProps, PopoverTriggerProps } from "./types.js";
+/**
+ * Acts on `target` (`action`, default `"toggle"`); light dismiss, Escape and nesting are
+ * handled by the browser. The popover opened this way uses the invoker as its implicit
+ * anchor, so no anchor name is emitted. Emits `data-uiify-popover-trigger`.
+ */
+declare function popoverTrigger<TAs extends ElementType = "button">(props: PopoverTriggerProps<TAs>): ReactElement;
+export declare const PopoverTrigger: typeof popoverTrigger & {
+    displayName: string;
+};
+/**
+ * The popover surface. `data-side`/`data-align` drive the optional anchor CSS in
+ * `@gunkin/uiify/styles`. Emits `popover`, `data-side`, `data-align`, `data-positioning="native"` and
+ * `data-uiify-popover-surface`.
+ */
+declare function popoverSurface(props: PopoverSurfaceProps): ReactElement;
+export declare const PopoverSurface: typeof popoverSurface & {
+    displayName: string;
+};
+/**
+ * Hides `target`. Emits `data-uiify-popover-close`.
+ */
+declare function popoverClose<TAs extends ElementType = "button">(props: PopoverCloseProps<TAs>): ReactElement;
+export declare const PopoverClose: typeof popoverClose & {
+    displayName: string;
+};
+export declare const Popover: {
+    Trigger: typeof popoverTrigger & {
+        displayName: string;
+    };
+    Surface: typeof popoverSurface & {
+        displayName: string;
+    };
+    Close: typeof popoverClose & {
+        displayName: string;
+    };
+};
+export {};
+//# sourceMappingURL=Popover.d.ts.map

package/dist/elements/popover/Popover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Popover.d.ts","sourceRoot":"","sources":["../../../src/elements/popover/Popover.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EAEnB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAiCpB;;;;GAIG;AACH,iBAAS,cAAc,CAAC,GAAG,SAAS,WAAW,GAAG,QAAQ,EACxD,KAAK,EAAE,mBAAmB,CAAC,GAAG,CAAC,GAC9B,YAAY,CAcd;AACD,eAAO,MAAM,cAAc;;CAEzB,CAAC;AAEH;;;;GAIG;AACH,iBAAS,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,YAAY,CAchE;AACD,eAAO,MAAM,cAAc;;CAEzB,CAAC;AAEH;;GAEG;AACH,iBAAS,YAAY,CAAC,GAAG,SAAS,WAAW,GAAG,QAAQ,EACtD,KAAK,EAAE,iBAAiB,CAAC,GAAG,CAAC,GAC5B,YAAY,CASd;AACD,eAAO,MAAM,YAAY;;CAEvB,CAAC;AAEH,eAAO,MAAM,OAAO;;;;;;;;;;CAInB,CAAC"}

package/dist/elements/popover/Popover.js

@@ -0,0 +1,72 @@
+import { jsx } from "react/jsx-runtime";
+import { createElement } from "react";
+function renderInvoker(as, marker, action, target, consumerProps) {
+  return createElement(as ?? "button", {
+    ...consumerProps,
+    [marker]: "",
+    popoverTarget: target,
+    popoverTargetAction: action,
+    type: "button"
+  });
+}
+function popoverTrigger(props) {
+  const {
+    action = "toggle",
+    as,
+    target,
+    ...consumerProps
+  } = props;
+  return renderInvoker(
+    as,
+    "data-uiify-popover-trigger",
+    action,
+    target,
+    consumerProps
+  );
+}
+const PopoverTrigger = /* @__PURE__ */ Object.assign(popoverTrigger, {
+  displayName: "PopoverTrigger"
+});
+function popoverSurface(props) {
+  const { align = "center", children, mode = "auto", side = "bottom", ...consumerProps } = props;
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      ...consumerProps,
+      "data-align": align,
+      "data-positioning": "native",
+      "data-side": side,
+      "data-uiify-popover-surface": "",
+      popover: mode,
+      children
+    }
+  );
+}
+const PopoverSurface = /* @__PURE__ */ Object.assign(popoverSurface, {
+  displayName: "PopoverSurface"
+});
+function popoverClose(props) {
+  const { as, target, ...consumerProps } = props;
+  return renderInvoker(
+    as,
+    "data-uiify-popover-close",
+    "hide",
+    target,
+    consumerProps
+  );
+}
+const PopoverClose = /* @__PURE__ */ Object.assign(popoverClose, {
+  displayName: "PopoverClose"
+});
+const Popover = {
+  Trigger: PopoverTrigger,
+  Surface: PopoverSurface,
+  Close: PopoverClose
+};
+export {
+  Popover,
+  PopoverClose,
+  PopoverSurface,
+  PopoverTrigger
+};
+//# sourceMappingURL=Popover.js.map

package/dist/elements/popover/Popover.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/elements/popover/Popover.tsx"],"sourcesContent":["import { createElement } from \"react\";\nimport type { ElementType, ReactElement } from \"react\";\nimport type {\n  PopoverCloseProps,\n  PopoverSurfaceProps,\n  PopoverTriggerAction,\n  PopoverTriggerProps,\n} from \"./types.js\";\n\n/**\n * Render a `popovertarget` invoker. React 19 knows `popoverTarget` and\n * `popoverTargetAction` as camelCase DOM properties: on the client it sets them via\n * `setAttribute`, which the browser lowercases automatically for an HTML element, and any\n * HTML parser (including hydration) lowercases attribute names from source regardless of\n * case — so the resulting DOM attribute is always `popovertarget`/`popovertargetaction`.\n * React's SSR string renderer has no case-mapping for these two (unlike `className` or\n * `htmlFor`) and serializes the literal camelCase spelling into the markup string; that is\n * a cosmetic detail of the raw SSR string, not a behavioral gap, since a real parser\n * normalizes it.\n *\n * `createElement` rather than JSX for the same reason as `elements/invoker`/`elements/dialog`:\n * `as` is typed as the generic `ElementType`, so a plain object survives type-checking where\n * a literal JSX attribute list on a polymorphic tag would not.\n */\nfunction renderInvoker(\n  as: ElementType | undefined,\n  marker: string,\n  action: PopoverTriggerAction,\n  target: string,\n  consumerProps: Record<string, unknown>,\n): ReactElement {\n  return createElement(as ?? \"button\", {\n    ...consumerProps,\n    [marker]: \"\",\n    popoverTarget: target,\n    popoverTargetAction: action,\n    type: \"button\",\n  });\n}\n\n/**\n * Acts on `target` (`action`, default `\"toggle\"`); light dismiss, Escape and nesting are\n * handled by the browser. The popover opened this way uses the invoker as its implicit\n * anchor, so no anchor name is emitted. Emits `data-uiify-popover-trigger`.\n */\nfunction popoverTrigger<TAs extends ElementType = \"button\">(\n  props: PopoverTriggerProps<TAs>,\n): ReactElement {\n  const {\n    action = \"toggle\",\n    as,\n    target,\n    ...consumerProps\n  } = props as PopoverTriggerProps<\"button\">;\n  return renderInvoker(\n    as,\n    \"data-uiify-popover-trigger\",\n    action,\n    target,\n    consumerProps as Record<string, unknown>,\n  );\n}\nexport const PopoverTrigger = /* @__PURE__ */ Object.assign(popoverTrigger, {\n  displayName: \"PopoverTrigger\",\n});\n\n/**\n * The popover surface. `data-side`/`data-align` drive the optional anchor CSS in\n * `@gunkin/uiify/styles`. Emits `popover`, `data-side`, `data-align`, `data-positioning=\"native\"` and\n * `data-uiify-popover-surface`.\n */\nfunction popoverSurface(props: PopoverSurfaceProps): ReactElement {\n  const { align = \"center\", children, mode = \"auto\", side = \"bottom\", ...consumerProps } = props;\n  return (\n    <div\n      {...consumerProps}\n      data-align={align}\n      data-positioning=\"native\"\n      data-side={side}\n      data-uiify-popover-surface=\"\"\n      popover={mode}\n    >\n      {children}\n    </div>\n  );\n}\nexport const PopoverSurface = /* @__PURE__ */ Object.assign(popoverSurface, {\n  displayName: \"PopoverSurface\",\n});\n\n/**\n * Hides `target`. Emits `data-uiify-popover-close`.\n */\nfunction popoverClose<TAs extends ElementType = \"button\">(\n  props: PopoverCloseProps<TAs>,\n): ReactElement {\n  const { as, target, ...consumerProps } = props as PopoverCloseProps<\"button\">;\n  return renderInvoker(\n    as,\n    \"data-uiify-popover-close\",\n    \"hide\",\n    target,\n    consumerProps as Record<string, unknown>,\n  );\n}\nexport const PopoverClose = /* @__PURE__ */ Object.assign(popoverClose, {\n  displayName: \"PopoverClose\",\n});\n\nexport const Popover = {\n  Trigger: PopoverTrigger,\n  Surface: PopoverSurface,\n  Close: PopoverClose,\n};\n"],"mappings":"AA0EI;AA1EJ,SAAS,qBAAqB;AAwB9B,SAAS,cACP,IACA,QACA,QACA,QACA,eACc;AACd,SAAO,cAAc,MAAM,UAAU;AAAA,IACnC,GAAG;AAAA,IACH,CAAC,MAAM,GAAG;AAAA,IACV,eAAe;AAAA,IACf,qBAAqB;AAAA,IACrB,MAAM;AAAA,EACR,CAAC;AACH;AAOA,SAAS,eACP,OACc;AACd,QAAM;AAAA,IACJ,SAAS;AAAA,IACT;AAAA,IACA;AAAA,IACA,GAAG;AAAA,EACL,IAAI;AACJ,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AACO,MAAM,iBAAiC,uBAAO,OAAO,gBAAgB;AAAA,EAC1E,aAAa;AACf,CAAC;AAOD,SAAS,eAAe,OAA0C;AAChE,QAAM,EAAE,QAAQ,UAAU,UAAU,OAAO,QAAQ,OAAO,UAAU,GAAG,cAAc,IAAI;AACzF,SACE;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACJ,cAAY;AAAA,MACZ,oBAAiB;AAAA,MACjB,aAAW;AAAA,MACX,8BAA2B;AAAA,MAC3B,SAAS;AAAA,MAER;AAAA;AAAA,EACH;AAEJ;AACO,MAAM,iBAAiC,uBAAO,OAAO,gBAAgB;AAAA,EAC1E,aAAa;AACf,CAAC;AAKD,SAAS,aACP,OACc;AACd,QAAM,EAAE,IAAI,QAAQ,GAAG,cAAc,IAAI;AACzC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AACO,MAAM,eAA+B,uBAAO,OAAO,cAAc;AAAA,EACtE,aAAa;AACf,CAAC;AAEM,MAAM,UAAU;AAAA,EACrB,SAAS;AAAA,EACT,SAAS;AAAA,EACT,OAAO;AACT;","names":[]}

package/dist/elements/popover/index.d.ts

@@ -0,0 +1,3 @@
+export { Popover, PopoverClose, PopoverSurface, PopoverTrigger } from "./Popover.js";
+export type { AnchorAlign, AnchorSide, PopoverCloseOwnProps, PopoverCloseProps, PopoverSurfaceMode, PopoverSurfaceOwnProps, PopoverSurfaceProps, PopoverTriggerAction, PopoverTriggerOwnProps, PopoverTriggerProps, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/elements/popover/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/elements/popover/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrF,YAAY,EACV,WAAW,EACX,UAAU,EACV,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/elements/popover/index.js

@@ -0,0 +1,8 @@
+import { Popover, PopoverClose, PopoverSurface, PopoverTrigger } from "./Popover.js";
+export {
+  Popover,
+  PopoverClose,
+  PopoverSurface,
+  PopoverTrigger
+};
+//# sourceMappingURL=index.js.map

package/dist/elements/popover/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/elements/popover/index.ts"],"sourcesContent":["export { Popover, PopoverClose, PopoverSurface, PopoverTrigger } from \"./Popover.js\";\nexport type {\n  AnchorAlign,\n  AnchorSide,\n  PopoverCloseOwnProps,\n  PopoverCloseProps,\n  PopoverSurfaceMode,\n  PopoverSurfaceOwnProps,\n  PopoverSurfaceProps,\n  PopoverTriggerAction,\n  PopoverTriggerOwnProps,\n  PopoverTriggerProps,\n} from \"./types.js\";\n"],"mappings":"AAAA,SAAS,SAAS,cAAc,gBAAgB,sBAAsB;","names":[]}

package/dist/elements/popover/types.d.ts

@@ -0,0 +1,33 @@
+import type { ComponentPropsWithRef, ElementType, ReactNode } from "react";
+import type { NativeButtonProps } from "@gunkin/uiify/core/render";
+/** Cross-engine baseline; `hint` is not part of this element's contract. */
+export type PopoverSurfaceMode = "auto" | "manual";
+export type AnchorSide = "top" | "right" | "bottom" | "left";
+export type AnchorAlign = "start" | "center" | "end";
+/** What a trigger does to its target popover when activated. */
+export type PopoverTriggerAction = "toggle" | "show" | "hide";
+export interface PopoverTriggerOwnProps {
+    readonly children?: ReactNode;
+    /** Defaults to `"toggle"`. */
+    readonly action?: PopoverTriggerAction;
+    /** `id` of the `Popover.Surface` this button acts on. */
+    readonly target: string;
+}
+export type PopoverTriggerProps<TAs extends ElementType = "button"> = NativeButtonProps<TAs, PopoverTriggerOwnProps>;
+export interface PopoverCloseOwnProps {
+    readonly children?: ReactNode;
+    /** `id` of the `Popover.Surface` this button hides. */
+    readonly target: string;
+}
+export type PopoverCloseProps<TAs extends ElementType = "button"> = NativeButtonProps<TAs, PopoverCloseOwnProps>;
+export interface PopoverSurfaceOwnProps {
+    readonly align?: AnchorAlign;
+    readonly children?: ReactNode;
+    /** Unique id supplied by the consumer; referenced by trigger and close `target`. */
+    readonly id: string;
+    readonly mode?: PopoverSurfaceMode;
+    readonly side?: AnchorSide;
+}
+/** `popover`, `data-side`, `data-align` and `data-positioning` are owned by the element. */
+export type PopoverSurfaceProps = PopoverSurfaceOwnProps & Omit<ComponentPropsWithRef<"div">, keyof PopoverSurfaceOwnProps | "popover">;
+//# sourceMappingURL=types.d.ts.map

package/dist/elements/popover/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/elements/popover/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,4EAA4E;AAC5E,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnD,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7D,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAErD,gEAAgE;AAChE,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC;IACvC,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,mBAAmB,CAAC,GAAG,SAAS,WAAW,GAAG,QAAQ,IAAI,iBAAiB,CACrF,GAAG,EACH,sBAAsB,CACvB,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,iBAAiB,CAAC,GAAG,SAAS,WAAW,GAAG,QAAQ,IAAI,iBAAiB,CACnF,GAAG,EACH,oBAAoB,CACrB,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B,oFAAoF;IACpF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;CAC5B;AAED,4FAA4F;AAC5F,MAAM,MAAM,mBAAmB,GAAG,sBAAsB,GACtD,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,MAAM,sBAAsB,GAAG,SAAS,CAAC,CAAC"}

package/dist/elements/popover/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/elements/popover/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/elements/popover.d.ts

@@ -0,0 +1 @@
+export * from "./popover/index.js";

package/dist/elements/popover.js

@@ -0,0 +1 @@
+export * from "./popover/index.js";

package/dist/hooks/index.d.ts

@@ -0,0 +1,36 @@
+export { useIsomorphicLayoutEffect } from "./use-isomorphic-layout-effect.js";
+export { useEventCallback } from "./use-event-callback.js";
+export { useIsMounted } from "./use-is-mounted.js";
+export { useUnmount } from "./use-unmount.js";
+export { useMergedRefs } from "./use-merged-refs.js";
+export { useId } from "./use-id.js";
+export { usePrevious } from "./use-previous.js";
+export { useToggle } from "./use-toggle.js";
+export { useControllableState } from "./use-controllable-state.js";
+export type { UseControllableStateParams } from "./use-controllable-state.js";
+export { useLocalStorage } from "./use-local-storage.js";
+export { useUpdateEffect } from "./use-update-effect.js";
+export { useTimeout } from "./use-timeout.js";
+export { useInterval } from "./use-interval.js";
+export { useDebounce } from "./use-debounce.js";
+export { useDebouncedCallback } from "./use-debounced-callback.js";
+export type { DebouncedFn } from "./use-debounced-callback.js";
+export { useThrottledCallback } from "./use-throttled-callback.js";
+export type { ThrottledFn } from "./use-throttled-callback.js";
+export { useEventListener } from "./use-event-listener.js";
+export { useMediaQuery } from "./use-media-query.js";
+export { useResizeObserver } from "./use-resize-observer.js";
+export type { Size } from "./use-resize-observer.js";
+export { useIntersectionObserver } from "./use-intersection-observer.js";
+export type { UseIntersectionObserverOptions } from "./use-intersection-observer.js";
+export { useWindowSize } from "./use-window-size.js";
+export type { WindowSize } from "./use-window-size.js";
+export { computeAnchoredScrollOffset, useChartViewport } from "./use-chart-viewport.js";
+export type { UseChartViewportOptions, UseChartViewportResult } from "./use-chart-viewport.js";
+export { useClickOutside } from "./use-click-outside.js";
+export { useFocusWithin } from "./use-focus-within.js";
+export type { UseFocusWithinProps, UseFocusWithinResult } from "./use-focus-within.js";
+export { useHover } from "./use-hover.js";
+export type { UseHoverResult } from "./use-hover.js";
+export { useLockBodyScroll } from "./use-lock-body-scroll.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,YAAY,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACxF,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAG/F,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,56 @@
+import { useIsomorphicLayoutEffect } from "./use-isomorphic-layout-effect.js";
+import { useEventCallback } from "./use-event-callback.js";
+import { useIsMounted } from "./use-is-mounted.js";
+import { useUnmount } from "./use-unmount.js";
+import { useMergedRefs } from "./use-merged-refs.js";
+import { useId } from "./use-id.js";
+import { usePrevious } from "./use-previous.js";
+import { useToggle } from "./use-toggle.js";
+import { useControllableState } from "./use-controllable-state.js";
+import { useLocalStorage } from "./use-local-storage.js";
+import { useUpdateEffect } from "./use-update-effect.js";
+import { useTimeout } from "./use-timeout.js";
+import { useInterval } from "./use-interval.js";
+import { useDebounce } from "./use-debounce.js";
+import { useDebouncedCallback } from "./use-debounced-callback.js";
+import { useThrottledCallback } from "./use-throttled-callback.js";
+import { useEventListener } from "./use-event-listener.js";
+import { useMediaQuery } from "./use-media-query.js";
+import { useResizeObserver } from "./use-resize-observer.js";
+import { useIntersectionObserver } from "./use-intersection-observer.js";
+import { useWindowSize } from "./use-window-size.js";
+import { computeAnchoredScrollOffset, useChartViewport } from "./use-chart-viewport.js";
+import { useClickOutside } from "./use-click-outside.js";
+import { useFocusWithin } from "./use-focus-within.js";
+import { useHover } from "./use-hover.js";
+import { useLockBodyScroll } from "./use-lock-body-scroll.js";
+export {
+  computeAnchoredScrollOffset,
+  useChartViewport,
+  useClickOutside,
+  useControllableState,
+  useDebounce,
+  useDebouncedCallback,
+  useEventCallback,
+  useEventListener,
+  useFocusWithin,
+  useHover,
+  useId,
+  useIntersectionObserver,
+  useInterval,
+  useIsMounted,
+  useIsomorphicLayoutEffect,
+  useLocalStorage,
+  useLockBodyScroll,
+  useMediaQuery,
+  useMergedRefs,
+  usePrevious,
+  useResizeObserver,
+  useThrottledCallback,
+  useTimeout,
+  useToggle,
+  useUnmount,
+  useUpdateEffect,
+  useWindowSize
+};
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/index.ts"],"sourcesContent":["// @gunkin/uiify/hooks — public API barrel. One re-export per hook.\n\n// Substrate\nexport { useIsomorphicLayoutEffect } from \"./use-isomorphic-layout-effect.js\";\nexport { useEventCallback } from \"./use-event-callback.js\";\nexport { useIsMounted } from \"./use-is-mounted.js\";\nexport { useUnmount } from \"./use-unmount.js\";\nexport { useMergedRefs } from \"./use-merged-refs.js\";\nexport { useId } from \"./use-id.js\";\n\n// State\nexport { usePrevious } from \"./use-previous.js\";\nexport { useToggle } from \"./use-toggle.js\";\nexport { useControllableState } from \"./use-controllable-state.js\";\nexport type { UseControllableStateParams } from \"./use-controllable-state.js\";\nexport { useLocalStorage } from \"./use-local-storage.js\";\n\n// Effects / timing\nexport { useUpdateEffect } from \"./use-update-effect.js\";\nexport { useTimeout } from \"./use-timeout.js\";\nexport { useInterval } from \"./use-interval.js\";\nexport { useDebounce } from \"./use-debounce.js\";\nexport { useDebouncedCallback } from \"./use-debounced-callback.js\";\nexport type { DebouncedFn } from \"./use-debounced-callback.js\";\nexport { useThrottledCallback } from \"./use-throttled-callback.js\";\nexport type { ThrottledFn } from \"./use-throttled-callback.js\";\n\n// Sensors\nexport { useEventListener } from \"./use-event-listener.js\";\nexport { useMediaQuery } from \"./use-media-query.js\";\nexport { useResizeObserver } from \"./use-resize-observer.js\";\nexport type { Size } from \"./use-resize-observer.js\";\nexport { useIntersectionObserver } from \"./use-intersection-observer.js\";\nexport type { UseIntersectionObserverOptions } from \"./use-intersection-observer.js\";\nexport { useWindowSize } from \"./use-window-size.js\";\nexport type { WindowSize } from \"./use-window-size.js\";\nexport { computeAnchoredScrollOffset, useChartViewport } from \"./use-chart-viewport.js\";\nexport type { UseChartViewportOptions, UseChartViewportResult } from \"./use-chart-viewport.js\";\n\n// UI / interaction\nexport { useClickOutside } from \"./use-click-outside.js\";\nexport { useFocusWithin } from \"./use-focus-within.js\";\nexport type { UseFocusWithinProps, UseFocusWithinResult } from \"./use-focus-within.js\";\nexport { useHover } from \"./use-hover.js\";\nexport type { UseHoverResult } from \"./use-hover.js\";\nexport { useLockBodyScroll } from \"./use-lock-body-scroll.js\";\n"],"mappings":"AAGA,SAAS,iCAAiC;AAC1C,SAAS,wBAAwB;AACjC,SAAS,oBAAoB;AAC7B,SAAS,kBAAkB;AAC3B,SAAS,qBAAqB;AAC9B,SAAS,aAAa;AAGtB,SAAS,mBAAmB;AAC5B,SAAS,iBAAiB;AAC1B,SAAS,4BAA4B;AAErC,SAAS,uBAAuB;AAGhC,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAC3B,SAAS,mBAAmB;AAC5B,SAAS,mBAAmB;AAC5B,SAAS,4BAA4B;AAErC,SAAS,4BAA4B;AAIrC,SAAS,wBAAwB;AACjC,SAAS,qBAAqB;AAC9B,SAAS,yBAAyB;AAElC,SAAS,+BAA+B;AAExC,SAAS,qBAAqB;AAE9B,SAAS,6BAA6B,wBAAwB;AAI9D,SAAS,uBAAuB;AAChC,SAAS,sBAAsB;AAE/B,SAAS,gBAAgB;AAEzB,SAAS,yBAAyB;","names":[]}

package/dist/hooks/use-chart-viewport.d.ts

@@ -0,0 +1,33 @@
+import type { RefObject } from "react";
+interface ChartWheelEvent {
+    readonly deltaX: number;
+    readonly deltaY: number;
+    readonly shiftKey: boolean;
+    preventDefault(): void;
+}
+export interface UseChartViewportOptions {
+    readonly enabled?: boolean;
+    readonly itemCount: number;
+    readonly initialScale?: number;
+    readonly maxScale?: number;
+    readonly minScale?: number;
+    readonly minItemWidth?: number;
+    /**
+     * Chrome reserved outside the scrollable item track (e.g. a fixed-width
+     * axis column plus its grid gap) that `ref`'s measured element includes
+     * but that isn't available to the items themselves. Subtracted from the
+     * measured width before it's used to size `minItemWidth`.
+     */
+    readonly measuredWidthOffset?: number;
+}
+export interface UseChartViewportResult {
+    readonly onWheel: (event: ChartWheelEvent) => void;
+    readonly ref: RefObject<HTMLElement | null>;
+    readonly reset: () => void;
+    readonly scale: number;
+    readonly itemWidth: number;
+}
+export declare function computeAnchoredScrollOffset(index: number, previousItemWidth: number, nextItemWidth: number, previousScrollOffset: number): number;
+export declare function useChartViewport(options: UseChartViewportOptions): UseChartViewportResult;
+export {};
+//# sourceMappingURL=use-chart-viewport.d.ts.map

package/dist/hooks/use-chart-viewport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-chart-viewport.d.ts","sourceRoot":"","sources":["../../src/hooks/use-chart-viewport.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,UAAU,eAAe;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,cAAc,IAAI,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IACnD,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAUD,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,MAAM,EACb,iBAAiB,EAAE,MAAM,EACzB,aAAa,EAAE,MAAM,EACrB,oBAAoB,EAAE,MAAM,GAC3B,MAAM,CAGR;AAyBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CAiDzF"}

package/dist/hooks/use-chart-viewport.js

@@ -0,0 +1,60 @@
+"use client";
+import { useCallback, useRef, useState } from "react";
+import { useEventListener } from "./use-event-listener.js";
+import { useResizeObserver } from "./use-resize-observer.js";
+const DEFAULT_INITIAL_SCALE = 3.2;
+const DEFAULT_MIN_SCALE = 1;
+const ZOOM_FACTOR = 1.2;
+function clamp(value, min, max) {
+  return Math.min(max, Math.max(min, value));
+}
+function computeAnchoredScrollOffset(index, previousItemWidth, nextItemWidth, previousScrollOffset) {
+  const viewportOffset = (index + 0.5) * previousItemWidth - previousScrollOffset;
+  return (index + 0.5) * nextItemWidth - viewportOffset;
+}
+function maxScaleFor(itemCount) {
+  return itemCount > 1 ? itemCount / 2 : 1;
+}
+function boundsFor(options, measuredWidth) {
+  const ceiling = maxScaleFor(options.itemCount);
+  const measuredMin = measuredWidth > 0 && options.minItemWidth !== void 0 ? options.minItemWidth * options.itemCount / measuredWidth : DEFAULT_MIN_SCALE;
+  const min = Math.min(ceiling, Math.max(1, options.minScale ?? DEFAULT_MIN_SCALE, measuredMin));
+  const max = Math.max(min, Math.min(options.maxScale ?? ceiling, ceiling));
+  const initial = clamp(options.initialScale ?? DEFAULT_INITIAL_SCALE, min, max);
+  return { initial, max, min };
+}
+function useChartViewport(options) {
+  const ref = useRef(null);
+  const measuredSize = useResizeObserver(ref);
+  const measuredWidth = Math.max(
+    0,
+    (measuredSize?.width ?? 0) - (options.measuredWidthOffset ?? 0)
+  );
+  const enabled = options.enabled ?? true;
+  const { initial, max, min } = boundsFor(options, measuredWidth);
+  const [rawScale, setScale] = useState(initial);
+  const scale = clamp(rawScale, min, max);
+  const onWheel = useCallback(
+    (event) => {
+      const horizontalDelta = event.shiftKey ? event.deltaY : event.deltaX;
+      const isHorizontal = horizontalDelta !== 0 && (event.shiftKey || Math.abs(event.deltaX) > Math.abs(event.deltaY));
+      if (!enabled || isHorizontal) return;
+      if (event.deltaY === 0) return;
+      event.preventDefault();
+      const factor = event.deltaY < 0 ? ZOOM_FACTOR : 1 / ZOOM_FACTOR;
+      setScale((current) => clamp(clamp(current, min, max) * factor, min, max));
+    },
+    [enabled, max, min]
+  );
+  useEventListener("wheel", onWheel, enabled ? ref : null, { passive: false });
+  const reset = useCallback(() => {
+    setScale(initial);
+  }, [initial]);
+  const itemWidth = measuredWidth > 0 && options.itemCount > 0 ? Math.max(options.minItemWidth ?? 0, measuredWidth * scale / options.itemCount) : options.minItemWidth ?? 0;
+  return { itemWidth, onWheel, ref, reset, scale };
+}
+export {
+  computeAnchoredScrollOffset,
+  useChartViewport
+};
+//# sourceMappingURL=use-chart-viewport.js.map