@accelint/design-toolkit 9.13.0 → 10.1.0

package/dist/components/drawer/context.d.ts

@@ -12,7 +12,7 @@
 
 import { DrawerContextValue, DrawerEvent } from "./types.js";
 import "client-only";
-import * as react18 from "react";
+import * as react10 from "react";
 import { UniqueId } from "@accelint/core";
 import { Broadcast } from "@accelint/bus";
 
@@ -25,7 +25,7 @@ import { Broadcast } from "@accelint/bus";
  * const { register, unregister, placement } = useContext(DrawerContext);
  * ```
  */
-declare const DrawerContext: react18.Context<DrawerContextValue>;
+declare const DrawerContext: react10.Context<DrawerContextValue>;
 /**
  * Event bus instance for drawer-related events.
  *

package/dist/components/drawer/footer.d.ts

@@ -11,7 +11,7 @@
  */
 
 import { ComponentPropsWithRef } from "react";
-import * as react_jsx_runtime64 from "react/jsx-runtime";
+import * as react_jsx_runtime45 from "react/jsx-runtime";
 
 //#region src/components/drawer/footer.d.ts
 
@@ -39,7 +39,7 @@ import * as react_jsx_runtime64 from "react/jsx-runtime";
 declare function DrawerFooter({
   className,
   ...rest
-}: ComponentPropsWithRef<'footer'>): react_jsx_runtime64.JSX.Element;
+}: ComponentPropsWithRef<'footer'>): react_jsx_runtime45.JSX.Element;
 //#endregion
 export { DrawerFooter };
 //# sourceMappingURL=footer.d.ts.map

package/dist/components/drawer/header-title.d.ts

@@ -11,7 +11,7 @@
  */
 
 import { DrawerTitleProps } from "./types.js";
-import * as react_jsx_runtime65 from "react/jsx-runtime";
+import * as react_jsx_runtime46 from "react/jsx-runtime";
 
 //#region src/components/drawer/header-title.d.ts
 
@@ -41,7 +41,7 @@ declare function DrawerHeaderTitle({
   className,
   level,
   ...rest
-}: DrawerTitleProps): react_jsx_runtime65.JSX.Element;
+}: DrawerTitleProps): react_jsx_runtime46.JSX.Element;
 //#endregion
 export { DrawerHeaderTitle };
 //# sourceMappingURL=header-title.d.ts.map

package/dist/components/drawer/header.d.ts

@@ -12,7 +12,7 @@
 
 import "client-only";
 import { ComponentPropsWithRef } from "react";
-import * as react_jsx_runtime66 from "react/jsx-runtime";
+import * as react_jsx_runtime47 from "react/jsx-runtime";
 
 //#region src/components/drawer/header.d.ts
 
@@ -52,7 +52,7 @@ declare function DrawerHeader({
   title,
   children,
   ...rest
-}: ComponentPropsWithRef<'header'>): react_jsx_runtime66.JSX.Element;
+}: ComponentPropsWithRef<'header'>): react_jsx_runtime47.JSX.Element;
 //#endregion
 export { DrawerHeader };
 //# sourceMappingURL=header.d.ts.map

package/dist/components/drawer/index.d.ts

@@ -12,7 +12,7 @@
 
 import { DrawerProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime67 from "react/jsx-runtime";
+import * as react_jsx_runtime48 from "react/jsx-runtime";
 
 //#region src/components/drawer/index.d.ts
 
@@ -63,7 +63,7 @@ declare function Drawer({
   size,
   onChange,
   ...rest
-}: DrawerProps): react_jsx_runtime67.JSX.Element;
+}: DrawerProps): react_jsx_runtime48.JSX.Element;
 //#endregion
 export { Drawer };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/drawer/layout-main.d.ts

@@ -11,7 +11,7 @@
  */
 
 import { ComponentPropsWithRef } from "react";
-import * as react_jsx_runtime68 from "react/jsx-runtime";
+import * as react_jsx_runtime82 from "react/jsx-runtime";
 
 //#region src/components/drawer/layout-main.d.ts
 
@@ -38,7 +38,7 @@ import * as react_jsx_runtime68 from "react/jsx-runtime";
 declare function DrawerLayoutMain({
   className,
   ...rest
-}: ComponentPropsWithRef<'main'>): react_jsx_runtime68.JSX.Element;
+}: ComponentPropsWithRef<'main'>): react_jsx_runtime82.JSX.Element;
 //#endregion
 export { DrawerLayoutMain };
 //# sourceMappingURL=layout-main.d.ts.map

package/dist/components/drawer/layout.d.ts

@@ -11,7 +11,7 @@
  */
 
 import { DrawerLayoutProps } from "./types.js";
-import * as react_jsx_runtime69 from "react/jsx-runtime";
+import * as react_jsx_runtime85 from "react/jsx-runtime";
 
 //#region src/components/drawer/layout.d.ts
 
@@ -42,7 +42,7 @@ declare function DrawerLayout({
   extend,
   push,
   ...rest
-}: DrawerLayoutProps): react_jsx_runtime69.JSX.Element;
+}: DrawerLayoutProps): react_jsx_runtime85.JSX.Element;
 //#endregion
 export { DrawerLayout };
 //# sourceMappingURL=layout.d.ts.map

package/dist/components/drawer/menu-item.d.ts

@@ -12,7 +12,7 @@
 
 import { DrawerMenuItemProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime70 from "react/jsx-runtime";
+import * as react_jsx_runtime86 from "react/jsx-runtime";
 
 //#region src/components/drawer/menu-item.d.ts
 
@@ -45,7 +45,7 @@ declare function DrawerMenuItem({
   toggle,
   textValue,
   ...rest
-}: DrawerMenuItemProps): react_jsx_runtime70.JSX.Element | null;
+}: DrawerMenuItemProps): react_jsx_runtime86.JSX.Element | null;
 //#endregion
 export { DrawerMenuItem };
 //# sourceMappingURL=menu-item.d.ts.map

package/dist/components/drawer/menu.d.ts

@@ -11,7 +11,7 @@
  */
 
 import { DrawerMenuProps } from "./types.js";
-import * as react_jsx_runtime71 from "react/jsx-runtime";
+import * as react_jsx_runtime87 from "react/jsx-runtime";
 
 //#region src/components/drawer/menu.d.ts
 
@@ -39,7 +39,7 @@ declare function DrawerMenu({
   position,
   children,
   ...rest
-}: DrawerMenuProps): react_jsx_runtime71.JSX.Element;
+}: DrawerMenuProps): react_jsx_runtime87.JSX.Element;
 //#endregion
 export { DrawerMenu };
 //# sourceMappingURL=menu.d.ts.map

package/dist/components/drawer/panel.d.ts

@@ -11,7 +11,7 @@
  */
 
 import { ComponentPropsWithRef } from "react";
-import * as react_jsx_runtime72 from "react/jsx-runtime";
+import * as react_jsx_runtime88 from "react/jsx-runtime";
 
 //#region src/components/drawer/panel.d.ts
 
@@ -36,7 +36,7 @@ import * as react_jsx_runtime72 from "react/jsx-runtime";
 declare function DrawerPanel({
   className,
   ...rest
-}: ComponentPropsWithRef<'div'>): react_jsx_runtime72.JSX.Element;
+}: ComponentPropsWithRef<'div'>): react_jsx_runtime88.JSX.Element;
 //#endregion
 export { DrawerPanel };
 //# sourceMappingURL=panel.d.ts.map

package/dist/components/drawer/trigger.d.ts

@@ -12,7 +12,7 @@
 
 import { DrawerTriggerProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime73 from "react/jsx-runtime";
+import * as react_jsx_runtime50 from "react/jsx-runtime";
 
 //#region src/components/drawer/trigger.d.ts
 
@@ -47,7 +47,7 @@ import * as react_jsx_runtime73 from "react/jsx-runtime";
 declare function DrawerTrigger({
   for: events,
   ...rest
-}: DrawerTriggerProps): react_jsx_runtime73.JSX.Element;
+}: DrawerTriggerProps): react_jsx_runtime50.JSX.Element;
 //#endregion
 export { DrawerTrigger };
 //# sourceMappingURL=trigger.d.ts.map

package/dist/components/drawer/view.d.ts

@@ -13,7 +13,7 @@
 import { ViewStackViewProps } from "../view-stack/types.js";
 import "client-only";
 import { ComponentPropsWithRef } from "react";
-import * as react_jsx_runtime74 from "react/jsx-runtime";
+import * as react_jsx_runtime52 from "react/jsx-runtime";
 
 //#region src/components/drawer/view.d.ts
 
@@ -44,7 +44,7 @@ declare function DrawerView({
   children,
   className,
   ...rest
-}: ViewStackViewProps & ComponentPropsWithRef<'div'>): react_jsx_runtime74.JSX.Element;
+}: ViewStackViewProps & ComponentPropsWithRef<'div'>): react_jsx_runtime52.JSX.Element;
 //#endregion
 export { DrawerView };
 //# sourceMappingURL=view.d.ts.map

package/dist/components/flashcard/index.d.ts

@@ -12,14 +12,14 @@
 
 import { FlashcardComponentProps, FlashcardDetailsListProps, FlashcardProps } from "./types.js";
 import "client-only";
-import * as react21 from "react";
-import * as react_jsx_runtime77 from "react/jsx-runtime";
+import * as react13 from "react";
+import * as react_jsx_runtime53 from "react/jsx-runtime";
 
 //#region src/components/flashcard/index.d.ts
 /**
  * Context for sharing Flashcard state across child components.
  */
-declare const FlashcardContext: react21.Context<FlashcardProps>;
+declare const FlashcardContext: react13.Context<FlashcardProps>;
 /**
  * Flashcard - A quick visual identifier for map entity data.
  *
@@ -46,7 +46,7 @@ declare const FlashcardContext: react21.Context<FlashcardProps>;
  * </Flashcard>
  * ```
  */
-declare function Flashcard(props: FlashcardProps): react_jsx_runtime77.JSX.Element;
+declare function Flashcard(props: FlashcardProps): react_jsx_runtime53.JSX.Element;
 declare namespace Flashcard {
   var displayName: string;
 }
@@ -68,7 +68,7 @@ declare namespace Flashcard {
  * </Flashcard>
  * ```
  */
-declare function FlashcardHero(props: FlashcardComponentProps): react_jsx_runtime77.JSX.Element;
+declare function FlashcardHero(props: FlashcardComponentProps): react_jsx_runtime53.JSX.Element;
 declare namespace FlashcardHero {
   var displayName: string;
 }
@@ -92,7 +92,7 @@ declare namespace FlashcardHero {
  * </Flashcard>
  * ```
  */
-declare function FlashcardAdditionalData(props: FlashcardComponentProps): react_jsx_runtime77.JSX.Element | null;
+declare function FlashcardAdditionalData(props: FlashcardComponentProps): react_jsx_runtime53.JSX.Element | null;
 declare namespace FlashcardAdditionalData {
   var displayName: string;
 }
@@ -119,7 +119,7 @@ declare namespace FlashcardAdditionalData {
  * </Flashcard>
  * ```
  */
-declare function FlashcardDetailsList(props: FlashcardDetailsListProps): react_jsx_runtime77.JSX.Element;
+declare function FlashcardDetailsList(props: FlashcardDetailsListProps): react_jsx_runtime53.JSX.Element;
 declare namespace FlashcardDetailsList {
   var displayName: string;
 }
@@ -141,7 +141,7 @@ declare namespace FlashcardDetailsList {
  * </FlashcardDetailsList>
  * ```
  */
-declare function FlashcardDetailsLabel(props: FlashcardComponentProps): react_jsx_runtime77.JSX.Element;
+declare function FlashcardDetailsLabel(props: FlashcardComponentProps): react_jsx_runtime53.JSX.Element;
 declare namespace FlashcardDetailsLabel {
   var displayName: string;
 }
@@ -163,7 +163,7 @@ declare namespace FlashcardDetailsLabel {
  * </FlashcardDetailsList>
  * ```
  */
-declare function FlashcardDetailsValue(props: FlashcardComponentProps): react_jsx_runtime77.JSX.Element;
+declare function FlashcardDetailsValue(props: FlashcardComponentProps): react_jsx_runtime53.JSX.Element;
 declare namespace FlashcardDetailsValue {
   var displayName: string;
 }

package/dist/components/floating-card/constants.d.ts

@@ -0,0 +1,26 @@
+//#region src/components/floating-card/constants.d.ts
+/** Size a card opens at when `initialDimensions` is omitted. */
+declare const DEFAULT_DIMENSIONS: {
+  readonly width: 300;
+  readonly height: 400;
+};
+/** Position a card opens at when `initialPosition` is omitted. */
+declare const DEFAULT_POSITION: {
+  readonly x: 100;
+  readonly y: 100;
+};
+/** Smallest size a card can be resized to. */
+declare const MIN_DIMENSIONS: {
+  readonly width: 150;
+  readonly height: 100;
+};
+/**
+ * Pointer travel, in pixels, before a press on the header becomes a drag.
+ * Keeps a click from nudging the card.
+ */
+declare const DRAG_THRESHOLD = 5;
+/** Stacking order the first card in a provider receives. */
+declare const BASE_Z_INDEX = 1;
+//#endregion
+export { BASE_Z_INDEX, DEFAULT_DIMENSIONS, DEFAULT_POSITION, DRAG_THRESHOLD, MIN_DIMENSIONS };
+//# sourceMappingURL=constants.d.ts.map

package/dist/components/floating-card/constants.js

@@ -0,0 +1,40 @@
+/*
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+//#region src/components/floating-card/constants.ts
+/** Size a card opens at when `initialDimensions` is omitted. */
+const DEFAULT_DIMENSIONS = {
+	width: 300,
+	height: 400
+};
+/** Position a card opens at when `initialPosition` is omitted. */
+const DEFAULT_POSITION = {
+	x: 100,
+	y: 100
+};
+/** Smallest size a card can be resized to. */
+const MIN_DIMENSIONS = {
+	width: 150,
+	height: 100
+};
+/**
+* Pointer travel, in pixels, before a press on the header becomes a drag.
+* Keeps a click from nudging the card.
+*/
+const DRAG_THRESHOLD = 5;
+/** Stacking order the first card in a provider receives. */
+const BASE_Z_INDEX = 1;
+
+//#endregion
+export { BASE_Z_INDEX, DEFAULT_DIMENSIONS, DEFAULT_POSITION, DRAG_THRESHOLD, MIN_DIMENSIONS };
+//# sourceMappingURL=constants.js.map

package/dist/components/floating-card/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","names":[],"sources":["../../../src/components/floating-card/constants.ts"],"sourcesContent":["// __private-exports\n/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n/** Size a card opens at when `initialDimensions` is omitted. */\nexport const DEFAULT_DIMENSIONS = { width: 300, height: 400 } as const;\n\n/** Position a card opens at when `initialPosition` is omitted. */\nexport const DEFAULT_POSITION = { x: 100, y: 100 } as const;\n\n/** Smallest size a card can be resized to. */\nexport const MIN_DIMENSIONS = { width: 150, height: 100 } as const;\n\n/**\n * Pointer travel, in pixels, before a press on the header becomes a drag.\n * Keeps a click from nudging the card.\n */\nexport const DRAG_THRESHOLD = 5;\n\n/** Stacking order the first card in a provider receives. */\nexport const BASE_Z_INDEX = 1;\n"],"mappings":";;;;;;;;;;;;;;;AAcA,MAAa,qBAAqB;CAAE,OAAO;CAAK,QAAQ;CAAK;;AAG7D,MAAa,mBAAmB;CAAE,GAAG;CAAK,GAAG;CAAK;;AAGlD,MAAa,iBAAiB;CAAE,OAAO;CAAK,QAAQ;CAAK;;;;;AAMzD,MAAa,iBAAiB;;AAG9B,MAAa,eAAe"}

package/dist/components/floating-card/context.d.ts

@@ -10,16 +10,48 @@
  * governing permissions and limitations under the License.
  */
 
-import { FloatingCardContextValue } from "./types.js";
-import * as react19 from "react";
+import { Dimensions, FloatingCardContextValue, Position } from "./types.js";
+import * as react14 from "react";
+import { UniqueId } from "@accelint/core/utility/uuid";
 
 //#region src/components/floating-card/context.d.ts
-declare const FloatingCardContext: react19.Context<FloatingCardContextValue | null>;
+/**
+ * How a `FloatingCard` attaches itself to its provider.
+ *
+ * @remarks
+ * Internal wiring rather than application API, so it is declared here rather
+ * than alongside the public types. Every member is stable for the provider's
+ * lifetime.
+ */
+type FloatingCardRegistryValue = {
+  /** Registers a card with the provider so it renders as a panel */
+  openCard: (id: UniqueId, title: string | undefined, position: Position, dimensions: Dimensions) => void;
+  /** Registers the DOM node a card's children portal into */
+  addRef: (id: UniqueId, ref: HTMLDivElement | null) => void;
+};
+declare const FloatingCardContext: react14.Context<FloatingCardContextValue | null>;
+/**
+ * Wiring between `FloatingCard` and its provider.
+ *
+ * @remarks
+ * Deliberately separate from {@link FloatingCardContext}: registering a card is
+ * an internal detail, so it stays off the value applications consume. Its
+ * members are stable for the provider's lifetime, so reading it never causes a
+ * re-render.
+ */
+declare const FloatingCardRegistryContext: react14.Context<FloatingCardRegistryValue | null>;
+/**
+ * Reads the registration channel a `FloatingCard` uses to attach itself.
+ *
+ * @returns The provider's registration callbacks.
+ * @throws {Error} If used outside of a FloatingCardProvider.
+ */
+declare function useFloatingCardRegistry(): FloatingCardRegistryValue;
 /**
  * Hook to access floating card management functionality.
  *
- * Provides access to card registry, ref management, and programmatic control
- * over opening, closing, and pinning floating cards.
+ * Provides the card registry and programmatic control over closing and pinning
+ * floating cards.
  *
  * @returns Context value with card management methods and state.
  * @throws {Error} If used outside of a FloatingCardProvider.
@@ -39,5 +71,5 @@ declare const FloatingCardContext: react19.Context<FloatingCardContextValue | nu
  */
 declare function useFloatingCard(): FloatingCardContextValue;
 //#endregion
-export { FloatingCardContext, useFloatingCard };
+export { FloatingCardContext, FloatingCardRegistryContext, FloatingCardRegistryValue, useFloatingCard, useFloatingCardRegistry };
 //# sourceMappingURL=context.d.ts.map

package/dist/components/floating-card/context.js

@@ -16,10 +16,31 @@ import { createContext, useContext } from "react";
 //#region src/components/floating-card/context.tsx
 const FloatingCardContext = createContext(null);
 /**
+* Wiring between `FloatingCard` and its provider.
+*
+* @remarks
+* Deliberately separate from {@link FloatingCardContext}: registering a card is
+* an internal detail, so it stays off the value applications consume. Its
+* members are stable for the provider's lifetime, so reading it never causes a
+* re-render.
+*/
+const FloatingCardRegistryContext = createContext(null);
+/**
+* Reads the registration channel a `FloatingCard` uses to attach itself.
+*
+* @returns The provider's registration callbacks.
+* @throws {Error} If used outside of a FloatingCardProvider.
+*/
+function useFloatingCardRegistry() {
+	const context = useContext(FloatingCardRegistryContext);
+	if (!context) throw new Error("FloatingCard must be rendered within a FloatingCardProvider.");
+	return context;
+}
+/**
 * Hook to access floating card management functionality.
 *
-* Provides access to card registry, ref management, and programmatic control
-* over opening, closing, and pinning floating cards.
+* Provides the card registry and programmatic control over closing and pinning
+* floating cards.
 *
 * @returns Context value with card management methods and state.
 * @throws {Error} If used outside of a FloatingCardProvider.
@@ -44,5 +65,5 @@ function useFloatingCard() {
 }
 
 //#endregion
-export { FloatingCardContext, useFloatingCard };
+export { FloatingCardContext, FloatingCardRegistryContext, useFloatingCard, useFloatingCardRegistry };
 //# sourceMappingURL=context.js.map

package/dist/components/floating-card/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/floating-card/context.tsx"],"sourcesContent":["// __private-exports\n/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { createContext, useContext } from 'react';\nimport type { FloatingCardContextValue } from './types';\n\nexport const FloatingCardContext =\n  createContext<FloatingCardContextValue | null>(null);\n/**\n * Hook to access floating card management functionality.\n *\n * Provides access to card registry, ref management, and programmatic control\n * over opening, closing, and pinning floating cards.\n *\n * @returns Context value with card management methods and state.\n * @throws {Error} If used outside of a FloatingCardProvider.\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const { closeCard, togglePinCard } = useFloatingCard();\n *\n *   return (\n *     <button onClick={() => closeCard('my-card-id' as UniqueId)}>\n *       Close Card\n *     </button>\n *   );\n * }\n * ```\n */\nexport function useFloatingCard(): FloatingCardContextValue {\n  const context = useContext(FloatingCardContext);\n  if (!context) {\n    throw new Error(\n      'useFloatingCard must be used within a FloatingCardProvider.',\n    );\n  }\n  return context;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,MAAa,sBACX,cAA+C,KAAK;;;;;;;;;;;;;;;;;;;;;;;AAuBtD,SAAgB,kBAA4C;CAC1D,MAAM,UAAU,WAAW,oBAAoB;AAC/C,KAAI,CAAC,QACH,OAAM,IAAI,MACR,8DACD;AAEH,QAAO"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/floating-card/context.tsx"],"sourcesContent":["// __private-exports\n/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { createContext, useContext } from 'react';\nimport type { UniqueId } from '@accelint/core/utility/uuid';\nimport type { Dimensions, FloatingCardContextValue, Position } from './types';\n\n/**\n * How a `FloatingCard` attaches itself to its provider.\n *\n * @remarks\n * Internal wiring rather than application API, so it is declared here rather\n * than alongside the public types. Every member is stable for the provider's\n * lifetime.\n */\nexport type FloatingCardRegistryValue = {\n  /** Registers a card with the provider so it renders as a panel */\n  openCard: (\n    id: UniqueId,\n    title: string | undefined,\n    position: Position,\n    dimensions: Dimensions,\n  ) => void;\n\n  /** Registers the DOM node a card's children portal into */\n  addRef: (id: UniqueId, ref: HTMLDivElement | null) => void;\n};\n\nexport const FloatingCardContext =\n  createContext<FloatingCardContextValue | null>(null);\n\n/**\n * Wiring between `FloatingCard` and its provider.\n *\n * @remarks\n * Deliberately separate from {@link FloatingCardContext}: registering a card is\n * an internal detail, so it stays off the value applications consume. Its\n * members are stable for the provider's lifetime, so reading it never causes a\n * re-render.\n */\nexport const FloatingCardRegistryContext =\n  createContext<FloatingCardRegistryValue | null>(null);\n\n/**\n * Reads the registration channel a `FloatingCard` uses to attach itself.\n *\n * @returns The provider's registration callbacks.\n * @throws {Error} If used outside of a FloatingCardProvider.\n */\nexport function useFloatingCardRegistry(): FloatingCardRegistryValue {\n  const context = useContext(FloatingCardRegistryContext);\n\n  if (!context) {\n    // Only FloatingCard reads this, so name that rather than the internal hook.\n    throw new Error(\n      'FloatingCard must be rendered within a FloatingCardProvider.',\n    );\n  }\n\n  return context;\n}\n\n/**\n * Hook to access floating card management functionality.\n *\n * Provides the card registry and programmatic control over closing and pinning\n * floating cards.\n *\n * @returns Context value with card management methods and state.\n * @throws {Error} If used outside of a FloatingCardProvider.\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const { closeCard, togglePinCard } = useFloatingCard();\n *\n *   return (\n *     <button onClick={() => closeCard('my-card-id' as UniqueId)}>\n *       Close Card\n *     </button>\n *   );\n * }\n * ```\n */\nexport function useFloatingCard(): FloatingCardContextValue {\n  const context = useContext(FloatingCardContext);\n  if (!context) {\n    throw new Error(\n      'useFloatingCard must be used within a FloatingCardProvider.',\n    );\n  }\n  return context;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAsCA,MAAa,sBACX,cAA+C,KAAK;;;;;;;;;;AAWtD,MAAa,8BACX,cAAgD,KAAK;;;;;;;AAQvD,SAAgB,0BAAqD;CACnE,MAAM,UAAU,WAAW,4BAA4B;AAEvD,KAAI,CAAC,QAEH,OAAM,IAAI,MACR,+DACD;AAGH,QAAO;;;;;;;;;;;;;;;;;;;;;;;;AAyBT,SAAgB,kBAA4C;CAC1D,MAAM,UAAU,WAAW,oBAAoB;AAC/C,KAAI,CAAC,QACH,OAAM,IAAI,MACR,8DACD;AAEH,QAAO"}

package/dist/components/floating-card/hooks/use-card-layout.d.ts

@@ -0,0 +1,36 @@
+/*
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import { Dimensions, FloatingCardLayout, Position } from "../types.js";
+import { UniqueId } from "@accelint/core/utility/uuid";
+
+//#region src/components/floating-card/hooks/use-card-layout.d.ts
+/**
+ * Tracks position, size, and stacking order for the cards in one provider.
+ *
+ * @returns The layout registry and the operations that mutate it.
+ *
+ * @remarks
+ * State is per-provider rather than module-level so two providers on a page
+ * keep independent stacking orders.
+ */
+declare function useCardLayout(): {
+  layouts: Record<UniqueId, FloatingCardLayout>;
+  registerCard: (id: UniqueId, title: string | undefined, position: Position, dimensions: Dimensions) => void;
+  unregisterCard: (id: UniqueId) => void;
+  moveCard: (id: UniqueId, position: Position) => void;
+  resizeCard: (id: UniqueId, dimensions: Dimensions, position: Position) => void;
+  bringToFront: (id: UniqueId) => void;
+};
+//#endregion
+export { useCardLayout };
+//# sourceMappingURL=use-card-layout.d.ts.map

package/dist/components/floating-card/hooks/use-card-layout.js

@@ -0,0 +1,106 @@
+/*
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+import { BASE_Z_INDEX } from "../constants.js";
+import { useCallback, useState } from "react";
+
+//#region src/components/floating-card/hooks/use-card-layout.ts
+/**
+* Tracks position, size, and stacking order for the cards in one provider.
+*
+* @returns The layout registry and the operations that mutate it.
+*
+* @remarks
+* State is per-provider rather than module-level so two providers on a page
+* keep independent stacking orders.
+*/
+function useCardLayout() {
+	const [layouts, setLayouts] = useState({});
+	return {
+		layouts,
+		registerCard: useCallback((id, title, position, dimensions) => {
+			setLayouts((current) => {
+				const existing = current[id];
+				if (existing) return existing.title === title ? current : {
+					...current,
+					[id]: {
+						...existing,
+						title
+					}
+				};
+				const highest = Object.values(current).reduce((max, layout) => Math.max(max, layout.zIndex), BASE_Z_INDEX - 1);
+				return {
+					...current,
+					[id]: {
+						title,
+						position,
+						dimensions,
+						zIndex: highest + 1
+					}
+				};
+			});
+		}, []),
+		unregisterCard: useCallback((id) => {
+			setLayouts((current) => {
+				if (!current[id]) return current;
+				const next = { ...current };
+				delete next[id];
+				return next;
+			});
+		}, []),
+		moveCard: useCallback((id, position) => {
+			setLayouts((current) => current[id] ? {
+				...current,
+				[id]: {
+					...current[id],
+					position
+				}
+			} : current);
+		}, []),
+		resizeCard: useCallback((id, dimensions, position) => {
+			setLayouts((current) => current[id] ? {
+				...current,
+				[id]: {
+					...current[id],
+					dimensions,
+					position
+				}
+			} : current);
+		}, []),
+		bringToFront: useCallback((id) => {
+			setLayouts((current) => {
+				const target = current[id];
+				if (!target) return current;
+				const highest = Object.values(current).reduce((max, layout) => Math.max(max, layout.zIndex), BASE_Z_INDEX - 1);
+				if (target.zIndex === highest) return current;
+				const ordered = Object.entries(current).filter(([cardId]) => cardId !== id).sort(([, a], [, b]) => a.zIndex - b.zIndex);
+				const next = { ...current };
+				ordered.forEach(([cardId, layout], index) => {
+					next[cardId] = {
+						...layout,
+						zIndex: BASE_Z_INDEX + index
+					};
+				});
+				next[id] = {
+					...target,
+					zIndex: BASE_Z_INDEX + ordered.length
+				};
+				return next;
+			});
+		}, [])
+	};
+}
+
+//#endregion
+export { useCardLayout };
+//# sourceMappingURL=use-card-layout.js.map

package/dist/components/floating-card/hooks/use-card-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-card-layout.js","names":[],"sources":["../../../../src/components/floating-card/hooks/use-card-layout.ts"],"sourcesContent":["// __private-exports\n/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { useCallback, useState } from 'react';\nimport { BASE_Z_INDEX } from '../constants';\nimport type { UniqueId } from '@accelint/core/utility/uuid';\nimport type { Dimensions, FloatingCardLayout, Position } from '../types';\n\n/**\n * Tracks position, size, and stacking order for the cards in one provider.\n *\n * @returns The layout registry and the operations that mutate it.\n *\n * @remarks\n * State is per-provider rather than module-level so two providers on a page\n * keep independent stacking orders.\n */\nexport function useCardLayout() {\n  const [layouts, setLayouts] = useState<Record<UniqueId, FloatingCardLayout>>(\n    {},\n  );\n\n  const registerCard = useCallback(\n    (\n      id: UniqueId,\n      title: string | undefined,\n      position: Position,\n      dimensions: Dimensions,\n    ) => {\n      setLayouts((current) => {\n        const existing = current[id];\n\n        // An open card keeps the geometry it has, so a re-register cannot undo\n        // a drag or resize. Only the title stays live.\n        if (existing) {\n          return existing.title === title\n            ? current\n            : { ...current, [id]: { ...existing, title } };\n        }\n\n        const highest = Object.values(current).reduce(\n          (max, layout) => Math.max(max, layout.zIndex),\n          BASE_Z_INDEX - 1,\n        );\n\n        return {\n          ...current,\n          [id]: { title, position, dimensions, zIndex: highest + 1 },\n        };\n      });\n    },\n    [],\n  );\n\n  const unregisterCard = useCallback((id: UniqueId) => {\n    setLayouts((current) => {\n      if (!current[id]) {\n        return current;\n      }\n\n      const next = { ...current };\n      delete next[id];\n\n      return next;\n    });\n  }, []);\n\n  const moveCard = useCallback((id: UniqueId, position: Position) => {\n    setLayouts((current) =>\n      current[id]\n        ? { ...current, [id]: { ...current[id], position } }\n        : current,\n    );\n  }, []);\n\n  const resizeCard = useCallback(\n    (id: UniqueId, dimensions: Dimensions, position: Position) => {\n      setLayouts((current) =>\n        current[id]\n          ? { ...current, [id]: { ...current[id], dimensions, position } }\n          : current,\n      );\n    },\n    [],\n  );\n\n  const bringToFront = useCallback((id: UniqueId) => {\n    setLayouts((current) => {\n      const target = current[id];\n\n      if (!target) {\n        return current;\n      }\n\n      const highest = Object.values(current).reduce(\n        (max, layout) => Math.max(max, layout.zIndex),\n        BASE_Z_INDEX - 1,\n      );\n\n      // Already on top -- skip the update so focusing a card repeatedly does\n      // not re-render every sibling.\n      if (target.zIndex === highest) {\n        return current;\n      }\n\n      // Renumber from the bottom rather than incrementing past the previous\n      // top. Alternating focus between two cards would otherwise climb without\n      // limit and eventually paint over application chrome.\n      const ordered = Object.entries(current)\n        .filter(([cardId]) => cardId !== id)\n        .sort(([, a], [, b]) => a.zIndex - b.zIndex);\n\n      const next = { ...current };\n\n      ordered.forEach(([cardId, layout], index) => {\n        next[cardId as UniqueId] = { ...layout, zIndex: BASE_Z_INDEX + index };\n      });\n\n      next[id] = { ...target, zIndex: BASE_Z_INDEX + ordered.length };\n\n      return next;\n    });\n  }, []);\n\n  return {\n    layouts,\n    registerCard,\n    unregisterCard,\n    moveCard,\n    resizeCard,\n    bringToFront,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,gBAAgB;CAC9B,MAAM,CAAC,SAAS,cAAc,SAC5B,EAAE,CACH;AAwGD,QAAO;EACL;EACA,cAxGmB,aAEjB,IACA,OACA,UACA,eACG;AACH,eAAY,YAAY;IACtB,MAAM,WAAW,QAAQ;AAIzB,QAAI,SACF,QAAO,SAAS,UAAU,QACtB,UACA;KAAE,GAAG;MAAU,KAAK;MAAE,GAAG;MAAU;MAAO;KAAE;IAGlD,MAAM,UAAU,OAAO,OAAO,QAAQ,CAAC,QACpC,KAAK,WAAW,KAAK,IAAI,KAAK,OAAO,OAAO,EAC7C,eAAe,EAChB;AAED,WAAO;KACL,GAAG;MACF,KAAK;MAAE;MAAO;MAAU;MAAY,QAAQ,UAAU;MAAG;KAC3D;KACD;KAEJ,EAAE,CACH;EA2EC,gBAzEqB,aAAa,OAAiB;AACnD,eAAY,YAAY;AACtB,QAAI,CAAC,QAAQ,IACX,QAAO;IAGT,MAAM,OAAO,EAAE,GAAG,SAAS;AAC3B,WAAO,KAAK;AAEZ,WAAO;KACP;KACD,EAAE,CAAC;EA+DJ,UA7De,aAAa,IAAc,aAAuB;AACjE,eAAY,YACV,QAAQ,MACJ;IAAE,GAAG;KAAU,KAAK;KAAE,GAAG,QAAQ;KAAK;KAAU;IAAE,GAClD,QACL;KACA,EAAE,CAAC;EAwDJ,YAtDiB,aAChB,IAAc,YAAwB,aAAuB;AAC5D,eAAY,YACV,QAAQ,MACJ;IAAE,GAAG;KAAU,KAAK;KAAE,GAAG,QAAQ;KAAK;KAAY;KAAU;IAAE,GAC9D,QACL;KAEH,EAAE,CACH;EA8CC,cA5CmB,aAAa,OAAiB;AACjD,eAAY,YAAY;IACtB,MAAM,SAAS,QAAQ;AAEvB,QAAI,CAAC,OACH,QAAO;IAGT,MAAM,UAAU,OAAO,OAAO,QAAQ,CAAC,QACpC,KAAK,WAAW,KAAK,IAAI,KAAK,OAAO,OAAO,EAC7C,eAAe,EAChB;AAID,QAAI,OAAO,WAAW,QACpB,QAAO;IAMT,MAAM,UAAU,OAAO,QAAQ,QAAQ,CACpC,QAAQ,CAAC,YAAY,WAAW,GAAG,CACnC,MAAM,GAAG,IAAI,GAAG,OAAO,EAAE,SAAS,EAAE,OAAO;IAE9C,MAAM,OAAO,EAAE,GAAG,SAAS;AAE3B,YAAQ,SAAS,CAAC,QAAQ,SAAS,UAAU;AAC3C,UAAK,UAAsB;MAAE,GAAG;MAAQ,QAAQ,eAAe;MAAO;MACtE;AAEF,SAAK,MAAM;KAAE,GAAG;KAAQ,QAAQ,eAAe,QAAQ;KAAQ;AAE/D,WAAO;KACP;KACD,EAAE,CAAC;EASL"}