@cognite/aura 0.3.5 → 1.46105.0

package/dist/lib/shared-theme-from-url.js

@@ -0,0 +1,61 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { buildSharedThemeCss, emptySharedTheme, readAppearanceFromHash, readThemeFromHash } from "./theme-share-url.js";
+const readInitialTheme = ()=>{
+    if (typeof window === 'undefined') return emptySharedTheme();
+    return readThemeFromHash(window.location.hash) ?? emptySharedTheme();
+};
+const readInitialAppearance = ()=>{
+    if (typeof window === 'undefined') return undefined;
+    return readAppearanceFromHash(window.location.hash);
+};
+/**
+ * Applies a shared theme (`#theme=…`) via injected CSS variables. Hash
+ * `#appearance=` overrides the Storybook toolbar theme so iframe parents can
+ * restyle the preview without remounting.
+ */ export const SharedThemeFromUrl = ({ toolbarTheme, children })=>{
+    const [shared, setShared] = useState(readInitialTheme);
+    const [hashAppearance, setHashAppearance] = useState(readInitialAppearance);
+    const applyFromHash = useCallback(()=>{
+        const fromHash = readThemeFromHash(window.location.hash);
+        if (fromHash) {
+            setShared(fromHash);
+        }
+        setHashAppearance(readAppearanceFromHash(window.location.hash));
+    }, []);
+    useEffect(()=>{
+        const onHashChange = ()=>applyFromHash();
+        window.addEventListener('hashchange', onHashChange);
+        return ()=>window.removeEventListener('hashchange', onHashChange);
+    }, [
+        applyFromHash
+    ]);
+    const theme = hashAppearance ?? toolbarTheme;
+    useEffect(()=>{
+        const root = document.documentElement;
+        if (theme === 'dark') {
+            root.classList.add('dark');
+        } else {
+            root.classList.remove('dark');
+        }
+    }, [
+        theme
+    ]);
+    const css = useMemo(()=>buildSharedThemeCss(shared), [
+        shared
+    ]);
+    return /*#__PURE__*/ _jsxs(_Fragment, {
+        children: [
+            css ? /*#__PURE__*/ _jsx("style", {
+                "data-aura-shared-theme": "",
+                children: css
+            }) : null,
+            /*#__PURE__*/ _jsx("div", {
+                className: theme === 'dark' ? 'dark text-foreground' : 'text-foreground',
+                children: children
+            })
+        ]
+    });
+};
+
+//# sourceMappingURL=shared-theme-from-url.js.map

package/dist/lib/shared-theme-from-url.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/shared-theme-from-url.tsx"],"sourcesContent":["import {\n  useCallback,\n  useEffect,\n  useMemo,\n  useState,\n  type ReactElement,\n  type ReactNode,\n} from 'react';\n\nimport {\n  buildSharedThemeCss,\n  emptySharedTheme,\n  readAppearanceFromHash,\n  readThemeFromHash,\n  type SharedThemeOverrides,\n  type ThemeAppearance,\n} from './theme-share-url';\n\nconst readInitialTheme = (): SharedThemeOverrides => {\n  if (typeof window === 'undefined') return emptySharedTheme();\n  return readThemeFromHash(window.location.hash) ?? emptySharedTheme();\n};\n\nconst readInitialAppearance = (): ThemeAppearance | undefined => {\n  if (typeof window === 'undefined') return undefined;\n  return readAppearanceFromHash(window.location.hash);\n};\n\ntype SharedThemeFromUrlProps = {\n  toolbarTheme: ThemeAppearance;\n  children: ReactNode;\n};\n\n/**\n * Applies a shared theme (`#theme=…`) via injected CSS variables. Hash\n * `#appearance=` overrides the Storybook toolbar theme so iframe parents can\n * restyle the preview without remounting.\n */\nexport const SharedThemeFromUrl = ({\n  toolbarTheme,\n  children,\n}: SharedThemeFromUrlProps): ReactElement => {\n  const [shared, setShared] = useState<SharedThemeOverrides>(readInitialTheme);\n  const [hashAppearance, setHashAppearance] = useState<\n    ThemeAppearance | undefined\n  >(readInitialAppearance);\n\n  const applyFromHash = useCallback(() => {\n    const fromHash = readThemeFromHash(window.location.hash);\n    if (fromHash) {\n      setShared(fromHash);\n    }\n    setHashAppearance(readAppearanceFromHash(window.location.hash));\n  }, []);\n\n  useEffect(() => {\n    const onHashChange = () => applyFromHash();\n    window.addEventListener('hashchange', onHashChange);\n    return () => window.removeEventListener('hashchange', onHashChange);\n  }, [applyFromHash]);\n\n  const theme = hashAppearance ?? toolbarTheme;\n\n  useEffect(() => {\n    const root = document.documentElement;\n    if (theme === 'dark') {\n      root.classList.add('dark');\n    } else {\n      root.classList.remove('dark');\n    }\n  }, [theme]);\n\n  const css = useMemo(() => buildSharedThemeCss(shared), [shared]);\n\n  return (\n    <>\n      {css ? <style data-aura-shared-theme=\"\">{css}</style> : null}\n      <div\n        className={\n          theme === 'dark' ? 'dark text-foreground' : 'text-foreground'\n        }\n      >\n        {children}\n      </div>\n    </>\n  );\n};\n"],"names":["useCallback","useEffect","useMemo","useState","buildSharedThemeCss","emptySharedTheme","readAppearanceFromHash","readThemeFromHash","readInitialTheme","window","location","hash","readInitialAppearance","undefined","SharedThemeFromUrl","toolbarTheme","children","shared","setShared","hashAppearance","setHashAppearance","applyFromHash","fromHash","onHashChange","addEventListener","removeEventListener","theme","root","document","documentElement","classList","add","remove","css","style","data-aura-shared-theme","div","className"],"mappings":";AAAA,SACEA,WAAW,EACXC,SAAS,EACTC,OAAO,EACPC,QAAQ,QAGH,QAAQ;AAEf,SACEC,mBAAmB,EACnBC,gBAAgB,EAChBC,sBAAsB,EACtBC,iBAAiB,QAGZ,uBAAoB;AAE3B,MAAMC,mBAAmB;IACvB,IAAI,OAAOC,WAAW,aAAa,OAAOJ;IAC1C,OAAOE,kBAAkBE,OAAOC,QAAQ,CAACC,IAAI,KAAKN;AACpD;AAEA,MAAMO,wBAAwB;IAC5B,IAAI,OAAOH,WAAW,aAAa,OAAOI;IAC1C,OAAOP,uBAAuBG,OAAOC,QAAQ,CAACC,IAAI;AACpD;AAOA;;;;CAIC,GACD,OAAO,MAAMG,qBAAqB,CAAC,EACjCC,YAAY,EACZC,QAAQ,EACgB;IACxB,MAAM,CAACC,QAAQC,UAAU,GAAGf,SAA+BK;IAC3D,MAAM,CAACW,gBAAgBC,kBAAkB,GAAGjB,SAE1CS;IAEF,MAAMS,gBAAgBrB,YAAY;QAChC,MAAMsB,WAAWf,kBAAkBE,OAAOC,QAAQ,CAACC,IAAI;QACvD,IAAIW,UAAU;YACZJ,UAAUI;QACZ;QACAF,kBAAkBd,uBAAuBG,OAAOC,QAAQ,CAACC,IAAI;IAC/D,GAAG,EAAE;IAELV,UAAU;QACR,MAAMsB,eAAe,IAAMF;QAC3BZ,OAAOe,gBAAgB,CAAC,cAAcD;QACtC,OAAO,IAAMd,OAAOgB,mBAAmB,CAAC,cAAcF;IACxD,GAAG;QAACF;KAAc;IAElB,MAAMK,QAAQP,kBAAkBJ;IAEhCd,UAAU;QACR,MAAM0B,OAAOC,SAASC,eAAe;QACrC,IAAIH,UAAU,QAAQ;YACpBC,KAAKG,SAAS,CAACC,GAAG,CAAC;QACrB,OAAO;YACLJ,KAAKG,SAAS,CAACE,MAAM,CAAC;QACxB;IACF,GAAG;QAACN;KAAM;IAEV,MAAMO,MAAM/B,QAAQ,IAAME,oBAAoBa,SAAS;QAACA;KAAO;IAE/D,qBACE;;YACGgB,oBAAM,KAACC;gBAAMC,0BAAuB;0BAAIF;iBAAe;0BACxD,KAACG;gBACCC,WACEX,UAAU,SAAS,yBAAyB;0BAG7CV;;;;AAIT,EAAE"}

package/dist/lib/style-scope.d.ts

@@ -1,5 +1,5 @@
 declare const styleScope: {
-    readonly styleScope: "aura-style-scope";
-    readonly portalContainer: "aura-portal-container";
+	readonly styleScope: "aura-style-scope";
+	readonly portalContainer: "aura-portal-container";
 };
 export default styleScope;

package/dist/lib/style-scope.js

@@ -1,7 +1,7 @@
-//#region libs/aura/src/lib/style-scope.ts
-var e = {
-	styleScope: "aura-style-scope",
-	portalContainer: "aura-portal-container"
+const styleScope = {
+    styleScope: 'aura-style-scope',
+    portalContainer: 'aura-portal-container'
 };
-//#endregion
-export { e as default };
+export default styleScope;
+
+//# sourceMappingURL=style-scope.js.map

package/dist/lib/style-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/style-scope.ts"],"sourcesContent":["const styleScope = {\n  styleScope: 'aura-style-scope',\n  portalContainer: 'aura-portal-container',\n} as const;\n\nexport default styleScope;\n"],"names":["styleScope","portalContainer"],"mappings":"AAAA,MAAMA,aAAa;IACjBA,YAAY;IACZC,iBAAiB;AACnB;AAEA,eAAeD,WAAW"}

package/dist/lib/theme-share-url.d.ts

@@ -0,0 +1,31 @@
+/**
+* Shareable theme encoding for Aura Storybook (and iframe parents).
+*
+* URL-safe base64 JSON of `{ base, light, dark }` string maps. Transport is
+* the URL hash (`#theme=…`) so a parent can restyle an iframe via `hashchange`
+* without rewriting Storybook's query string (which would remount the preview).
+*/
+export declare const THEME_HASH_PARAM = "theme";
+export declare const APPEARANCE_HASH_PARAM = "appearance";
+export type ThemeAppearance = "light" | "dark";
+export interface SharedThemeOverrides {
+	base: Record<string, string>;
+	light: Record<string, string>;
+	dark: Record<string, string>;
+}
+export declare const emptySharedTheme: () => SharedThemeOverrides;
+/** Encodes theme overrides into a URL-safe base64 string. */
+export declare function encodeTheme(overrides: SharedThemeOverrides): string;
+/** Decodes a theme string, returning undefined when malformed or unsafe. */
+export declare function decodeTheme(encoded: string): SharedThemeOverrides | undefined;
+/** Reads and decodes `#theme=…` from a location hash. */
+export declare function readThemeFromHash(hash: string): SharedThemeOverrides | undefined;
+/** Reads `#appearance=light|dark` from a location hash. */
+export declare function readAppearanceFromHash(hash: string): ThemeAppearance | undefined;
+/**
+* Builds a URL with the theme (and optional appearance) in the hash.
+* Existing hash params unrelated to theme/appearance are preserved.
+*/
+export declare function buildThemeHashUrl(baseUrl: string, overrides: SharedThemeOverrides, appearance?: ThemeAppearance): string;
+/** Serialises overrides into a `:root` / `.dark` CSS block (changed tokens only). */
+export declare function buildSharedThemeCss(overrides: SharedThemeOverrides): string;

package/dist/lib/theme-share-url.js

@@ -0,0 +1,116 @@
+/**
+ * Shareable theme encoding for Aura Storybook (and iframe parents).
+ *
+ * URL-safe base64 JSON of `{ base, light, dark }` string maps. Transport is
+ * the URL hash (`#theme=…`) so a parent can restyle an iframe via `hashchange`
+ * without rewriting Storybook's query string (which would remount the preview).
+ */ export const THEME_HASH_PARAM = 'theme';
+export const APPEARANCE_HASH_PARAM = 'appearance';
+export const emptySharedTheme = ()=>({
+        base: {},
+        light: {},
+        dark: {}
+    });
+const toBase64 = (input)=>btoa(unescape(encodeURIComponent(input)));
+const fromBase64 = (input)=>decodeURIComponent(escape(atob(input)));
+const toUrlSafe = (value)=>value.replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
+const fromUrlSafe = (value)=>{
+    const padded = value.replace(/-/g, '+').replace(/_/g, '/');
+    const remainder = padded.length % 4;
+    return remainder === 0 ? padded : padded + '='.repeat(4 - remainder);
+};
+const isRecord = (value)=>typeof value === 'object' && value !== null && !Array.isArray(value);
+const isStringRecord = (value)=>isRecord(value) && Object.values(value).every((entry)=>typeof entry === 'string');
+/** CSS custom-property name without the leading `--`. */ const CSS_TOKEN_NAME_PATTERN = /^[a-zA-Z][a-zA-Z0-9-]{0,127}$/;
+const isSafeCssTokenName = (name)=>CSS_TOKEN_NAME_PATTERN.test(name);
+const BREAKOUT_CHARS = new Set([
+    ';',
+    '{',
+    '}',
+    '<',
+    '>',
+    '\\'
+]);
+const hasUnsafeCssChars = (value)=>{
+    for (const char of value){
+        const code = char.charCodeAt(0);
+        if (code <= 0x1f || code === 0x7f || BREAKOUT_CHARS.has(char)) {
+            return true;
+        }
+    }
+    return false;
+};
+/** Rejects values that can break out of a CSS declaration or `<style>` block. */ const isSafeCssTokenValue = (value)=>{
+    if (value.length === 0 || value.length > 512) return false;
+    if (hasUnsafeCssChars(value)) return false;
+    return !/@|url\s*\(|expression\s*\(/i.test(value);
+};
+const isSafeTokenRecord = (value)=>isStringRecord(value) && Object.entries(value).every(([name, tokenValue])=>isSafeCssTokenName(name) && isSafeCssTokenValue(tokenValue));
+const sanitizeDeclarations = (declarations)=>Object.fromEntries(Object.entries(declarations).filter(([name, tokenValue])=>isSafeCssTokenName(name) && isSafeCssTokenValue(tokenValue)));
+/** Encodes theme overrides into a URL-safe base64 string. */ export function encodeTheme(overrides) {
+    return toUrlSafe(toBase64(JSON.stringify(overrides)));
+}
+/** Decodes a theme string, returning undefined when malformed or unsafe. */ export function decodeTheme(encoded) {
+    try {
+        const parsed = JSON.parse(fromBase64(fromUrlSafe(encoded)));
+        if (!isRecord(parsed)) return undefined;
+        if (!isSafeTokenRecord(parsed.base) || !isSafeTokenRecord(parsed.light) || !isSafeTokenRecord(parsed.dark)) {
+            return undefined;
+        }
+        return {
+            base: parsed.base,
+            light: parsed.light,
+            dark: parsed.dark
+        };
+    } catch  {
+        return undefined;
+    }
+}
+function parseHashParams(hash) {
+    const raw = hash.startsWith('#') ? hash.slice(1) : hash;
+    return new URLSearchParams(raw);
+}
+/** Reads and decodes `#theme=…` from a location hash. */ export function readThemeFromHash(hash) {
+    const encoded = parseHashParams(hash).get(THEME_HASH_PARAM);
+    return encoded ? decodeTheme(encoded) : undefined;
+}
+/** Reads `#appearance=light|dark` from a location hash. */ export function readAppearanceFromHash(hash) {
+    const value = parseHashParams(hash).get(APPEARANCE_HASH_PARAM);
+    return value === 'light' || value === 'dark' ? value : undefined;
+}
+/**
+ * Builds a URL with the theme (and optional appearance) in the hash.
+ * Existing hash params unrelated to theme/appearance are preserved.
+ */ export function buildThemeHashUrl(baseUrl, overrides, appearance) {
+    const url = new URL(baseUrl, typeof window !== 'undefined' ? window.location.origin : 'http://localhost');
+    const params = parseHashParams(url.hash);
+    params.set(THEME_HASH_PARAM, encodeTheme(overrides));
+    if (appearance) {
+        params.set(APPEARANCE_HASH_PARAM, appearance);
+    } else {
+        params.delete(APPEARANCE_HASH_PARAM);
+    }
+    url.hash = params.toString();
+    return url.toString();
+}
+/** Serialises overrides into a `:root` / `.dark` CSS block (changed tokens only). */ export function buildSharedThemeCss(overrides) {
+    const nl = String.fromCharCode(10);
+    const renderBlock = (selector, declarations)=>{
+        const safe = sanitizeDeclarations(declarations);
+        const names = Object.keys(safe).sort();
+        if (names.length === 0) return undefined;
+        const body = names.map((name)=>`  --${name}: ${safe[name]};`).join(nl);
+        return `${selector} {${nl}${body}${nl}}`;
+    };
+    const blocks = [];
+    const lightBlock = renderBlock(':root', {
+        ...overrides.base,
+        ...overrides.light
+    });
+    if (lightBlock) blocks.push(lightBlock);
+    const darkBlock = renderBlock('.dark', overrides.dark);
+    if (darkBlock) blocks.push(darkBlock);
+    return blocks.join(nl + nl);
+}
+
+//# sourceMappingURL=theme-share-url.js.map

package/dist/lib/theme-share-url.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/theme-share-url.ts"],"sourcesContent":["/**\n * Shareable theme encoding for Aura Storybook (and iframe parents).\n *\n * URL-safe base64 JSON of `{ base, light, dark }` string maps. Transport is\n * the URL hash (`#theme=…`) so a parent can restyle an iframe via `hashchange`\n * without rewriting Storybook's query string (which would remount the preview).\n */\n\nexport const THEME_HASH_PARAM = 'theme';\nexport const APPEARANCE_HASH_PARAM = 'appearance';\n\nexport type ThemeAppearance = 'light' | 'dark';\n\nexport interface SharedThemeOverrides {\n  base: Record<string, string>;\n  light: Record<string, string>;\n  dark: Record<string, string>;\n}\n\nexport const emptySharedTheme = (): SharedThemeOverrides => ({\n  base: {},\n  light: {},\n  dark: {},\n});\n\nconst toBase64 = (input: string): string =>\n  btoa(unescape(encodeURIComponent(input)));\n\nconst fromBase64 = (input: string): string =>\n  decodeURIComponent(escape(atob(input)));\n\nconst toUrlSafe = (value: string): string =>\n  value.replace(/\\+/g, '-').replace(/\\//g, '_').replace(/=+$/, '');\n\nconst fromUrlSafe = (value: string): string => {\n  const padded = value.replace(/-/g, '+').replace(/_/g, '/');\n  const remainder = padded.length % 4;\n  return remainder === 0 ? padded : padded + '='.repeat(4 - remainder);\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nconst isStringRecord = (value: unknown): value is Record<string, string> =>\n  isRecord(value) &&\n  Object.values(value).every((entry) => typeof entry === 'string');\n\n/** CSS custom-property name without the leading `--`. */\nconst CSS_TOKEN_NAME_PATTERN = /^[a-zA-Z][a-zA-Z0-9-]{0,127}$/;\n\nconst isSafeCssTokenName = (name: string): boolean =>\n  CSS_TOKEN_NAME_PATTERN.test(name);\n\nconst BREAKOUT_CHARS = new Set([';', '{', '}', '<', '>', '\\\\']);\n\nconst hasUnsafeCssChars = (value: string): boolean => {\n  for (const char of value) {\n    const code = char.charCodeAt(0);\n    if (code <= 0x1f || code === 0x7f || BREAKOUT_CHARS.has(char)) {\n      return true;\n    }\n  }\n  return false;\n};\n\n/** Rejects values that can break out of a CSS declaration or `<style>` block. */\nconst isSafeCssTokenValue = (value: string): boolean => {\n  if (value.length === 0 || value.length > 512) return false;\n  if (hasUnsafeCssChars(value)) return false;\n  return !/@|url\\s*\\(|expression\\s*\\(/i.test(value);\n};\n\nconst isSafeTokenRecord = (value: unknown): value is Record<string, string> =>\n  isStringRecord(value) &&\n  Object.entries(value).every(\n    ([name, tokenValue]) =>\n      isSafeCssTokenName(name) && isSafeCssTokenValue(tokenValue)\n  );\n\nconst sanitizeDeclarations = (\n  declarations: Record<string, string>\n): Record<string, string> =>\n  Object.fromEntries(\n    Object.entries(declarations).filter(\n      ([name, tokenValue]) =>\n        isSafeCssTokenName(name) && isSafeCssTokenValue(tokenValue)\n    )\n  );\n\n/** Encodes theme overrides into a URL-safe base64 string. */\nexport function encodeTheme(overrides: SharedThemeOverrides): string {\n  return toUrlSafe(toBase64(JSON.stringify(overrides)));\n}\n\n/** Decodes a theme string, returning undefined when malformed or unsafe. */\nexport function decodeTheme(encoded: string): SharedThemeOverrides | undefined {\n  try {\n    const parsed: unknown = JSON.parse(fromBase64(fromUrlSafe(encoded)));\n    if (!isRecord(parsed)) return undefined;\n    if (\n      !isSafeTokenRecord(parsed.base) ||\n      !isSafeTokenRecord(parsed.light) ||\n      !isSafeTokenRecord(parsed.dark)\n    ) {\n      return undefined;\n    }\n    return {\n      base: parsed.base,\n      light: parsed.light,\n      dark: parsed.dark,\n    };\n  } catch {\n    return undefined;\n  }\n}\n\nfunction parseHashParams(hash: string): URLSearchParams {\n  const raw = hash.startsWith('#') ? hash.slice(1) : hash;\n  return new URLSearchParams(raw);\n}\n\n/** Reads and decodes `#theme=…` from a location hash. */\nexport function readThemeFromHash(\n  hash: string\n): SharedThemeOverrides | undefined {\n  const encoded = parseHashParams(hash).get(THEME_HASH_PARAM);\n  return encoded ? decodeTheme(encoded) : undefined;\n}\n\n/** Reads `#appearance=light|dark` from a location hash. */\nexport function readAppearanceFromHash(\n  hash: string\n): ThemeAppearance | undefined {\n  const value = parseHashParams(hash).get(APPEARANCE_HASH_PARAM);\n  return value === 'light' || value === 'dark' ? value : undefined;\n}\n\n/**\n * Builds a URL with the theme (and optional appearance) in the hash.\n * Existing hash params unrelated to theme/appearance are preserved.\n */\nexport function buildThemeHashUrl(\n  baseUrl: string,\n  overrides: SharedThemeOverrides,\n  appearance?: ThemeAppearance\n): string {\n  const url = new URL(\n    baseUrl,\n    typeof window !== 'undefined' ? window.location.origin : 'http://localhost'\n  );\n  const params = parseHashParams(url.hash);\n  params.set(THEME_HASH_PARAM, encodeTheme(overrides));\n  if (appearance) {\n    params.set(APPEARANCE_HASH_PARAM, appearance);\n  } else {\n    params.delete(APPEARANCE_HASH_PARAM);\n  }\n  url.hash = params.toString();\n  return url.toString();\n}\n\n/** Serialises overrides into a `:root` / `.dark` CSS block (changed tokens only). */\nexport function buildSharedThemeCss(overrides: SharedThemeOverrides): string {\n  const nl = String.fromCharCode(10);\n  const renderBlock = (\n    selector: string,\n    declarations: Record<string, string>\n  ): string | undefined => {\n    const safe = sanitizeDeclarations(declarations);\n    const names = Object.keys(safe).sort();\n    if (names.length === 0) return undefined;\n    const body = names.map((name) => `  --${name}: ${safe[name]};`).join(nl);\n    return `${selector} {${nl}${body}${nl}}`;\n  };\n\n  const blocks: string[] = [];\n  const lightBlock = renderBlock(':root', {\n    ...overrides.base,\n    ...overrides.light,\n  });\n  if (lightBlock) blocks.push(lightBlock);\n  const darkBlock = renderBlock('.dark', overrides.dark);\n  if (darkBlock) blocks.push(darkBlock);\n  return blocks.join(nl + nl);\n}\n"],"names":["THEME_HASH_PARAM","APPEARANCE_HASH_PARAM","emptySharedTheme","base","light","dark","toBase64","input","btoa","unescape","encodeURIComponent","fromBase64","decodeURIComponent","escape","atob","toUrlSafe","value","replace","fromUrlSafe","padded","remainder","length","repeat","isRecord","Array","isArray","isStringRecord","Object","values","every","entry","CSS_TOKEN_NAME_PATTERN","isSafeCssTokenName","name","test","BREAKOUT_CHARS","Set","hasUnsafeCssChars","char","code","charCodeAt","has","isSafeCssTokenValue","isSafeTokenRecord","entries","tokenValue","sanitizeDeclarations","declarations","fromEntries","filter","encodeTheme","overrides","JSON","stringify","decodeTheme","encoded","parsed","parse","undefined","parseHashParams","hash","raw","startsWith","slice","URLSearchParams","readThemeFromHash","get","readAppearanceFromHash","buildThemeHashUrl","baseUrl","appearance","url","URL","window","location","origin","params","set","delete","toString","buildSharedThemeCss","nl","String","fromCharCode","renderBlock","selector","safe","names","keys","sort","body","map","join","blocks","lightBlock","push","darkBlock"],"mappings":"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"}

package/dist/lib/types.d.ts

@@ -1,50 +1,50 @@
 export interface ComponentExample {
-    title: string;
-    description: string;
-    component: React.ComponentType;
-    code: string;
-    tags?: string[];
-    difficulty?: 'beginner' | 'intermediate' | 'advanced';
-    notes?: string;
-    category?: 'usage' | 'variants' | 'advanced';
+	title: string;
+	description: string;
+	component: React.ComponentType;
+	code: string;
+	tags?: string[];
+	difficulty?: "beginner" | "intermediate" | "advanced";
+	notes?: string;
+	category?: "usage" | "variants" | "advanced";
 }
 export type ComponentExamples = Record<string, ComponentExample>;
 export interface PropDefinition {
-    name: string;
-    type: string;
-    default?: string;
-    required?: boolean;
-    description: string;
+	name: string;
+	type: string;
+	default?: string;
+	required?: boolean;
+	description: string;
 }
 export interface ComponentMeta {
-    name: string;
-    description: string;
-    /** Component status - defaults to 'draft' if not specified */
-    status?: ComponentStatusType;
-    llmUsage?: string;
-    importPath?: string;
-    apiReference?: {
-        props: PropDefinition[];
-    };
-    relatedComponents?: string[];
-    notes?: string[];
-    codeExamples?: CodeExample[];
+	name: string;
+	description: string;
+	/** Component status - defaults to 'draft' if not specified */
+	status?: ComponentStatusType;
+	llmUsage?: string;
+	importPath?: string;
+	apiReference?: {
+		props: PropDefinition[];
+	};
+	relatedComponents?: string[];
+	notes?: string[];
+	codeExamples?: CodeExample[];
 }
 export interface CodeExample {
-    /** Title of the code example */
-    title: string;
-    /** Optional description */
-    description?: string;
-    /** The actual code string */
-    code: string;
+	/** Title of the code example */
+	title: string;
+	/** Optional description */
+	description?: string;
+	/** The actual code string */
+	code: string;
 }
-export type ComponentStatusType = 'deprecated' | 'planned' | 'shadcn-ui' | 'experimental' | 'draft' | 'in-progress-storybook' | 'in-progress-code-review' | 'in-progress-chromatic' | 'in-progress-design-conformance' | 'ready-for-ga' | 'stable';
+export type ComponentStatusType = "deprecated" | "planned" | "shadcn-ui" | "experimental" | "draft" | "in-progress-storybook" | "in-progress-code-review" | "in-progress-chromatic" | "in-progress-design-conformance" | "ready-for-ga" | "stable";
 export interface StatusConfig {
-    label: string;
-    color: string;
-    colorDark: string;
-    bgColor: string;
-    bgColorDark: string;
-    borderColor: string;
-    borderColorDark: string;
+	label: string;
+	color: string;
+	colorDark: string;
+	bgColor: string;
+	bgColorDark: string;
+	borderColor: string;
+	borderColorDark: string;
 }

package/dist/lib/types.js

@@ -0,0 +1,3 @@
+export { };
+
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/types.ts"],"sourcesContent":["export interface ComponentExample {\n  title: string;\n  description: string;\n  component: React.ComponentType;\n  code: string;\n  tags?: string[];\n  difficulty?: 'beginner' | 'intermediate' | 'advanced';\n  notes?: string;\n  category?: 'usage' | 'variants' | 'advanced';\n}\n\nexport type ComponentExamples = Record<string, ComponentExample>;\n\n// API Reference types\nexport interface PropDefinition {\n  name: string;\n  type: string;\n  default?: string;\n  required?: boolean;\n  description: string;\n}\n\nexport interface ComponentMeta {\n  name: string;\n  description: string;\n  /** Component status - defaults to 'draft' if not specified */\n  status?: ComponentStatusType;\n  llmUsage?: string;\n  importPath?: string;\n  apiReference?: {\n    props: PropDefinition[];\n  };\n  relatedComponents?: string[];\n  notes?: string[];\n  codeExamples?: CodeExample[];\n}\n\nexport interface CodeExample {\n  /** Title of the code example */\n  title: string;\n  /** Optional description */\n  description?: string;\n  /** The actual code string */\n  code: string;\n}\n\nexport type ComponentStatusType =\n  | 'deprecated'\n  | 'planned'\n  | 'shadcn-ui'\n  | 'experimental'\n  | 'draft'\n  | 'in-progress-storybook'\n  | 'in-progress-code-review'\n  | 'in-progress-chromatic'\n  | 'in-progress-design-conformance'\n  | 'ready-for-ga'\n  | 'stable';\n\nexport interface StatusConfig {\n  label: string;\n  color: string; // hex color for light mode text\n  colorDark: string; // hex color for dark mode text\n  bgColor: string; // background hex for light mode\n  bgColorDark: string; // background hex for dark mode\n  borderColor: string; // border hex for light mode\n  borderColorDark: string; // border hex for dark mode\n}\n"],"names":[],"mappings":"AA2DA,WAQC"}

package/dist/lib/use-controllable-state.d.ts

@@ -1,11 +1,8 @@
 type UseControllableStateParams<T> = {
-    prop?: T;
-    defaultProp: T;
-    onChange?: (next: T) => void;
+	prop?: T;
+	defaultProp: T;
+	onChange?: (next: T) => void;
 };
 type SetStateAction<T> = T | ((prev: T) => T);
-export declare function useControllableState<T>({ prop, defaultProp, onChange, }: UseControllableStateParams<T>): readonly [
-    T,
-    (next: SetStateAction<T>) => void
-];
+export declare function useControllableState<T>({ prop, defaultProp, onChange }: UseControllableStateParams<T>): readonly [T, (next: SetStateAction<T>) => void];
 export {};

package/dist/lib/use-controllable-state.js

@@ -1,23 +1,36 @@
-import { useCallback as e, useEffect as t, useRef as n, useState as r } from "react";
-//#region libs/aura/src/lib/use-controllable-state.ts
-function i(e) {
-	return typeof e == "function";
+import { useCallback, useEffect, useRef, useState } from "react";
+function isUpdater(next) {
+    return typeof next === 'function';
 }
-function a({ prop: a, defaultProp: o, onChange: s }) {
-	let [c, l] = r(o), u = a !== void 0, d = u ? a : c, f = n(s);
-	return t(() => {
-		f.current = s;
-	}, [s]), [d, e((e) => {
-		if (u) {
-			let t = i(e) ? e(a) : e;
-			f.current?.(t);
-			return;
-		}
-		l((t) => {
-			let n = i(e) ? e(t) : e;
-			return f.current?.(n), n;
-		});
-	}, [u, a])];
+export function useControllableState({ prop, defaultProp, onChange }) {
+    const [uncontrolledValue, setUncontrolledValue] = useState(defaultProp);
+    const isControlled = prop !== undefined;
+    const value = isControlled ? prop : uncontrolledValue;
+    const onChangeRef = useRef(onChange);
+    useEffect(()=>{
+        onChangeRef.current = onChange;
+    }, [
+        onChange
+    ]);
+    const setValue = useCallback((next)=>{
+        if (isControlled) {
+            const resolved = isUpdater(next) ? next(prop) : next;
+            onChangeRef.current?.(resolved);
+            return;
+        }
+        setUncontrolledValue((prev)=>{
+            const resolved = isUpdater(next) ? next(prev) : next;
+            onChangeRef.current?.(resolved);
+            return resolved;
+        });
+    }, [
+        isControlled,
+        prop
+    ]);
+    return [
+        value,
+        setValue
+    ];
 }
-//#endregion
-export { a as useControllableState };
+
+//# sourceMappingURL=use-controllable-state.js.map

package/dist/lib/use-controllable-state.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/use-controllable-state.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\n\ntype UseControllableStateParams<T> = {\n  prop?: T;\n  defaultProp: T;\n  onChange?: (next: T) => void;\n};\n\ntype SetStateAction<T> = T | ((prev: T) => T);\n\nfunction isUpdater<T>(next: SetStateAction<T>): next is (prev: T) => T {\n  return typeof next === 'function';\n}\n\nexport function useControllableState<T>({\n  prop,\n  defaultProp,\n  onChange,\n}: UseControllableStateParams<T>): readonly [\n  T,\n  (next: SetStateAction<T>) => void,\n] {\n  const [uncontrolledValue, setUncontrolledValue] = useState<T>(defaultProp);\n  const isControlled = prop !== undefined;\n  const value = isControlled ? prop : uncontrolledValue;\n\n  const onChangeRef = useRef(onChange);\n  useEffect(() => {\n    onChangeRef.current = onChange;\n  }, [onChange]);\n\n  const setValue = useCallback(\n    (next: SetStateAction<T>) => {\n      if (isControlled) {\n        const resolved = isUpdater(next) ? next(prop) : next;\n        onChangeRef.current?.(resolved);\n        return;\n      }\n\n      setUncontrolledValue((prev) => {\n        const resolved = isUpdater(next) ? next(prev) : next;\n        onChangeRef.current?.(resolved);\n        return resolved;\n      });\n    },\n    [isControlled, prop]\n  );\n\n  return [value, setValue];\n}\n"],"names":["useCallback","useEffect","useRef","useState","isUpdater","next","useControllableState","prop","defaultProp","onChange","uncontrolledValue","setUncontrolledValue","isControlled","undefined","value","onChangeRef","current","setValue","resolved","prev"],"mappings":"AAAA,SAASA,WAAW,EAAEC,SAAS,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,QAAQ;AAUjE,SAASC,UAAaC,IAAuB;IAC3C,OAAO,OAAOA,SAAS;AACzB;AAEA,OAAO,SAASC,qBAAwB,EACtCC,IAAI,EACJC,WAAW,EACXC,QAAQ,EACsB;IAI9B,MAAM,CAACC,mBAAmBC,qBAAqB,GAAGR,SAAYK;IAC9D,MAAMI,eAAeL,SAASM;IAC9B,MAAMC,QAAQF,eAAeL,OAAOG;IAEpC,MAAMK,cAAcb,OAAOO;IAC3BR,UAAU;QACRc,YAAYC,OAAO,GAAGP;IACxB,GAAG;QAACA;KAAS;IAEb,MAAMQ,WAAWjB,YACf,CAACK;QACC,IAAIO,cAAc;YAChB,MAAMM,WAAWd,UAAUC,QAAQA,KAAKE,QAAQF;YAChDU,YAAYC,OAAO,GAAGE;YACtB;QACF;QAEAP,qBAAqB,CAACQ;YACpB,MAAMD,WAAWd,UAAUC,QAAQA,KAAKc,QAAQd;YAChDU,YAAYC,OAAO,GAAGE;YACtB,OAAOA;QACT;IACF,GACA;QAACN;QAAcL;KAAK;IAGtB,OAAO;QAACO;QAAOG;KAAS;AAC1B"}

package/dist/lib/utils.d.ts

@@ -1,54 +1,83 @@
-import { ClassValue } from 'clsx';
+import { type ClassValue } from "clsx";
 type PortalContainerOptions = {
-    id?: string;
-    className?: string;
-    style?: Partial<CSSStyleDeclaration>;
+	id?: string;
+	className?: string;
+	style?: Partial<CSSStyleDeclaration>;
 };
 export declare function cn(...inputs: ClassValue[]): string;
 export declare const isStorybookTestEnv: boolean;
 export declare function getInitials(name: string): string;
 /**
- * Focus rings for non-form interactive elements (buttons, etc.).
- * These provide only the shadow-based focus ring without background/border changes.
- */
+* Focus rings for non-form interactive elements (buttons, etc.).
+* These provide only the shadow-based focus ring without background/border changes.
+*/
 export declare const focusRing: "focus-visible:shadow-focus-ring outline-none";
 export declare const focusRingDestructive: "focus-visible:shadow-focus-ring-destructive outline-none";
+/** Shared typography for section/group labels inside menus (dropdown, select, command). */
+export declare const menuSectionLabelTypography: "text-sm font-medium text-muted-foreground";
+/** Popover menu surface padding (dropdown content, command list). */
+export declare const menuContainerPadding: "p-1";
+/** Menu item padding — section labels use the same horizontal inset. */
+export declare const menuItemPadding: "p-2";
+/** Section label layout: 8px top, 4px bottom, horizontal padding aligned with menu items. */
+export declare const menuSectionLabelLayout: "pt-2 pb-1 px-2";
+export declare const menuSectionLabelClasses: string;
+/** Full-width divider between menu sections (not below section labels).
+* `-mx-1` cancels container padding so the line is edge-to-edge;
+* `my-1` keeps a 4px gap so item hover surfaces match the container inset. */
+export declare const menuSectionSeparatorClasses: "bg-default h-px shrink-0 -mx-1 my-1";
 /**
- * Reusable form element state Tailwind classes.
- * Import these to maintain consistent styling across all form components.
- */
-export declare const formElementBase: "border border-transparent rounded-lg bg-muted-background py-1.75 pl-2 pr-1 text-sm leading-5 tracking-tight text-muted-foreground placeholder:text-muted-foreground";
-export declare const hoverState: "hover:bg-accent-background hover:border hover:border-border-emphasized";
-export declare const filledState: "[&:not(:placeholder-shown):not(:focus)]:bg-muted-background [&:not(:placeholder-shown)]:text-foreground";
-export declare const focusState: "focus-visible:shadow-focus-ring focus-visible:bg-background focus-visible:border-transparent focus-visible:text-foreground outline-none";
-export declare const invalidState: "aria-invalid:border-destructive-foreground aria-invalid:shadow-focus-ring-destructive aria-invalid:border-transparent aria-invalid:text-foreground aria-invalid:focus-visible:shadow-focus-ring aria-invalid:focus-visible:bg-background aria-invalid:focus-visible:border-transparent aria-invalid:focus-visible:text-foreground outline-none";
-export declare const disabledState: "disabled:bg-disabled-background disabled:border-transparent disabled:text-disabled-foreground disabled:placeholder:text-disabled-foreground disabled:pointer-events-none disabled:cursor-not-allowed";
-export declare const readOnlyState: "read-only:border-transparent read-only:text-muted-foreground read-only:cursor-default read-only:hover:border-transparent read-only:focus-visible:shadow-none read-only:focus-visible:border-transparent read-only:focus-visible:bg-muted-background [&:read-only:not(:placeholder-shown)]:text-muted-foreground";
+* cmdk group headings (Command palette sections).
+* pl-2 matches menu item content start — icon column when present, text when not.
+*/
+export declare const menuSectionLabelCmdkHeadingClasses: "**:[[cmdk-group-heading]]:text-sm **:[[cmdk-group-heading]]:font-medium **:[[cmdk-group-heading]]:text-muted-foreground **:[[cmdk-group-heading]]:pt-2 **:[[cmdk-group-heading]]:pb-1 **:[[cmdk-group-heading]]:pl-2 **:[[cmdk-group-heading]]:pr-2";
+/** When cmdk items use inset padding (e.g. checkbox column), align labels with item text. */
+export declare const menuSectionLabelCmdkHeadingInsetClasses: "**:[[cmdk-group][data-inset=true]>[[cmdk-group-heading]]]:pl-8";
 /**
- * Reusable styles for selection-control rows (radio group items, checkbox items, etc.).
- * These provide the shared layout, card variant, label, and description classes
- * without baking in a parent group name (ancestor `group-has-[...]/<name>` selectors
- * must stay inline in each consumer so they reference that component's own `group/<name>`).
- */
+* Reusable form element state Tailwind classes.
+* Import these to maintain consistent styling across all form components.
+*/
+export declare const formElementBase: "border border-transparent rounded-lg bg-medium-background py-1.75 pl-2 pr-1 text-sm leading-5 tracking-tight text-muted-foreground placeholder:text-muted-foreground";
+export declare const hoverState: "hover:border-emphasized";
+export declare const filledState: "[&:not(:placeholder-shown):not(:focus):not(:read-only)]:bg-medium-background [&:not(:placeholder-shown):not(:read-only)]:text-base-foreground";
+export declare const focusState: "focus-visible:shadow-focus-ring focus-visible:bg-base-background focus-visible:border-transparent focus-visible:text-base-foreground outline-none";
+export declare const invalidState: "aria-invalid:border-destructive-foreground aria-invalid:shadow-focus-ring-destructive aria-invalid:border-transparent aria-invalid:text-base-foreground aria-invalid:focus-visible:shadow-focus-ring aria-invalid:focus-visible:bg-base-background aria-invalid:focus-visible:border-transparent aria-invalid:focus-visible:text-base-foreground outline-none";
+export declare const disabledState: "disabled:bg-transparent disabled:border-disabled disabled:text-base-foreground-disabled disabled:placeholder:text-base-foreground-disabled disabled:pointer-events-none disabled:cursor-not-allowed";
+export declare const formFieldTriggerDisabledState: string;
+/** Shared layout and states for select/combobox triggers (not native inputs). */
+export declare const formFieldTriggerLayout: "w-full min-w-0 h-9 flex items-center justify-between gap-2 text-left overflow-hidden transition-[color,box-shadow] cursor-pointer";
+export declare const formFieldOpenState: "shadow-focus-ring bg-base-background border-transparent focus:border-transparent hover:border-transparent text-base-foreground";
+export declare const formFieldTriggerIcon: "[&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4 [&_svg:not([class*='text-'])]:text-muted-foreground disabled:[&_svg:not([class*='text-'])]:text-base-foreground-disabled data-disabled:[&_svg:not([class*='text-'])]:text-base-foreground-disabled data-readonly:[&_svg:not([class*='text-'])]:text-muted-foreground";
+export declare const formFieldTriggerReadOnlyState: "data-readonly:bg-card-background data-readonly:border-transparent data-readonly:text-muted-foreground data-readonly:cursor-default data-readonly:hover:border-transparent data-readonly:focus-visible:shadow-none data-readonly:focus-visible:border-transparent data-readonly:focus-visible:bg-card-background";
+export declare const formFieldTriggerClasses: string;
+export declare const readOnlyState: "read-only:bg-card-background read-only:border-transparent read-only:text-muted-foreground read-only:placeholder:text-muted-foreground read-only:cursor-default read-only:hover:border-transparent read-only:focus-visible:shadow-none read-only:focus-visible:border-transparent read-only:focus-visible:bg-card-background [&:read-only:not(:placeholder-shown)]:text-muted-foreground";
+/**
+* Reusable styles for selection-control rows (radio group items, checkbox items, etc.).
+* These provide the shared layout, card variant, label, and description classes
+* without baking in a parent group name (ancestor `group-has-[...]/<name>` selectors
+* must stay inline in each consumer so they reference that component's own `group/<name>`).
+*/
 export declare const selectionItemBase: "grid max-w-150 cursor-pointer grid-cols-[auto_1fr] items-start gap-x-2 gap-y-1 has-[[data-disabled]]:cursor-not-allowed";
 export declare const selectionItemDefault: "min-h-9 py-2";
 export declare const selectionItemCard: string;
-export declare const selectionItemLabel: "col-start-2 text-sm font-medium leading-4.5 tracking-normal text-secondary-foreground dark:text-secondary-foreground";
+export declare const selectionItemLabel: "col-start-2 text-sm font-medium leading-4.5 tracking-normal text-secondary-foreground";
 export declare const selectionItemDescription: "col-start-2 text-xs font-normal leading-3.5 tracking-tightest text-muted-foreground";
 export declare function slugToPascalCase(slug: string): string;
 /**
- * Safely extracts hostname from a URL string.
- * Returns the hostname if valid, otherwise returns the original string or "unknown".
- *
- * @param url - URL string to extract hostname from (optional)
- * @returns The hostname, original string, or "unknown" if url is undefined
- */
+* Safely extracts hostname from a URL string.
+* Returns the hostname if valid, otherwise returns the original string or "unknown".
+*
+* @param url - URL string to extract hostname from (optional)
+* @returns The hostname, original string, or "unknown" if url is undefined
+*/
 export declare function getHostname(url: string | undefined): string;
+/** True when `value` parses as JSON, so it is worth highlighting as such. */
+export declare function isJsonString(value: string): boolean;
 /**
- * Gets or creates the portal container for portalled UI components.
- * Container is created in document.body to avoid positioning issues
- * from the shell app's container query context.
- * The result is cached to avoid side effects on subsequent calls during React renders.
- */
+* Gets or creates the portal container for portalled UI components.
+* Container is created in document.body to avoid positioning issues
+* from the shell app's container query context.
+* The result is cached to avoid side effects on subsequent calls during React renders.
+*/
 export declare const getPortalContainer: (options?: PortalContainerOptions) => HTMLElement | undefined;
 export {};