npm - @alneas/appkit-react - Versions diffs - 0.2.0 → 0.3.0 - Mend

@alneas/appkit-react 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1514) hide show

package/dist/ui/components/ui/toggle-group.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"toggle-group.js","names":["~~React","~~ToggleGroupPrimitive","TogglePrimitive","~~React$1","~~ToggleGroup$1","ToggleGroup","props","cn","className","ToggleGroupItem","Toggle"],"sources":["../../../../src/ui/components/ui/toggle-group.tsx"],"sourcesContent":["import * as React from 'react';\nimport { ToggleGroup as ToggleGroupPrimitive } from '@base-ui/react/toggle-group';\nimport { Toggle as TogglePrimitive } from '@base-ui/react/toggle';\n\nimport { cn } from '../../lib/utils';\n\n/*\n Coordinates a collection of toggle values through Base UI group state.\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 ToggleGroup composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Place distinct value-bearing items under ToggleGroup. The wrappers use Base UI ToggleGroup and Toggle directly; group selection behavior follows the upstream props. Unlike Toggle, these wrappers do not apply toggleVariants. The ref prop forwards to the rendered control or container declared by the component ref type.\n * @example\n * ```tsx\n * import { ToggleGroup, ToggleGroupItem } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n \n export function Example() {\n * return (<ToggleGroup defaultValue={[\"bold\"]} aria-label=\"Text style\"><ToggleGroupItem value=\"bold\" aria-label=\"Bold\">B</ToggleGroupItem><ToggleGroupItem value=\"italic\" aria-label=\"Italic\">I</ToggleGroupItem></ToggleGroup>);\n * }\n * ```\n /\~~nconst~~ ToggleGroup ~~= React.forwardRef<\~~n ~~HTMLDivElement~~,\n React.ComponentPropsWithoutRef<typeof ToggleGroupPrimitive>\n>~~(({ className, children, ...props }, ref~~) => (\n <ToggleGroupPrimitive\n ref={ref}\n className={cn('flex items-center justify-center gap-1', className)}\n {...props}\n >\n {children}\n </ToggleGroupPrimitive>\n));\nToggleGroup.displayName = 'ToggleGroup';\n\n/\n Renders a value-bearing toggle inside its surrounding 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 ToggleGroupItem composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Place distinct value-bearing items under ToggleGroup. The wrappers use Base UI ToggleGroup and Toggle directly; group selection behavior follows the upstream props. Unlike Toggle, these wrappers do not apply toggleVariants. The ref prop forwards to the rendered control or container declared by the component ref type.\n * @example\n * ```tsx\n * import { ToggleGroup, ToggleGroupItem } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n \n export function Example() {\n * return (<ToggleGroup defaultValue={[\"bold\"]} aria-label=\"Text style\"><ToggleGroupItem value=\"bold\" aria-label=\"Bold\">B</ToggleGroupItem><ToggleGroupItem value=\"italic\" aria-label=\"Italic\">I</ToggleGroupItem></ToggleGroup>);\n * }\n * ```\n /\~~nconst~~ ToggleGroupItem = React.~~forwardRef~~<\n ~~HTMLButtonElement,\n~~ React.ComponentPropsWithoutRef<typeof TogglePrimitive> & {\n /\n Identity for this choice within the surrounding group; provide a distinct stable string.\n */\n value: string;\n }\n>~~(({~~ ~~className, children, ...props }, ref~~) => {\n // In Base UI, we just use Toggle inside ToggleGroup?\n // Or is there a ToggleGroup.Item?\n // Docs/Exports showed ToggleGroup export.\n // Usually standard pattern is ToggleGroup.Item.\n // But if ToggleGroup is a component, maybe it accepts Toggles?\n // Let's assume we use Toggle as Item, but wrapped.\n // Wait, Toggle needs to know if it's checked based on Group.\n // If Base UI ToggleGroup communicates via Context, then Toggle inside it works.\n // Explicitly importing standard Toggle.\n return (\n <TogglePrimitive\n ref={ref}\n className={cn(\n 'inline-flex items-center justify-center rounded-md text-sm font-medium ring-offset-background transition-colors hover:bg-muted hover:text-muted-foreground 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-[pressed]:bg-accent data-[pressed]:text-accent-foreground first:rounded-l-md last:rounded-r-md',\n className,\n )}\n {...props}\n >\n {children}\n </TogglePrimitive>\n );\n}~~);\~~nToggleGroupItem.displayName = 'ToggleGroupItem';\n\nexport { ToggleGroup, ToggleGroupItem };\n"],"mappings":";;;;;;;AAqBA,~~IAAMK~~,~~IAAcL~~,~~EAAM~~,~~YAGvB~~,~~EAAE~~,~~cAAW~~,~~aAAU~~,~~GAAGM~~,~~KAAS~~,~~MACpC~~,~~kBAACL,~~GAAD;~~CACO~~;~~CACL~~,~~WAAWM~~,EAAG,0CAA0CC,CAAS;~~CACjE~~,GAAIF;~~CAEH~~;~~AACmB~~,CAAA~~,CACvB~~;~~AACD~~,EAAY,cAAc;AAiB1B,~~IAAMG~~,~~IAAkBT~~,~~EAAM~~,~~YAQ3B~~,~~EAAE~~,~~cAAW~~,~~aAAU~~,~~GAAGM~~,~~KAAS~~,~~MAWlC~~,~~kBAACJ,~~GAAD;~~CACO~~;~~CACL~~,~~WAAWK~~,EACT,uZACAC,CACF;~~CACA~~,GAAIF;~~CAEH~~;~~AACc~~,CAAA~~,CAEpB~~;~~AACD~~,EAAgB,cAAc"}
1	+ {"version":3,"file":"toggle-group.js","names":["ToggleGroupPrimitive","TogglePrimitive","ToggleGroup$1","ToggleGroup","props","cn","className","ToggleGroupItem","Toggle"],"sources":["../../../../src/ui/components/ui/toggle-group.tsx"],"sourcesContent":["import * as React from 'react';\nimport { ToggleGroup as ToggleGroupPrimitive } from '@base-ui/react/toggle-group';\nimport { Toggle as TogglePrimitive } from '@base-ui/react/toggle';\n\nimport { cn } from '../../lib/utils';\n\n/*\n Coordinates a collection of toggle values through Base UI group state.\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 ToggleGroup composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Place distinct value-bearing items under ToggleGroup. The wrappers use Base UI ToggleGroup and Toggle directly; group selection behavior follows the upstream props. Unlike Toggle, these wrappers do not apply toggleVariants. The ref prop forwards to the rendered control or container declared by the component ref type.\n * @example\n * ```tsx\n * import { ToggleGroup, ToggleGroupItem } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n \n export function Example() {\n * return (<ToggleGroup defaultValue={[\"bold\"]} aria-label=\"Text style\"><ToggleGroupItem value=\"bold\" aria-label=\"Bold\">B</ToggleGroupItem><ToggleGroupItem value=\"italic\" aria-label=\"Italic\">I</ToggleGroupItem></ToggleGroup>);\n * }\n * ```\n /\nfunction ToggleGroup({\n ref,\n className,\n children,\n ...props\n}: React.PropsWithoutRef<React.ComponentPropsWithoutRef<typeof ToggleGroupPrimitive>> &\n React.RefAttributes<HTMLDivElement>) {\n return (\n <ToggleGroupPrimitive\n ref={ref}\n className={cn('flex items-center justify-center gap-1', className)}\n {...props}\n >\n {children}\n </ToggleGroupPrimitive>\n );\n}\nToggleGroup.displayName = 'ToggleGroup';\n\n/\n Renders a value-bearing toggle inside its surrounding 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 ToggleGroupItem composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Place distinct value-bearing items under ToggleGroup. The wrappers use Base UI ToggleGroup and Toggle directly; group selection behavior follows the upstream props. Unlike Toggle, these wrappers do not apply toggleVariants. The ref prop forwards to the rendered control or container declared by the component ref type.\n * @example\n * ```tsx\n * import { ToggleGroup, ToggleGroupItem } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n \n export function Example() {\n * return (<ToggleGroup defaultValue={[\"bold\"]} aria-label=\"Text style\"><ToggleGroupItem value=\"bold\" aria-label=\"Bold\">B</ToggleGroupItem><ToggleGroupItem value=\"italic\" aria-label=\"Italic\">I</ToggleGroupItem></ToggleGroup>);\n * }\n * ```\n /\nfunction ToggleGroupItem({\n ref,\n className,\n children,\n ...props\n}: React.PropsWithoutRef<\n React.ComponentPropsWithoutRef<typeof TogglePrimitive> & {\n /\n Identity for this choice within the surrounding group; provide a distinct stable string.\n */\n value: string;\n }\n> &\n React.RefAttributes<HTMLButtonElement>) {\n // In Base UI, we just use Toggle inside ToggleGroup?\n // Or is there a ToggleGroup.Item?\n // Docs/Exports showed ToggleGroup export.\n // Usually standard pattern is ToggleGroup.Item.\n // But if ToggleGroup is a component, maybe it accepts Toggles?\n // Let's assume we use Toggle as Item, but wrapped.\n // Wait, Toggle needs to know if it's checked based on Group.\n // If Base UI ToggleGroup communicates via Context, then Toggle inside it works.\n // Explicitly importing standard Toggle.\n return (\n <TogglePrimitive\n ref={ref}\n className={cn(\n 'inline-flex items-center justify-center rounded-md text-sm font-medium ring-offset-background transition-colors hover:bg-muted hover:text-muted-foreground 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-[pressed]:bg-accent data-[pressed]:text-accent-foreground first:rounded-l-md last:rounded-r-md',\n className,\n )}\n {...props}\n >\n {children}\n </TogglePrimitive>\n );\n}\nToggleGroupItem.displayName = 'ToggleGroupItem';\n\nexport { ToggleGroup, ToggleGroupItem };\n"],"mappings":";;;;;;;AAqBA,SAASG,EAAY,EACnB,QACA,cACA,aACA,GAAGC,KAEkC;CACrC,OACE,kBAACJ,GAAD;EACO;EACL,WAAWK,EAAG,0CAA0CC,CAAS;EACjE,GAAIF;EAEH;CACmB,CAAA;AAE1B;AACA,EAAY,cAAc;AAiB1B,SAASG,EAAgB,EACvB,QACA,cACA,aACA,GAAGH,KASqC;CAUxC,OACE,kBAACH,GAAD;EACO;EACL,WAAWI,EACT,uZACAC,CACF;EACA,GAAIF;EAEH;CACc,CAAA;AAErB;AACA,EAAgB,cAAc"}

package/dist/ui/components/ui/tooltip.cjs CHANGED Viewed

@@ -1,2 +1,2 @@
-"use client";"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../../_virtual/_rolldown/runtime.cjs"),t=require("../../lib/utils.cjs");let n=require("react/jsx-runtime"),r=require("react");r=e.__toESM(r,1);let i=require("@base-ui/react/tooltip");function a({delay:e=0,...t}){return(0,n.jsx)(i.Tooltip.Provider,{"data-slot":`tooltip-provider`,delay:e,...t})}function o({...e}){return(0,n.jsx)(a,{children:(0,n.jsx)(i.Tooltip.Root,{"data-slot":`tooltip`,...e})})}function s({children:e,...t}){return(0,n.jsx)(i.Tooltip.Trigger,{"data-slot":`tooltip-trigger`,...t,children:e})}var c=r.forwardRef(({className:e,side:r=`top`,sideOffset:a=4,align:o=`center`,alignOffset:s=0,children:c,...l},u)=>(0,n.jsx)(i.Tooltip.Portal,{children:(0,n.jsx)(i.Tooltip.Positioner,{align:o,alignOffset:s,side:r,sideOffset:a,className:`isolate z-50`,children:(0,n.jsxs)(i.Tooltip.Popup,{ref:u,"data-slot":`tooltip-content`,className:t.cn(`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)`,e),...l,children:[c,(0,n.jsx)(i.Tooltip.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`})]})})}));c.displayName=`TooltipContent`,exports.Tooltip=o,exports.TooltipContent=c,exports.TooltipProvider=a,exports.TooltipTrigger=s;
+"use client";"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../../_virtual/_rolldown/runtime.cjs"),t=require("../../lib/utils.cjs");let n=require("react/jsx-runtime"),r=require("react");r=e.__toESM(r,1);let i=require("@base-ui/react/tooltip");function a({delay:e=0,...t}){return(0,n.jsx)(i.Tooltip.Provider,{"data-slot":`tooltip-provider`,delay:e,...t})}function o({...e}){return(0,n.jsx)(a,{children:(0,n.jsx)(i.Tooltip.Root,{"data-slot":`tooltip`,...e})})}function s({children:e,...t}){return(0,n.jsx)(i.Tooltip.Trigger,{"data-slot":`tooltip-trigger`,...t,children:e})}function c({ref:e,className:r,side:a=`top`,sideOffset:o=4,align:s=`center`,alignOffset:c=0,children:l,...u}){return(0,n.jsx)(i.Tooltip.Portal,{children:(0,n.jsx)(i.Tooltip.Positioner,{align:s,alignOffset:c,side:a,sideOffset:o,className:`isolate z-50`,children:(0,n.jsxs)(i.Tooltip.Popup,{ref:e,"data-slot":`tooltip-content`,className:t.cn(`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)`,r),...u,children:[l,(0,n.jsx)(i.Tooltip.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`})]})})})}c.displayName=`TooltipContent`,exports.Tooltip=o,exports.TooltipContent=c,exports.TooltipProvider=a,exports.TooltipTrigger=s;
 //# sourceMappingURL=tooltip.cjs.map

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

	@@ -1 +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 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"}
1	+ {"version":3,"file":"tooltip.cjs","names":["TooltipPrimitive","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 */\nfunction TooltipContent({\n ref,\n className,\n side = 'top',\n sideOffset = 4,\n align = 'center',\n alignOffset = 0,\n children,\n ...props\n}: React.PropsWithoutRef<\n TooltipPrimitive.Popup.Props &\n Pick<TooltipPrimitive.Positioner.Props, 'align' \| 'alignOffset' \| 'side' \| 'sideOffset'>\n> &\n React.RefAttributes<HTMLDivElement>) {\n return (\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,SAASO,EAAgB,CAAE,QAAQ,EAAG,GAAGC,GAA0C,CACjF,OAAO,EAAAJ,EAAA,IAAA,CAACJ,EAAAA,QAAiB,SAAlB,CAA2B,YAAU,mBAA0B,QAAO,GAAIQ,CAAQ,CAAA,CAC3F,CAiBA,SAASC,EAAQ,CAAE,GAAGD,GAAsC,CAC1D,OACE,EAAAJ,EAAA,IAAA,CAACG,EAAD,CAAA,UACE,EAAAH,EAAA,IAAA,CAACJ,EAAAA,QAAiB,KAAlB,CAAuB,YAAU,UAAU,GAAIQ,CAAQ,CAAA,CACxC,CAAA,CAErB,CAiBA,SAASE,EAAe,CACtB,WACA,GAAGF,GAC8B,CACjC,OACE,EAAAJ,EAAA,IAAA,CAACJ,EAAAA,QAAiB,QAAlB,CACE,YAAU,kBACV,GAAIQ,EAEH,UACuB,CAAA,CAE9B,CAiBA,SAASG,EAAe,CACtB,MACA,YACA,OAAO,MACP,aAAa,EACb,QAAQ,SACR,cAAc,EACd,WACA,GAAGH,GAKkC,CACrC,OACE,EAAAJ,EAAA,IAAA,CAACJ,EAAAA,QAAiB,OAAlB,CAAA,UACE,EAAAI,EAAA,IAAA,CAACJ,EAAAA,QAAiB,WAAlB,CACS,QACM,cACP,OACM,aACZ,UAAU,eAEV,UAAA,EAAAI,EAAA,KAAA,CAACJ,EAAAA,QAAiB,MAAlB,CACO,MACL,YAAU,kBACV,UAAWC,EAAAA,GACT,8fACAW,CACF,EACA,GAAIJ,EAPN,SAAA,CASGK,GACD,EAAAT,EAAA,IAAA,CAACJ,EAAAA,QAAiB,MAAlB,CAAwB,UAAU,uUAAyU,CAAA,CACrV,C,EACG,CAAA,CACN,CAAA,CAE7B,CACA,EAAe,YAAc,iB"}

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

@@ -63,5 +63,8 @@ declare function TooltipTrigger({ children, ...props }: TooltipPrimitive.Trigger
  * }
  * ```
  */
-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>>;
+declare function TooltipContent({ ref, className, side, sideOffset, align, alignOffset, children, ...props }: React.PropsWithoutRef<TooltipPrimitive.Popup.Props & Pick<TooltipPrimitive.Positioner.Props, 'align' | 'alignOffset' | 'side' | 'sideOffset'>> & React.RefAttributes<HTMLDivElement>): React.JSX.Element;
+declare namespace TooltipContent {
+    var displayName: string;
+}
 export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };

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

@@ -63,5 +63,8 @@ declare function TooltipTrigger({ children, ...props }: TooltipPrimitive.Trigger
  * }
  * ```
  */
-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>>;
+declare function TooltipContent({ ref, className, side, sideOffset, align, alignOffset, children, ...props }: React.PropsWithoutRef<TooltipPrimitive.Popup.Props & Pick<TooltipPrimitive.Positioner.Props, 'align' | 'alignOffset' | 'side' | 'sideOffset'>> & React.RefAttributes<HTMLDivElement>): React.JSX.Element;
+declare namespace TooltipContent {
+    var displayName: string;
+}
 export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };

package/dist/ui/components/ui/tooltip.js CHANGED Viewed

@@ -2,45 +2,47 @@
 "use client";
 import { cn as e } from "../../lib/utils.js";
 import { jsx as t, jsxs as n } from "react/jsx-runtime";
-import * as r from "react";
-import { Tooltip as i } from "@base-ui/react/tooltip";
+import "react";
+import { Tooltip as r } from "@base-ui/react/tooltip";
 //#region src/ui/components/ui/tooltip.tsx
-function a({ delay: e = 0, ...n }) {
-	return /* @__PURE__ */ t(i.Provider, {
+function i({ delay: e = 0, ...n }) {
+	return /* @__PURE__ */ t(r.Provider, {
 		"data-slot": "tooltip-provider",
 		delay: e,
 		...n
 	});
 }
-function o({ ...e }) {
-	return /* @__PURE__ */ t(a, { children: /* @__PURE__ */ t(i.Root, {
+function a({ ...e }) {
+	return /* @__PURE__ */ t(i, { children: /* @__PURE__ */ t(r.Root, {
 		"data-slot": "tooltip",
 		...e
 	}) });
 }
-function s({ children: e, ...n }) {
-	return /* @__PURE__ */ t(i.Trigger, {
+function o({ children: e, ...n }) {
+	return /* @__PURE__ */ t(r.Trigger, {
 		"data-slot": "tooltip-trigger",
 		...n,
 		children: e
 	});
 }
-var c = r.forwardRef(({ className: r, side: a = "top", sideOffset: o = 4, align: s = "center", alignOffset: c = 0, children: l, ...u }, d) => /* @__PURE__ */ t(i.Portal, { children: /* @__PURE__ */ t(i.Positioner, {
-	align: s,
-	alignOffset: c,
-	side: a,
-	sideOffset: o,
-	className: "isolate z-50",
-	children: /* @__PURE__ */ n(i.Popup, {
-		ref: d,
-		"data-slot": "tooltip-content",
-		className: e("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)", r),
-		...u,
-		children: [l, /* @__PURE__ */ t(i.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" })]
-	})
-}) }));
-c.displayName = "TooltipContent";
+function s({ ref: i, className: a, side: o = "top", sideOffset: s = 4, align: c = "center", alignOffset: l = 0, children: u, ...d }) {
+	return /* @__PURE__ */ t(r.Portal, { children: /* @__PURE__ */ t(r.Positioner, {
+		align: c,
+		alignOffset: l,
+		side: o,
+		sideOffset: s,
+		className: "isolate z-50",
+		children: /* @__PURE__ */ n(r.Popup, {
+			ref: i,
+			"data-slot": "tooltip-content",
+			className: e("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)", a),
+			...d,
+			children: [u, /* @__PURE__ */ t(r.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" })]
+		})
+	}) });
+}
+s.displayName = "TooltipContent";
 //#endregion
-export { o as Tooltip, c as TooltipContent, a as TooltipProvider, s as TooltipTrigger };
+export { a as Tooltip, s as TooltipContent, i as TooltipProvider, o as TooltipTrigger };
 //# sourceMappingURL=tooltip.js.map

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

	@@ -1 +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 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"}
1	+ {"version":3,"file":"tooltip.js","names":["TooltipPrimitive","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 */\nfunction TooltipContent({\n ref,\n className,\n side = 'top',\n sideOffset = 4,\n align = 'center',\n alignOffset = 0,\n children,\n ...props\n}: React.PropsWithoutRef<\n TooltipPrimitive.Popup.Props &\n Pick<TooltipPrimitive.Positioner.Props, 'align' \| 'alignOffset' \| 'side' \| 'sideOffset'>\n> &\n React.RefAttributes<HTMLDivElement>) {\n return (\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,SAASE,EAAgB,EAAE,WAAQ,GAAG,GAAGC,KAA0C;CACjF,OAAO,kBAACH,EAAiB,UAAlB;EAA2B,aAAU;EAA0B;EAAO,GAAIG;CAAQ,CAAA;AAC3F;AAiBA,SAASC,EAAQ,EAAE,GAAGD,KAAsC;CAC1D,OACE,kBAACD,GAAD,EAAA,UACE,kBAACF,EAAiB,MAAlB;EAAuB,aAAU;EAAU,GAAIG;CAAQ,CAAA,EACxC,CAAA;AAErB;AAiBA,SAASE,EAAe,EACtB,aACA,GAAGF,KAC8B;CACjC,OACE,kBAACH,EAAiB,SAAlB;EACE,aAAU;EACV,GAAIG;EAEH;CACuB,CAAA;AAE9B;AAiBA,SAASG,EAAe,EACtB,QACA,cACA,UAAO,OACP,gBAAa,GACb,WAAQ,UACR,iBAAc,GACd,aACA,GAAGH,KAKkC;CACrC,OACE,kBAACH,EAAiB,QAAlB,EAAA,UACE,kBAACA,EAAiB,YAAlB;EACS;EACM;EACP;EACM;EACZ,WAAU;EAEV,UAAA,kBAACA,EAAiB,OAAlB;GACO;GACL,aAAU;GACV,WAAWO,EACT,+fACAC,CACF;GACA,GAAIL;GAPN,UAAA,CASGM,GACD,kBAACT,EAAiB,OAAlB,EAAwB,WAAU,wUAAyU,CAAA,CACrV;;CACG,CAAA,EACN,CAAA;AAE7B;AACA,EAAe,cAAc"}

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

@@ -1,2 +1,2 @@
-"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("react");function t(t,n=!0){(0,e.useEffect)(()=>{if(!n)return;let e=e=>{for(let n of t){let t=n.ctrlKey===void 0?!0:n.ctrlKey?e.ctrlKey||e.metaKey:!(e.ctrlKey||e.metaKey),r=n.metaKey===void 0||n.metaKey===e.metaKey,i=n.shiftKey===void 0||n.shiftKey===e.shiftKey,a=n.altKey===void 0||n.altKey===e.altKey,o=e.key.toLowerCase()===n.key.toLowerCase();if(t&&r&&i&&a&&o){n.preventDefault!==!1&&e.preventDefault(),n.handler(e);break}}};return window.addEventListener(`keydown`,e),()=>window.removeEventListener(`keydown`,e)},[t,n])}exports.useKeyboardShortcuts=t;
+"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("react");function t(t,n=!0){let r=(0,e.useEffectEvent)(e=>{for(let n of t){let t=n.ctrlKey===void 0?!0:n.ctrlKey?e.ctrlKey||e.metaKey:!(e.ctrlKey||e.metaKey),r=n.metaKey===void 0||n.metaKey===e.metaKey,i=n.shiftKey===void 0||n.shiftKey===e.shiftKey,a=n.altKey===void 0||n.altKey===e.altKey,o=e.key.toLowerCase()===n.key.toLowerCase();if(t&&r&&i&&a&&o){n.preventDefault!==!1&&e.preventDefault(),n.handler(e);break}}});(0,e.useEffect)(()=>{if(!n)return;let e=e=>r(e);return window.addEventListener(`keydown`,e),()=>window.removeEventListener(`keydown`,e)},[n])}exports.useKeyboardShortcuts=t;
 //# sourceMappingURL=use-keyboard-shortcut.cjs.map

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

	@@ -1 +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 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"}
1	+ {"version":3,"file":"use-keyboard-shortcut.cjs","names":["useEffectEvent","react","useKeyboardShortcuts","onKeyDown","shortcut","shortcuts","ctrlMatch","metaMatch","shiftMatch","altMatch","keyMatch","enabled","handleKeyDown","event"],"sources":["../../../../src/ui/lib/hooks/use-keyboard-shortcut.ts"],"sourcesContent":["import { useEffect, useEffectEvent } 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 when disabled.\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. Definitions and handlers use their latest committed\n * values without resubscribing; only enabled controls the subscription.\n \n @example\n * ```tsx\n * import { useKeyboardShortcuts } from '@alneas/appkit-react/ui/hooks';\n * export function SaveShortcut({ save }: { save: () => void }) {\n * useKeyboardShortcuts([{ key: 's', ctrlKey: true, handler: save }]);\n * return null;\n * }\n * ```\n */\nexport function useKeyboardShortcuts(shortcuts: KeyboardShortcut[], enabled: boolean = true) {\n const onKeyDown = useEffectEvent((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 = 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 useEffect(() => {\n if (!enabled) return;\n\n const handleKeyDown = (event: KeyboardEvent) => onKeyDown(event);\n window.addEventListener('keydown', handleKeyDown);\n return () => window.removeEventListener('keydown', handleKeyDown);\n }, [enabled]);\n}\n"],"mappings":"A,uGAsEA,SAAgBE,EAAqB,EAA+B,EAAmB,GAAM,CAC3F,IAAMC,GAAA,EAAYH,EAAAA,eAAAA,CAAgB,GAAqB,CACrD,IAAK,IAAMI,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,EAAaJ,EAAS,WAAa,IAAA,IAAmBA,EAAS,WAAa,EAAE,SAE9EK,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,CAAC,GAED,EAAAH,EAAA,UAAA,KAAgB,CACd,GAAI,CAACU,EAAS,OAEd,IAAMC,EAAiB,GAAyBT,EAAUU,CAAK,EAE/D,OADA,OAAO,iBAAiB,UAAWD,CAAa,MACnC,OAAO,oBAAoB,UAAWA,CAAa,CAClE,EAAG,CAACD,CAAO,CAAC,CACd,C"}

package/dist/ui/lib/hooks/use-keyboard-shortcut.d.cts CHANGED Viewed

@@ -48,20 +48,19 @@ export interface KeyboardShortcut {
  *
  * @param enabled - Enable the listener; defaults to true.
  *
- * @returns No value; effect cleanup removes the listener on unmount or input changes.
+ * @returns No value; effect cleanup removes the listener on unmount or when disabled.
  *
  * @remarks Omitted modifiers are ignored. ctrlKey:true accepts Ctrl or Meta on every
  * platform. Events in inputs, composition and repeats are not filtered. Handlers run
  * synchronously and their exceptions propagate through the browser event dispatch.
- * No providers or styles are required; keep the definitions stable to avoid resubscription.
+ * No providers or styles are required. Definitions and handlers use their latest committed
+ * values without resubscribing; only enabled controls the subscription.
  *
  * @example
  * ```tsx
- * import { useMemo } from 'react';
  * import { useKeyboardShortcuts } from '@alneas/appkit-react/ui/hooks';
  * export function SaveShortcut({ save }: { save: () => void }) {
- *   const shortcuts = useMemo(() => [{ key: 's', ctrlKey: true, handler: save }], [save]);
- *   useKeyboardShortcuts(shortcuts);
+ *   useKeyboardShortcuts([{ key: 's', ctrlKey: true, handler: save }]);
  *   return null;
  * }
  * ```

package/dist/ui/lib/hooks/use-keyboard-shortcut.d.ts CHANGED Viewed

@@ -48,20 +48,19 @@ export interface KeyboardShortcut {
  *
  * @param enabled - Enable the listener; defaults to true.
  *
- * @returns No value; effect cleanup removes the listener on unmount or input changes.
+ * @returns No value; effect cleanup removes the listener on unmount or when disabled.
  *
  * @remarks Omitted modifiers are ignored. ctrlKey:true accepts Ctrl or Meta on every
  * platform. Events in inputs, composition and repeats are not filtered. Handlers run
  * synchronously and their exceptions propagate through the browser event dispatch.
- * No providers or styles are required; keep the definitions stable to avoid resubscription.
+ * No providers or styles are required. Definitions and handlers use their latest committed
+ * values without resubscribing; only enabled controls the subscription.
  *
  * @example
  * ```tsx
- * import { useMemo } from 'react';
  * import { useKeyboardShortcuts } from '@alneas/appkit-react/ui/hooks';
  * export function SaveShortcut({ save }: { save: () => void }) {
- *   const shortcuts = useMemo(() => [{ key: 's', ctrlKey: true, handler: save }], [save]);
- *   useKeyboardShortcuts(shortcuts);
+ *   useKeyboardShortcuts([{ key: 's', ctrlKey: true, handler: save }]);
  *   return null;
  * }
  * ```

package/dist/ui/lib/hooks/use-keyboard-shortcut.js CHANGED Viewed

@@ -1,22 +1,23 @@
 "use client";
-import { useEffect as e } from "react";
+import { useEffect as e, useEffectEvent as t } from "react";
 //#region src/ui/lib/hooks/use-keyboard-shortcut.ts
-function t(t, n = !0) {
-	e(() => {
-		if (!n) return;
-		let e = (e) => {
-			for (let n of t) {
-				let t = n.ctrlKey === void 0 ? !0 : n.ctrlKey ? e.ctrlKey || e.metaKey : !(e.ctrlKey || e.metaKey), r = n.metaKey === void 0 || n.metaKey === e.metaKey, i = n.shiftKey === void 0 || n.shiftKey === e.shiftKey, a = n.altKey === void 0 || n.altKey === e.altKey, o = e.key.toLowerCase() === n.key.toLowerCase();
-				if (t && r && i && a && o) {
-					n.preventDefault !== !1 && e.preventDefault(), n.handler(e);
-					break;
-				}
+function n(n, r = !0) {
+	let i = t((e) => {
+		for (let t of n) {
+			let n = t.ctrlKey === void 0 ? !0 : t.ctrlKey ? e.ctrlKey || e.metaKey : !(e.ctrlKey || e.metaKey), r = t.metaKey === void 0 || t.metaKey === e.metaKey, i = t.shiftKey === void 0 || t.shiftKey === e.shiftKey, a = t.altKey === void 0 || t.altKey === e.altKey, o = e.key.toLowerCase() === t.key.toLowerCase();
+			if (n && r && i && a && o) {
+				t.preventDefault !== !1 && e.preventDefault(), t.handler(e);
+				break;
 			}
-		};
+		}
+	});
+	e(() => {
+		if (!r) return;
+		let e = (e) => i(e);
 		return window.addEventListener("keydown", e), () => window.removeEventListener("keydown", e);
-	}, [t, n]);
+	}, [r]);
 }
 //#endregion
-export { t as useKeyboardShortcuts };
+export { n as useKeyboardShortcuts };
 //# sourceMappingURL=use-keyboard-shortcut.js.map

package/dist/ui/lib/hooks/use-keyboard-shortcut.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"use-keyboard-shortcut.js","names":["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":";;;~~AAuEA~~,SAAgBA,EAAqB,GAA+B,IAAmB,IAAM;CAC3F,~~QAAgB;EACd~~,~~IAAI~~,~~CAACC~~,~~GAAS;EAEd,IAAMC,KAAiB,~~MAAqB;~~GAC1C~~,KAAK,IAAMC,KAAYC,GAAW;~~IAEhC~~,IAAMC,IACJF,EAAS,YAAY,KAAA,IACjB,KACAA,EAAS,UACP,EAAE,WAAW,EAAE,UACf,EAAE,EAAE,WAAW,EAAE,UAGnBG,IAAYH,EAAS,YAAY,KAAA,KAAmBA,EAAS,YAAY,EAAE,SAE3EI,~~IACJJ~~,EAAS,aAAa,KAAA,KAAmBA,EAAS,aAAa,EAAE,~~UAE7DK~~,IAAWL,EAAS,WAAW,KAAA,KAAmBA,EAAS,WAAW,EAAE,QAExEM,IAAW,EAAE,IAAI,YAAY,MAAMN,EAAS,IAAI,YAAY;~~IAElE~~,IAAIE,KAAaC,KAAaC,KAAcC,KAAYC,GAAU;~~KAIhE~~,AAHIN,EAAS,mBAAmB,MAC9B,EAAE,eAAe,GAEnBA,EAAS,QAAQ,CAAC;~~KAClB~~;~~IACF;~~GACF;EACF;~~EAGA~~,OADA,OAAO,iBAAiB,WAAWD,CAAa,SACnC,OAAO,oBAAoB,WAAWA,CAAa;CAClE,GAAG,~~CAACE~~,~~GAAWH,~~CAAO,CAAC;~~AACzB~~"}
1	+ {"version":3,"file":"use-keyboard-shortcut.js","names":["useKeyboardShortcuts","onKeyDown","useEffectEvent","shortcut","shortcuts","ctrlMatch","metaMatch","shiftMatch","altMatch","keyMatch","enabled","handleKeyDown","event"],"sources":["../../../../src/ui/lib/hooks/use-keyboard-shortcut.ts"],"sourcesContent":["import { useEffect, useEffectEvent } 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 when disabled.\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. Definitions and handlers use their latest committed\n * values without resubscribing; only enabled controls the subscription.\n \n @example\n * ```tsx\n * import { useKeyboardShortcuts } from '@alneas/appkit-react/ui/hooks';\n * export function SaveShortcut({ save }: { save: () => void }) {\n * useKeyboardShortcuts([{ key: 's', ctrlKey: true, handler: save }]);\n * return null;\n * }\n * ```\n */\nexport function useKeyboardShortcuts(shortcuts: KeyboardShortcut[], enabled: boolean = true) {\n const onKeyDown = useEffectEvent((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 = 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 useEffect(() => {\n if (!enabled) return;\n\n const handleKeyDown = (event: KeyboardEvent) => onKeyDown(event);\n window.addEventListener('keydown', handleKeyDown);\n return () => window.removeEventListener('keydown', handleKeyDown);\n }, [enabled]);\n}\n"],"mappings":";;;AAsEA,SAAgBA,EAAqB,GAA+B,IAAmB,IAAM;CAC3F,IAAMC,IAAYC,GAAgB,MAAqB;EACrD,KAAK,IAAMC,KAAYC,GAAW;GAEhC,IAAMC,IACJF,EAAS,YAAY,KAAA,IACjB,KACAA,EAAS,UACP,EAAE,WAAW,EAAE,UACf,EAAE,EAAE,WAAW,EAAE,UAGnBG,IAAYH,EAAS,YAAY,KAAA,KAAmBA,EAAS,YAAY,EAAE,SAE3EI,IAAaJ,EAAS,aAAa,KAAA,KAAmBA,EAAS,aAAa,EAAE,UAE9EK,IAAWL,EAAS,WAAW,KAAA,KAAmBA,EAAS,WAAW,EAAE,QAExEM,IAAW,EAAE,IAAI,YAAY,MAAMN,EAAS,IAAI,YAAY;GAElE,IAAIE,KAAaC,KAAaC,KAAcC,KAAYC,GAAU;IAIhE,AAHIN,EAAS,mBAAmB,MAC9B,EAAE,eAAe,GAEnBA,EAAS,QAAQ,CAAC;IAClB;GACF;EACF;CACF,CAAC;CAED,QAAgB;EACd,IAAI,CAACO,GAAS;EAEd,IAAMC,KAAiB,MAAyBV,EAAUW,CAAK;EAE/D,OADA,OAAO,iBAAiB,WAAWD,CAAa,SACnC,OAAO,oBAAoB,WAAWA,CAAa;CAClE,GAAG,CAACD,CAAO,CAAC;AACd"}

package/docs/index.md CHANGED Viewed

@@ -10,106 +10,33 @@ tags: ["appkit", "overview"]
 # Appkit React
-React 19 components, schema-driven forms and record views for business applications.
+React 19 components, schema-driven forms, record tables and AI interfaces for
+business applications. Your application supplies data adapters and server rules.
-[npm](https://www.npmjs.com/package/@alneas/appkit-react) · [Documentation](https://tech-docs.alneas.com/appkit/appkit-react/) · [GitHub](https://github.com/dataarthub/appkit) · [Change history](https://github.com/dataarthub/appkit/blob/main/packages/appkit-react/CHANGELOG.md)
+## Usage
-## Elevator Pitch
-Turn a JSON Schema into a form with validation and connect saves to your own backend. Combine forms with record tables, shared UI primitives and AI proposal review interfaces.
-## Why & Value
-Use React when your application needs the presentation layer for Appkit's schema and record contracts. You provide the authenticated data adapter and server rules; the form uses that adapter and reports the save result to your UI.
-React depends on [Appkit Core](https://www.npmjs.com/package/@alneas/appkit-core). Install Core directly as well when your own code imports its types or functions, as the example below does. For backend-only validation, storage or graph calculations, use Core alone.
-## Key Highlights
-- **Schema forms and record tables:** build input, filtering and CRUD views around shared record contracts. [Tools guide](tools.md)
-- **React UI primitives:** compose buttons, dialogs, shared providers and hooks. [UI guide](ui.md)
-- **AI interfaces:** connect chat and proposal review to explicit application approval and execution boundaries. [AI guide](ai.md)
-- **Explicit integration:** import styles and supply host providers and data adapters. [Complete form recipe](request-form.md)
-## Quickstart
-### Requirements and installation
-Use an existing React application. The package declares Node.js **24 or later** and requires React and React DOM **`^19.2.3`**. It provides ESM, CommonJS and TypeScript declarations.
-```bash
-npm install @alneas/appkit-react @alneas/appkit-core react@^19.2.3 react-dom@^19.2.3 @tanstack/react-query@5.104.4
-# Or use bun add with the same package names and versions.
-```
-The example directly imports TanStack Query, so it is listed explicitly. Import Appkit CSS once at your application's stylesheet entry point. `FormView` also requires `QueryClientProvider` and `DataAccessProvider`; a standalone `Button` does not require those data providers. Install optional chart, barcode, QR or AI peers only for their corresponding features; see [the export reference](exports.md).
-### Render and save a request form
-This component accepts your application's `DataAccessAdapter`. Implement that adapter for your backend and pass it as the `adapter` prop; no demo backend or credentials are included.
+Requires Node.js 24 or later and React / React DOM `^19.2.3`. Import styles once
+at your application's entry point.
 ```tsx
-import { useState, type ComponentProps } from 'react';
-import type { DataAccessAdapter } from '@alneas/appkit-core/data';
-import { QueryClientProvider } from '@tanstack/react-query';
-import {
-  createQueryClient,
-  DataAccessProvider,
-} from '@alneas/appkit-react/tools/data-access/react';
-import { FormView } from '@alneas/appkit-react/tools/form';
+import { Button } from '@alneas/appkit-react/ui';
 import '@alneas/appkit-react/styles';
-const schema: ComponentProps<typeof FormView>['schema'] = {
-  type: 'object',
-  properties: {
-    name: { type: 'string', title: 'Name', minLength: 2 },
-    reason: { type: 'string', title: 'Reason', 'x-ui': { widget: 'textarea' } },
-  },
-  required: ['name'],
-};
-export function RequestForm({ adapter }: { adapter: DataAccessAdapter }) {
-  const [client] = useState(createQueryClient);
-  const [saved, setSaved] = useState('');
-  return (
-    <QueryClientProvider client={client}>
-      <DataAccessProvider adapter={adapter}>
-        <FormView
-          testId="persistence"
-          collection="records"
-          mode="create"
-          schema={schema}
-          validation={{
-            emptyStrings: 'preserve',
-            locale: 'en',
-            cast: { numericMode: 'strict' },
-          }}
-          onSuccess={record => setSaved(JSON.stringify(record))}
-        />
-        <output aria-label="Persisted">{saved}</output>
-      </DataAccessProvider>
-    </QueryClientProvider>
-  );
+export function SaveButton({ save }: { save: () => void }) {
+  return <Button onClick={save}>Save</Button>;
 }
 ```
-The form renders Name and Reason fields. A name shorter than two characters should fail validation. A successful save displays the record returned by your adapter. Your backend must enforce authorization, business rules and concurrency; browser validation is only the UI boundary. If your application already has a shared Query client, reuse its provider instead of adding another one. See the [complete recipe](request-form.md) for failure and retry checks.
-## Next Steps
-- [Schema forms and record tables](tools.md): the business UI entry points.
-- [UI primitives and providers](ui.md): components and shared host setup.
-- [Public exports and optional peers](exports.md): exact feature paths and additional dependencies.
-- [AI integration and security](ai.md): proposal review and execution boundaries.
-- [Migration guide](migration.md): moving from the earlier separate packages.
-### For coding agents
-Start with the [agent instructions](https://github.com/dataarthub/appkit/blob/main/packages/appkit-react/consumer-ai/SKILL.md), then use the [API catalog](https://github.com/dataarthub/appkit/blob/main/packages/appkit-react/consumer-ai/api-index.json) and [full documentation](https://github.com/dataarthub/appkit/blob/main/packages/appkit-react/llms-full.txt). Installed packages include these files under `consumer-ai/` and `llms-full.txt`; their locations are also listed in the `appkit.agent` manifest field.
+For schema forms and record views, follow the [complete form recipe](request-form.md)
+for the data adapter, Query provider and peer setup. Optional integrations have
+[additional peer requirements](exports.md).
-### Contributing and license
+## Documentation
-[Contributing](https://github.com/dataarthub/appkit/blob/main/CONTRIBUTING.md) · [Releasing](https://github.com/dataarthub/appkit/blob/main/RELEASING.md) · [MIT license](https://github.com/dataarthub/appkit/blob/main/packages/appkit-react/LICENSE)
+[Guides and API](https://tech-docs.alneas.com/appkit/appkit-react/) ·
+[Change history](https://github.com/dataarthub/appkit/blob/main/packages/appkit-react/CHANGELOG.md) ·
+[GitHub Issues](https://github.com/dataarthub/appkit/issues)
-Third-party license texts retained from the compiled CSS are included in [THIRD_PARTY_NOTICES.md](https://github.com/dataarthub/appkit/blob/main/packages/appkit-react/THIRD_PARTY_NOTICES.md), also shipped in the package root.
+Upgrading to 0.3.0 introduces breaking drag-event and component-type changes.
+Read the [migration guide](https://github.com/dataarthub/appkit/blob/main/packages/appkit-react/docs/migration.md)
+before upgrading. A prepared source version does not establish npm availability.