@alneas/appkit-react 0.1.0 → 0.2.0

package/dist/ui/components/ui/toolbar.d.ts

@@ -3,33 +3,120 @@ import { ToggleGroup as ToggleGroupPrimitive } from '@base-ui/react/toggle-group
 import { Toggle as TogglePrimitive } from '@base-ui/react/toggle';
 import * as React from 'react';
 /**
- * ツールバーのルートコンテナ。
+ * Coordinates keyboard navigation for a horizontal action toolbar.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered Toolbar composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose buttons/links/groups under Toolbar and toggle items under ToolbarToggleGroup. Base UI owns focus navigation and pressed selection. Callbacks and navigation effects remain host-owned.
+ * @example
+ * ```tsx
+ * import { Toolbar, ToolbarGroup, ToolbarButton, ToolbarSeparator, ToolbarLink, ToolbarToggleGroup, ToolbarToggleItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Toolbar aria-label="Editor"><ToolbarGroup><ToolbarButton>Save</ToolbarButton><ToolbarLink href="/help">Help</ToolbarLink></ToolbarGroup><ToolbarSeparator /><ToolbarToggleGroup defaultValue={["bold"]}><ToolbarToggleItem value="bold" aria-label="Bold">B</ToolbarToggleItem></ToolbarToggleGroup></Toolbar>);
+ * }
+ * ```
  */
 declare function Toolbar({ className, ...props }: React.ComponentProps<typeof ToolbarPrimitive.Root>): React.JSX.Element;
 /**
- * ツールバー内のアイテムをグループ化するためのコンポーネント。
+ * Lays out a related group of toolbar controls.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ToolbarGroup composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose buttons/links/groups under Toolbar and toggle items under ToolbarToggleGroup. Base UI owns focus navigation and pressed selection. Callbacks and navigation effects remain host-owned.
+ * @example
+ * ```tsx
+ * import { Toolbar, ToolbarGroup, ToolbarButton, ToolbarSeparator, ToolbarLink, ToolbarToggleGroup, ToolbarToggleItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Toolbar aria-label="Editor"><ToolbarGroup><ToolbarButton>Save</ToolbarButton><ToolbarLink href="/help">Help</ToolbarLink></ToolbarGroup><ToolbarSeparator /><ToolbarToggleGroup defaultValue={["bold"]}><ToolbarToggleItem value="bold" aria-label="Bold">B</ToolbarToggleItem></ToolbarToggleGroup></Toolbar>);
+ * }
+ * ```
  */
 declare function ToolbarGroup({ className, ...props }: React.ComponentProps<typeof ToolbarPrimitive.Group>): React.JSX.Element;
 /**
- * ツールバー内に配置されるアクション実行用ボタン。
+ * Renders an action button participating in toolbar focus navigation.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ToolbarButton composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose buttons/links/groups under Toolbar and toggle items under ToolbarToggleGroup. Base UI owns focus navigation and pressed selection. Callbacks and navigation effects remain host-owned.
+ * @example
+ * ```tsx
+ * import { Toolbar, ToolbarGroup, ToolbarButton, ToolbarSeparator, ToolbarLink, ToolbarToggleGroup, ToolbarToggleItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Toolbar aria-label="Editor"><ToolbarGroup><ToolbarButton>Save</ToolbarButton><ToolbarLink href="/help">Help</ToolbarLink></ToolbarGroup><ToolbarSeparator /><ToolbarToggleGroup defaultValue={["bold"]}><ToolbarToggleItem value="bold" aria-label="Bold">B</ToolbarToggleItem></ToolbarToggleGroup></Toolbar>);
+ * }
+ * ```
  */
 declare function ToolbarButton({ className, ...props }: React.ComponentProps<typeof ToolbarPrimitive.Button>): React.JSX.Element;
 /**
- * ツールバー内のグループやアイテム同士を区切るためのセパレーター。
+ * Separates toolbar control groups with a vertical rule.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ToolbarSeparator composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose buttons/links/groups under Toolbar and toggle items under ToolbarToggleGroup. Base UI owns focus navigation and pressed selection. Callbacks and navigation effects remain host-owned.
+ * @example
+ * ```tsx
+ * import { Toolbar, ToolbarGroup, ToolbarButton, ToolbarSeparator, ToolbarLink, ToolbarToggleGroup, ToolbarToggleItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Toolbar aria-label="Editor"><ToolbarGroup><ToolbarButton>Save</ToolbarButton><ToolbarLink href="/help">Help</ToolbarLink></ToolbarGroup><ToolbarSeparator /><ToolbarToggleGroup defaultValue={["bold"]}><ToolbarToggleItem value="bold" aria-label="Bold">B</ToolbarToggleItem></ToolbarToggleGroup></Toolbar>);
+ * }
+ * ```
  */
 declare function ToolbarSeparator({ className, ...props }: React.ComponentProps<typeof ToolbarPrimitive.Separator>): React.JSX.Element;
 /**
- * ツールバー内に配置されるナビゲーション用のリンク。
+ * Renders a navigation link participating in toolbar focus navigation.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ToolbarLink composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose buttons/links/groups under Toolbar and toggle items under ToolbarToggleGroup. Base UI owns focus navigation and pressed selection. Callbacks and navigation effects remain host-owned.
+ * @example
+ * ```tsx
+ * import { Toolbar, ToolbarGroup, ToolbarButton, ToolbarSeparator, ToolbarLink, ToolbarToggleGroup, ToolbarToggleItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Toolbar aria-label="Editor"><ToolbarGroup><ToolbarButton>Save</ToolbarButton><ToolbarLink href="/help">Help</ToolbarLink></ToolbarGroup><ToolbarSeparator /><ToolbarToggleGroup defaultValue={["bold"]}><ToolbarToggleItem value="bold" aria-label="Bold">B</ToolbarToggleItem></ToolbarToggleGroup></Toolbar>);
+ * }
+ * ```
  */
 declare function ToolbarLink({ className, ...props }: React.ComponentProps<typeof ToolbarPrimitive.Link>): React.JSX.Element;
 /**
- * オン・オフの状態を切り替えるトグル式のツールバーアイテム。
+ * Renders one value-bearing Base UI toggle within a toolbar toggle group.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ToolbarToggleItem composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose buttons/links/groups under Toolbar and toggle items under ToolbarToggleGroup. Base UI owns focus navigation and pressed selection. Callbacks and navigation effects remain host-owned.
+ * @example
+ * ```tsx
+ * import { Toolbar, ToolbarGroup, ToolbarButton, ToolbarSeparator, ToolbarLink, ToolbarToggleGroup, ToolbarToggleItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Toolbar aria-label="Editor"><ToolbarGroup><ToolbarButton>Save</ToolbarButton><ToolbarLink href="/help">Help</ToolbarLink></ToolbarGroup><ToolbarSeparator /><ToolbarToggleGroup defaultValue={["bold"]}><ToolbarToggleItem value="bold" aria-label="Bold">B</ToolbarToggleItem></ToolbarToggleGroup></Toolbar>);
+ * }
+ * ```
  */
 declare function ToolbarToggleItem({ className, ...props }: React.ComponentProps<typeof TogglePrimitive> & {
+    /**
+     * Identity for this choice within the surrounding group; provide a distinct stable string.
+     */
     value: string;
 }): React.JSX.Element;
 /**
- * 複数のトグルアイテムをまとめて選択状態を管理するグループコンポーネント。
+ * Coordinates a value collection of toggle buttons within a toolbar.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ToolbarToggleGroup composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose buttons/links/groups under Toolbar and toggle items under ToolbarToggleGroup. Base UI owns focus navigation and pressed selection. Callbacks and navigation effects remain host-owned.
+ * @example
+ * ```tsx
+ * import { Toolbar, ToolbarGroup, ToolbarButton, ToolbarSeparator, ToolbarLink, ToolbarToggleGroup, ToolbarToggleItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Toolbar aria-label="Editor"><ToolbarGroup><ToolbarButton>Save</ToolbarButton><ToolbarLink href="/help">Help</ToolbarLink></ToolbarGroup><ToolbarSeparator /><ToolbarToggleGroup defaultValue={["bold"]}><ToolbarToggleItem value="bold" aria-label="Bold">B</ToolbarToggleItem></ToolbarToggleGroup></Toolbar>);
+ * }
+ * ```
  */
 declare function ToolbarToggleGroup({ className, ...props }: React.ComponentProps<typeof ToggleGroupPrimitive>): React.JSX.Element;
 export { Toolbar, ToolbarGroup, ToolbarButton, ToolbarSeparator, ToolbarLink, ToolbarToggleGroup, ToolbarToggleItem, };

package/dist/ui/components/ui/toolbar.js.map

@@ -1 +1 @@
-{"version":3,"file":"toolbar.js","names":["ToolbarPrimitive","TogglePrimitive","ToggleGroupPrimitive","Toolbar$1","Toolbar","props","cn","className","ToolbarGroup","ToolbarButton","ToolbarSeparator","ToolbarLink","ToolbarToggleItem","Toggle","ToolbarToggleGroup","ToggleGroup"],"sources":["../../../../src/ui/components/ui/toolbar.tsx"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { Toolbar as ToolbarPrimitive } from '@base-ui/react/toolbar';\nimport { ToggleGroup as ToggleGroupPrimitive } from '@base-ui/react/toggle-group';\nimport { Toggle as TogglePrimitive } from '@base-ui/react/toggle';\nimport { cn } from '../../lib/utils';\n\n/**\n * ツールバーのルートコンテナ。\n */\nfunction Toolbar({ className, ...props }: React.ComponentProps<typeof ToolbarPrimitive.Root>) {\n  return (\n    <ToolbarPrimitive.Root\n      data-slot='toolbar'\n      className={cn(\n        'flex h-10 items-center justify-between rounded-md border bg-background p-1',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n/**\n * ツールバー内のアイテムをグループ化するためのコンポーネント。\n */\nfunction ToolbarGroup({\n  className,\n  ...props\n}: React.ComponentProps<typeof ToolbarPrimitive.Group>) {\n  return (\n    <ToolbarPrimitive.Group\n      data-slot='toolbar-group'\n      className={cn('flex items-center gap-1', className)}\n      {...props}\n    />\n  );\n}\n\n/**\n * ツールバー内に配置されるアクション実行用ボタン。\n */\nfunction ToolbarButton({\n  className,\n  ...props\n}: React.ComponentProps<typeof ToolbarPrimitive.Button>) {\n  return (\n    <ToolbarPrimitive.Button\n      data-slot='toolbar-button'\n      className={cn(\n        'inline-flexitems-center justify-center whitespace-nowrap rounded-sm px-2.5 py-1.5 text-sm font-medium ring-offset-background transition-all focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 data-[state=on]:bg-accent data-[state=on]:text-accent-foreground hover:bg-muted hover:text-muted-foreground',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n/**\n * ツールバー内のグループやアイテム同士を区切るためのセパレーター。\n */\nfunction ToolbarSeparator({\n  className,\n  ...props\n}: React.ComponentProps<typeof ToolbarPrimitive.Separator>) {\n  return (\n    <ToolbarPrimitive.Separator\n      data-slot='toolbar-separator'\n      className={cn('mx-1 h-5 w-[1px] bg-border', className)}\n      {...props}\n    />\n  );\n}\n\n/**\n * ツールバー内に配置されるナビゲーション用のリンク。\n */\nfunction ToolbarLink({ className, ...props }: React.ComponentProps<typeof ToolbarPrimitive.Link>) {\n  return (\n    <ToolbarPrimitive.Link\n      data-slot='toolbar-link'\n      className={cn(\n        'inline-flex items-center justify-center whitespace-nowrap rounded-sm px-2.5 py-1.5 text-sm font-medium ring-offset-background transition-all focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 hover:bg-muted hover:text-muted-foreground data-[state=active]:bg-accent data-[state=active]:text-accent-foreground',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n/**\n * オン・オフの状態を切り替えるトグル式のツールバーアイテム。\n */\nfunction ToolbarToggleItem({\n  className,\n  ...props\n}: React.ComponentProps<typeof TogglePrimitive> & { value: string }) {\n  return (\n    <TogglePrimitive\n      data-slot='toolbar-toggle-item'\n      className={cn(\n        'inline-flex items-center justify-center rounded-md text-sm font-medium transition-colors hover:bg-muted hover:text-muted-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50 data-[pressed]:bg-accent data-[pressed]:text-accent-foreground p-2',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n/**\n * 複数のトグルアイテムをまとめて選択状態を管理するグループコンポーネント。\n */\nfunction ToolbarToggleGroup({\n  className,\n  ...props\n}: React.ComponentProps<typeof ToggleGroupPrimitive>) {\n  return (\n    <ToggleGroupPrimitive\n      data-slot='toolbar-toggle-group'\n      className={cn('flex items-center gap-1', className)}\n      {...props}\n    />\n  );\n}\n\nexport {\n  Toolbar,\n  ToolbarGroup,\n  ToolbarButton,\n  ToolbarSeparator,\n  ToolbarLink,\n  ToolbarToggleGroup,\n  ToolbarToggleItem,\n};\n"],"mappings":";;;;;;;;;AAWA,SAASI,EAAQ,EAAE,cAAW,GAAGC,KAA6D;CAC5F,OACE,kBAACL,EAAiB,MAAlB;EACE,aAAU;EACV,WAAWM,EACT,8EACAC,CACF;EACA,GAAIF;CACL,CAAA;AAEL;AAKA,SAASG,EAAa,EACpB,cACA,GAAGH,KACmD;CACtD,OACE,kBAACL,EAAiB,OAAlB;EACE,aAAU;EACV,WAAWM,EAAG,2BAA2BC,CAAS;EAClD,GAAIF;CACL,CAAA;AAEL;AAKA,SAASI,EAAc,EACrB,cACA,GAAGJ,KACoD;CACvD,OACE,kBAACL,EAAiB,QAAlB;EACE,aAAU;EACV,WAAWM,EACT,gZACAC,CACF;EACA,GAAIF;CACL,CAAA;AAEL;AAKA,SAASK,EAAiB,EACxB,cACA,GAAGL,KACuD;CAC1D,OACE,kBAACL,EAAiB,WAAlB;EACE,aAAU;EACV,WAAWM,EAAG,8BAA8BC,CAAS;EACrD,GAAIF;CACL,CAAA;AAEL;AAKA,SAASM,EAAY,EAAE,cAAW,GAAGN,KAA6D;CAChG,OACE,kBAACL,EAAiB,MAAlB;EACE,aAAU;EACV,WAAWM,EACT,yZACAC,CACF;EACA,GAAIF;CACL,CAAA;AAEL;AAKA,SAASO,EAAkB,EACzB,cACA,GAAGP,KACgE;CACnE,OACE,kBAACJ,GAAD;EACE,aAAU;EACV,WAAWK,EACT,mUACAC,CACF;EACA,GAAIF;CACL,CAAA;AAEL;AAKA,SAASS,EAAmB,EAC1B,cACA,GAAGT,KACiD;CACpD,OACE,kBAACH,GAAD;EACE,aAAU;EACV,WAAWI,EAAG,2BAA2BC,CAAS;EAClD,GAAIF;CACL,CAAA;AAEL"}
+{"version":3,"file":"toolbar.js","names":["ToolbarPrimitive","TogglePrimitive","ToggleGroupPrimitive","Toolbar$1","Toolbar","props","cn","className","ToolbarGroup","ToolbarButton","ToolbarSeparator","ToolbarLink","ToolbarToggleItem","Toggle","ToolbarToggleGroup","ToggleGroup"],"sources":["../../../../src/ui/components/ui/toolbar.tsx"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { Toolbar as ToolbarPrimitive } from '@base-ui/react/toolbar';\nimport { ToggleGroup as ToggleGroupPrimitive } from '@base-ui/react/toggle-group';\nimport { Toggle as TogglePrimitive } from '@base-ui/react/toggle';\nimport { cn } from '../../lib/utils';\n\n/**\n * Coordinates keyboard navigation for a horizontal action toolbar.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.\n * @returns The rendered Toolbar composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose buttons/links/groups under Toolbar and toggle items under ToolbarToggleGroup. Base UI owns focus navigation and pressed selection. Callbacks and navigation effects remain host-owned.\n * @example\n * ```tsx\n * import { Toolbar, ToolbarGroup, ToolbarButton, ToolbarSeparator, ToolbarLink, ToolbarToggleGroup, ToolbarToggleItem } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<Toolbar aria-label=\"Editor\"><ToolbarGroup><ToolbarButton>Save</ToolbarButton><ToolbarLink href=\"/help\">Help</ToolbarLink></ToolbarGroup><ToolbarSeparator /><ToolbarToggleGroup defaultValue={[\"bold\"]}><ToolbarToggleItem value=\"bold\" aria-label=\"Bold\">B</ToolbarToggleItem></ToolbarToggleGroup></Toolbar>);\n * }\n * ```\n */\nfunction Toolbar({ className, ...props }: React.ComponentProps<typeof ToolbarPrimitive.Root>) {\n  return (\n    <ToolbarPrimitive.Root\n      data-slot='toolbar'\n      className={cn(\n        'flex h-10 items-center justify-between rounded-md border bg-background p-1',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n/**\n * Lays out a related group of toolbar controls.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.\n * @returns The rendered ToolbarGroup composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose buttons/links/groups under Toolbar and toggle items under ToolbarToggleGroup. Base UI owns focus navigation and pressed selection. Callbacks and navigation effects remain host-owned.\n * @example\n * ```tsx\n * import { Toolbar, ToolbarGroup, ToolbarButton, ToolbarSeparator, ToolbarLink, ToolbarToggleGroup, ToolbarToggleItem } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<Toolbar aria-label=\"Editor\"><ToolbarGroup><ToolbarButton>Save</ToolbarButton><ToolbarLink href=\"/help\">Help</ToolbarLink></ToolbarGroup><ToolbarSeparator /><ToolbarToggleGroup defaultValue={[\"bold\"]}><ToolbarToggleItem value=\"bold\" aria-label=\"Bold\">B</ToolbarToggleItem></ToolbarToggleGroup></Toolbar>);\n * }\n * ```\n */\nfunction ToolbarGroup({\n  className,\n  ...props\n}: React.ComponentProps<typeof ToolbarPrimitive.Group>) {\n  return (\n    <ToolbarPrimitive.Group\n      data-slot='toolbar-group'\n      className={cn('flex items-center gap-1', className)}\n      {...props}\n    />\n  );\n}\n\n/**\n * Renders an action button participating in toolbar focus navigation.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.\n * @returns The rendered ToolbarButton composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose buttons/links/groups under Toolbar and toggle items under ToolbarToggleGroup. Base UI owns focus navigation and pressed selection. Callbacks and navigation effects remain host-owned.\n * @example\n * ```tsx\n * import { Toolbar, ToolbarGroup, ToolbarButton, ToolbarSeparator, ToolbarLink, ToolbarToggleGroup, ToolbarToggleItem } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<Toolbar aria-label=\"Editor\"><ToolbarGroup><ToolbarButton>Save</ToolbarButton><ToolbarLink href=\"/help\">Help</ToolbarLink></ToolbarGroup><ToolbarSeparator /><ToolbarToggleGroup defaultValue={[\"bold\"]}><ToolbarToggleItem value=\"bold\" aria-label=\"Bold\">B</ToolbarToggleItem></ToolbarToggleGroup></Toolbar>);\n * }\n * ```\n */\nfunction ToolbarButton({\n  className,\n  ...props\n}: React.ComponentProps<typeof ToolbarPrimitive.Button>) {\n  return (\n    <ToolbarPrimitive.Button\n      data-slot='toolbar-button'\n      className={cn(\n        'inline-flexitems-center justify-center whitespace-nowrap rounded-sm px-2.5 py-1.5 text-sm font-medium ring-offset-background transition-all focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 data-[state=on]:bg-accent data-[state=on]:text-accent-foreground hover:bg-muted hover:text-muted-foreground',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n/**\n * Separates toolbar control groups with a vertical rule.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.\n * @returns The rendered ToolbarSeparator composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose buttons/links/groups under Toolbar and toggle items under ToolbarToggleGroup. Base UI owns focus navigation and pressed selection. Callbacks and navigation effects remain host-owned.\n * @example\n * ```tsx\n * import { Toolbar, ToolbarGroup, ToolbarButton, ToolbarSeparator, ToolbarLink, ToolbarToggleGroup, ToolbarToggleItem } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<Toolbar aria-label=\"Editor\"><ToolbarGroup><ToolbarButton>Save</ToolbarButton><ToolbarLink href=\"/help\">Help</ToolbarLink></ToolbarGroup><ToolbarSeparator /><ToolbarToggleGroup defaultValue={[\"bold\"]}><ToolbarToggleItem value=\"bold\" aria-label=\"Bold\">B</ToolbarToggleItem></ToolbarToggleGroup></Toolbar>);\n * }\n * ```\n */\nfunction ToolbarSeparator({\n  className,\n  ...props\n}: React.ComponentProps<typeof ToolbarPrimitive.Separator>) {\n  return (\n    <ToolbarPrimitive.Separator\n      data-slot='toolbar-separator'\n      className={cn('mx-1 h-5 w-[1px] bg-border', className)}\n      {...props}\n    />\n  );\n}\n\n/**\n * Renders a navigation link participating in toolbar focus navigation.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.\n * @returns The rendered ToolbarLink composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose buttons/links/groups under Toolbar and toggle items under ToolbarToggleGroup. Base UI owns focus navigation and pressed selection. Callbacks and navigation effects remain host-owned.\n * @example\n * ```tsx\n * import { Toolbar, ToolbarGroup, ToolbarButton, ToolbarSeparator, ToolbarLink, ToolbarToggleGroup, ToolbarToggleItem } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<Toolbar aria-label=\"Editor\"><ToolbarGroup><ToolbarButton>Save</ToolbarButton><ToolbarLink href=\"/help\">Help</ToolbarLink></ToolbarGroup><ToolbarSeparator /><ToolbarToggleGroup defaultValue={[\"bold\"]}><ToolbarToggleItem value=\"bold\" aria-label=\"Bold\">B</ToolbarToggleItem></ToolbarToggleGroup></Toolbar>);\n * }\n * ```\n */\nfunction ToolbarLink({ className, ...props }: React.ComponentProps<typeof ToolbarPrimitive.Link>) {\n  return (\n    <ToolbarPrimitive.Link\n      data-slot='toolbar-link'\n      className={cn(\n        'inline-flex items-center justify-center whitespace-nowrap rounded-sm px-2.5 py-1.5 text-sm font-medium ring-offset-background transition-all focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 hover:bg-muted hover:text-muted-foreground data-[state=active]:bg-accent data-[state=active]:text-accent-foreground',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n/**\n * Renders one value-bearing Base UI toggle within a toolbar toggle group.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.\n * @returns The rendered ToolbarToggleItem composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose buttons/links/groups under Toolbar and toggle items under ToolbarToggleGroup. Base UI owns focus navigation and pressed selection. Callbacks and navigation effects remain host-owned.\n * @example\n * ```tsx\n * import { Toolbar, ToolbarGroup, ToolbarButton, ToolbarSeparator, ToolbarLink, ToolbarToggleGroup, ToolbarToggleItem } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<Toolbar aria-label=\"Editor\"><ToolbarGroup><ToolbarButton>Save</ToolbarButton><ToolbarLink href=\"/help\">Help</ToolbarLink></ToolbarGroup><ToolbarSeparator /><ToolbarToggleGroup defaultValue={[\"bold\"]}><ToolbarToggleItem value=\"bold\" aria-label=\"Bold\">B</ToolbarToggleItem></ToolbarToggleGroup></Toolbar>);\n * }\n * ```\n */\nfunction ToolbarToggleItem({\n  className,\n  ...props\n}: React.ComponentProps<typeof TogglePrimitive> & { /**\n * Identity for this choice within the surrounding group; provide a distinct stable string.\n */\n/**\n * Identity for this choice within the surrounding group; provide a distinct stable string.\n */\nvalue: string }) {\n  return (\n    <TogglePrimitive\n      data-slot='toolbar-toggle-item'\n      className={cn(\n        'inline-flex items-center justify-center rounded-md text-sm font-medium transition-colors hover:bg-muted hover:text-muted-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50 data-[pressed]:bg-accent data-[pressed]:text-accent-foreground p-2',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n/**\n * Coordinates a value collection of toggle buttons within a toolbar.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.\n * @returns The rendered ToolbarToggleGroup composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Compose buttons/links/groups under Toolbar and toggle items under ToolbarToggleGroup. Base UI owns focus navigation and pressed selection. Callbacks and navigation effects remain host-owned.\n * @example\n * ```tsx\n * import { Toolbar, ToolbarGroup, ToolbarButton, ToolbarSeparator, ToolbarLink, ToolbarToggleGroup, ToolbarToggleItem } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<Toolbar aria-label=\"Editor\"><ToolbarGroup><ToolbarButton>Save</ToolbarButton><ToolbarLink href=\"/help\">Help</ToolbarLink></ToolbarGroup><ToolbarSeparator /><ToolbarToggleGroup defaultValue={[\"bold\"]}><ToolbarToggleItem value=\"bold\" aria-label=\"Bold\">B</ToolbarToggleItem></ToolbarToggleGroup></Toolbar>);\n * }\n * ```\n */\nfunction ToolbarToggleGroup({\n  className,\n  ...props\n}: React.ComponentProps<typeof ToggleGroupPrimitive>) {\n  return (\n    <ToggleGroupPrimitive\n      data-slot='toolbar-toggle-group'\n      className={cn('flex items-center gap-1', className)}\n      {...props}\n    />\n  );\n}\n\nexport {\n  Toolbar,\n  ToolbarGroup,\n  ToolbarButton,\n  ToolbarSeparator,\n  ToolbarLink,\n  ToolbarToggleGroup,\n  ToolbarToggleItem,\n};\n"],"mappings":";;;;;;;;;AAuBA,SAASI,EAAQ,EAAE,cAAW,GAAGC,KAA6D;CAC5F,OACE,kBAACL,EAAiB,MAAlB;EACE,aAAU;EACV,WAAWM,EACT,8EACAC,CACF;EACA,GAAIF;CACL,CAAA;AAEL;AAiBA,SAASG,EAAa,EACpB,cACA,GAAGH,KACmD;CACtD,OACE,kBAACL,EAAiB,OAAlB;EACE,aAAU;EACV,WAAWM,EAAG,2BAA2BC,CAAS;EAClD,GAAIF;CACL,CAAA;AAEL;AAiBA,SAASI,EAAc,EACrB,cACA,GAAGJ,KACoD;CACvD,OACE,kBAACL,EAAiB,QAAlB;EACE,aAAU;EACV,WAAWM,EACT,gZACAC,CACF;EACA,GAAIF;CACL,CAAA;AAEL;AAiBA,SAASK,EAAiB,EACxB,cACA,GAAGL,KACuD;CAC1D,OACE,kBAACL,EAAiB,WAAlB;EACE,aAAU;EACV,WAAWM,EAAG,8BAA8BC,CAAS;EACrD,GAAIF;CACL,CAAA;AAEL;AAiBA,SAASM,EAAY,EAAE,cAAW,GAAGN,KAA6D;CAChG,OACE,kBAACL,EAAiB,MAAlB;EACE,aAAU;EACV,WAAWM,EACT,yZACAC,CACF;EACA,GAAIF;CACL,CAAA;AAEL;AAiBA,SAASO,EAAkB,EACzB,cACA,GAAGP,KAOY;CACf,OACE,kBAACJ,GAAD;EACE,aAAU;EACV,WAAWK,EACT,mUACAC,CACF;EACA,GAAIF;CACL,CAAA;AAEL;AAiBA,SAASS,EAAmB,EAC1B,cACA,GAAGT,KACiD;CACpD,OACE,kBAACH,GAAD;EACE,aAAU;EACV,WAAWI,EAAG,2BAA2BC,CAAS;EAClD,GAAIF;CACL,CAAA;AAEL"}

package/dist/ui/components/ui/tooltip.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"tooltip.cjs","names":["TooltipPrimitive","React","cn","require_runtime","require_ui_lib_utils","react_jsx_runtime","react","_base_ui_react_tooltip","TooltipProvider","props","Tooltip","TooltipTrigger","TooltipContent","className","children"],"sources":["../../../../src/ui/components/ui/tooltip.tsx"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { Tooltip as TooltipPrimitive } from '@base-ui/react/tooltip';\n\nimport { cn } from '../../lib/utils';\n\n/**\n * ツールチップの表示遅延時間などの設定を子コンポーネントに提供するプロバイダー。\n */\nfunction TooltipProvider({ delay = 0, ...props }: TooltipPrimitive.Provider.Props) {\n  return <TooltipPrimitive.Provider data-slot='tooltip-provider' delay={delay} {...props} />;\n}\n\n/**\n * 要素をホバーまたはフォーカスした際、補足テキスト（ツールチップ）を表示するルートコンポーネント。\n */\nfunction Tooltip({ ...props }: TooltipPrimitive.Root.Props) {\n  return (\n    <TooltipProvider>\n      <TooltipPrimitive.Root data-slot='tooltip' {...props} />\n    </TooltipProvider>\n  );\n}\n\n/**\n * ツールチップを表示するためのトリガー要素（ホバー対象）。\n */\nfunction TooltipTrigger({\n  children,\n  ...props\n}: TooltipPrimitive.Trigger.Props) {\n  return (\n    <TooltipPrimitive.Trigger\n      data-slot='tooltip-trigger'\n      {...props}\n    >\n      {children}\n    </TooltipPrimitive.Trigger>\n  );\n}\n\nconst TooltipContent = React.forwardRef<\n  HTMLDivElement,\n  TooltipPrimitive.Popup.Props &\n    Pick<TooltipPrimitive.Positioner.Props, 'align' | 'alignOffset' | 'side' | 'sideOffset'>\n>(\n  (\n    {\n      className,\n      side = 'top',\n      sideOffset = 4,\n      align = 'center',\n      alignOffset = 0,\n      children,\n      ...props\n    },\n    ref,\n  ) => (\n    <TooltipPrimitive.Portal>\n      <TooltipPrimitive.Positioner\n        align={align}\n        alignOffset={alignOffset}\n        side={side}\n        sideOffset={sideOffset}\n        className='isolate z-50'\n      >\n        <TooltipPrimitive.Popup\n          ref={ref}\n          data-slot='tooltip-content'\n          className={cn(\n            'data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-[state=delayed-open]:animate-in data-[state=delayed-open]:fade-in-0 data-[state=delayed-open]:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 rounded-md px-3 py-1.5 text-xs bg-foreground text-background z-50 w-fit max-w-xs origin-(--transform-origin)',\n            className,\n          )}\n          {...props}\n        >\n          {children}\n          <TooltipPrimitive.Arrow className='size-2.5 translate-y-[calc(-50%_-_2px)] rotate-45 rounded-[2px] bg-foreground fill-foreground z-50 data-[side=bottom]:top-1 data-[side=left]:top-1/2! data-[side=left]:-right-1 data-[side=left]:-translate-y-1/2 data-[side=right]:top-1/2! data-[side=right]:-left-1 data-[side=right]:-translate-y-1/2 data-[side=top]:-bottom-2.5' />\n        </TooltipPrimitive.Popup>\n      </TooltipPrimitive.Positioner>\n    </TooltipPrimitive.Portal>\n  ),\n);\nTooltipContent.displayName = 'TooltipContent';\n\nexport { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };\n"],"mappings":"A,wSAUA,SAASQ,EAAgB,CAAE,QAAQ,EAAG,GAAGC,GAA0C,CACjF,OAAO,EAAAJ,EAAA,IAAA,CAACL,EAAAA,QAAiB,SAAlB,CAA2B,YAAU,mBAA0B,QAAO,GAAIS,CAAQ,CAAA,CAC3F,CAKA,SAASC,EAAQ,CAAE,GAAGD,GAAsC,CAC1D,OACE,EAAAJ,EAAA,IAAA,CAACG,EAAD,CAAA,UACE,EAAAH,EAAA,IAAA,CAACL,EAAAA,QAAiB,KAAlB,CAAuB,YAAU,UAAU,GAAIS,CAAQ,CAAA,CACxC,CAAA,CAErB,CAKA,SAASE,EAAe,CACtB,WACA,GAAGF,GAC8B,CACjC,OACE,EAAAJ,EAAA,IAAA,CAACL,EAAAA,QAAiB,QAAlB,CACE,YAAU,kBACV,GAAIS,EAEH,UACuB,CAAA,CAE9B,CAEA,IAAMG,EAAiBX,EAAM,YAMzB,CACE,YACA,OAAO,MACP,aAAa,EACb,QAAQ,SACR,cAAc,EACd,WACA,GAAGQ,GAEL,KAEA,EAAAJ,EAAA,IAAA,CAACL,EAAAA,QAAiB,OAAlB,CAAA,UACE,EAAAK,EAAA,IAAA,CAACL,EAAAA,QAAiB,WAAlB,CACS,QACM,cACP,OACM,aACZ,UAAU,eAEV,UAAA,EAAAK,EAAA,KAAA,CAACL,EAAAA,QAAiB,MAAlB,CACO,MACL,YAAU,kBACV,UAAWE,EAAAA,GACT,8fACAW,CACF,EACA,GAAIJ,EAPN,SAAA,CASGK,GACD,EAAAT,EAAA,IAAA,CAACL,EAAAA,QAAiB,MAAlB,CAAwB,UAAU,uUAAyU,CAAA,CACrV,C,EACG,CAAA,CACN,CAAA,CAE7B,EACA,EAAe,YAAc,iB"}
+{"version":3,"file":"tooltip.cjs","names":["TooltipPrimitive","React","cn","require_runtime","require_ui_lib_utils","react_jsx_runtime","react","_base_ui_react_tooltip","TooltipProvider","props","Tooltip","TooltipTrigger","TooltipContent","className","children"],"sources":["../../../../src/ui/components/ui/tooltip.tsx"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { Tooltip as TooltipPrimitive } from '@base-ui/react/tooltip';\n\nimport { cn } from '../../lib/utils';\n\n/**\n * Provides shared Base UI tooltip timing configuration with a zero-millisecond default delay.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: delay=0.\n * @returns The rendered TooltipProvider composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Trigger and Content require Tooltip context. Tooltip inserts its own Provider with delay=0, so wrapping it in a separate TooltipProvider does not pass a different delay through that inner provider. Content supplies portal/positioner. Timing offsets are milliseconds; positional offsets are CSS pixels.\n * @example\n * ```tsx\n * import { Tooltip, TooltipTrigger, TooltipContent } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<Tooltip><TooltipTrigger>Help</TooltipTrigger><TooltipContent>Learn about this field</TooltipContent></Tooltip>);\n * }\n * ```\n */\nfunction TooltipProvider({ delay = 0, ...props }: TooltipPrimitive.Provider.Props) {\n  return <TooltipPrimitive.Provider data-slot='tooltip-provider' delay={delay} {...props} />;\n}\n\n/**\n * Creates a tooltip root inside its own zero-delay TooltipProvider.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.\n * @returns The rendered Tooltip composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Trigger and Content require Tooltip context. Tooltip inserts its own Provider with delay=0, so wrapping it in a separate TooltipProvider does not pass a different delay through that inner provider. Content supplies portal/positioner. Timing offsets are milliseconds; positional offsets are CSS pixels.\n * @example\n * ```tsx\n * import { Tooltip, TooltipTrigger, TooltipContent } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<Tooltip><TooltipTrigger>Help</TooltipTrigger><TooltipContent>Learn about this field</TooltipContent></Tooltip>);\n * }\n * ```\n */\nfunction Tooltip({ ...props }: TooltipPrimitive.Root.Props) {\n  return (\n    <TooltipProvider>\n      <TooltipPrimitive.Root data-slot='tooltip' {...props} />\n    </TooltipProvider>\n  );\n}\n\n/**\n * Renders the target that opens its surrounding tooltip on the upstream interactions.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.\n * @returns The rendered TooltipTrigger composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Trigger and Content require Tooltip context. Tooltip inserts its own Provider with delay=0, so wrapping it in a separate TooltipProvider does not pass a different delay through that inner provider. Content supplies portal/positioner. Timing offsets are milliseconds; positional offsets are CSS pixels.\n * @example\n * ```tsx\n * import { Tooltip, TooltipTrigger, TooltipContent } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<Tooltip><TooltipTrigger>Help</TooltipTrigger><TooltipContent>Learn about this field</TooltipContent></Tooltip>);\n * }\n * ```\n */\nfunction TooltipTrigger({\n  children,\n  ...props\n}: TooltipPrimitive.Trigger.Props) {\n  return (\n    <TooltipPrimitive.Trigger\n      data-slot='tooltip-trigger'\n      {...props}\n    >\n      {children}\n    </TooltipPrimitive.Trigger>\n  );\n}\n\n/**\n * Portals and positions supplemental tooltip content relative to its trigger.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: side='top', sideOffset=4, align='center', alignOffset=0.\n * @returns The rendered TooltipContent composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Trigger and Content require Tooltip context. Tooltip inserts its own Provider with delay=0, so wrapping it in a separate TooltipProvider does not pass a different delay through that inner provider. Content supplies portal/positioner. Timing offsets are milliseconds; positional offsets are CSS pixels. The ref prop forwards to the rendered control or container declared by the component ref type.\n * @example\n * ```tsx\n * import { Tooltip, TooltipTrigger, TooltipContent } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<Tooltip><TooltipTrigger>Help</TooltipTrigger><TooltipContent>Learn about this field</TooltipContent></Tooltip>);\n * }\n * ```\n */\nconst TooltipContent = React.forwardRef<\n  HTMLDivElement,\n  TooltipPrimitive.Popup.Props &\n    Pick<TooltipPrimitive.Positioner.Props, 'align' | 'alignOffset' | 'side' | 'sideOffset'>\n>(\n  (\n    {\n      className,\n      side = 'top',\n      sideOffset = 4,\n      align = 'center',\n      alignOffset = 0,\n      children,\n      ...props\n    },\n    ref,\n  ) => (\n    <TooltipPrimitive.Portal>\n      <TooltipPrimitive.Positioner\n        align={align}\n        alignOffset={alignOffset}\n        side={side}\n        sideOffset={sideOffset}\n        className='isolate z-50'\n      >\n        <TooltipPrimitive.Popup\n          ref={ref}\n          data-slot='tooltip-content'\n          className={cn(\n            'data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-[state=delayed-open]:animate-in data-[state=delayed-open]:fade-in-0 data-[state=delayed-open]:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 rounded-md px-3 py-1.5 text-xs bg-foreground text-background z-50 w-fit max-w-xs origin-(--transform-origin)',\n            className,\n          )}\n          {...props}\n        >\n          {children}\n          <TooltipPrimitive.Arrow className='size-2.5 translate-y-[calc(-50%_-_2px)] rotate-45 rounded-[2px] bg-foreground fill-foreground z-50 data-[side=bottom]:top-1 data-[side=left]:top-1/2! data-[side=left]:-right-1 data-[side=left]:-translate-y-1/2 data-[side=right]:top-1/2! data-[side=right]:-left-1 data-[side=right]:-translate-y-1/2 data-[side=top]:-bottom-2.5' />\n        </TooltipPrimitive.Popup>\n      </TooltipPrimitive.Positioner>\n    </TooltipPrimitive.Portal>\n  ),\n);\nTooltipContent.displayName = 'TooltipContent';\n\nexport { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };\n"],"mappings":"A,wSAsBA,SAASQ,EAAgB,CAAE,QAAQ,EAAG,GAAGC,GAA0C,CACjF,OAAO,EAAAJ,EAAA,IAAA,CAACL,EAAAA,QAAiB,SAAlB,CAA2B,YAAU,mBAA0B,QAAO,GAAIS,CAAQ,CAAA,CAC3F,CAiBA,SAASC,EAAQ,CAAE,GAAGD,GAAsC,CAC1D,OACE,EAAAJ,EAAA,IAAA,CAACG,EAAD,CAAA,UACE,EAAAH,EAAA,IAAA,CAACL,EAAAA,QAAiB,KAAlB,CAAuB,YAAU,UAAU,GAAIS,CAAQ,CAAA,CACxC,CAAA,CAErB,CAiBA,SAASE,EAAe,CACtB,WACA,GAAGF,GAC8B,CACjC,OACE,EAAAJ,EAAA,IAAA,CAACL,EAAAA,QAAiB,QAAlB,CACE,YAAU,kBACV,GAAIS,EAEH,UACuB,CAAA,CAE9B,CAiBA,IAAMG,EAAiBX,EAAM,YAMzB,CACE,YACA,OAAO,MACP,aAAa,EACb,QAAQ,SACR,cAAc,EACd,WACA,GAAGQ,GAEL,KAEA,EAAAJ,EAAA,IAAA,CAACL,EAAAA,QAAiB,OAAlB,CAAA,UACE,EAAAK,EAAA,IAAA,CAACL,EAAAA,QAAiB,WAAlB,CACS,QACM,cACP,OACM,aACZ,UAAU,eAEV,UAAA,EAAAK,EAAA,KAAA,CAACL,EAAAA,QAAiB,MAAlB,CACO,MACL,YAAU,kBACV,UAAWE,EAAAA,GACT,8fACAW,CACF,EACA,GAAIJ,EAPN,SAAA,CASGK,GACD,EAAAT,EAAA,IAAA,CAACL,EAAAA,QAAiB,MAAlB,CAAwB,UAAU,uUAAyU,CAAA,CACrV,C,EACG,CAAA,CACN,CAAA,CAE7B,EACA,EAAe,YAAc,iB"}

package/dist/ui/components/ui/tooltip.d.cts

@@ -1,16 +1,67 @@
 import { Tooltip as TooltipPrimitive } from '@base-ui/react/tooltip';
 import * as React from 'react';
 /**
- * ツールチップの表示遅延時間などの設定を子コンポーネントに提供するプロバイダー。
+ * Provides shared Base UI tooltip timing configuration with a zero-millisecond default delay.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: delay=0.
+ * @returns The rendered TooltipProvider composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Trigger and Content require Tooltip context. Tooltip inserts its own Provider with delay=0, so wrapping it in a separate TooltipProvider does not pass a different delay through that inner provider. Content supplies portal/positioner. Timing offsets are milliseconds; positional offsets are CSS pixels.
+ * @example
+ * ```tsx
+ * import { Tooltip, TooltipTrigger, TooltipContent } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Tooltip><TooltipTrigger>Help</TooltipTrigger><TooltipContent>Learn about this field</TooltipContent></Tooltip>);
+ * }
+ * ```
  */
 declare function TooltipProvider({ delay, ...props }: TooltipPrimitive.Provider.Props): React.JSX.Element;
 /**
- * 要素をホバーまたはフォーカスした際、補足テキスト（ツールチップ）を表示するルートコンポーネント。
+ * Creates a tooltip root inside its own zero-delay TooltipProvider.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered Tooltip composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Trigger and Content require Tooltip context. Tooltip inserts its own Provider with delay=0, so wrapping it in a separate TooltipProvider does not pass a different delay through that inner provider. Content supplies portal/positioner. Timing offsets are milliseconds; positional offsets are CSS pixels.
+ * @example
+ * ```tsx
+ * import { Tooltip, TooltipTrigger, TooltipContent } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Tooltip><TooltipTrigger>Help</TooltipTrigger><TooltipContent>Learn about this field</TooltipContent></Tooltip>);
+ * }
+ * ```
  */
 declare function Tooltip({ ...props }: TooltipPrimitive.Root.Props): React.JSX.Element;
 /**
- * ツールチップを表示するためのトリガー要素（ホバー対象）。
+ * Renders the target that opens its surrounding tooltip on the upstream interactions.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered TooltipTrigger composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Trigger and Content require Tooltip context. Tooltip inserts its own Provider with delay=0, so wrapping it in a separate TooltipProvider does not pass a different delay through that inner provider. Content supplies portal/positioner. Timing offsets are milliseconds; positional offsets are CSS pixels.
+ * @example
+ * ```tsx
+ * import { Tooltip, TooltipTrigger, TooltipContent } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Tooltip><TooltipTrigger>Help</TooltipTrigger><TooltipContent>Learn about this field</TooltipContent></Tooltip>);
+ * }
+ * ```
  */
 declare function TooltipTrigger({ children, ...props }: TooltipPrimitive.Trigger.Props): React.JSX.Element;
+/**
+ * Portals and positions supplemental tooltip content relative to its trigger.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: side='top', sideOffset=4, align='center', alignOffset=0.
+ * @returns The rendered TooltipContent composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Trigger and Content require Tooltip context. Tooltip inserts its own Provider with delay=0, so wrapping it in a separate TooltipProvider does not pass a different delay through that inner provider. Content supplies portal/positioner. Timing offsets are milliseconds; positional offsets are CSS pixels. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { Tooltip, TooltipTrigger, TooltipContent } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Tooltip><TooltipTrigger>Help</TooltipTrigger><TooltipContent>Learn about this field</TooltipContent></Tooltip>);
+ * }
+ * ```
+ */
 declare const TooltipContent: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').TooltipPopupProps & Pick<import('@base-ui/react').TooltipPositionerProps, "side" | "align" | "sideOffset" | "alignOffset">, "ref"> & React.RefAttributes<HTMLDivElement>>;
 export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };

package/dist/ui/components/ui/tooltip.d.ts

@@ -1,16 +1,67 @@
 import { Tooltip as TooltipPrimitive } from '@base-ui/react/tooltip';
 import * as React from 'react';
 /**
- * ツールチップの表示遅延時間などの設定を子コンポーネントに提供するプロバイダー。
+ * Provides shared Base UI tooltip timing configuration with a zero-millisecond default delay.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: delay=0.
+ * @returns The rendered TooltipProvider composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Trigger and Content require Tooltip context. Tooltip inserts its own Provider with delay=0, so wrapping it in a separate TooltipProvider does not pass a different delay through that inner provider. Content supplies portal/positioner. Timing offsets are milliseconds; positional offsets are CSS pixels.
+ * @example
+ * ```tsx
+ * import { Tooltip, TooltipTrigger, TooltipContent } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Tooltip><TooltipTrigger>Help</TooltipTrigger><TooltipContent>Learn about this field</TooltipContent></Tooltip>);
+ * }
+ * ```
  */
 declare function TooltipProvider({ delay, ...props }: TooltipPrimitive.Provider.Props): React.JSX.Element;
 /**
- * 要素をホバーまたはフォーカスした際、補足テキスト（ツールチップ）を表示するルートコンポーネント。
+ * Creates a tooltip root inside its own zero-delay TooltipProvider.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered Tooltip composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Trigger and Content require Tooltip context. Tooltip inserts its own Provider with delay=0, so wrapping it in a separate TooltipProvider does not pass a different delay through that inner provider. Content supplies portal/positioner. Timing offsets are milliseconds; positional offsets are CSS pixels.
+ * @example
+ * ```tsx
+ * import { Tooltip, TooltipTrigger, TooltipContent } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Tooltip><TooltipTrigger>Help</TooltipTrigger><TooltipContent>Learn about this field</TooltipContent></Tooltip>);
+ * }
+ * ```
  */
 declare function Tooltip({ ...props }: TooltipPrimitive.Root.Props): React.JSX.Element;
 /**
- * ツールチップを表示するためのトリガー要素（ホバー対象）。
+ * Renders the target that opens its surrounding tooltip on the upstream interactions.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered TooltipTrigger composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Trigger and Content require Tooltip context. Tooltip inserts its own Provider with delay=0, so wrapping it in a separate TooltipProvider does not pass a different delay through that inner provider. Content supplies portal/positioner. Timing offsets are milliseconds; positional offsets are CSS pixels.
+ * @example
+ * ```tsx
+ * import { Tooltip, TooltipTrigger, TooltipContent } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Tooltip><TooltipTrigger>Help</TooltipTrigger><TooltipContent>Learn about this field</TooltipContent></Tooltip>);
+ * }
+ * ```
  */
 declare function TooltipTrigger({ children, ...props }: TooltipPrimitive.Trigger.Props): React.JSX.Element;
+/**
+ * Portals and positions supplemental tooltip content relative to its trigger.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: side='top', sideOffset=4, align='center', alignOffset=0.
+ * @returns The rendered TooltipContent composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Trigger and Content require Tooltip context. Tooltip inserts its own Provider with delay=0, so wrapping it in a separate TooltipProvider does not pass a different delay through that inner provider. Content supplies portal/positioner. Timing offsets are milliseconds; positional offsets are CSS pixels. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { Tooltip, TooltipTrigger, TooltipContent } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Tooltip><TooltipTrigger>Help</TooltipTrigger><TooltipContent>Learn about this field</TooltipContent></Tooltip>);
+ * }
+ * ```
+ */
 declare const TooltipContent: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').TooltipPopupProps & Pick<import('@base-ui/react').TooltipPositionerProps, "side" | "align" | "sideOffset" | "alignOffset">, "ref"> & React.RefAttributes<HTMLDivElement>>;
 export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };

package/dist/ui/components/ui/tooltip.js.map

@@ -1 +1 @@
-{"version":3,"file":"tooltip.js","names":["TooltipPrimitive","React","React$1","Tooltip$1","TooltipProvider","props","Tooltip","TooltipTrigger","TooltipContent","cn","className","children"],"sources":["../../../../src/ui/components/ui/tooltip.tsx"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { Tooltip as TooltipPrimitive } from '@base-ui/react/tooltip';\n\nimport { cn } from '../../lib/utils';\n\n/**\n * ツールチップの表示遅延時間などの設定を子コンポーネントに提供するプロバイダー。\n */\nfunction TooltipProvider({ delay = 0, ...props }: TooltipPrimitive.Provider.Props) {\n  return <TooltipPrimitive.Provider data-slot='tooltip-provider' delay={delay} {...props} />;\n}\n\n/**\n * 要素をホバーまたはフォーカスした際、補足テキスト（ツールチップ）を表示するルートコンポーネント。\n */\nfunction Tooltip({ ...props }: TooltipPrimitive.Root.Props) {\n  return (\n    <TooltipProvider>\n      <TooltipPrimitive.Root data-slot='tooltip' {...props} />\n    </TooltipProvider>\n  );\n}\n\n/**\n * ツールチップを表示するためのトリガー要素（ホバー対象）。\n */\nfunction TooltipTrigger({\n  children,\n  ...props\n}: TooltipPrimitive.Trigger.Props) {\n  return (\n    <TooltipPrimitive.Trigger\n      data-slot='tooltip-trigger'\n      {...props}\n    >\n      {children}\n    </TooltipPrimitive.Trigger>\n  );\n}\n\nconst TooltipContent = React.forwardRef<\n  HTMLDivElement,\n  TooltipPrimitive.Popup.Props &\n    Pick<TooltipPrimitive.Positioner.Props, 'align' | 'alignOffset' | 'side' | 'sideOffset'>\n>(\n  (\n    {\n      className,\n      side = 'top',\n      sideOffset = 4,\n      align = 'center',\n      alignOffset = 0,\n      children,\n      ...props\n    },\n    ref,\n  ) => (\n    <TooltipPrimitive.Portal>\n      <TooltipPrimitive.Positioner\n        align={align}\n        alignOffset={alignOffset}\n        side={side}\n        sideOffset={sideOffset}\n        className='isolate z-50'\n      >\n        <TooltipPrimitive.Popup\n          ref={ref}\n          data-slot='tooltip-content'\n          className={cn(\n            'data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-[state=delayed-open]:animate-in data-[state=delayed-open]:fade-in-0 data-[state=delayed-open]:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 rounded-md px-3 py-1.5 text-xs bg-foreground text-background z-50 w-fit max-w-xs origin-(--transform-origin)',\n            className,\n          )}\n          {...props}\n        >\n          {children}\n          <TooltipPrimitive.Arrow className='size-2.5 translate-y-[calc(-50%_-_2px)] rotate-45 rounded-[2px] bg-foreground fill-foreground z-50 data-[side=bottom]:top-1 data-[side=left]:top-1/2! data-[side=left]:-right-1 data-[side=left]:-translate-y-1/2 data-[side=right]:top-1/2! data-[side=right]:-left-1 data-[side=right]:-translate-y-1/2 data-[side=top]:-bottom-2.5' />\n        </TooltipPrimitive.Popup>\n      </TooltipPrimitive.Positioner>\n    </TooltipPrimitive.Portal>\n  ),\n);\nTooltipContent.displayName = 'TooltipContent';\n\nexport { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };\n"],"mappings":";;;;;;;AAUA,SAASI,EAAgB,EAAE,WAAQ,GAAG,GAAGC,KAA0C;CACjF,OAAO,kBAACL,EAAiB,UAAlB;EAA2B,aAAU;EAA0B;EAAO,GAAIK;CAAQ,CAAA;AAC3F;AAKA,SAASC,EAAQ,EAAE,GAAGD,KAAsC;CAC1D,OACE,kBAACD,GAAD,EAAA,UACE,kBAACJ,EAAiB,MAAlB;EAAuB,aAAU;EAAU,GAAIK;CAAQ,CAAA,EACxC,CAAA;AAErB;AAKA,SAASE,EAAe,EACtB,aACA,GAAGF,KAC8B;CACjC,OACE,kBAACL,EAAiB,SAAlB;EACE,aAAU;EACV,GAAIK;EAEH;CACuB,CAAA;AAE9B;AAEA,IAAMG,IAAiBP,EAAM,YAMzB,EACE,cACA,UAAO,OACP,gBAAa,GACb,WAAQ,UACR,iBAAc,GACd,aACA,GAAGI,KAEL,MAEA,kBAACL,EAAiB,QAAlB,EAAA,UACE,kBAACA,EAAiB,YAAlB;CACS;CACM;CACP;CACM;CACZ,WAAU;CAEV,UAAA,kBAACA,EAAiB,OAAlB;EACO;EACL,aAAU;EACV,WAAWS,EACT,+fACAC,CACF;EACA,GAAIL;EAPN,UAAA,CASGM,GACD,kBAACX,EAAiB,OAAlB,EAAwB,WAAU,wUAAyU,CAAA,CACrV;;AACG,CAAA,EACN,CAAA,CAE7B;AACA,EAAe,cAAc"}
+{"version":3,"file":"tooltip.js","names":["TooltipPrimitive","React","React$1","Tooltip$1","TooltipProvider","props","Tooltip","TooltipTrigger","TooltipContent","cn","className","children"],"sources":["../../../../src/ui/components/ui/tooltip.tsx"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { Tooltip as TooltipPrimitive } from '@base-ui/react/tooltip';\n\nimport { cn } from '../../lib/utils';\n\n/**\n * Provides shared Base UI tooltip timing configuration with a zero-millisecond default delay.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: delay=0.\n * @returns The rendered TooltipProvider composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Trigger and Content require Tooltip context. Tooltip inserts its own Provider with delay=0, so wrapping it in a separate TooltipProvider does not pass a different delay through that inner provider. Content supplies portal/positioner. Timing offsets are milliseconds; positional offsets are CSS pixels.\n * @example\n * ```tsx\n * import { Tooltip, TooltipTrigger, TooltipContent } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<Tooltip><TooltipTrigger>Help</TooltipTrigger><TooltipContent>Learn about this field</TooltipContent></Tooltip>);\n * }\n * ```\n */\nfunction TooltipProvider({ delay = 0, ...props }: TooltipPrimitive.Provider.Props) {\n  return <TooltipPrimitive.Provider data-slot='tooltip-provider' delay={delay} {...props} />;\n}\n\n/**\n * Creates a tooltip root inside its own zero-delay TooltipProvider.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.\n * @returns The rendered Tooltip composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Trigger and Content require Tooltip context. Tooltip inserts its own Provider with delay=0, so wrapping it in a separate TooltipProvider does not pass a different delay through that inner provider. Content supplies portal/positioner. Timing offsets are milliseconds; positional offsets are CSS pixels.\n * @example\n * ```tsx\n * import { Tooltip, TooltipTrigger, TooltipContent } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<Tooltip><TooltipTrigger>Help</TooltipTrigger><TooltipContent>Learn about this field</TooltipContent></Tooltip>);\n * }\n * ```\n */\nfunction Tooltip({ ...props }: TooltipPrimitive.Root.Props) {\n  return (\n    <TooltipProvider>\n      <TooltipPrimitive.Root data-slot='tooltip' {...props} />\n    </TooltipProvider>\n  );\n}\n\n/**\n * Renders the target that opens its surrounding tooltip on the upstream interactions.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.\n * @returns The rendered TooltipTrigger composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Trigger and Content require Tooltip context. Tooltip inserts its own Provider with delay=0, so wrapping it in a separate TooltipProvider does not pass a different delay through that inner provider. Content supplies portal/positioner. Timing offsets are milliseconds; positional offsets are CSS pixels.\n * @example\n * ```tsx\n * import { Tooltip, TooltipTrigger, TooltipContent } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<Tooltip><TooltipTrigger>Help</TooltipTrigger><TooltipContent>Learn about this field</TooltipContent></Tooltip>);\n * }\n * ```\n */\nfunction TooltipTrigger({\n  children,\n  ...props\n}: TooltipPrimitive.Trigger.Props) {\n  return (\n    <TooltipPrimitive.Trigger\n      data-slot='tooltip-trigger'\n      {...props}\n    >\n      {children}\n    </TooltipPrimitive.Trigger>\n  );\n}\n\n/**\n * Portals and positions supplemental tooltip content relative to its trigger.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: side='top', sideOffset=4, align='center', alignOffset=0.\n * @returns The rendered TooltipContent composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Trigger and Content require Tooltip context. Tooltip inserts its own Provider with delay=0, so wrapping it in a separate TooltipProvider does not pass a different delay through that inner provider. Content supplies portal/positioner. Timing offsets are milliseconds; positional offsets are CSS pixels. The ref prop forwards to the rendered control or container declared by the component ref type.\n * @example\n * ```tsx\n * import { Tooltip, TooltipTrigger, TooltipContent } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<Tooltip><TooltipTrigger>Help</TooltipTrigger><TooltipContent>Learn about this field</TooltipContent></Tooltip>);\n * }\n * ```\n */\nconst TooltipContent = React.forwardRef<\n  HTMLDivElement,\n  TooltipPrimitive.Popup.Props &\n    Pick<TooltipPrimitive.Positioner.Props, 'align' | 'alignOffset' | 'side' | 'sideOffset'>\n>(\n  (\n    {\n      className,\n      side = 'top',\n      sideOffset = 4,\n      align = 'center',\n      alignOffset = 0,\n      children,\n      ...props\n    },\n    ref,\n  ) => (\n    <TooltipPrimitive.Portal>\n      <TooltipPrimitive.Positioner\n        align={align}\n        alignOffset={alignOffset}\n        side={side}\n        sideOffset={sideOffset}\n        className='isolate z-50'\n      >\n        <TooltipPrimitive.Popup\n          ref={ref}\n          data-slot='tooltip-content'\n          className={cn(\n            'data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-[state=delayed-open]:animate-in data-[state=delayed-open]:fade-in-0 data-[state=delayed-open]:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 rounded-md px-3 py-1.5 text-xs bg-foreground text-background z-50 w-fit max-w-xs origin-(--transform-origin)',\n            className,\n          )}\n          {...props}\n        >\n          {children}\n          <TooltipPrimitive.Arrow className='size-2.5 translate-y-[calc(-50%_-_2px)] rotate-45 rounded-[2px] bg-foreground fill-foreground z-50 data-[side=bottom]:top-1 data-[side=left]:top-1/2! data-[side=left]:-right-1 data-[side=left]:-translate-y-1/2 data-[side=right]:top-1/2! data-[side=right]:-left-1 data-[side=right]:-translate-y-1/2 data-[side=top]:-bottom-2.5' />\n        </TooltipPrimitive.Popup>\n      </TooltipPrimitive.Positioner>\n    </TooltipPrimitive.Portal>\n  ),\n);\nTooltipContent.displayName = 'TooltipContent';\n\nexport { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };\n"],"mappings":";;;;;;;AAsBA,SAASI,EAAgB,EAAE,WAAQ,GAAG,GAAGC,KAA0C;CACjF,OAAO,kBAACL,EAAiB,UAAlB;EAA2B,aAAU;EAA0B;EAAO,GAAIK;CAAQ,CAAA;AAC3F;AAiBA,SAASC,EAAQ,EAAE,GAAGD,KAAsC;CAC1D,OACE,kBAACD,GAAD,EAAA,UACE,kBAACJ,EAAiB,MAAlB;EAAuB,aAAU;EAAU,GAAIK;CAAQ,CAAA,EACxC,CAAA;AAErB;AAiBA,SAASE,EAAe,EACtB,aACA,GAAGF,KAC8B;CACjC,OACE,kBAACL,EAAiB,SAAlB;EACE,aAAU;EACV,GAAIK;EAEH;CACuB,CAAA;AAE9B;AAiBA,IAAMG,IAAiBP,EAAM,YAMzB,EACE,cACA,UAAO,OACP,gBAAa,GACb,WAAQ,UACR,iBAAc,GACd,aACA,GAAGI,KAEL,MAEA,kBAACL,EAAiB,QAAlB,EAAA,UACE,kBAACA,EAAiB,YAAlB;CACS;CACM;CACP;CACM;CACZ,WAAU;CAEV,UAAA,kBAACA,EAAiB,OAAlB;EACO;EACL,aAAU;EACV,WAAWS,EACT,+fACAC,CACF;EACA,GAAIL;EAPN,UAAA,CASGM,GACD,kBAACX,EAAiB,OAAlB,EAAwB,WAAU,wUAAyU,CAAA,CACrV;;AACG,CAAA,EACN,CAAA,CAE7B;AACA,EAAe,cAAc"}

package/dist/ui/lib/hooks/use-gps.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-gps.cjs","names":["useState","react","useGPS","location","setLocation","active","position","error"],"sources":["../../../../src/ui/lib/hooks/use-gps.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n/** Browser location in decimal degrees, with accuracy in metres. */\nexport interface GPSCoordinates {\n  latitude: number;\n  longitude: number;\n  accuracy: number;\n}\n/**\n * Request one position after mount. Returns undefined before success, on denial,\n * or when geolocation is unavailable. Requires the host's secure context/permission.\n * Never requests during SSR and ignores late callbacks after unmount. Errors are logged.\n */\nexport function useGPS(): GPSCoordinates | undefined {\n  const [location, setLocation] = useState<GPSCoordinates>();\n  useEffect(() => {\n    let active = true;\n    if (typeof navigator !== 'undefined' && navigator.geolocation) {\n      navigator.geolocation.getCurrentPosition(\n        (position) => {\n          if (active)\n            setLocation({\n              latitude: position.coords.latitude,\n              longitude: position.coords.longitude,\n              accuracy: position.coords.accuracy,\n            });\n        },\n        (error) => {\n          if (active) console.error('GPS Error:', error);\n        },\n      );\n    }\n    return () => {\n      active = false;\n    };\n  }, []);\n  return location;\n}\n"],"mappings":"A,uGAYA,SAAgBE,GAAqC,CACnD,GAAM,CAACC,EAAUC,IAAA,EAAeJ,EAAAA,SAAAA,CAAyB,EAsBzD,OArBA,EAAAC,EAAA,UAAA,KAAgB,CACd,IAAII,EAAS,GAgBb,OAfI,OAAO,UAAc,KAAe,UAAU,aAChD,UAAU,YAAY,mBACnB,GAAa,CACRA,GACFD,EAAY,CACV,SAAUE,EAAS,OAAO,SAC1B,UAAWA,EAAS,OAAO,UAC3B,SAAUA,EAAS,OAAO,QAC5B,CAAC,CACL,EACC,GAAU,CACLD,GAAQ,QAAQ,MAAM,aAAcE,CAAK,CAC/C,CACF,MAEW,CACX,EAAS,EACX,CACF,EAAG,CAAC,CAAC,EACEJ,CACT,C"}
+{"version":3,"file":"use-gps.cjs","names":["useState","react","useGPS","location","setLocation","active","position","error"],"sources":["../../../../src/ui/lib/hooks/use-gps.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n/**\n * Browser location in decimal degrees, with accuracy in metres.\n * @see useGPS for the canonical usage example.\n */\nexport interface GPSCoordinates {\n  /**\n   * Latitude in decimal degrees as supplied by browser geolocation.\n   */\n  latitude: number;\n  /**\n   * Longitude in decimal degrees as supplied by browser geolocation.\n   */\n  longitude: number;\n  /**\n   * Estimated horizontal accuracy in metres reported by the browser.\n   */\n  accuracy: number;\n}\n/**\n * Requests one browser position after mounting.\n *\n * @returns Coordinates after success, otherwise undefined while pending, denied or unavailable.\n *\n * @remarks Requires a secure context and browser location permission. No SSR request is\n * made. Late callbacks are ignored after unmount; underlying geolocation is not cancelled.\n * Errors are logged to console; no providers or styles are required.\n *\n * @example\n * ```tsx\n * import { useGPS } from '@alneas/appkit-react/ui/hooks';\n * export function Location() {\n *   const position = useGPS();\n *   return <output>{position ? `${position.latitude}, ${position.longitude}` : 'Location unavailable'}</output>;\n * }\n * ```\n */\nexport function useGPS(): GPSCoordinates | undefined {\n  const [location, setLocation] = useState<GPSCoordinates>();\n  useEffect(() => {\n    let active = true;\n    if (typeof navigator !== 'undefined' && navigator.geolocation) {\n      navigator.geolocation.getCurrentPosition(\n        (position) => {\n          if (active)\n            setLocation({\n              latitude: position.coords.latitude,\n              longitude: position.coords.longitude,\n              accuracy: position.coords.accuracy,\n            });\n        },\n        (error) => {\n          if (active) console.error('GPS Error:', error);\n        },\n      );\n    }\n    return () => {\n      active = false;\n    };\n  }, []);\n  return location;\n}\n"],"mappings":"A,uGAqCA,SAAgBE,GAAqC,CACnD,GAAM,CAACC,EAAUC,IAAA,EAAeJ,EAAAA,SAAAA,CAAyB,EAsBzD,OArBA,EAAAC,EAAA,UAAA,KAAgB,CACd,IAAII,EAAS,GAgBb,OAfI,OAAO,UAAc,KAAe,UAAU,aAChD,UAAU,YAAY,mBACnB,GAAa,CACRA,GACFD,EAAY,CACV,SAAUE,EAAS,OAAO,SAC1B,UAAWA,EAAS,OAAO,UAC3B,SAAUA,EAAS,OAAO,QAC5B,CAAC,CACL,EACC,GAAU,CACLD,GAAQ,QAAQ,MAAM,aAAcE,CAAK,CAC/C,CACF,MAEW,CACX,EAAS,EACX,CACF,EAAG,CAAC,CAAC,EACEJ,CACT,C"}

package/dist/ui/lib/hooks/use-gps.d.cts

@@ -1,12 +1,37 @@
-/** Browser location in decimal degrees, with accuracy in metres. */
+/**
+ * Browser location in decimal degrees, with accuracy in metres.
+ * @see useGPS for the canonical usage example.
+ */
 export interface GPSCoordinates {
+    /**
+     * Latitude in decimal degrees as supplied by browser geolocation.
+     */
     latitude: number;
+    /**
+     * Longitude in decimal degrees as supplied by browser geolocation.
+     */
     longitude: number;
+    /**
+     * Estimated horizontal accuracy in metres reported by the browser.
+     */
     accuracy: number;
 }
 /**
- * Request one position after mount. Returns undefined before success, on denial,
- * or when geolocation is unavailable. Requires the host's secure context/permission.
- * Never requests during SSR and ignores late callbacks after unmount. Errors are logged.
+ * Requests one browser position after mounting.
+ *
+ * @returns Coordinates after success, otherwise undefined while pending, denied or unavailable.
+ *
+ * @remarks Requires a secure context and browser location permission. No SSR request is
+ * made. Late callbacks are ignored after unmount; underlying geolocation is not cancelled.
+ * Errors are logged to console; no providers or styles are required.
+ *
+ * @example
+ * ```tsx
+ * import { useGPS } from '@alneas/appkit-react/ui/hooks';
+ * export function Location() {
+ *   const position = useGPS();
+ *   return <output>{position ? `${position.latitude}, ${position.longitude}` : 'Location unavailable'}</output>;
+ * }
+ * ```
  */
 export declare function useGPS(): GPSCoordinates | undefined;

package/dist/ui/lib/hooks/use-gps.d.ts

@@ -1,12 +1,37 @@
-/** Browser location in decimal degrees, with accuracy in metres. */
+/**
+ * Browser location in decimal degrees, with accuracy in metres.
+ * @see useGPS for the canonical usage example.
+ */
 export interface GPSCoordinates {
+    /**
+     * Latitude in decimal degrees as supplied by browser geolocation.
+     */
     latitude: number;
+    /**
+     * Longitude in decimal degrees as supplied by browser geolocation.
+     */
     longitude: number;
+    /**
+     * Estimated horizontal accuracy in metres reported by the browser.
+     */
     accuracy: number;
 }
 /**
- * Request one position after mount. Returns undefined before success, on denial,
- * or when geolocation is unavailable. Requires the host's secure context/permission.
- * Never requests during SSR and ignores late callbacks after unmount. Errors are logged.
+ * Requests one browser position after mounting.
+ *
+ * @returns Coordinates after success, otherwise undefined while pending, denied or unavailable.
+ *
+ * @remarks Requires a secure context and browser location permission. No SSR request is
+ * made. Late callbacks are ignored after unmount; underlying geolocation is not cancelled.
+ * Errors are logged to console; no providers or styles are required.
+ *
+ * @example
+ * ```tsx
+ * import { useGPS } from '@alneas/appkit-react/ui/hooks';
+ * export function Location() {
+ *   const position = useGPS();
+ *   return <output>{position ? `${position.latitude}, ${position.longitude}` : 'Location unavailable'}</output>;
+ * }
+ * ```
  */
 export declare function useGPS(): GPSCoordinates | undefined;

package/dist/ui/lib/hooks/use-gps.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-gps.js","names":["useGPS","location","setLocation","useState","useEffect","active","position","error"],"sources":["../../../../src/ui/lib/hooks/use-gps.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n/** Browser location in decimal degrees, with accuracy in metres. */\nexport interface GPSCoordinates {\n  latitude: number;\n  longitude: number;\n  accuracy: number;\n}\n/**\n * Request one position after mount. Returns undefined before success, on denial,\n * or when geolocation is unavailable. Requires the host's secure context/permission.\n * Never requests during SSR and ignores late callbacks after unmount. Errors are logged.\n */\nexport function useGPS(): GPSCoordinates | undefined {\n  const [location, setLocation] = useState<GPSCoordinates>();\n  useEffect(() => {\n    let active = true;\n    if (typeof navigator !== 'undefined' && navigator.geolocation) {\n      navigator.geolocation.getCurrentPosition(\n        (position) => {\n          if (active)\n            setLocation({\n              latitude: position.coords.latitude,\n              longitude: position.coords.longitude,\n              accuracy: position.coords.accuracy,\n            });\n        },\n        (error) => {\n          if (active) console.error('GPS Error:', error);\n        },\n      );\n    }\n    return () => {\n      active = false;\n    };\n  }, []);\n  return location;\n}\n"],"mappings":";;;AAYA,SAAgBA,IAAqC;CACnD,IAAM,CAACC,GAAUC,KAAeC,EAAyB;CAsBzD,OArBAC,QAAgB;EACd,IAAIC,IAAS;EAgBb,OAfI,OAAO,YAAc,OAAe,UAAU,eAChD,UAAU,YAAY,oBACnB,MAAa;GACZ,AAAIA,KACFH,EAAY;IACV,UAAUI,EAAS,OAAO;IAC1B,WAAWA,EAAS,OAAO;IAC3B,UAAUA,EAAS,OAAO;GAC5B,CAAC;EACL,IACC,MAAU;GACT,AAAID,KAAQ,QAAQ,MAAM,cAAcE,CAAK;EAC/C,CACF,SAEW;GACX,IAAS;EACX;CACF,GAAG,CAAC,CAAC,GACEN;AACT"}
+{"version":3,"file":"use-gps.js","names":["useGPS","location","setLocation","useState","useEffect","active","position","error"],"sources":["../../../../src/ui/lib/hooks/use-gps.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n/**\n * Browser location in decimal degrees, with accuracy in metres.\n * @see useGPS for the canonical usage example.\n */\nexport interface GPSCoordinates {\n  /**\n   * Latitude in decimal degrees as supplied by browser geolocation.\n   */\n  latitude: number;\n  /**\n   * Longitude in decimal degrees as supplied by browser geolocation.\n   */\n  longitude: number;\n  /**\n   * Estimated horizontal accuracy in metres reported by the browser.\n   */\n  accuracy: number;\n}\n/**\n * Requests one browser position after mounting.\n *\n * @returns Coordinates after success, otherwise undefined while pending, denied or unavailable.\n *\n * @remarks Requires a secure context and browser location permission. No SSR request is\n * made. Late callbacks are ignored after unmount; underlying geolocation is not cancelled.\n * Errors are logged to console; no providers or styles are required.\n *\n * @example\n * ```tsx\n * import { useGPS } from '@alneas/appkit-react/ui/hooks';\n * export function Location() {\n *   const position = useGPS();\n *   return <output>{position ? `${position.latitude}, ${position.longitude}` : 'Location unavailable'}</output>;\n * }\n * ```\n */\nexport function useGPS(): GPSCoordinates | undefined {\n  const [location, setLocation] = useState<GPSCoordinates>();\n  useEffect(() => {\n    let active = true;\n    if (typeof navigator !== 'undefined' && navigator.geolocation) {\n      navigator.geolocation.getCurrentPosition(\n        (position) => {\n          if (active)\n            setLocation({\n              latitude: position.coords.latitude,\n              longitude: position.coords.longitude,\n              accuracy: position.coords.accuracy,\n            });\n        },\n        (error) => {\n          if (active) console.error('GPS Error:', error);\n        },\n      );\n    }\n    return () => {\n      active = false;\n    };\n  }, []);\n  return location;\n}\n"],"mappings":";;;AAqCA,SAAgBA,IAAqC;CACnD,IAAM,CAACC,GAAUC,KAAeC,EAAyB;CAsBzD,OArBAC,QAAgB;EACd,IAAIC,IAAS;EAgBb,OAfI,OAAO,YAAc,OAAe,UAAU,eAChD,UAAU,YAAY,oBACnB,MAAa;GACZ,AAAIA,KACFH,EAAY;IACV,UAAUI,EAAS,OAAO;IAC1B,WAAWA,EAAS,OAAO;IAC3B,UAAUA,EAAS,OAAO;GAC5B,CAAC;EACL,IACC,MAAU;GACT,AAAID,KAAQ,QAAQ,MAAM,cAAcE,CAAK;EAC/C,CACF,SAEW;GACX,IAAS;EACX;CACF,GAAG,CAAC,CAAC,GACEN;AACT"}

package/dist/ui/lib/hooks/use-is-client.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-is-client.cjs","names":["useSyncExternalStore","react","subscribe","useIsClient"],"sources":["../../../../src/ui/lib/hooks/use-is-client.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\n\nfunction subscribe() {\n  return () => undefined;\n}\n\n/**\n * Returns `true` only after hydration on the client.\n * Useful for SSR-safe rendering branches without setState in effects.\n */\nexport function useIsClient(): boolean {\n  return useSyncExternalStore(\n    subscribe,\n    () => true,\n    () => false,\n  );\n}\n"],"mappings":"A,uGAEA,SAASE,GAAY,CACnB,UAAa,IAAA,EACf,CAMA,SAAgBC,GAAuB,CACrC,OAAA,EAAOH,EAAAA,qBAAAA,CACLE,MACM,OACA,EACR,CACF,C"}
+{"version":3,"file":"use-is-client.cjs","names":["useSyncExternalStore","react","subscribe","useIsClient"],"sources":["../../../../src/ui/lib/hooks/use-is-client.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\n\nfunction subscribe() {\n  return () => undefined;\n}\n\n/**\n * Reports whether React is rendering on the client after hydration.\n *\n * @returns False for the server snapshot and initial hydration snapshot, then true on the client.\n *\n * @remarks Requires React; no context, styles, listener or disposal is required.\n *\n * @example\n * ```tsx\n * import { useIsClient } from '@alneas/appkit-react/ui/hooks';\n * export function ClientStatus() { return <span>{useIsClient() ? 'Client' : 'Server'}</span>; }\n * ```\n */\nexport function useIsClient(): boolean {\n  return useSyncExternalStore(\n    subscribe,\n    () => true,\n    () => false,\n  );\n}\n"],"mappings":"A,uGAEA,SAASE,GAAY,CACnB,UAAa,IAAA,EACf,CAeA,SAAgBC,GAAuB,CACrC,OAAA,EAAOH,EAAAA,qBAAAA,CACLE,MACM,OACA,EACR,CACF,C"}

package/dist/ui/lib/hooks/use-is-client.d.cts

@@ -1,5 +1,14 @@
 /**
- * Returns `true` only after hydration on the client.
- * Useful for SSR-safe rendering branches without setState in effects.
+ * Reports whether React is rendering on the client after hydration.
+ *
+ * @returns False for the server snapshot and initial hydration snapshot, then true on the client.
+ *
+ * @remarks Requires React; no context, styles, listener or disposal is required.
+ *
+ * @example
+ * ```tsx
+ * import { useIsClient } from '@alneas/appkit-react/ui/hooks';
+ * export function ClientStatus() { return <span>{useIsClient() ? 'Client' : 'Server'}</span>; }
+ * ```
  */
 export declare function useIsClient(): boolean;

package/dist/ui/lib/hooks/use-is-client.d.ts

@@ -1,5 +1,14 @@
 /**
- * Returns `true` only after hydration on the client.
- * Useful for SSR-safe rendering branches without setState in effects.
+ * Reports whether React is rendering on the client after hydration.
+ *
+ * @returns False for the server snapshot and initial hydration snapshot, then true on the client.
+ *
+ * @remarks Requires React; no context, styles, listener or disposal is required.
+ *
+ * @example
+ * ```tsx
+ * import { useIsClient } from '@alneas/appkit-react/ui/hooks';
+ * export function ClientStatus() { return <span>{useIsClient() ? 'Client' : 'Server'}</span>; }
+ * ```
  */
 export declare function useIsClient(): boolean;

package/dist/ui/lib/hooks/use-is-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-is-client.js","names":["subscribe","useIsClient","useSyncExternalStore"],"sources":["../../../../src/ui/lib/hooks/use-is-client.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\n\nfunction subscribe() {\n  return () => undefined;\n}\n\n/**\n * Returns `true` only after hydration on the client.\n * Useful for SSR-safe rendering branches without setState in effects.\n */\nexport function useIsClient(): boolean {\n  return useSyncExternalStore(\n    subscribe,\n    () => true,\n    () => false,\n  );\n}\n"],"mappings":";;;AAEA,SAASA,IAAY;CACnB,aAAa,KAAA;AACf;AAMA,SAAgBC,IAAuB;CACrC,OAAOC,EACLF,SACM,UACA,EACR;AACF"}
+{"version":3,"file":"use-is-client.js","names":["subscribe","useIsClient","useSyncExternalStore"],"sources":["../../../../src/ui/lib/hooks/use-is-client.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\n\nfunction subscribe() {\n  return () => undefined;\n}\n\n/**\n * Reports whether React is rendering on the client after hydration.\n *\n * @returns False for the server snapshot and initial hydration snapshot, then true on the client.\n *\n * @remarks Requires React; no context, styles, listener or disposal is required.\n *\n * @example\n * ```tsx\n * import { useIsClient } from '@alneas/appkit-react/ui/hooks';\n * export function ClientStatus() { return <span>{useIsClient() ? 'Client' : 'Server'}</span>; }\n * ```\n */\nexport function useIsClient(): boolean {\n  return useSyncExternalStore(\n    subscribe,\n    () => true,\n    () => false,\n  );\n}\n"],"mappings":";;;AAEA,SAASA,IAAY;CACnB,aAAa,KAAA;AACf;AAeA,SAAgBC,IAAuB;CACrC,OAAOC,EACLF,SACM,UACA,EACR;AACF"}

package/dist/ui/lib/hooks/use-keyboard-shortcut.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-keyboard-shortcut.cjs","names":["react","useKeyboardShortcuts","enabled","handleKeyDown","shortcut","shortcuts","ctrlMatch","metaMatch","shiftMatch","altMatch","keyMatch"],"sources":["../../../../src/ui/lib/hooks/use-keyboard-shortcut.ts"],"sourcesContent":["import { useEffect } from 'react';\n\n/**\n * キーボードショートカットの定義\n * Keyboard shortcut configuration\n */\nexport interface KeyboardShortcut {\n  /** キー名（e.g. 's', 'Enter', 'Escape'） */\n  key: string;\n  /** Ctrl/Cmd キーが必要か（Mac では Cmd も許容） */\n  ctrlKey?: boolean;\n  /** Meta (Cmd) キーが必要か */\n  metaKey?: boolean;\n  /** Shift キーが必要か */\n  shiftKey?: boolean;\n  /** Alt キーが必要か */\n  altKey?: boolean;\n  /** ショートカットが押された時のハンドラ */\n  handler: (e: KeyboardEvent) => void;\n  /** 説明（ヘルプ表示用） */\n  description?: string;\n  /** preventDefault を呼ぶか（デフォルト: true） */\n  preventDefault?: boolean;\n}\n\n/**\n * キーボードショートカットを登録するフック。\n *\n * `ctrlKey: true` の場合、Windows/Linux では Ctrl、Mac では Cmd (metaKey) の両方にマッチします。\n *\n * @param shortcuts - ショートカット定義の配列\n * @param enabled - ショートカットの有効/無効（デフォルト: true）\n *\n * @example\n * ```tsx\n * useKeyboardShortcuts([\n *   { key: 's', ctrlKey: true, handler: () => save(), description: '保存' },\n *   { key: 'Escape', handler: () => close(), description: '閉じる' },\n * ]);\n * ```\n */\nexport function useKeyboardShortcuts(shortcuts: KeyboardShortcut[], enabled: boolean = true) {\n  useEffect(() => {\n    if (!enabled) return;\n\n    const handleKeyDown = (e: KeyboardEvent) => {\n      for (const shortcut of shortcuts) {\n        // For ctrlKey, match either Ctrl (Windows/Linux) or Cmd (Mac)\n        const ctrlMatch =\n          shortcut.ctrlKey === undefined\n            ? true\n            : shortcut.ctrlKey\n              ? e.ctrlKey || e.metaKey\n              : !(e.ctrlKey || e.metaKey);\n\n        // For metaKey, only match Cmd on Mac\n        const metaMatch = shortcut.metaKey === undefined ? true : shortcut.metaKey === e.metaKey;\n\n        const shiftMatch =\n          shortcut.shiftKey === undefined ? true : shortcut.shiftKey === e.shiftKey;\n\n        const altMatch = shortcut.altKey === undefined ? true : shortcut.altKey === e.altKey;\n\n        const keyMatch = e.key.toLowerCase() === shortcut.key.toLowerCase();\n\n        if (ctrlMatch && metaMatch && shiftMatch && altMatch && keyMatch) {\n          if (shortcut.preventDefault !== false) {\n            e.preventDefault();\n          }\n          shortcut.handler(e);\n          break; // Only trigger one shortcut per keypress\n        }\n      }\n    };\n\n    window.addEventListener('keydown', handleKeyDown);\n    return () => window.removeEventListener('keydown', handleKeyDown);\n  }, [shortcuts, enabled]);\n}\n"],"mappings":"A,uGAyCA,SAAgBC,EAAqB,EAA+B,EAAmB,GAAM,EAC3F,EAAAD,EAAA,UAAA,KAAgB,CACd,GAAI,CAACE,EAAS,OAEd,IAAMC,EAAiB,GAAqB,CAC1C,IAAK,IAAMC,KAAYC,EAAW,CAEhC,IAAMC,EACJF,EAAS,UAAY,IAAA,GACjB,GACAA,EAAS,QACP,EAAE,SAAW,EAAE,QACf,EAAE,EAAE,SAAW,EAAE,SAGnBG,EAAYH,EAAS,UAAY,IAAA,IAAmBA,EAAS,UAAY,EAAE,QAE3EI,EACJJ,EAAS,WAAa,IAAA,IAAmBA,EAAS,WAAa,EAAE,SAE7DK,EAAWL,EAAS,SAAW,IAAA,IAAmBA,EAAS,SAAW,EAAE,OAExEM,EAAW,EAAE,IAAI,YAAY,IAAMN,EAAS,IAAI,YAAY,EAElE,GAAIE,GAAaC,GAAaC,GAAcC,GAAYC,EAAU,CAC5DN,EAAS,iBAAmB,IAC9B,EAAE,eAAe,EAEnBA,EAAS,QAAQ,CAAC,EAClB,KACF,CACF,CACF,EAGA,OADA,OAAO,iBAAiB,UAAWD,CAAa,MACnC,OAAO,oBAAoB,UAAWA,CAAa,CAClE,EAAG,CAACE,EAAWH,CAAO,CAAC,CACzB,C"}
+{"version":3,"file":"use-keyboard-shortcut.cjs","names":["react","useKeyboardShortcuts","enabled","handleKeyDown","shortcut","shortcuts","ctrlMatch","metaMatch","shiftMatch","altMatch","keyMatch"],"sources":["../../../../src/ui/lib/hooks/use-keyboard-shortcut.ts"],"sourcesContent":["import { useEffect } from 'react';\n\n/**\n * A case-insensitive key match and handler for useKeyboardShortcuts.\n *\n * @see useKeyboardShortcuts for registration and cleanup.\n */\nexport interface KeyboardShortcut {\n    /**\n     * KeyboardEvent.key value, compared case-insensitively.\n     */\n  key: string;\n    /**\n     * When true accept Ctrl or Meta; false excludes both; omission ignores this modifier.\n     */\n  ctrlKey?: boolean;\n    /**\n     * Require exact Meta state when provided; omission ignores Meta.\n     */\n  metaKey?: boolean;\n    /**\n     * Require exact Shift state when provided; omission ignores Shift.\n     */\n  shiftKey?: boolean;\n    /**\n     * Require exact Alt state when provided; omission ignores Alt.\n     */\n  altKey?: boolean;\n    /**\n     * Callback receiving the original keydown event after a match; only the first matching shortcut runs.\n     *\n     * @param e - Original matched keydown event.\n     *\n     * @returns No value after the handler completes.\n     */\n  handler: (e: KeyboardEvent) => void;\n    /**\n     * Optional application help text; not read by the hook.\n     */\n  description?: string;\n    /**\n     * Prevent the matched event default unless explicitly false; defaults to true.\n     */\n  preventDefault?: boolean;\n}\n\n/**\n * Registers ordered keyboard shortcuts on the browser window.\n *\n * @param shortcuts - Match definitions; the first matching definition receives the original event.\n *\n * @param enabled - Enable the listener; defaults to true.\n *\n * @returns No value; effect cleanup removes the listener on unmount or input changes.\n *\n * @remarks Omitted modifiers are ignored. ctrlKey:true accepts Ctrl or Meta on every\n * platform. Events in inputs, composition and repeats are not filtered. Handlers run\n * synchronously and their exceptions propagate through the browser event dispatch.\n * No providers or styles are required; keep the definitions stable to avoid resubscription.\n *\n * @example\n * ```tsx\n * import { useMemo } from 'react';\n * import { useKeyboardShortcuts } from '@alneas/appkit-react/ui/hooks';\n * export function SaveShortcut({ save }: { save: () => void }) {\n *   const shortcuts = useMemo(() => [{ key: 's', ctrlKey: true, handler: save }], [save]);\n *   useKeyboardShortcuts(shortcuts);\n *   return null;\n * }\n * ```\n */\nexport function useKeyboardShortcuts(shortcuts: KeyboardShortcut[], enabled: boolean = true) {\n  useEffect(() => {\n    if (!enabled) return;\n\n    const handleKeyDown = (e: KeyboardEvent) => {\n      for (const shortcut of shortcuts) {\n        // For ctrlKey, match either Ctrl (Windows/Linux) or Cmd (Mac)\n        const ctrlMatch =\n          shortcut.ctrlKey === undefined\n            ? true\n            : shortcut.ctrlKey\n              ? e.ctrlKey || e.metaKey\n              : !(e.ctrlKey || e.metaKey);\n\n        // For metaKey, only match Cmd on Mac\n        const metaMatch = shortcut.metaKey === undefined ? true : shortcut.metaKey === e.metaKey;\n\n        const shiftMatch =\n          shortcut.shiftKey === undefined ? true : shortcut.shiftKey === e.shiftKey;\n\n        const altMatch = shortcut.altKey === undefined ? true : shortcut.altKey === e.altKey;\n\n        const keyMatch = e.key.toLowerCase() === shortcut.key.toLowerCase();\n\n        if (ctrlMatch && metaMatch && shiftMatch && altMatch && keyMatch) {\n          if (shortcut.preventDefault !== false) {\n            e.preventDefault();\n          }\n          shortcut.handler(e);\n          break; // Only trigger one shortcut per keypress\n        }\n      }\n    };\n\n    window.addEventListener('keydown', handleKeyDown);\n    return () => window.removeEventListener('keydown', handleKeyDown);\n  }, [shortcuts, enabled]);\n}\n"],"mappings":"A,uGAuEA,SAAgBC,EAAqB,EAA+B,EAAmB,GAAM,EAC3F,EAAAD,EAAA,UAAA,KAAgB,CACd,GAAI,CAACE,EAAS,OAEd,IAAMC,EAAiB,GAAqB,CAC1C,IAAK,IAAMC,KAAYC,EAAW,CAEhC,IAAMC,EACJF,EAAS,UAAY,IAAA,GACjB,GACAA,EAAS,QACP,EAAE,SAAW,EAAE,QACf,EAAE,EAAE,SAAW,EAAE,SAGnBG,EAAYH,EAAS,UAAY,IAAA,IAAmBA,EAAS,UAAY,EAAE,QAE3EI,EACJJ,EAAS,WAAa,IAAA,IAAmBA,EAAS,WAAa,EAAE,SAE7DK,EAAWL,EAAS,SAAW,IAAA,IAAmBA,EAAS,SAAW,EAAE,OAExEM,EAAW,EAAE,IAAI,YAAY,IAAMN,EAAS,IAAI,YAAY,EAElE,GAAIE,GAAaC,GAAaC,GAAcC,GAAYC,EAAU,CAC5DN,EAAS,iBAAmB,IAC9B,EAAE,eAAe,EAEnBA,EAAS,QAAQ,CAAC,EAClB,KACF,CACF,CACF,EAGA,OADA,OAAO,iBAAiB,UAAWD,CAAa,MACnC,OAAO,oBAAoB,UAAWA,CAAa,CAClE,EAAG,CAACE,EAAWH,CAAO,CAAC,CACzB,C"}