@accelint/design-toolkit 9.3.0 → 9.4.0

package/dist/components/flashcard/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/flashcard/index.tsx"],"sourcesContent":["/*\n * Copyright 2025 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'use client';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport 'client-only';\nimport { createContext, useContext } from 'react';\nimport { Heading, Text } from 'react-aria-components';\nimport { DetailsList } from '../details-list';\nimport { DetailsListLabel } from '../details-list/label';\nimport { DetailsListValue } from '../details-list/value';\nimport { Skeleton } from '../skeleton';\nimport styles from './styles.module.css';\nimport type {\n  FlashcardComponentProps,\n  FlashcardDetailsListProps,\n  FlashcardProps,\n} from './types';\n\nexport const FlashcardContext = createContext<FlashcardProps>({\n  isLoading: false,\n  header: '',\n  subheader: '',\n});\n\n/**\n * Example usage.\n *\n * ```tsx\n * <Flashcard isLoading={isLoading} header=\"Identifier\" subheader=\"DATA\">\n *  <FlashcardHero />\n *  <FlashcardAdditionalData>\n *    {secondaryData}\n *  </FlashcardAdditionalData>\n *  <FlashcardDetailsList>\n *    {detail.map((detail) => (\n *     <Fragment key={detail.id}>\n *       <FlashcardDetailsLabel>\n *         {detail.label}\n *       </FlashcardDetailsLabel>\n *       <FlashcardDetailsValue>\n *         {detail.value}\n *       </FlashcardDetailsValue>\n *     </Fragment>\n *     ))}\n *  </FlashcardDetailsList>\n * </Flashcard>\n * ```\n */\nexport function Flashcard(props: FlashcardProps) {\n  const { isLoading, header, subheader, children, className, ...rest } = props;\n\n  return (\n    <FlashcardContext.Provider value={{ isLoading, header, subheader }}>\n      <div {...rest} className={clsx(styles.container, className)}>\n        {children}\n      </div>\n    </FlashcardContext.Provider>\n  );\n}\nFlashcard.displayName = 'Flashcard';\n\nexport function FlashcardHero(props: FlashcardComponentProps) {\n  const { children, className, ...rest } = props;\n  const { isLoading, header, subheader } = useContext(FlashcardContext);\n\n  if (isLoading) {\n    return (\n      <div {...rest} className={clsx(styles.hero, className, 'gap-s')}>\n        <Skeleton className={styles.skeleton} data-testid='hero-skeleton' />\n        <Skeleton className={clsx(styles.skeleton, styles.half)} />\n      </div>\n    );\n  }\n\n  return (\n    <div {...rest} className={clsx(styles.hero, className)}>\n      <FlashcardHeader className={styles.header}>{header}</FlashcardHeader>\n      <FlashcardSubheader className={styles.subheader}>\n        {subheader}\n      </FlashcardSubheader>\n    </div>\n  );\n}\nFlashcardHero.displayName = 'FlashcardHero';\n\nconst FlashcardHeader = Heading;\nconst FlashcardSubheader = Text;\n\nexport function FlashcardAdditionalData(props: FlashcardComponentProps) {\n  const { children, className, ...rest } = props;\n  const { isLoading } = useContext(FlashcardContext);\n\n  // While loading, don't display.\n  if (isLoading) {\n    return null;\n  }\n\n  return (\n    <div {...rest} className={clsx(styles.data, className)}>\n      {children}\n    </div>\n  );\n}\nFlashcardAdditionalData.displayName = 'FlashcardAdditionalData';\n\nexport function FlashcardDetailsList(props: FlashcardDetailsListProps) {\n  const { children, className, ...rest } = props;\n  return (\n    <DetailsList\n      {...rest}\n      align='justify'\n      classNames={{ list: clsx(styles['details-list'], className) }}\n    >\n      {children}\n    </DetailsList>\n  );\n}\nFlashcardDetailsList.displayName = 'FlashcardDetailsList';\n\nexport function FlashcardDetailsLabel(props: FlashcardComponentProps) {\n  const { isLoading } = useContext(FlashcardContext);\n  const { className, children, ...rest } = props;\n  return (\n    <DetailsListLabel\n      {...rest}\n      className={clsx(styles['details-label'], className)}\n    >\n      {isLoading ? (\n        <Skeleton className={clsx(styles.skeleton, styles.smaller)} />\n      ) : (\n        children\n      )}\n    </DetailsListLabel>\n  );\n}\nFlashcardDetailsLabel.displayName = 'FlashcardDetailsLabel';\n\nexport function FlashcardDetailsValue(props: FlashcardComponentProps) {\n  const { isLoading } = useContext(FlashcardContext);\n  const { className, children, ...rest } = props;\n  return (\n    <DetailsListValue\n      {...rest}\n      className={clsx(styles['details-value'], className)}\n    >\n      {isLoading ? (\n        <Skeleton className={clsx(styles.skeleton, styles.smaller)} />\n      ) : (\n        children\n      )}\n    </DetailsListValue>\n  );\n}\nFlashcardDetailsValue.displayName = 'FlashcardDetailsValue';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,MAAa,mBAAmB,cAA8B;CAC5D,WAAW;CACX,QAAQ;CACR,WAAW;CACZ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;AA0BF,SAAgB,UAAU,OAAuB;CAC/C,MAAM,EAAE,WAAW,QAAQ,WAAW,UAAU,WAAW,GAAG,SAAS;AAEvE,QACE,oBAAC,iBAAiB;EAAS,OAAO;GAAE;GAAW;GAAQ;GAAW;YAChE,oBAAC;GAAI,GAAI;GAAM,WAAW,KAAK,OAAO,WAAW,UAAU;GACxD;IACG;GACoB;;AAGhC,UAAU,cAAc;AAExB,SAAgB,cAAc,OAAgC;CAC5D,MAAM,EAAE,UAAU,WAAW,GAAG,SAAS;CACzC,MAAM,EAAE,WAAW,QAAQ,cAAc,WAAW,iBAAiB;AAErE,KAAI,UACF,QACE,qBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,MAAM,WAAW,QAAQ;aAC7D,oBAAC;GAAS,WAAW,OAAO;GAAU,eAAY;IAAkB,EACpE,oBAAC,YAAS,WAAW,KAAK,OAAO,UAAU,OAAO,KAAK,GAAI;GACvD;AAIV,QACE,qBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,MAAM,UAAU;aACpD,oBAAC;GAAgB,WAAW,OAAO;aAAS;IAAyB,EACrE,oBAAC;GAAmB,WAAW,OAAO;aACnC;IACkB;GACjB;;AAGV,cAAc,cAAc;AAE5B,MAAM,kBAAkB;AACxB,MAAM,qBAAqB;AAE3B,SAAgB,wBAAwB,OAAgC;CACtE,MAAM,EAAE,UAAU,WAAW,GAAG,SAAS;CACzC,MAAM,EAAE,cAAc,WAAW,iBAAiB;AAGlD,KAAI,UACF,QAAO;AAGT,QACE,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,MAAM,UAAU;EACnD;GACG;;AAGV,wBAAwB,cAAc;AAEtC,SAAgB,qBAAqB,OAAkC;CACrE,MAAM,EAAE,UAAU,WAAW,GAAG,SAAS;AACzC,QACE,oBAAC;EACC,GAAI;EACJ,OAAM;EACN,YAAY,EAAE,MAAM,KAAK,OAAO,iBAAiB,UAAU,EAAE;EAE5D;GACW;;AAGlB,qBAAqB,cAAc;AAEnC,SAAgB,sBAAsB,OAAgC;CACpE,MAAM,EAAE,cAAc,WAAW,iBAAiB;CAClD,MAAM,EAAE,WAAW,UAAU,GAAG,SAAS;AACzC,QACE,oBAAC;EACC,GAAI;EACJ,WAAW,KAAK,OAAO,kBAAkB,UAAU;YAElD,YACC,oBAAC,YAAS,WAAW,KAAK,OAAO,UAAU,OAAO,QAAQ,GAAI,GAE9D;GAEe;;AAGvB,sBAAsB,cAAc;AAEpC,SAAgB,sBAAsB,OAAgC;CACpE,MAAM,EAAE,cAAc,WAAW,iBAAiB;CAClD,MAAM,EAAE,WAAW,UAAU,GAAG,SAAS;AACzC,QACE,oBAAC;EACC,GAAI;EACJ,WAAW,KAAK,OAAO,kBAAkB,UAAU;YAElD,YACC,oBAAC,YAAS,WAAW,KAAK,OAAO,UAAU,OAAO,QAAQ,GAAI,GAE9D;GAEe;;AAGvB,sBAAsB,cAAc"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/flashcard/index.tsx"],"sourcesContent":["/*\n * Copyright 2025 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'use client';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport 'client-only';\nimport { createContext, useContext } from 'react';\nimport { Heading, Text } from 'react-aria-components';\nimport { DetailsList } from '../details-list';\nimport { DetailsListLabel } from '../details-list/label';\nimport { DetailsListValue } from '../details-list/value';\nimport { Skeleton } from '../skeleton';\nimport styles from './styles.module.css';\nimport type {\n  FlashcardComponentProps,\n  FlashcardDetailsListProps,\n  FlashcardProps,\n} from './types';\n\n/**\n * Context for sharing Flashcard state across child components.\n */\nexport const FlashcardContext = createContext<FlashcardProps>({\n  isLoading: false,\n  header: '',\n  subheader: '',\n});\n\n/**\n * Flashcard - A quick visual identifier for map entity data.\n *\n * Container component that provides loading state and header/subheader\n * to child components via context.\n *\n * @param props - {@link FlashcardProps}\n * @param props.isLoading - Whether the flashcard is in a loading state.\n * @param props.header - Primary header text.\n * @param props.subheader - Secondary text below the header.\n * @param props.children - Child components to render.\n * @param props.className - Optional CSS class name.\n * @returns The rendered Flashcard component.\n *\n * @example\n * ```tsx\n * <Flashcard isLoading={false} header=\"Identifier\" subheader=\"DATA\">\n *   <FlashcardHero />\n *   <FlashcardAdditionalData>Secondary info</FlashcardAdditionalData>\n *   <FlashcardDetailsList>\n *     <FlashcardDetailsLabel>Status</FlashcardDetailsLabel>\n *     <FlashcardDetailsValue>Active</FlashcardDetailsValue>\n *   </FlashcardDetailsList>\n * </Flashcard>\n * ```\n */\nexport function Flashcard(props: FlashcardProps) {\n  const { isLoading, header, subheader, children, className, ...rest } = props;\n\n  return (\n    <FlashcardContext.Provider value={{ isLoading, header, subheader }}>\n      <div {...rest} className={clsx(styles.container, className)}>\n        {children}\n      </div>\n    </FlashcardContext.Provider>\n  );\n}\nFlashcard.displayName = 'Flashcard';\n\n/**\n * FlashcardHero - Upper section displaying header and subheader.\n *\n * Reads header and subheader from Flashcard context. Shows skeleton\n * placeholders when the parent Flashcard has isLoading=true.\n *\n * @param props - {@link FlashcardComponentProps}\n * @param props.children - Optional child content.\n * @param props.className - Optional CSS class name.\n * @returns The rendered FlashcardHero component.\n *\n * @example\n * ```tsx\n * <Flashcard header=\"Entity Name\" subheader=\"Type\">\n *   <FlashcardHero />\n * </Flashcard>\n * ```\n */\nexport function FlashcardHero(props: FlashcardComponentProps) {\n  const { children, className, ...rest } = props;\n  const { isLoading, header, subheader } = useContext(FlashcardContext);\n\n  if (isLoading) {\n    return (\n      <div {...rest} className={clsx(styles.hero, className, 'gap-s')}>\n        <Skeleton className={styles.skeleton} data-testid='hero-skeleton' />\n        <Skeleton className={clsx(styles.skeleton, styles.half)} />\n      </div>\n    );\n  }\n\n  return (\n    <div {...rest} className={clsx(styles.hero, className)}>\n      <FlashcardHeader className={styles.header}>{header}</FlashcardHeader>\n      <FlashcardSubheader className={styles.subheader}>\n        {subheader}\n      </FlashcardSubheader>\n    </div>\n  );\n}\nFlashcardHero.displayName = 'FlashcardHero';\n\nconst FlashcardHeader = Heading;\nconst FlashcardSubheader = Text;\n\n/**\n * FlashcardAdditionalData - Secondary data section below the hero.\n *\n * Hidden when the parent Flashcard has isLoading=true.\n *\n * @param props - {@link FlashcardComponentProps}\n * @param props.children - Content to display in the section.\n * @param props.className - Optional CSS class name.\n * @returns The rendered FlashcardAdditionalData component, or null if loading.\n *\n * @example\n * ```tsx\n * <Flashcard header=\"Entity\" subheader=\"Data\">\n *   <FlashcardHero />\n *   <FlashcardAdditionalData>\n *     Last updated: 2024-01-15\n *   </FlashcardAdditionalData>\n * </Flashcard>\n * ```\n */\nexport function FlashcardAdditionalData(props: FlashcardComponentProps) {\n  const { children, className, ...rest } = props;\n  const { isLoading } = useContext(FlashcardContext);\n\n  // While loading, don't display.\n  if (isLoading) {\n    return null;\n  }\n\n  return (\n    <div {...rest} className={clsx(styles.data, className)}>\n      {children}\n    </div>\n  );\n}\nFlashcardAdditionalData.displayName = 'FlashcardAdditionalData';\n\n/**\n * FlashcardDetailsList - Wrapper for key-value detail pairs.\n *\n * Wraps DetailsList with justify alignment for flashcard styling.\n *\n * @param props - {@link FlashcardDetailsListProps}\n * @param props.children - FlashcardDetailsLabel and FlashcardDetailsValue pairs.\n * @param props.className - Optional CSS class name.\n * @returns The rendered FlashcardDetailsList component.\n *\n * @example\n * ```tsx\n * <Flashcard header=\"Aircraft\" subheader=\"Entity\">\n *   <FlashcardHero />\n *   <FlashcardDetailsList>\n *     <FlashcardDetailsLabel>Status</FlashcardDetailsLabel>\n *     <FlashcardDetailsValue>Active</FlashcardDetailsValue>\n *     <FlashcardDetailsLabel>Speed</FlashcardDetailsLabel>\n *     <FlashcardDetailsValue>450 kts</FlashcardDetailsValue>\n *   </FlashcardDetailsList>\n * </Flashcard>\n * ```\n */\nexport function FlashcardDetailsList(props: FlashcardDetailsListProps) {\n  const { children, className, ...rest } = props;\n  return (\n    <DetailsList\n      {...rest}\n      align='justify'\n      classNames={{ list: clsx(styles['details-list'], className) }}\n    >\n      {children}\n    </DetailsList>\n  );\n}\nFlashcardDetailsList.displayName = 'FlashcardDetailsList';\n\n/**\n * FlashcardDetailsLabel - Label for detail items.\n *\n * Shows skeleton placeholder when the parent Flashcard has isLoading=true.\n *\n * @param props - {@link FlashcardComponentProps}\n * @param props.children - Label text content.\n * @param props.className - Optional CSS class name.\n * @returns The rendered FlashcardDetailsLabel component.\n *\n * @example\n * ```tsx\n * <FlashcardDetailsList>\n *   <FlashcardDetailsLabel>Status</FlashcardDetailsLabel>\n *   <FlashcardDetailsValue>Active</FlashcardDetailsValue>\n * </FlashcardDetailsList>\n * ```\n */\nexport function FlashcardDetailsLabel(props: FlashcardComponentProps) {\n  const { isLoading } = useContext(FlashcardContext);\n  const { className, children, ...rest } = props;\n  return (\n    <DetailsListLabel\n      {...rest}\n      className={clsx(styles['details-label'], className)}\n    >\n      {isLoading ? (\n        <Skeleton className={clsx(styles.skeleton, styles.smaller)} />\n      ) : (\n        children\n      )}\n    </DetailsListLabel>\n  );\n}\nFlashcardDetailsLabel.displayName = 'FlashcardDetailsLabel';\n\n/**\n * FlashcardDetailsValue - Value for detail items.\n *\n * Shows skeleton placeholder when the parent Flashcard has isLoading=true.\n *\n * @param props - {@link FlashcardComponentProps}\n * @param props.children - Value text content.\n * @param props.className - Optional CSS class name.\n * @returns The rendered FlashcardDetailsValue component.\n *\n * @example\n * ```tsx\n * <FlashcardDetailsList>\n *   <FlashcardDetailsLabel>Type</FlashcardDetailsLabel>\n *   <FlashcardDetailsValue>Aircraft</FlashcardDetailsValue>\n * </FlashcardDetailsList>\n * ```\n */\nexport function FlashcardDetailsValue(props: FlashcardComponentProps) {\n  const { isLoading } = useContext(FlashcardContext);\n  const { className, children, ...rest } = props;\n  return (\n    <DetailsListValue\n      {...rest}\n      className={clsx(styles['details-value'], className)}\n    >\n      {isLoading ? (\n        <Skeleton className={clsx(styles.skeleton, styles.smaller)} />\n      ) : (\n        children\n      )}\n    </DetailsListValue>\n  );\n}\nFlashcardDetailsValue.displayName = 'FlashcardDetailsValue';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,MAAa,mBAAmB,cAA8B;CAC5D,WAAW;CACX,QAAQ;CACR,WAAW;CACZ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BF,SAAgB,UAAU,OAAuB;CAC/C,MAAM,EAAE,WAAW,QAAQ,WAAW,UAAU,WAAW,GAAG,SAAS;AAEvE,QACE,oBAAC,iBAAiB;EAAS,OAAO;GAAE;GAAW;GAAQ;GAAW;YAChE,oBAAC;GAAI,GAAI;GAAM,WAAW,KAAK,OAAO,WAAW,UAAU;GACxD;IACG;GACoB;;AAGhC,UAAU,cAAc;;;;;;;;;;;;;;;;;;;AAoBxB,SAAgB,cAAc,OAAgC;CAC5D,MAAM,EAAE,UAAU,WAAW,GAAG,SAAS;CACzC,MAAM,EAAE,WAAW,QAAQ,cAAc,WAAW,iBAAiB;AAErE,KAAI,UACF,QACE,qBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,MAAM,WAAW,QAAQ;aAC7D,oBAAC;GAAS,WAAW,OAAO;GAAU,eAAY;IAAkB,EACpE,oBAAC,YAAS,WAAW,KAAK,OAAO,UAAU,OAAO,KAAK,GAAI;GACvD;AAIV,QACE,qBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,MAAM,UAAU;aACpD,oBAAC;GAAgB,WAAW,OAAO;aAAS;IAAyB,EACrE,oBAAC;GAAmB,WAAW,OAAO;aACnC;IACkB;GACjB;;AAGV,cAAc,cAAc;AAE5B,MAAM,kBAAkB;AACxB,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;AAsB3B,SAAgB,wBAAwB,OAAgC;CACtE,MAAM,EAAE,UAAU,WAAW,GAAG,SAAS;CACzC,MAAM,EAAE,cAAc,WAAW,iBAAiB;AAGlD,KAAI,UACF,QAAO;AAGT,QACE,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,MAAM,UAAU;EACnD;GACG;;AAGV,wBAAwB,cAAc;;;;;;;;;;;;;;;;;;;;;;;;AAyBtC,SAAgB,qBAAqB,OAAkC;CACrE,MAAM,EAAE,UAAU,WAAW,GAAG,SAAS;AACzC,QACE,oBAAC;EACC,GAAI;EACJ,OAAM;EACN,YAAY,EAAE,MAAM,KAAK,OAAO,iBAAiB,UAAU,EAAE;EAE5D;GACW;;AAGlB,qBAAqB,cAAc;;;;;;;;;;;;;;;;;;;AAoBnC,SAAgB,sBAAsB,OAAgC;CACpE,MAAM,EAAE,cAAc,WAAW,iBAAiB;CAClD,MAAM,EAAE,WAAW,UAAU,GAAG,SAAS;AACzC,QACE,oBAAC;EACC,GAAI;EACJ,WAAW,KAAK,OAAO,kBAAkB,UAAU;YAElD,YACC,oBAAC,YAAS,WAAW,KAAK,OAAO,UAAU,OAAO,QAAQ,GAAI,GAE9D;GAEe;;AAGvB,sBAAsB,cAAc;;;;;;;;;;;;;;;;;;;AAoBpC,SAAgB,sBAAsB,OAAgC;CACpE,MAAM,EAAE,cAAc,WAAW,iBAAiB;CAClD,MAAM,EAAE,WAAW,UAAU,GAAG,SAAS;AACzC,QACE,oBAAC;EACC,GAAI;EACJ,WAAW,KAAK,OAAO,kBAAkB,UAAU;YAElD,YACC,oBAAC,YAAS,WAAW,KAAK,OAAO,UAAU,OAAO,QAAQ,GAAI,GAE9D;GAEe;;AAGvB,sBAAsB,cAAc"}

package/dist/components/flashcard/styles.module.css

@@ -14,7 +14,7 @@
 
 @layer components.l1 {
   .container {
-    @apply rounded-medium font-display outline-interactive-hover outline;
+    @apply rounded-medium font-display outline-interactive-hover bg-surface-default outline;
 
     min-width: 128px;
   }

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

@@ -14,12 +14,24 @@ import { DetailsListProps } from "../details-list/types.js";
 import { ComponentPropsWithRef, PropsWithChildren } from "react";
 
 //#region src/components/flashcard/types.d.ts
+/**
+ * Base props for Flashcard child components.
+ */
 type FlashcardComponentProps = PropsWithChildren & ComponentPropsWithRef<'div'>;
+/**
+ * Props for the Flashcard component.
+ */
 type FlashcardProps = FlashcardComponentProps & {
+  /** Whether the flashcard is in a loading state. */
   isLoading?: boolean;
+  /** Primary header text displayed in the hero section. */
   header: string;
+  /** Secondary text displayed below the header. */
   subheader: string;
 };
+/**
+ * Props for the FlashcardDetailsList component.
+ */
 type FlashcardDetailsListProps = FlashcardComponentProps & Partial<DetailsListProps>;
 //#endregion
 export { FlashcardComponentProps, FlashcardDetailsListProps, FlashcardProps };

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

@@ -12,11 +12,14 @@
 
 import { HeroProps } from "./types.js";
 import "client-only";
-import * as react19 from "react";
+import * as react27 from "react";
 import { ContextValue } from "react-aria-components";
 
 //#region src/components/hero/context.d.ts
-declare const HeroContext: react19.Context<ContextValue<HeroProps, HTMLElement>>;
+/**
+ * Context for sharing Hero props across component tree.
+ */
+declare const HeroContext: react27.Context<ContextValue<HeroProps, HTMLElement>>;
 //#endregion
 export { HeroContext };
 //# sourceMappingURL=context.d.ts.map

package/dist/components/hero/context.js

@@ -17,6 +17,9 @@ import "client-only";
 import { createContext } from "react";
 
 //#region src/components/hero/context.tsx
+/**
+* Context for sharing Hero props across component tree.
+*/
 const HeroContext = createContext(null);
 
 //#endregion

package/dist/components/hero/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/hero/context.tsx"],"sourcesContent":["/*\n * Copyright 2025 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'use client';\n\nimport 'client-only';\nimport { createContext } from 'react';\nimport type { ContextValue } from 'react-aria-components';\nimport type { HeroProps } from './types';\n\nexport const HeroContext =\n  createContext<ContextValue<HeroProps, HTMLElement>>(null);\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,MAAa,cACX,cAAoD,KAAK"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/hero/context.tsx"],"sourcesContent":["/*\n * Copyright 2025 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'use client';\n\nimport 'client-only';\nimport { createContext } from 'react';\nimport type { ContextValue } from 'react-aria-components';\nimport type { HeroProps } from './types';\n\n/**\n * Context for sharing Hero props across component tree.\n */\nexport const HeroContext =\n  createContext<ContextValue<HeroProps, HTMLElement>>(null);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAqBA,MAAa,cACX,cAAoD,KAAK"}

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

@@ -12,7 +12,7 @@
 
 import { HeroProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime56 from "react/jsx-runtime";
+import * as react_jsx_runtime53 from "react/jsx-runtime";
 
 //#region src/components/hero/index.d.ts
 
@@ -20,6 +20,13 @@ import * as react_jsx_runtime56 from "react/jsx-runtime";
  * A versatile hero component that displays an icon alongside primary and secondary content.
  * Automatically organizes child components by type and supports both stacked and grid layouts.
  *
+ * @param props - {@link HeroProps}
+ * @param props.ref - Ref to the header element.
+ * @param props.children - Child components (Icon, HeroTitle, HeroSubtitle).
+ * @param props.classNames - Class names for Hero sub-elements.
+ * @param props.compact - Whether to use compact grid layout.
+ * @returns The rendered Hero component.
+ *
  * @example
  * ```tsx
  * // Basic hero with icon and content
@@ -49,7 +56,7 @@ import * as react_jsx_runtime56 from "react/jsx-runtime";
 declare function Hero({
   ref,
   ...props
-}: HeroProps): react_jsx_runtime56.JSX.Element;
+}: HeroProps): react_jsx_runtime53.JSX.Element;
 //#endregion
 export { Hero };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/hero/index.js

@@ -26,6 +26,13 @@ import styles from "./styles.module.css";
 * A versatile hero component that displays an icon alongside primary and secondary content.
 * Automatically organizes child components by type and supports both stacked and grid layouts.
 *
+* @param props - {@link HeroProps}
+* @param props.ref - Ref to the header element.
+* @param props.children - Child components (Icon, HeroTitle, HeroSubtitle).
+* @param props.classNames - Class names for Hero sub-elements.
+* @param props.compact - Whether to use compact grid layout.
+* @returns The rendered Hero component.
+*
 * @example
 * ```tsx
 * // Basic hero with icon and content

package/dist/components/hero/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/hero/index.tsx"],"sourcesContent":["/*\n * Copyright 2025 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'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport {\n  Header,\n  HeadingContext,\n  Provider,\n  TextContext,\n  useContextProps,\n} from 'react-aria-components';\nimport { IconContext } from '../icon/context';\nimport { HeroContext } from './context';\nimport styles from './styles.module.css';\nimport type { HeroProps } from './types';\n\n/**\n * A versatile hero component that displays an icon alongside primary and secondary content.\n * Automatically organizes child components by type and supports both stacked and grid layouts.\n *\n * @example\n * ```tsx\n * // Basic hero with icon and content\n * <Hero>\n *   <Icon><Placeholder /></Icon>\n *   <HeroTitle>Primary Title</HeroTitle>\n *   <HeroSubtitle>Secondary information</HeroSubtitle>\n * </Hero>\n *\n * // Grid layout for compact display\n * <Hero compact>\n *   <Icon><Settings /></Icon>\n *   <HeroTitle>Settings</HeroTitle>\n *   <HeroSubtitle>Configure your preferences</HeroSubtitle>\n * </Hero>\n * ```\n *\n * ## Child Component Behavior\n * - **Icon**: Only one allowed\n * - **HeroTitle**: Only one allowed\n * - **HeroSubtitle**: Any number allowed as secondary content\n *\n * ## Layout Modes\n * - **Stack** (default): Vertical layout with larger icon and stacked content\n * - **Grid** (compact=true): Horizontal layout with smaller icon beside content\n */\nexport function Hero({ ref, ...props }: HeroProps) {\n  [props, ref] = useContextProps(props, ref ?? null, HeroContext);\n\n  const { children, classNames, compact, ...rest } = props;\n\n  return (\n    <Provider\n      values={[\n        [\n          IconContext,\n          { className: clsx(styles.icon, classNames?.icon), size: 'large' },\n        ],\n        [\n          HeadingContext,\n          { className: clsx(styles.title, classNames?.title), level: 2 },\n        ],\n        [\n          TextContext,\n          { className: clsx(styles.subtitle, classNames?.subtitle) },\n        ],\n      ]}\n    >\n      <Header\n        {...rest}\n        ref={ref}\n        className={clsx('group/hero', styles.hero, classNames?.hero)}\n        data-layout={compact ? 'grid' : 'stack'}\n      >\n        {children}\n      </Header>\n    </Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyDA,SAAgB,KAAK,EAAE,KAAK,GAAG,SAAoB;AACjD,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,YAAY;CAE/D,MAAM,EAAE,UAAU,YAAY,SAAS,GAAG,SAAS;AAEnD,QACE,oBAAC;EACC,QAAQ;GACN,CACE,aACA;IAAE,WAAW,KAAK,OAAO,MAAM,YAAY,KAAK;IAAE,MAAM;IAAS,CAClE;GACD,CACE,gBACA;IAAE,WAAW,KAAK,OAAO,OAAO,YAAY,MAAM;IAAE,OAAO;IAAG,CAC/D;GACD,CACE,aACA,EAAE,WAAW,KAAK,OAAO,UAAU,YAAY,SAAS,EAAE,CAC3D;GACF;YAED,oBAAC;GACC,GAAI;GACC;GACL,WAAW,KAAK,cAAc,OAAO,MAAM,YAAY,KAAK;GAC5D,eAAa,UAAU,SAAS;GAE/B;IACM;GACA"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/hero/index.tsx"],"sourcesContent":["/*\n * Copyright 2025 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'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport {\n  Header,\n  HeadingContext,\n  Provider,\n  TextContext,\n  useContextProps,\n} from 'react-aria-components';\nimport { IconContext } from '../icon/context';\nimport { HeroContext } from './context';\nimport styles from './styles.module.css';\nimport type { HeroProps } from './types';\n\n/**\n * A versatile hero component that displays an icon alongside primary and secondary content.\n * Automatically organizes child components by type and supports both stacked and grid layouts.\n *\n * @param props - {@link HeroProps}\n * @param props.ref - Ref to the header element.\n * @param props.children - Child components (Icon, HeroTitle, HeroSubtitle).\n * @param props.classNames - Class names for Hero sub-elements.\n * @param props.compact - Whether to use compact grid layout.\n * @returns The rendered Hero component.\n *\n * @example\n * ```tsx\n * // Basic hero with icon and content\n * <Hero>\n *   <Icon><Placeholder /></Icon>\n *   <HeroTitle>Primary Title</HeroTitle>\n *   <HeroSubtitle>Secondary information</HeroSubtitle>\n * </Hero>\n *\n * // Grid layout for compact display\n * <Hero compact>\n *   <Icon><Settings /></Icon>\n *   <HeroTitle>Settings</HeroTitle>\n *   <HeroSubtitle>Configure your preferences</HeroSubtitle>\n * </Hero>\n * ```\n *\n * ## Child Component Behavior\n * - **Icon**: Only one allowed\n * - **HeroTitle**: Only one allowed\n * - **HeroSubtitle**: Any number allowed as secondary content\n *\n * ## Layout Modes\n * - **Stack** (default): Vertical layout with larger icon and stacked content\n * - **Grid** (compact=true): Horizontal layout with smaller icon beside content\n */\nexport function Hero({ ref, ...props }: HeroProps) {\n  [props, ref] = useContextProps(props, ref ?? null, HeroContext);\n\n  const { children, classNames, compact, ...rest } = props;\n\n  return (\n    <Provider\n      values={[\n        [\n          IconContext,\n          { className: clsx(styles.icon, classNames?.icon), size: 'large' },\n        ],\n        [\n          HeadingContext,\n          { className: clsx(styles.title, classNames?.title), level: 2 },\n        ],\n        [\n          TextContext,\n          { className: clsx(styles.subtitle, classNames?.subtitle) },\n        ],\n      ]}\n    >\n      <Header\n        {...rest}\n        ref={ref}\n        className={clsx('group/hero', styles.hero, classNames?.hero)}\n        data-layout={compact ? 'grid' : 'stack'}\n      >\n        {children}\n      </Header>\n    </Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgEA,SAAgB,KAAK,EAAE,KAAK,GAAG,SAAoB;AACjD,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,YAAY;CAE/D,MAAM,EAAE,UAAU,YAAY,SAAS,GAAG,SAAS;AAEnD,QACE,oBAAC;EACC,QAAQ;GACN,CACE,aACA;IAAE,WAAW,KAAK,OAAO,MAAM,YAAY,KAAK;IAAE,MAAM;IAAS,CAClE;GACD,CACE,gBACA;IAAE,WAAW,KAAK,OAAO,OAAO,YAAY,MAAM;IAAE,OAAO;IAAG,CAC/D;GACD,CACE,aACA,EAAE,WAAW,KAAK,OAAO,UAAU,YAAY,SAAS,EAAE,CAC3D;GACF;YAED,oBAAC;GACC,GAAI;GACC;GACL,WAAW,KAAK,cAAc,OAAO,MAAM,YAAY,KAAK;GAC5D,eAAa,UAAU,SAAS;GAE/B;IACM;GACA"}

package/dist/components/hero/subtitle.d.ts

@@ -11,11 +11,26 @@
  */
 
 import "client-only";
-import * as react20 from "react";
+import * as react21 from "react";
 import * as react_aria_components0 from "react-aria-components";
 
 //#region src/components/hero/subtitle.d.ts
-declare const HeroSubtitle: react20.ForwardRefExoticComponent<react_aria_components0.TextProps & react20.RefAttributes<HTMLElement>>;
+/**
+ * HeroSubtitle - Secondary text content for the Hero component.
+ *
+ * Zero or more allowed per Hero for displaying additional metadata.
+ *
+ * @example
+ * ```tsx
+ * <Hero>
+ *   <Icon><User /></Icon>
+ *   <HeroTitle>John Doe</HeroTitle>
+ *   <HeroSubtitle>Software Engineer</HeroSubtitle>
+ *   <HeroSubtitle>San Francisco, CA</HeroSubtitle>
+ * </Hero>
+ * ```
+ */
+declare const HeroSubtitle: react21.ForwardRefExoticComponent<react_aria_components0.TextProps & react21.RefAttributes<HTMLElement>>;
 //#endregion
 export { HeroSubtitle };
 //# sourceMappingURL=subtitle.d.ts.map

package/dist/components/hero/subtitle.js

@@ -17,6 +17,21 @@ import "client-only";
 import { Text } from "react-aria-components";
 
 //#region src/components/hero/subtitle.tsx
+/**
+* HeroSubtitle - Secondary text content for the Hero component.
+*
+* Zero or more allowed per Hero for displaying additional metadata.
+*
+* @example
+* ```tsx
+* <Hero>
+*   <Icon><User /></Icon>
+*   <HeroTitle>John Doe</HeroTitle>
+*   <HeroSubtitle>Software Engineer</HeroSubtitle>
+*   <HeroSubtitle>San Francisco, CA</HeroSubtitle>
+* </Hero>
+* ```
+*/
 const HeroSubtitle = Text;
 
 //#endregion

package/dist/components/hero/subtitle.js.map

@@ -1 +1 @@
-{"version":3,"file":"subtitle.js","names":[],"sources":["../../../src/components/hero/subtitle.tsx"],"sourcesContent":["/*\n * Copyright 2025 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'use client';\n\nimport 'client-only';\nimport { Text } from 'react-aria-components';\n\nexport const HeroSubtitle = Text;\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAgBA,MAAa,eAAe"}
+{"version":3,"file":"subtitle.js","names":[],"sources":["../../../src/components/hero/subtitle.tsx"],"sourcesContent":["/*\n * Copyright 2025 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'use client';\n\nimport 'client-only';\nimport { Text } from 'react-aria-components';\n\n/**\n * HeroSubtitle - Secondary text content for the Hero component.\n *\n * Zero or more allowed per Hero for displaying additional metadata.\n *\n * @example\n * ```tsx\n * <Hero>\n *   <Icon><User /></Icon>\n *   <HeroTitle>John Doe</HeroTitle>\n *   <HeroSubtitle>Software Engineer</HeroSubtitle>\n *   <HeroSubtitle>San Francisco, CA</HeroSubtitle>\n * </Hero>\n * ```\n */\nexport const HeroSubtitle = Text;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,MAAa,eAAe"}

package/dist/components/hero/title.d.ts

@@ -11,11 +11,24 @@
  */
 
 import "client-only";
-import * as react16 from "react";
+import * as react18 from "react";
 import * as react_aria_components0 from "react-aria-components";
 
 //#region src/components/hero/title.d.ts
-declare const HeroTitle: react16.ForwardRefExoticComponent<react_aria_components0.HeadingProps & react16.RefAttributes<HTMLHeadingElement>>;
+/**
+ * HeroTitle - Primary heading for the Hero component.
+ *
+ * Renders as an `<h2>` element. Exactly one required per Hero.
+ *
+ * @example
+ * ```tsx
+ * <Hero>
+ *   <Icon><Placeholder /></Icon>
+ *   <HeroTitle>Primary Title</HeroTitle>
+ * </Hero>
+ * ```
+ */
+declare const HeroTitle: react18.ForwardRefExoticComponent<react_aria_components0.HeadingProps & react18.RefAttributes<HTMLHeadingElement>>;
 //#endregion
 export { HeroTitle };
 //# sourceMappingURL=title.d.ts.map

package/dist/components/hero/title.js

@@ -17,6 +17,19 @@ import "client-only";
 import { Heading } from "react-aria-components";
 
 //#region src/components/hero/title.tsx
+/**
+* HeroTitle - Primary heading for the Hero component.
+*
+* Renders as an `<h2>` element. Exactly one required per Hero.
+*
+* @example
+* ```tsx
+* <Hero>
+*   <Icon><Placeholder /></Icon>
+*   <HeroTitle>Primary Title</HeroTitle>
+* </Hero>
+* ```
+*/
 const HeroTitle = Heading;
 
 //#endregion

package/dist/components/hero/title.js.map

@@ -1 +1 @@
-{"version":3,"file":"title.js","names":[],"sources":["../../../src/components/hero/title.tsx"],"sourcesContent":["/*\n * Copyright 2025 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'use client';\n\nimport 'client-only';\nimport { Heading } from 'react-aria-components';\n\nexport const HeroTitle = Heading;\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAgBA,MAAa,YAAY"}
+{"version":3,"file":"title.js","names":[],"sources":["../../../src/components/hero/title.tsx"],"sourcesContent":["/*\n * Copyright 2025 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'use client';\n\nimport 'client-only';\nimport { Heading } from 'react-aria-components';\n\n/**\n * HeroTitle - Primary heading for the Hero component.\n *\n * Renders as an `<h2>` element. Exactly one required per Hero.\n *\n * @example\n * ```tsx\n * <Hero>\n *   <Icon><Placeholder /></Icon>\n *   <HeroTitle>Primary Title</HeroTitle>\n * </Hero>\n * ```\n */\nexport const HeroTitle = Heading;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,MAAa,YAAY"}

package/dist/components/hero/types.d.ts

@@ -13,13 +13,22 @@
 import { ComponentPropsWithRef } from "react";
 
 //#region src/components/hero/types.d.ts
+/**
+ * Props for the Hero component.
+ */
 type HeroProps = Omit<ComponentPropsWithRef<'header'>, 'className'> & {
+  /** Class names for Hero sub-elements. */
   classNames?: {
+    /** Class name for the hero container. */
     hero?: string;
+    /** Class name for the icon. */
     icon?: string;
+    /** Class name for the title. */
     title?: string;
+    /** Class name for the subtitle. */
     subtitle?: string;
   };
+  /** Whether to use compact grid layout instead of stacked layout. */
   compact?: boolean;
 };
 //#endregion

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

@@ -13,16 +13,36 @@
 import { ProviderProps } from "../../lib/types.js";
 import { HotkeyProps } from "./types.js";
 import "client-only";
-import * as react18 from "react";
+import * as react20 from "react";
 import { ContextValue } from "react-aria-components";
-import * as react_jsx_runtime48 from "react/jsx-runtime";
+import * as react_jsx_runtime52 from "react/jsx-runtime";
 
 //#region src/components/hotkey/context.d.ts
-declare const HotkeyContext: react18.Context<ContextValue<HotkeyProps, HTMLElement>>;
+/**
+ * Context for sharing Hotkey props across component tree.
+ */
+declare const HotkeyContext: react20.Context<ContextValue<HotkeyProps, HTMLElement>>;
+/**
+ * HotkeyProvider - Context provider for setting default Hotkey props.
+ *
+ * Use this to configure shared variant across multiple Hotkey components.
+ *
+ * @param props - ProviderProps<HotkeyProps>
+ * @param props.children - Child components to receive context.
+ * @returns The rendered HotkeyProvider component.
+ *
+ * @example
+ * ```tsx
+ * <HotkeyProvider variant="flat">
+ *   <Hotkey>Ctrl</Hotkey>
+ *   <Hotkey>C</Hotkey>
+ * </HotkeyProvider>
+ * ```
+ */
 declare function HotkeyProvider({
   children,
   ...props
-}: ProviderProps<HotkeyProps>): react_jsx_runtime48.JSX.Element;
+}: ProviderProps<HotkeyProps>): react_jsx_runtime52.JSX.Element;
 //#endregion
 export { HotkeyContext, HotkeyProvider };
 //# sourceMappingURL=context.d.ts.map

package/dist/components/hotkey/context.js

@@ -18,7 +18,27 @@ import { createContext } from "react";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/components/hotkey/context.tsx
+/**
+* Context for sharing Hotkey props across component tree.
+*/
 const HotkeyContext = createContext(null);
+/**
+* HotkeyProvider - Context provider for setting default Hotkey props.
+*
+* Use this to configure shared variant across multiple Hotkey components.
+*
+* @param props - ProviderProps<HotkeyProps>
+* @param props.children - Child components to receive context.
+* @returns The rendered HotkeyProvider component.
+*
+* @example
+* ```tsx
+* <HotkeyProvider variant="flat">
+*   <Hotkey>Ctrl</Hotkey>
+*   <Hotkey>C</Hotkey>
+* </HotkeyProvider>
+* ```
+*/
 function HotkeyProvider({ children, ...props }) {
 	return /* @__PURE__ */ jsx(HotkeyContext.Provider, {
 		value: props,

package/dist/components/hotkey/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/hotkey/context.tsx"],"sourcesContent":["/*\n * Copyright 2025 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'use client';\n\nimport type { ProviderProps } from '@/lib/types';\nimport 'client-only';\nimport { createContext } from 'react';\nimport type { ContextValue } from 'react-aria-components';\nimport type { HotkeyProps } from './types';\n\nexport const HotkeyContext =\n  createContext<ContextValue<HotkeyProps, HTMLElement>>(null);\n\nexport function HotkeyProvider({\n  children,\n  ...props\n}: ProviderProps<HotkeyProps>) {\n  return (\n    <HotkeyContext.Provider value={props}>{children}</HotkeyContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,MAAa,gBACX,cAAsD,KAAK;AAE7D,SAAgB,eAAe,EAC7B,UACA,GAAG,SAC0B;AAC7B,QACE,oBAAC,cAAc;EAAS,OAAO;EAAQ;GAAkC"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/hotkey/context.tsx"],"sourcesContent":["/*\n * Copyright 2025 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'use client';\n\nimport type { ProviderProps } from '@/lib/types';\nimport 'client-only';\nimport { createContext } from 'react';\nimport type { ContextValue } from 'react-aria-components';\nimport type { HotkeyProps } from './types';\n\n/**\n * Context for sharing Hotkey props across component tree.\n */\nexport const HotkeyContext =\n  createContext<ContextValue<HotkeyProps, HTMLElement>>(null);\n\n/**\n * HotkeyProvider - Context provider for setting default Hotkey props.\n *\n * Use this to configure shared variant across multiple Hotkey components.\n *\n * @param props - ProviderProps<HotkeyProps>\n * @param props.children - Child components to receive context.\n * @returns The rendered HotkeyProvider component.\n *\n * @example\n * ```tsx\n * <HotkeyProvider variant=\"flat\">\n *   <Hotkey>Ctrl</Hotkey>\n *   <Hotkey>C</Hotkey>\n * </HotkeyProvider>\n * ```\n */\nexport function HotkeyProvider({\n  children,\n  ...props\n}: ProviderProps<HotkeyProps>) {\n  return (\n    <HotkeyContext.Provider value={props}>{children}</HotkeyContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAa,gBACX,cAAsD,KAAK;;;;;;;;;;;;;;;;;;AAmB7D,SAAgB,eAAe,EAC7B,UACA,GAAG,SAC0B;AAC7B,QACE,oBAAC,cAAc;EAAS,OAAO;EAAQ;GAAkC"}

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

@@ -12,7 +12,7 @@
 
 import { HotkeyProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime50 from "react/jsx-runtime";
+import * as react_jsx_runtime55 from "react/jsx-runtime";
 
 //#region src/components/hotkey/index.d.ts
 
@@ -24,34 +24,49 @@ import * as react_jsx_runtime50 from "react/jsx-runtime";
  * keyboard shortcuts. Supports multiple visual styles including outlined keys,
  * flat presentation, and icon-specific formatting.
  *
+ * @param props - {@link HotkeyProps}
+ * @param props.ref - Ref to the kbd element.
+ * @param props.children - Key text or icon to display.
+ * @param props.className - Optional CSS class name.
+ * @param props.variant - Visual style variant.
+ * @returns The rendered Hotkey component.
+ *
  * @example
+ * ```tsx
  * // Basic hotkey display
  * <Hotkey>Ctrl</Hotkey>
+ * ```
  *
  * @example
+ * ```tsx
  * // Hotkey combination with different variants
  * <HotkeySet>
  *   <Hotkey variant="outline">Cmd</Hotkey>
  *   <span>+</span>
  *   <Hotkey variant="outline">K</Hotkey>
  * </HotkeySet>
+ * ```
  *
  * @example
+ * ```tsx
  * // Flat style for inline text
  * <p>Press <Hotkey variant="flat">Enter</Hotkey> to submit</p>
+ * ```
  *
  * @example
+ * ```tsx
  * // Icon variant for special keys
  * <HotkeySet>
  *   <Hotkey variant="icon">⌘</Hotkey>
  *   <Hotkey>Space</Hotkey>
  * </HotkeySet>
+ * ```
  */
 declare function Hotkey({
   ref,
   children,
   ...props
-}: HotkeyProps): react_jsx_runtime50.JSX.Element;
+}: HotkeyProps): react_jsx_runtime55.JSX.Element;
 //#endregion
 export { Hotkey };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/hotkey/index.js

@@ -29,28 +29,43 @@ import styles from "./styles.module.css";
 * keyboard shortcuts. Supports multiple visual styles including outlined keys,
 * flat presentation, and icon-specific formatting.
 *
+* @param props - {@link HotkeyProps}
+* @param props.ref - Ref to the kbd element.
+* @param props.children - Key text or icon to display.
+* @param props.className - Optional CSS class name.
+* @param props.variant - Visual style variant.
+* @returns The rendered Hotkey component.
+*
 * @example
+* ```tsx
 * // Basic hotkey display
 * <Hotkey>Ctrl</Hotkey>
+* ```
 *
 * @example
+* ```tsx
 * // Hotkey combination with different variants
 * <HotkeySet>
 *   <Hotkey variant="outline">Cmd</Hotkey>
 *   <span>+</span>
 *   <Hotkey variant="outline">K</Hotkey>
 * </HotkeySet>
+* ```
 *
 * @example
+* ```tsx
 * // Flat style for inline text
 * <p>Press <Hotkey variant="flat">Enter</Hotkey> to submit</p>
+* ```
 *
 * @example
+* ```tsx
 * // Icon variant for special keys
 * <HotkeySet>
 *   <Hotkey variant="icon">⌘</Hotkey>
 *   <Hotkey>Space</Hotkey>
 * </HotkeySet>
+* ```
 */
 function Hotkey({ ref, children, ...props }) {
 	[props, ref] = useContextProps(props, ref ?? null, HotkeyContext);

package/dist/components/hotkey/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/hotkey/index.tsx"],"sourcesContent":["/*\n * Copyright 2025 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'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Keyboard, useContextProps } from 'react-aria-components';\nimport { HotkeyContext } from './context';\nimport styles from './styles.module.css';\nimport type { HotkeyProps } from './types';\n\n/**\n * Hotkey - A visual representation of keyboard shortcuts and key combinations\n *\n * Displays keyboard keys and shortcuts in a consistent, accessible format.\n * Perfect for documentation, help systems, or UI elements that need to show\n * keyboard shortcuts. Supports multiple visual styles including outlined keys,\n * flat presentation, and icon-specific formatting.\n *\n * @example\n * // Basic hotkey display\n * <Hotkey>Ctrl</Hotkey>\n *\n * @example\n * // Hotkey combination with different variants\n * <HotkeySet>\n *   <Hotkey variant=\"outline\">Cmd</Hotkey>\n *   <span>+</span>\n *   <Hotkey variant=\"outline\">K</Hotkey>\n * </HotkeySet>\n *\n * @example\n * // Flat style for inline text\n * <p>Press <Hotkey variant=\"flat\">Enter</Hotkey> to submit</p>\n *\n * @example\n * // Icon variant for special keys\n * <HotkeySet>\n *   <Hotkey variant=\"icon\">⌘</Hotkey>\n *   <Hotkey>Space</Hotkey>\n * </HotkeySet>\n */\nexport function Hotkey({ ref, children, ...props }: HotkeyProps) {\n  [props, ref] = useContextProps(props, ref ?? null, HotkeyContext);\n\n  const { className, variant = 'outline', ...rest } = props;\n\n  return (\n    <Keyboard\n      {...rest}\n      ref={ref}\n      className={clsx(styles.key, styles[variant], className)}\n    >\n      {children}\n    </Keyboard>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoDA,SAAgB,OAAO,EAAE,KAAK,UAAU,GAAG,SAAsB;AAC/D,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,cAAc;CAEjE,MAAM,EAAE,WAAW,UAAU,WAAW,GAAG,SAAS;AAEpD,QACE,oBAAC;EACC,GAAI;EACC;EACL,WAAW,KAAK,OAAO,KAAK,OAAO,UAAU,UAAU;EAEtD;GACQ"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/hotkey/index.tsx"],"sourcesContent":["/*\n * Copyright 2025 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'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Keyboard, useContextProps } from 'react-aria-components';\nimport { HotkeyContext } from './context';\nimport styles from './styles.module.css';\nimport type { HotkeyProps } from './types';\n\n/**\n * Hotkey - A visual representation of keyboard shortcuts and key combinations\n *\n * Displays keyboard keys and shortcuts in a consistent, accessible format.\n * Perfect for documentation, help systems, or UI elements that need to show\n * keyboard shortcuts. Supports multiple visual styles including outlined keys,\n * flat presentation, and icon-specific formatting.\n *\n * @param props - {@link HotkeyProps}\n * @param props.ref - Ref to the kbd element.\n * @param props.children - Key text or icon to display.\n * @param props.className - Optional CSS class name.\n * @param props.variant - Visual style variant.\n * @returns The rendered Hotkey component.\n *\n * @example\n * ```tsx\n * // Basic hotkey display\n * <Hotkey>Ctrl</Hotkey>\n * ```\n *\n * @example\n * ```tsx\n * // Hotkey combination with different variants\n * <HotkeySet>\n *   <Hotkey variant=\"outline\">Cmd</Hotkey>\n *   <span>+</span>\n *   <Hotkey variant=\"outline\">K</Hotkey>\n * </HotkeySet>\n * ```\n *\n * @example\n * ```tsx\n * // Flat style for inline text\n * <p>Press <Hotkey variant=\"flat\">Enter</Hotkey> to submit</p>\n * ```\n *\n * @example\n * ```tsx\n * // Icon variant for special keys\n * <HotkeySet>\n *   <Hotkey variant=\"icon\">⌘</Hotkey>\n *   <Hotkey>Space</Hotkey>\n * </HotkeySet>\n * ```\n */\nexport function Hotkey({ ref, children, ...props }: HotkeyProps) {\n  [props, ref] = useContextProps(props, ref ?? null, HotkeyContext);\n\n  const { className, variant = 'outline', ...rest } = props;\n\n  return (\n    <Keyboard\n      {...rest}\n      ref={ref}\n      className={clsx(styles.key, styles[variant], className)}\n    >\n      {children}\n    </Keyboard>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmEA,SAAgB,OAAO,EAAE,KAAK,UAAU,GAAG,SAAsB;AAC/D,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,cAAc;CAEjE,MAAM,EAAE,WAAW,UAAU,WAAW,GAAG,SAAS;AAEpD,QACE,oBAAC;EACC,GAAI;EACC;EACL,WAAW,KAAK,OAAO,KAAK,OAAO,UAAU,UAAU;EAEtD;GACQ"}

package/dist/components/hotkey/set.d.ts

@@ -12,13 +12,32 @@
 
 import "client-only";
 import { ComponentPropsWithRef } from "react";
-import * as react_jsx_runtime51 from "react/jsx-runtime";
+import * as react_jsx_runtime96 from "react/jsx-runtime";
 
 //#region src/components/hotkey/set.d.ts
+
+/**
+ * HotkeySet - Container for grouping multiple Hotkey components.
+ *
+ * Automatically sizes icons via IconProvider.
+ *
+ * @param props - ComponentPropsWithRef<'div'>
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered HotkeySet component.
+ *
+ * @example
+ * ```tsx
+ * <HotkeySet>
+ *   <Hotkey>CMD</Hotkey>
+ *   <span>+</span>
+ *   <Hotkey>K</Hotkey>
+ * </HotkeySet>
+ * ```
+ */
 declare function HotkeySet({
   className,
   ...rest
-}: ComponentPropsWithRef<'div'>): react_jsx_runtime51.JSX.Element;
+}: ComponentPropsWithRef<'div'>): react_jsx_runtime96.JSX.Element;
 //#endregion
 export { HotkeySet };
 //# sourceMappingURL=set.d.ts.map

package/dist/components/hotkey/set.js

@@ -20,6 +20,24 @@ import { jsx } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/hotkey/set.tsx
+/**
+* HotkeySet - Container for grouping multiple Hotkey components.
+*
+* Automatically sizes icons via IconProvider.
+*
+* @param props - ComponentPropsWithRef<'div'>
+* @param props.className - Optional CSS class name.
+* @returns The rendered HotkeySet component.
+*
+* @example
+* ```tsx
+* <HotkeySet>
+*   <Hotkey>CMD</Hotkey>
+*   <span>+</span>
+*   <Hotkey>K</Hotkey>
+* </HotkeySet>
+* ```
+*/
 function HotkeySet({ className, ...rest }) {
 	return /* @__PURE__ */ jsx(IconProvider, {
 		size: "large",

package/dist/components/hotkey/set.js.map

@@ -1 +1 @@
-{"version":3,"file":"set.js","names":[],"sources":["../../../src/components/hotkey/set.tsx"],"sourcesContent":["/*\n * Copyright 2025 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'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { IconProvider } from '../icon/context';\nimport styles from './styles.module.css';\nimport type { ComponentPropsWithRef } from 'react';\n\nexport function HotkeySet({\n  className,\n  ...rest\n}: ComponentPropsWithRef<'div'>) {\n  return (\n    <IconProvider size='large'>\n      <div {...rest} className={clsx(styles.set, className)} />\n    </IconProvider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,UAAU,EACxB,WACA,GAAG,QAC4B;AAC/B,QACE,oBAAC;EAAa,MAAK;YACjB,oBAAC;GAAI,GAAI;GAAM,WAAW,KAAK,OAAO,KAAK,UAAU;IAAI;GAC5C"}
+{"version":3,"file":"set.js","names":[],"sources":["../../../src/components/hotkey/set.tsx"],"sourcesContent":["/*\n * Copyright 2025 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'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { IconProvider } from '../icon/context';\nimport styles from './styles.module.css';\nimport type { ComponentPropsWithRef } from 'react';\n\n/**\n * HotkeySet - Container for grouping multiple Hotkey components.\n *\n * Automatically sizes icons via IconProvider.\n *\n * @param props - ComponentPropsWithRef<'div'>\n * @param props.className - Optional CSS class name.\n * @returns The rendered HotkeySet component.\n *\n * @example\n * ```tsx\n * <HotkeySet>\n *   <Hotkey>CMD</Hotkey>\n *   <span>+</span>\n *   <Hotkey>K</Hotkey>\n * </HotkeySet>\n * ```\n */\nexport function HotkeySet({\n  className,\n  ...rest\n}: ComponentPropsWithRef<'div'>) {\n  return (\n    <IconProvider size='large'>\n      <div {...rest} className={clsx(styles.set, className)} />\n    </IconProvider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,SAAgB,UAAU,EACxB,WACA,GAAG,QAC4B;AAC/B,QACE,oBAAC;EAAa,MAAK;YACjB,oBAAC;GAAI,GAAI;GAAM,WAAW,KAAK,OAAO,KAAK,UAAU;IAAI;GAC5C"}

package/dist/components/hotkey/types.d.ts

@@ -13,7 +13,11 @@
 import { ComponentPropsWithRef } from "react";
 
 //#region src/components/hotkey/types.d.ts
+/**
+ * Props for the Hotkey component.
+ */
 type HotkeyProps = ComponentPropsWithRef<'kbd'> & {
+  /** Visual style variant for the hotkey display. */
   variant?: 'flat' | 'icon' | 'outline';
 };
 //#endregion