@accelint/design-toolkit 9.3.0 → 9.4.0

package/dist/components/classification-badge/index.d.ts

@@ -15,20 +15,38 @@ import "client-only";
 import * as react_jsx_runtime24 from "react/jsx-runtime";
 
 //#region src/components/classification-badge/index.d.ts
+
 /**
- * ClassificationBadge - A specialized badge for security and data classification
+ * ClassificationBadge - Displays security classification levels for documents and data.
+ *
+ * Provides standardized visual indicators for classification levels such as
+ * unclassified, confidential, secret, and top-secret. Designed for compliance
+ * with security standards in government and secure environments.
  *
- * Provides standardized visual indicators for data classification levels such as
- * confidential, secret, or public information. Designed for compliance with
- * security standards and information governance requirements.
+ * @param props - The classification badge props.
+ * @param props.ref - Reference to the badge element.
+ * @param props.children - Custom text content (defaults to variant label).
+ * @param props.className - Additional CSS class names for styling.
+ * @param props.size - Size of the badge.
+ * @param props.variant - Classification level variant.
+ * @returns The classification badge component.
+ *
+ * @example
+ * ```tsx
+ * <ClassificationBadge variant="secret" />
+ * ```
  *
  * @example
- * // Basic classification badge
- * <ClassificationBadge level="confidential" />
+ * ```tsx
+ * // With custom text
+ * <ClassificationBadge variant="top-secret">TOP SECRET//NOFORN</ClassificationBadge>
+ * ```
  *
  * @example
- * // Classification with custom styling
- * <ClassificationBadge level="secret" />
+ * ```tsx
+ * // Different sizes
+ * <ClassificationBadge variant="confidential" size="small" />
+ * ```
  */
 declare function ClassificationBadge({
   ref,

package/dist/components/classification-badge/index.js

@@ -31,19 +31,36 @@ const fallbackContent = {
 	"ts-sci": "TS/SCI"
 };
 /**
-* ClassificationBadge - A specialized badge for security and data classification
+* ClassificationBadge - Displays security classification levels for documents and data.
 *
-* Provides standardized visual indicators for data classification levels such as
-* confidential, secret, or public information. Designed for compliance with
-* security standards and information governance requirements.
+* Provides standardized visual indicators for classification levels such as
+* unclassified, confidential, secret, and top-secret. Designed for compliance
+* with security standards in government and secure environments.
+*
+* @param props - The classification badge props.
+* @param props.ref - Reference to the badge element.
+* @param props.children - Custom text content (defaults to variant label).
+* @param props.className - Additional CSS class names for styling.
+* @param props.size - Size of the badge.
+* @param props.variant - Classification level variant.
+* @returns The classification badge component.
+*
+* @example
+* ```tsx
+* <ClassificationBadge variant="secret" />
+* ```
 *
 * @example
-* // Basic classification badge
-* <ClassificationBadge level="confidential" />
+* ```tsx
+* // With custom text
+* <ClassificationBadge variant="top-secret">TOP SECRET//NOFORN</ClassificationBadge>
+* ```
 *
 * @example
-* // Classification with custom styling
-* <ClassificationBadge level="secret" />
+* ```tsx
+* // Different sizes
+* <ClassificationBadge variant="confidential" size="small" />
+* ```
 */
 function ClassificationBadge({ ref, ...props }) {
 	[props, ref] = useContextProps(props, ref ?? null, ClassificationBadgeContext);

package/dist/components/classification-badge/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/classification-badge/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 { useContextProps } from 'react-aria-components';\nimport { ClassificationBadgeContext } from './context';\nimport styles from './styles.module.css';\nimport type { ClassificationBadgeProps } from './types';\n\nconst fallbackContent = {\n  missing: 'Missing',\n  unclassified: 'Unclassified',\n  cui: 'CUI',\n  confidential: 'Confidential',\n  secret: 'Secret',\n  'top-secret': 'Top Secret',\n  'ts-sci': 'TS/SCI',\n} as const;\n\n/**\n * ClassificationBadge - A specialized badge for security and data classification\n *\n * Provides standardized visual indicators for data classification levels such as\n * confidential, secret, or public information. Designed for compliance with\n * security standards and information governance requirements.\n *\n * @example\n * // Basic classification badge\n * <ClassificationBadge level=\"confidential\" />\n *\n * @example\n * // Classification with custom styling\n * <ClassificationBadge level=\"secret\" />\n */\nexport function ClassificationBadge({\n  ref,\n  ...props\n}: ClassificationBadgeProps) {\n  [props, ref] = useContextProps(\n    props,\n    ref ?? null,\n    ClassificationBadgeContext,\n  );\n\n  const {\n    children,\n    className,\n    size = 'medium',\n    variant = 'missing',\n    ...rest\n  } = props;\n\n  return (\n    <span\n      {...rest}\n      className={clsx(\n        'group/classification-badge',\n        styles.badge,\n        styles[variant],\n        className,\n      )}\n      data-size={size}\n    >\n      {children || fallbackContent[variant]}\n    </span>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAoBA,MAAM,kBAAkB;CACtB,SAAS;CACT,cAAc;CACd,KAAK;CACL,cAAc;CACd,QAAQ;CACR,cAAc;CACd,UAAU;CACX;;;;;;;;;;;;;;;;AAiBD,SAAgB,oBAAoB,EAClC,KACA,GAAG,SACwB;AAC3B,EAAC,OAAO,OAAO,gBACb,OACA,OAAO,MACP,2BACD;CAED,MAAM,EACJ,UACA,WACA,OAAO,UACP,UAAU,WACV,GAAG,SACD;AAEJ,QACE,oBAAC;EACC,GAAI;EACJ,WAAW,KACT,8BACA,OAAO,OACP,OAAO,UACP,UACD;EACD,aAAW;YAEV,YAAY,gBAAgB;GACxB"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/classification-badge/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 { useContextProps } from 'react-aria-components';\nimport { ClassificationBadgeContext } from './context';\nimport styles from './styles.module.css';\nimport type { ClassificationBadgeProps } from './types';\n\nconst fallbackContent = {\n  missing: 'Missing',\n  unclassified: 'Unclassified',\n  cui: 'CUI',\n  confidential: 'Confidential',\n  secret: 'Secret',\n  'top-secret': 'Top Secret',\n  'ts-sci': 'TS/SCI',\n} as const;\n\n/**\n * ClassificationBadge - Displays security classification levels for documents and data.\n *\n * Provides standardized visual indicators for classification levels such as\n * unclassified, confidential, secret, and top-secret. Designed for compliance\n * with security standards in government and secure environments.\n *\n * @param props - The classification badge props.\n * @param props.ref - Reference to the badge element.\n * @param props.children - Custom text content (defaults to variant label).\n * @param props.className - Additional CSS class names for styling.\n * @param props.size - Size of the badge.\n * @param props.variant - Classification level variant.\n * @returns The classification badge component.\n *\n * @example\n * ```tsx\n * <ClassificationBadge variant=\"secret\" />\n * ```\n *\n * @example\n * ```tsx\n * // With custom text\n * <ClassificationBadge variant=\"top-secret\">TOP SECRET//NOFORN</ClassificationBadge>\n * ```\n *\n * @example\n * ```tsx\n * // Different sizes\n * <ClassificationBadge variant=\"confidential\" size=\"small\" />\n * ```\n */\nexport function ClassificationBadge({\n  ref,\n  ...props\n}: ClassificationBadgeProps) {\n  [props, ref] = useContextProps(\n    props,\n    ref ?? null,\n    ClassificationBadgeContext,\n  );\n\n  const {\n    children,\n    className,\n    size = 'medium',\n    variant = 'missing',\n    ...rest\n  } = props;\n\n  return (\n    <span\n      {...rest}\n      className={clsx(\n        'group/classification-badge',\n        styles.badge,\n        styles[variant],\n        className,\n      )}\n      data-size={size}\n    >\n      {children || fallbackContent[variant]}\n    </span>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAoBA,MAAM,kBAAkB;CACtB,SAAS;CACT,cAAc;CACd,KAAK;CACL,cAAc;CACd,QAAQ;CACR,cAAc;CACd,UAAU;CACX;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCD,SAAgB,oBAAoB,EAClC,KACA,GAAG,SACwB;AAC3B,EAAC,OAAO,OAAO,gBACb,OACA,OAAO,MACP,2BACD;CAED,MAAM,EACJ,UACA,WACA,OAAO,UACP,UAAU,WACV,GAAG,SACD;AAEJ,QACE,oBAAC;EACC,GAAI;EACJ,WAAW,KACT,8BACA,OAAO,OACP,OAAO,UACP,UACD;EACD,aAAW;YAEV,YAAY,gBAAgB;GACxB"}

package/dist/components/classification-badge/types.d.ts

@@ -14,7 +14,11 @@ import { ClassificationBannerProps } from "../classification-banner/types.js";
 import { ComponentPropsWithRef } from "react";
 
 //#region src/components/classification-badge/types.d.ts
+/**
+ * Props for the ClassificationBadge component.
+ */
 type ClassificationBadgeProps = Pick<ClassificationBannerProps, 'variant'> & ComponentPropsWithRef<'span'> & {
+  /** Size of the badge. */
   size?: 'medium' | 'small';
 };
 //#endregion

package/dist/components/classification-banner/context.d.ts

@@ -13,16 +13,32 @@
 import { ProviderProps } from "../../lib/types.js";
 import { ClassificationBannerProps } from "./types.js";
 import "client-only";
-import * as react12 from "react";
+import * as react11 from "react";
 import { ContextValue } from "react-aria-components";
-import * as react_jsx_runtime28 from "react/jsx-runtime";
+import * as react_jsx_runtime25 from "react/jsx-runtime";
 
 //#region src/components/classification-banner/context.d.ts
-declare const ClassificationBannerContext: react12.Context<ContextValue<ClassificationBannerProps, HTMLDivElement>>;
+/** React context for sharing ClassificationBanner configuration across components. */
+declare const ClassificationBannerContext: react11.Context<ContextValue<ClassificationBannerProps, HTMLDivElement>>;
+/**
+ * Context provider for setting default props across multiple ClassificationBanner components.
+ *
+ * @param props - The provider props.
+ * @param props.children - Child components that will receive the classification banner context.
+ * @returns The classification banner context provider wrapping children.
+ *
+ * @example
+ * ```tsx
+ * <ClassificationBannerProvider variant="secret">
+ *   <ClassificationBanner />
+ *   <ClassificationBanner />
+ * </ClassificationBannerProvider>
+ * ```
+ */
 declare function ClassificationBannerProvider({
   children,
   ...props
-}: ProviderProps<ClassificationBannerProps>): react_jsx_runtime28.JSX.Element;
+}: ProviderProps<ClassificationBannerProps>): react_jsx_runtime25.JSX.Element;
 //#endregion
 export { ClassificationBannerContext, ClassificationBannerProvider };
 //# sourceMappingURL=context.d.ts.map

package/dist/components/classification-banner/context.js

@@ -18,7 +18,23 @@ import { createContext } from "react";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/components/classification-banner/context.tsx
+/** React context for sharing ClassificationBanner configuration across components. */
 const ClassificationBannerContext = createContext(null);
+/**
+* Context provider for setting default props across multiple ClassificationBanner components.
+*
+* @param props - The provider props.
+* @param props.children - Child components that will receive the classification banner context.
+* @returns The classification banner context provider wrapping children.
+*
+* @example
+* ```tsx
+* <ClassificationBannerProvider variant="secret">
+*   <ClassificationBanner />
+*   <ClassificationBanner />
+* </ClassificationBannerProvider>
+* ```
+*/
 function ClassificationBannerProvider({ children, ...props }) {
 	return /* @__PURE__ */ jsx(ClassificationBannerContext.Provider, {
 		value: props,

package/dist/components/classification-banner/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/classification-banner/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 type { ProviderProps } from '@/lib/types';\nimport 'client-only';\nimport { createContext } from 'react';\nimport type { ContextValue } from 'react-aria-components';\nimport type { ClassificationBannerProps } from './types';\n\nexport const ClassificationBannerContext =\n  createContext<ContextValue<ClassificationBannerProps, HTMLDivElement>>(null);\n\nexport function ClassificationBannerProvider({\n  children,\n  ...props\n}: ProviderProps<ClassificationBannerProps>) {\n  return (\n    <ClassificationBannerContext.Provider value={props}>\n      {children}\n    </ClassificationBannerContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmBA,MAAa,8BACX,cAAuE,KAAK;AAE9E,SAAgB,6BAA6B,EAC3C,UACA,GAAG,SACwC;AAC3C,QACE,oBAAC,4BAA4B;EAAS,OAAO;EAC1C;GACoC"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/classification-banner/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 type { ProviderProps } from '@/lib/types';\nimport 'client-only';\nimport { createContext } from 'react';\nimport type { ContextValue } from 'react-aria-components';\nimport type { ClassificationBannerProps } from './types';\n\n/** React context for sharing ClassificationBanner configuration across components. */\nexport const ClassificationBannerContext =\n  createContext<ContextValue<ClassificationBannerProps, HTMLDivElement>>(null);\n\n/**\n * Context provider for setting default props across multiple ClassificationBanner components.\n *\n * @param props - The provider props.\n * @param props.children - Child components that will receive the classification banner context.\n * @returns The classification banner context provider wrapping children.\n *\n * @example\n * ```tsx\n * <ClassificationBannerProvider variant=\"secret\">\n *   <ClassificationBanner />\n *   <ClassificationBanner />\n * </ClassificationBannerProvider>\n * ```\n */\nexport function ClassificationBannerProvider({\n  children,\n  ...props\n}: ProviderProps<ClassificationBannerProps>) {\n  return (\n    <ClassificationBannerContext.Provider value={props}>\n      {children}\n    </ClassificationBannerContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAoBA,MAAa,8BACX,cAAuE,KAAK;;;;;;;;;;;;;;;;AAiB9E,SAAgB,6BAA6B,EAC3C,UACA,GAAG,SACwC;AAC3C,QACE,oBAAC,4BAA4B;EAAS,OAAO;EAC1C;GACoC"}

package/dist/components/classification-banner/index.d.ts

@@ -12,9 +12,10 @@
 
 import { ClassificationBannerProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime29 from "react/jsx-runtime";
+import * as react_jsx_runtime26 from "react/jsx-runtime";
 
 //#region src/components/classification-banner/index.d.ts
+
 /**
  * ClassificationBanner - A prominent banner for displaying security classification
  *
@@ -22,14 +23,23 @@ import * as react_jsx_runtime29 from "react/jsx-runtime";
  * information at the top or bottom of pages. Essential for applications handling
  * classified or sensitive information requiring clear visual indicators.
  *
+ * @param props - The classification banner props.
+ * @param props.ref - Reference to the banner element.
+ * @param props.children - Custom text content (defaults to variant label).
+ * @param props.className - Additional CSS class names for styling.
+ * @param props.variant - Classification level variant.
+ * @returns The classification banner component.
+ *
  * @example
+ * ```tsx
  * // Top classification banner
  * <ClassificationBanner variant="confidential" />
+ * ```
  */
 declare function ClassificationBanner({
   ref,
   ...props
-}: ClassificationBannerProps): react_jsx_runtime29.JSX.Element;
+}: ClassificationBannerProps): react_jsx_runtime26.JSX.Element;
 //#endregion
 export { ClassificationBanner };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/classification-banner/index.js

@@ -37,9 +37,18 @@ const fallbackContent = {
 * information at the top or bottom of pages. Essential for applications handling
 * classified or sensitive information requiring clear visual indicators.
 *
+* @param props - The classification banner props.
+* @param props.ref - Reference to the banner element.
+* @param props.children - Custom text content (defaults to variant label).
+* @param props.className - Additional CSS class names for styling.
+* @param props.variant - Classification level variant.
+* @returns The classification banner component.
+*
 * @example
+* ```tsx
 * // Top classification banner
 * <ClassificationBanner variant="confidential" />
+* ```
 */
 function ClassificationBanner({ ref, ...props }) {
 	[props, ref] = useContextProps(props, ref ?? null, ClassificationBannerContext);

package/dist/components/classification-banner/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/classification-banner/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 { useContextProps } from 'react-aria-components';\nimport { ClassificationBannerContext } from './context';\nimport styles from './styles.module.css';\nimport type { ClassificationBannerProps } from './types';\n\nconst fallbackContent = {\n  missing: 'Missing',\n  unclassified: 'Unclassified',\n  cui: 'CUI',\n  confidential: 'Confidential',\n  secret: 'Secret',\n  'top-secret': 'Top Secret',\n  'ts-sci': 'Top Secret/SCI',\n} as const;\n\n/**\n * ClassificationBanner - A prominent banner for displaying security classification\n *\n * Provides a full-width banner component for displaying security classification\n * information at the top or bottom of pages. Essential for applications handling\n * classified or sensitive information requiring clear visual indicators.\n *\n * @example\n * // Top classification banner\n * <ClassificationBanner variant=\"confidential\" />\n */\nexport function ClassificationBanner({\n  ref,\n  ...props\n}: ClassificationBannerProps) {\n  [props, ref] = useContextProps(\n    props,\n    ref ?? null,\n    ClassificationBannerContext,\n  );\n\n  const { children, className, variant = 'missing', ...rest } = props;\n\n  return (\n    <div\n      {...rest}\n      ref={ref}\n      className={clsx(styles.banner, styles[variant], className)}\n    >\n      {children || fallbackContent[variant]}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAoBA,MAAM,kBAAkB;CACtB,SAAS;CACT,cAAc;CACd,KAAK;CACL,cAAc;CACd,QAAQ;CACR,cAAc;CACd,UAAU;CACX;;;;;;;;;;;;AAaD,SAAgB,qBAAqB,EACnC,KACA,GAAG,SACyB;AAC5B,EAAC,OAAO,OAAO,gBACb,OACA,OAAO,MACP,4BACD;CAED,MAAM,EAAE,UAAU,WAAW,UAAU,WAAW,GAAG,SAAS;AAE9D,QACE,oBAAC;EACC,GAAI;EACC;EACL,WAAW,KAAK,OAAO,QAAQ,OAAO,UAAU,UAAU;YAEzD,YAAY,gBAAgB;GACzB"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/classification-banner/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 { useContextProps } from 'react-aria-components';\nimport { ClassificationBannerContext } from './context';\nimport styles from './styles.module.css';\nimport type { ClassificationBannerProps } from './types';\n\nconst fallbackContent = {\n  missing: 'Missing',\n  unclassified: 'Unclassified',\n  cui: 'CUI',\n  confidential: 'Confidential',\n  secret: 'Secret',\n  'top-secret': 'Top Secret',\n  'ts-sci': 'Top Secret/SCI',\n} as const;\n\n/**\n * ClassificationBanner - A prominent banner for displaying security classification\n *\n * Provides a full-width banner component for displaying security classification\n * information at the top or bottom of pages. Essential for applications handling\n * classified or sensitive information requiring clear visual indicators.\n *\n * @param props - The classification banner props.\n * @param props.ref - Reference to the banner element.\n * @param props.children - Custom text content (defaults to variant label).\n * @param props.className - Additional CSS class names for styling.\n * @param props.variant - Classification level variant.\n * @returns The classification banner component.\n *\n * @example\n * ```tsx\n * // Top classification banner\n * <ClassificationBanner variant=\"confidential\" />\n * ```\n */\nexport function ClassificationBanner({\n  ref,\n  ...props\n}: ClassificationBannerProps) {\n  [props, ref] = useContextProps(\n    props,\n    ref ?? null,\n    ClassificationBannerContext,\n  );\n\n  const { children, className, variant = 'missing', ...rest } = props;\n\n  return (\n    <div\n      {...rest}\n      ref={ref}\n      className={clsx(styles.banner, styles[variant], className)}\n    >\n      {children || fallbackContent[variant]}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAoBA,MAAM,kBAAkB;CACtB,SAAS;CACT,cAAc;CACd,KAAK;CACL,cAAc;CACd,QAAQ;CACR,cAAc;CACd,UAAU;CACX;;;;;;;;;;;;;;;;;;;;;AAsBD,SAAgB,qBAAqB,EACnC,KACA,GAAG,SACyB;AAC5B,EAAC,OAAO,OAAO,gBACb,OACA,OAAO,MACP,4BACD;CAED,MAAM,EAAE,UAAU,WAAW,UAAU,WAAW,GAAG,SAAS;AAE9D,QACE,oBAAC;EACC,GAAI;EACC;EACL,WAAW,KAAK,OAAO,QAAQ,OAAO,UAAU,UAAU;YAEzD,YAAY,gBAAgB;GACzB"}

package/dist/components/classification-banner/types.d.ts

@@ -13,7 +13,11 @@
 import { ComponentPropsWithRef } from "react";
 
 //#region src/components/classification-banner/types.d.ts
+/**
+ * Props for the ClassificationBanner component.
+ */
 type ClassificationBannerProps = ComponentPropsWithRef<'div'> & {
+  /** Classification level to display. */
   variant?: 'missing' | 'unclassified' | 'cui' | 'confidential' | 'secret' | 'top-secret' | 'ts-sci';
 };
 //#endregion

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

@@ -12,7 +12,7 @@
 
 import { ClockProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime31 from "react/jsx-runtime";
+import * as react_jsx_runtime28 from "react/jsx-runtime";
 
 //#region src/components/clock/index.d.ts
 
@@ -24,15 +24,24 @@ import * as react_jsx_runtime31 from "react/jsx-runtime";
  *
  * NOTE: This component comes **unstyled by default**.
  *
+ * @param props - The clock props.
+ * @param props.formatter - Custom DateTimeFormat for time display.
+ * @returns The clock component displaying current time.
+ *
  * @example
+ * ```tsx
  * // Standard Clock
  * <Clock /> // <time>15:54:14 UTC</time>
+ * ```
  *
  * @example
+ * ```tsx
  * // Styled
  * <Clock className="fg-accent-primary-bold" />
+ * ```
  *
  * @example
+ * ```tsx
  * // Custom Format
  * const formatter = new Intl.DateTimeFormat('en-US', {
  *   dateStyle: "short",
@@ -42,13 +51,14 @@ import * as react_jsx_runtime31 from "react/jsx-runtime";
  * });
  *
  * <Clock formatter={formatter} /> // <time>9/30/25, 15:54:14 UTC</time>
+ * ```
  *
  * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat| DateTimeFormat MDN}
  */
 declare function Clock({
   formatter,
   ...rest
-}: ClockProps): react_jsx_runtime31.JSX.Element;
+}: ClockProps): react_jsx_runtime28.JSX.Element;
 //#endregion
 export { Clock };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/clock/index.js

@@ -32,15 +32,24 @@ const DEFAULT_FORMATTER = new Intl.DateTimeFormat("en-US", {
 *
 * NOTE: This component comes **unstyled by default**.
 *
+* @param props - The clock props.
+* @param props.formatter - Custom DateTimeFormat for time display.
+* @returns The clock component displaying current time.
+*
 * @example
+* ```tsx
 * // Standard Clock
 * <Clock /> // <time>15:54:14 UTC</time>
+* ```
 *
 * @example
+* ```tsx
 * // Styled
 * <Clock className="fg-accent-primary-bold" />
+* ```
 *
 * @example
+* ```tsx
 * // Custom Format
 * const formatter = new Intl.DateTimeFormat('en-US', {
 *   dateStyle: "short",
@@ -50,6 +59,7 @@ const DEFAULT_FORMATTER = new Intl.DateTimeFormat("en-US", {
 * });
 *
 * <Clock formatter={formatter} /> // <time>9/30/25, 15:54:14 UTC</time>
+* ```
 *
 * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat| DateTimeFormat MDN}
 */

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/clock/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 { setClockInterval } from '@accelint/temporal';\nimport 'client-only';\nimport { useCallback, useEffect, useState } from 'react';\nimport type { ClockProps } from './types';\n\nconst DEFAULT_FORMATTER = new Intl.DateTimeFormat('en-US', {\n  timeStyle: 'long',\n  timeZone: 'UTC',\n  hour12: false,\n});\n\n/**\n * Clock - An auto-updating UTC time component.\n *\n * Uses a {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat|DateTimeFormat} configured with `'en-US', { timeStyle: 'long, timeZone: 'UTC', hour12: false }` by default,\n * but can be overridden with the `formatter` prop.\n *\n * NOTE: This component comes **unstyled by default**.\n *\n * @example\n * // Standard Clock\n * <Clock /> // <time>15:54:14 UTC</time>\n *\n * @example\n * // Styled\n * <Clock className=\"fg-accent-primary-bold\" />\n *\n * @example\n * // Custom Format\n * const formatter = new Intl.DateTimeFormat('en-US', {\n *   dateStyle: \"short\",\n *   timeStyle: 'long',\n *   timeZone: 'UTC',\n *   hour12: false\n * });\n *\n * <Clock formatter={formatter} /> // <time>9/30/25, 15:54:14 UTC</time>\n *\n * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat| DateTimeFormat MDN}\n */\nexport function Clock({ formatter = DEFAULT_FORMATTER, ...rest }: ClockProps) {\n  const now = useCallback(() => formatter.format(Date.now()), [formatter]);\n\n  const [time, setTime] = useState<string>(now());\n\n  useEffect(() => setClockInterval(() => setTime(now()), 1000), [now]);\n\n  return <time {...rest}>{time}</time>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAkBA,MAAM,oBAAoB,IAAI,KAAK,eAAe,SAAS;CACzD,WAAW;CACX,UAAU;CACV,QAAQ;CACT,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BF,SAAgB,MAAM,EAAE,YAAY,mBAAmB,GAAG,QAAoB;CAC5E,MAAM,MAAM,kBAAkB,UAAU,OAAO,KAAK,KAAK,CAAC,EAAE,CAAC,UAAU,CAAC;CAExE,MAAM,CAAC,MAAM,WAAW,SAAiB,KAAK,CAAC;AAE/C,iBAAgB,uBAAuB,QAAQ,KAAK,CAAC,EAAE,IAAK,EAAE,CAAC,IAAI,CAAC;AAEpE,QAAO,oBAAC;EAAK,GAAI;YAAO;GAAY"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/clock/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 { setClockInterval } from '@accelint/temporal';\nimport 'client-only';\nimport { useCallback, useEffect, useState } from 'react';\nimport type { ClockProps } from './types';\n\nconst DEFAULT_FORMATTER = new Intl.DateTimeFormat('en-US', {\n  timeStyle: 'long',\n  timeZone: 'UTC',\n  hour12: false,\n});\n\n/**\n * Clock - An auto-updating UTC time component.\n *\n * Uses a {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat|DateTimeFormat} configured with `'en-US', { timeStyle: 'long, timeZone: 'UTC', hour12: false }` by default,\n * but can be overridden with the `formatter` prop.\n *\n * NOTE: This component comes **unstyled by default**.\n *\n * @param props - The clock props.\n * @param props.formatter - Custom DateTimeFormat for time display.\n * @returns The clock component displaying current time.\n *\n * @example\n * ```tsx\n * // Standard Clock\n * <Clock /> // <time>15:54:14 UTC</time>\n * ```\n *\n * @example\n * ```tsx\n * // Styled\n * <Clock className=\"fg-accent-primary-bold\" />\n * ```\n *\n * @example\n * ```tsx\n * // Custom Format\n * const formatter = new Intl.DateTimeFormat('en-US', {\n *   dateStyle: \"short\",\n *   timeStyle: 'long',\n *   timeZone: 'UTC',\n *   hour12: false\n * });\n *\n * <Clock formatter={formatter} /> // <time>9/30/25, 15:54:14 UTC</time>\n * ```\n *\n * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat| DateTimeFormat MDN}\n */\nexport function Clock({ formatter = DEFAULT_FORMATTER, ...rest }: ClockProps) {\n  const now = useCallback(() => formatter.format(Date.now()), [formatter]);\n\n  const [time, setTime] = useState<string>(now());\n\n  useEffect(() => setClockInterval(() => setTime(now()), 1000), [now]);\n\n  return <time {...rest}>{time}</time>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAkBA,MAAM,oBAAoB,IAAI,KAAK,eAAe,SAAS;CACzD,WAAW;CACX,UAAU;CACV,QAAQ;CACT,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCF,SAAgB,MAAM,EAAE,YAAY,mBAAmB,GAAG,QAAoB;CAC5E,MAAM,MAAM,kBAAkB,UAAU,OAAO,KAAK,KAAK,CAAC,EAAE,CAAC,UAAU,CAAC;CAExE,MAAM,CAAC,MAAM,WAAW,SAAiB,KAAK,CAAC;AAE/C,iBAAgB,uBAAuB,QAAQ,KAAK,CAAC,EAAE,IAAK,EAAE,CAAC,IAAI,CAAC;AAEpE,QAAO,oBAAC;EAAK,GAAI;YAAO;GAAY"}

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

@@ -13,7 +13,11 @@
 import { ComponentPropsWithRef } from "react";
 
 //#region src/components/clock/types.d.ts
+/**
+ * Props for the Clock component.
+ */
 type ClockProps = ComponentPropsWithRef<'time'> & {
+  /** Custom DateTimeFormat for time display. */
   formatter?: Intl.DateTimeFormat;
 };
 //#endregion

package/dist/components/color-picker/index.d.ts

@@ -12,7 +12,7 @@
 
 import { ColorPickerProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime25 from "react/jsx-runtime";
+import * as react_jsx_runtime30 from "react/jsx-runtime";
 
 //#region src/components/color-picker/index.d.ts
 
@@ -24,11 +24,13 @@ import * as react_jsx_runtime25 from "react/jsx-runtime";
  * to select that color. The component supports keyboard navigation, accessibility
  * features, and fine-grained styling control through the classNames prop.
  *
- * @param items - Array of color values to display as selectable swatches
- * @param classNames - Object containing CSS class names for fine-grained styling control
- * @param classNames.picker - CSS class name for the main picker container
- * @param classNames.item - CSS class name for individual swatch items
- * @param classNames.swatch - CSS class name for the color swatch elements
+ * @param props - The color picker props.
+ * @param props.items - Array of color values to display as selectable swatches.
+ * @param props.classNames - Custom class names for sub-elements.
+ * @param props.classNames.picker - Class name for the picker container.
+ * @param props.classNames.item - Class name for individual swatch items.
+ * @param props.classNames.swatch - Class name for the color swatch elements.
+ * @returns The color picker component.
  *
  * @example
  * ```tsx
@@ -39,13 +41,13 @@ import * as react_jsx_runtime25 from "react/jsx-runtime";
  * ];
  *
  * <ColorPicker
- *   options={colors}
- *   value={'#ff0000'}
+ *   items={colors}
+ *   value="#ff0000"
  *   onChange={(color) => console.log('Selected:', color)}
  *   classNames={{
  *     picker: 'gap-4',
  *     item: 'rounded-lg',
- *     swatch: 'w-8 h-8'
+ *     swatch: 'w-8 h-8',
  *   }}
  * />
  * ```
@@ -60,7 +62,7 @@ declare function ColorPicker({
   classNames,
   items,
   ...rest
-}: ColorPickerProps): react_jsx_runtime25.JSX.Element;
+}: ColorPickerProps): react_jsx_runtime30.JSX.Element;
 //#endregion
 export { ColorPicker };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/color-picker/index.js

@@ -28,11 +28,13 @@ import styles from "./styles.module.css";
 * to select that color. The component supports keyboard navigation, accessibility
 * features, and fine-grained styling control through the classNames prop.
 *
-* @param items - Array of color values to display as selectable swatches
-* @param classNames - Object containing CSS class names for fine-grained styling control
-* @param classNames.picker - CSS class name for the main picker container
-* @param classNames.item - CSS class name for individual swatch items
-* @param classNames.swatch - CSS class name for the color swatch elements
+* @param props - The color picker props.
+* @param props.items - Array of color values to display as selectable swatches.
+* @param props.classNames - Custom class names for sub-elements.
+* @param props.classNames.picker - Class name for the picker container.
+* @param props.classNames.item - Class name for individual swatch items.
+* @param props.classNames.swatch - Class name for the color swatch elements.
+* @returns The color picker component.
 *
 * @example
 * ```tsx
@@ -43,13 +45,13 @@ import styles from "./styles.module.css";
 * ];
 *
 * <ColorPicker
-*   options={colors}
-*   value={'#ff0000'}
+*   items={colors}
+*   value="#ff0000"
 *   onChange={(color) => console.log('Selected:', color)}
 *   classNames={{
 *     picker: 'gap-4',
 *     item: 'rounded-lg',
-*     swatch: 'w-8 h-8'
+*     swatch: 'w-8 h-8',
 *   }}
 * />
 * ```

package/dist/components/color-picker/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/color-picker/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  ColorSwatch,\n  ColorSwatchPicker,\n  ColorSwatchPickerItem,\n  composeRenderProps,\n} from 'react-aria-components';\nimport styles from './styles.module.css';\nimport type { ColorPickerProps } from './types';\n\n/**\n * A color picker component that renders a grid of color swatches for selection.\n *\n * This component provides a simple interface for users to select from a predefined\n * set of colors. It renders each color as an interactive swatch that can be clicked\n * to select that color. The component supports keyboard navigation, accessibility\n * features, and fine-grained styling control through the classNames prop.\n *\n * @param items - Array of color values to display as selectable swatches\n * @param classNames - Object containing CSS class names for fine-grained styling control\n * @param classNames.picker - CSS class name for the main picker container\n * @param classNames.item - CSS class name for individual swatch items\n * @param classNames.swatch - CSS class name for the color swatch elements\n *\n * @example\n * ```tsx\n * const colors = [\n *   '#ff0000',\n *   '#00ff00',\n *   '#0000ff',\n * ];\n *\n * <ColorPicker\n *   options={colors}\n *   value={'#ff0000'}\n *   onChange={(color) => console.log('Selected:', color)}\n *   classNames={{\n *     picker: 'gap-4',\n *     item: 'rounded-lg',\n *     swatch: 'w-8 h-8'\n *   }}\n * />\n * ```\n *\n * @remarks\n * - Colors can be provided as Color objects or color strings\n * - The component automatically handles color parsing and validation\n * - Supports all accessibility features from react-aria-components\n * - Uses a grid layout by default but can be customized via the layout prop\n */\nexport function ColorPicker({ classNames, items, ...rest }: ColorPickerProps) {\n  return (\n    <ColorSwatchPicker\n      {...rest}\n      className={composeRenderProps(classNames?.picker, (className) =>\n        clsx(styles.picker, className),\n      )}\n    >\n      {items.map((color) => (\n        <ColorSwatchPickerItem\n          key={color.toString('hexa')}\n          className={composeRenderProps(classNames?.item, (className) =>\n            clsx(styles.item, className),\n          )}\n          color={color}\n        >\n          <ColorSwatch\n            className={composeRenderProps(classNames?.swatch, (className) =>\n              clsx(styles.swatch, className),\n            )}\n          />\n        </ColorSwatchPickerItem>\n      ))}\n    </ColorSwatchPicker>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgEA,SAAgB,YAAY,EAAE,YAAY,OAAO,GAAG,QAA0B;AAC5E,QACE,oBAAC;EACC,GAAI;EACJ,WAAW,mBAAmB,YAAY,SAAS,cACjD,KAAK,OAAO,QAAQ,UAAU,CAC/B;YAEA,MAAM,KAAK,UACV,oBAAC;GAEC,WAAW,mBAAmB,YAAY,OAAO,cAC/C,KAAK,OAAO,MAAM,UAAU,CAC7B;GACM;aAEP,oBAAC,eACC,WAAW,mBAAmB,YAAY,SAAS,cACjD,KAAK,OAAO,QAAQ,UAAU,CAC/B,GACD;KAVG,MAAM,SAAS,OAAO,CAWL,CACxB;GACgB"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/color-picker/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  ColorSwatch,\n  ColorSwatchPicker,\n  ColorSwatchPickerItem,\n  composeRenderProps,\n} from 'react-aria-components';\nimport styles from './styles.module.css';\nimport type { ColorPickerProps } from './types';\n\n/**\n * A color picker component that renders a grid of color swatches for selection.\n *\n * This component provides a simple interface for users to select from a predefined\n * set of colors. It renders each color as an interactive swatch that can be clicked\n * to select that color. The component supports keyboard navigation, accessibility\n * features, and fine-grained styling control through the classNames prop.\n *\n * @param props - The color picker props.\n * @param props.items - Array of color values to display as selectable swatches.\n * @param props.classNames - Custom class names for sub-elements.\n * @param props.classNames.picker - Class name for the picker container.\n * @param props.classNames.item - Class name for individual swatch items.\n * @param props.classNames.swatch - Class name for the color swatch elements.\n * @returns The color picker component.\n *\n * @example\n * ```tsx\n * const colors = [\n *   '#ff0000',\n *   '#00ff00',\n *   '#0000ff',\n * ];\n *\n * <ColorPicker\n *   items={colors}\n *   value=\"#ff0000\"\n *   onChange={(color) => console.log('Selected:', color)}\n *   classNames={{\n *     picker: 'gap-4',\n *     item: 'rounded-lg',\n *     swatch: 'w-8 h-8',\n *   }}\n * />\n * ```\n *\n * @remarks\n * - Colors can be provided as Color objects or color strings\n * - The component automatically handles color parsing and validation\n * - Supports all accessibility features from react-aria-components\n * - Uses a grid layout by default but can be customized via the layout prop\n */\nexport function ColorPicker({ classNames, items, ...rest }: ColorPickerProps) {\n  return (\n    <ColorSwatchPicker\n      {...rest}\n      className={composeRenderProps(classNames?.picker, (className) =>\n        clsx(styles.picker, className),\n      )}\n    >\n      {items.map((color) => (\n        <ColorSwatchPickerItem\n          key={color.toString('hexa')}\n          className={composeRenderProps(classNames?.item, (className) =>\n            clsx(styles.item, className),\n          )}\n          color={color}\n        >\n          <ColorSwatch\n            className={composeRenderProps(classNames?.swatch, (className) =>\n              clsx(styles.swatch, className),\n            )}\n          />\n        </ColorSwatchPickerItem>\n      ))}\n    </ColorSwatchPicker>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkEA,SAAgB,YAAY,EAAE,YAAY,OAAO,GAAG,QAA0B;AAC5E,QACE,oBAAC;EACC,GAAI;EACJ,WAAW,mBAAmB,YAAY,SAAS,cACjD,KAAK,OAAO,QAAQ,UAAU,CAC/B;YAEA,MAAM,KAAK,UACV,oBAAC;GAEC,WAAW,mBAAmB,YAAY,OAAO,cAC/C,KAAK,OAAO,MAAM,UAAU,CAC7B;GACM;aAEP,oBAAC,eACC,WAAW,mBAAmB,YAAY,SAAS,cACjD,KAAK,OAAO,QAAQ,UAAU,CAC/B,GACD;KAVG,MAAM,SAAS,OAAO,CAWL,CACxB;GACgB"}

package/dist/components/color-picker/types.d.ts

@@ -14,12 +14,20 @@ import { RefAttributes } from "react";
 import { ColorSwatchPickerItemProps, ColorSwatchPickerProps, ColorSwatchProps } from "react-aria-components";
 
 //#region src/components/color-picker/types.d.ts
+/**
+ * Props for the ColorPicker component.
+ */
 type ColorPickerProps = Omit<ColorSwatchPickerProps, 'children' | 'layout'> & RefAttributes<HTMLDivElement> & {
+  /** Custom class names for sub-elements. */
   classNames?: {
+    /** Class name for the picker container. */
     picker?: ColorSwatchPickerProps['className'];
+    /** Class name for individual swatch items. */
     item?: ColorSwatchPickerItemProps['className'];
+    /** Class name for the color swatch elements. */
     swatch?: ColorSwatchProps['className'];
   };
+  /** Array of color values to display as selectable swatches. */
   items: ColorSwatchPickerItemProps['color'][];
 };
 //#endregion

package/dist/components/combobox-field/context.d.ts

@@ -14,16 +14,32 @@ import { ProviderProps } from "../../lib/types.js";
 import { OptionsDataItem } from "../options/types.js";
 import { ComboBoxFieldProps } from "./types.js";
 import "client-only";
-import * as react7 from "react";
+import * as react13 from "react";
 import { ContextValue } from "react-aria-components";
-import * as react_jsx_runtime20 from "react/jsx-runtime";
+import * as react_jsx_runtime31 from "react/jsx-runtime";
 
 //#region src/components/combobox-field/context.d.ts
-declare const ComboBoxFieldContext: react7.Context<ContextValue<ComboBoxFieldProps<any>, HTMLDivElement>>;
+/** React context for sharing ComboBoxField configuration across components. */
+declare const ComboBoxFieldContext: react13.Context<ContextValue<ComboBoxFieldProps<any>, HTMLDivElement>>;
+/**
+ * Context provider for setting default props across multiple ComboBoxField components.
+ *
+ * @param props - The provider props.
+ * @param props.children - Child components that will receive the combobox field context.
+ * @returns The combobox field context provider wrapping children.
+ *
+ * @example
+ * ```tsx
+ * <ComboBoxFieldProvider size="small">
+ *   <ComboBoxField defaultItems={items1}>{...}</ComboBoxField>
+ *   <ComboBoxField defaultItems={items2}>{...}</ComboBoxField>
+ * </ComboBoxFieldProvider>
+ * ```
+ */
 declare function ComboBoxFieldProvider<T extends OptionsDataItem>({
   children,
   ...props
-}: ProviderProps<ComboBoxFieldProps<T>>): react_jsx_runtime20.JSX.Element;
+}: ProviderProps<ComboBoxFieldProps<T>>): react_jsx_runtime31.JSX.Element;
 //#endregion
 export { ComboBoxFieldContext, ComboBoxFieldProvider };
 //# sourceMappingURL=context.d.ts.map

package/dist/components/combobox-field/context.js

@@ -18,7 +18,23 @@ import { createContext } from "react";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/components/combobox-field/context.tsx
+/** React context for sharing ComboBoxField configuration across components. */
 const ComboBoxFieldContext = createContext(null);
+/**
+* Context provider for setting default props across multiple ComboBoxField components.
+*
+* @param props - The provider props.
+* @param props.children - Child components that will receive the combobox field context.
+* @returns The combobox field context provider wrapping children.
+*
+* @example
+* ```tsx
+* <ComboBoxFieldProvider size="small">
+*   <ComboBoxField defaultItems={items1}>{...}</ComboBoxField>
+*   <ComboBoxField defaultItems={items2}>{...}</ComboBoxField>
+* </ComboBoxFieldProvider>
+* ```
+*/
 function ComboBoxFieldProvider({ children, ...props }) {
 	return /* @__PURE__ */ jsx(ComboBoxFieldContext.Provider, {
 		value: props,

package/dist/components/combobox-field/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/combobox-field/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 { ProviderProps } from '@/lib/types';\nimport type { OptionsDataItem } from '../options/types';\nimport type { ComboBoxFieldProps } from './types';\n\nexport const ComboBoxFieldContext =\n  // biome-ignore lint/suspicious/noExplicitAny: Setting a type would restrict it beyond what the component allows to extend to\n  createContext<ContextValue<ComboBoxFieldProps<any>, HTMLDivElement>>(null);\n\nexport function ComboBoxFieldProvider<T extends OptionsDataItem>({\n  children,\n  ...props\n}: ProviderProps<ComboBoxFieldProps<T>>) {\n  return (\n    <ComboBoxFieldContext.Provider value={props}>\n      {children}\n    </ComboBoxFieldContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,MAAa,uBAEX,cAAqE,KAAK;AAE5E,SAAgB,sBAAiD,EAC/D,UACA,GAAG,SACoC;AACvC,QACE,oBAAC,qBAAqB;EAAS,OAAO;EACnC;GAC6B"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/combobox-field/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 { ProviderProps } from '@/lib/types';\nimport type { OptionsDataItem } from '../options/types';\nimport type { ComboBoxFieldProps } from './types';\n\n/** React context for sharing ComboBoxField configuration across components. */\nexport const ComboBoxFieldContext =\n  // biome-ignore lint/suspicious/noExplicitAny: Setting a type would restrict it beyond what the component allows to extend to\n  createContext<ContextValue<ComboBoxFieldProps<any>, HTMLDivElement>>(null);\n\n/**\n * Context provider for setting default props across multiple ComboBoxField components.\n *\n * @param props - The provider props.\n * @param props.children - Child components that will receive the combobox field context.\n * @returns The combobox field context provider wrapping children.\n *\n * @example\n * ```tsx\n * <ComboBoxFieldProvider size=\"small\">\n *   <ComboBoxField defaultItems={items1}>{...}</ComboBoxField>\n *   <ComboBoxField defaultItems={items2}>{...}</ComboBoxField>\n * </ComboBoxFieldProvider>\n * ```\n */\nexport function ComboBoxFieldProvider<T extends OptionsDataItem>({\n  children,\n  ...props\n}: ProviderProps<ComboBoxFieldProps<T>>) {\n  return (\n    <ComboBoxFieldContext.Provider value={props}>\n      {children}\n    </ComboBoxFieldContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAqBA,MAAa,uBAEX,cAAqE,KAAK;;;;;;;;;;;;;;;;AAiB5E,SAAgB,sBAAiD,EAC/D,UACA,GAAG,SACoC;AACvC,QACE,oBAAC,qBAAqB;EAAS,OAAO;EACnC;GAC6B"}