@askrjs/themes 0.0.25 → 0.0.28

package/dist/components/_internal/style.js

@@ -3,6 +3,7 @@ import * as Askr from "@askrjs/askr";
 const cssPropertyNameCache = /* @__PURE__ */ new Map();
 const MAX_PROPERTY_CACHE = 256;
 const CSS_UNSAFE_RE = /[{}<>\\]/;
+const CSS_COMMENT_DELIMITER_RE = /\/\*|\*\//;
 const CSS_URI_SCHEME_RE = /(?:^|[\s(,])([a-z][a-z0-9+.-]*):/i;
 const CSS_FUNCTION_NAME_RE = /([a-z-][a-z0-9-]*)\s*\(/gi;
 const CSS_ALLOWED_FUNCTIONS = /* @__PURE__ */ new Set([
@@ -54,7 +55,7 @@ function isSafeCssPropertyName(name) {
 	return /^[a-zA-Z_][a-zA-Z0-9_-]*$/.test(name);
 }
 function isSafeCssValue(value) {
-	if (CSS_UNSAFE_RE.test(value) || CSS_URI_SCHEME_RE.test(value)) return false;
+	if (CSS_UNSAFE_RE.test(value) || CSS_COMMENT_DELIMITER_RE.test(value) || CSS_URI_SCHEME_RE.test(value)) return false;
 	for (const match of value.matchAll(CSS_FUNCTION_NAME_RE)) if (!CSS_ALLOWED_FUNCTIONS.has(match[1].toLowerCase())) return false;
 	return true;
 }

package/dist/components/_internal/style.js.map

@@ -1 +1 @@
-{"version":3,"file":"style.js","names":[],"sources":["../../../src/components/_internal/style.ts"],"sourcesContent":["import * as Askr from \"@askrjs/askr\";\n\nconst cssPropertyNameCache = new Map<string, string>();\nconst MAX_PROPERTY_CACHE = 256;\n\nconst CSS_UNSAFE_RE = /[{}<>\\\\]/;\nconst CSS_URI_SCHEME_RE = /(?:^|[\\s(,])([a-z][a-z0-9+.-]*):/i;\nconst CSS_FUNCTION_NAME_RE = /([a-z-][a-z0-9-]*)\\s*\\(/gi;\nconst CSS_ALLOWED_FUNCTIONS = new Set([\n  \"var\",\n  \"calc\",\n  \"min\",\n  \"max\",\n  \"clamp\",\n  \"minmax\",\n  \"repeat\",\n  \"rgb\",\n  \"rgba\",\n  \"hsl\",\n  \"hsla\",\n  \"lab\",\n  \"lch\",\n  \"oklab\",\n  \"oklch\",\n  \"color\",\n  \"color-mix\",\n  \"translate\",\n  \"translatex\",\n  \"translatey\",\n  \"translatez\",\n  \"scale\",\n  \"scalex\",\n  \"scaley\",\n  \"scalez\",\n  \"rotate\",\n  \"rotatex\",\n  \"rotatey\",\n  \"rotatez\",\n  \"skew\",\n  \"skewx\",\n  \"skewy\",\n  \"matrix\",\n  \"matrix3d\",\n  \"linear-gradient\",\n  \"radial-gradient\",\n  \"conic-gradient\",\n  \"repeating-linear-gradient\",\n  \"repeating-radial-gradient\",\n  \"repeating-conic-gradient\",\n  \"cubic-bezier\",\n  \"steps\",\n]);\n\nfunction isSafeCssPropertyName(name: string): boolean {\n  if (name.startsWith(\"--\")) return /^--[a-zA-Z0-9_-]+$/.test(name);\n  return /^[a-zA-Z_][a-zA-Z0-9_-]*$/.test(name);\n}\n\nfunction isSafeCssValue(value: string): boolean {\n  if (CSS_UNSAFE_RE.test(value) || CSS_URI_SCHEME_RE.test(value)) return false;\n\n  for (const match of value.matchAll(CSS_FUNCTION_NAME_RE)) {\n    if (!CSS_ALLOWED_FUNCTIONS.has(match[1]!.toLowerCase())) return false;\n  }\n\n  return true;\n}\n\nfunction splitCssDeclarations(value: string): string[] {\n  const declarations: string[] = [];\n  let start = 0;\n  let depth = 0;\n  let quote: string | undefined;\n\n  for (let index = 0; index < value.length; index += 1) {\n    const char = value[index]!;\n    if (quote) {\n      if (char === quote && value[index - 1] !== \"\\\\\") quote = undefined;\n      continue;\n    }\n    if (char === '\"' || char === \"'\") {\n      quote = char;\n      continue;\n    }\n    if (char === \"(\") depth += 1;\n    if (char === \")\" && depth > 0) depth -= 1;\n    if (char === \";\" && depth === 0) {\n      declarations.push(value.slice(start, index));\n      start = index + 1;\n    }\n  }\n\n  declarations.push(value.slice(start));\n  return declarations;\n}\n\nfunction serializeCssString(value: string): string {\n  const entries: Array<[string, string]> = [];\n  for (const candidate of splitCssDeclarations(value)) {\n    const separator = candidate.indexOf(\":\");\n    if (separator <= 0) continue;\n    const key = candidate.slice(0, separator).trim();\n    const cssValue = candidate.slice(separator + 1).trim();\n    if (key && cssValue) entries.push([key, cssValue]);\n  }\n  return serializeCssDeclarations(Object.fromEntries(entries));\n}\n\nfunction cssPropertyName(name: string): string {\n  let cached = cssPropertyNameCache.get(name);\n  if (cached !== undefined) {\n    return cached;\n  }\n\n  let result = \"\";\n\n  for (let index = 0; index < name.length; index += 1) {\n    const code = name.charCodeAt(index);\n\n    if (code >= 65 && code <= 90) {\n      result += `-${String.fromCharCode(code + 32)}`;\n    } else {\n      result += name[index];\n    }\n  }\n\n  if (cssPropertyNameCache.size < MAX_PROPERTY_CACHE) {\n    cssPropertyNameCache.set(name, result);\n  }\n  return result;\n}\n\nexport function serializeCssDeclarations(styles: Record<string, unknown>): string {\n  const keys = Object.keys(styles);\n  let result = \"\";\n\n  for (const key of keys) {\n    const value = styles[key];\n    if (value === undefined || value === null) {\n      continue;\n    }\n\n    const rawProperty = key.trim();\n    if (!isSafeCssPropertyName(rawProperty)) {\n      continue;\n    }\n    const property = cssPropertyName(rawProperty).trim();\n    const cssValue = String(value).trim();\n    if (!cssValue || !isSafeCssValue(cssValue)) {\n      continue;\n    }\n\n    const declaration = `${property}:${cssValue}`;\n    result = result ? `${result};${declaration}` : declaration;\n  }\n\n  return result;\n}\n\nexport function mergeCssVar(style: unknown, name: string, value: string): string {\n  const decl = `${name}:${value}`;\n\n  if (typeof style === \"string\") {\n    const trimmed = style.trim();\n    return trimmed ? `${trimmed};${decl}` : decl;\n  }\n\n  if (style && typeof style === \"object\") {\n    const entries = serializeCssDeclarations(style as Record<string, unknown>);\n    return entries ? `${entries};${decl}` : decl;\n  }\n\n  return decl;\n}\n\nconst STYLE_REGISTRY_ATTR = \"data-askr-style-registry\";\nconst STYLE_CLASS_PREFIX = \"ak-style-\";\nconst MAX_STYLE_RULES = 512;\nconst MAX_COLLISION_CACHE = 4096;\n\ntype StyleRule = {\n  className: string;\n  declarations: string;\n  rule: string;\n};\n\nconst styleCollisionCache = new Map<string, StyleRule>();\ntype StyleRegistry = {\n  element: HTMLStyleElement;\n  ruleCount: number;\n  rules: Map<string, StyleRule>;\n};\nconst registries = new WeakMap<Document, Map<string, StyleRegistry>>();\nfunction countRegisteredRules(value: string | null): number {\n  return value?.match(/\\.ak-style-[a-z0-9]+\\{/g)?.length ?? 0;\n}\n\nfunction styleClassName(declarations: string): string {\n  let first = 0xdeadbeef ^ declarations.length;\n  let second = 0x41c6ce57 ^ declarations.length;\n\n  for (let index = 0; index < declarations.length; index += 1) {\n    const code = declarations.charCodeAt(index);\n    first = Math.imul(first ^ code, 2_654_435_761);\n    second = Math.imul(second ^ code, 1_597_334_677);\n  }\n\n  first =\n    Math.imul(first ^ (first >>> 16), 2_246_822_507) ^\n    Math.imul(second ^ (second >>> 13), 3_266_489_909);\n  second =\n    Math.imul(second ^ (second >>> 16), 2_246_822_507) ^\n    Math.imul(first ^ (first >>> 13), 3_266_489_909);\n\n  return `${STYLE_CLASS_PREFIX}${(second >>> 0).toString(36)}${(first >>> 0).toString(36)}`;\n}\n\nfunction escapeStyleRawText(value: string): string {\n  return value.replace(/<\\//g, \"<\\\\/\");\n}\n\nfunction styleRuleFor(declarations: string): StyleRule {\n  const className = styleClassName(declarations);\n  const existing = styleCollisionCache.get(className);\n  if (existing) {\n    if (existing.declarations !== declarations) {\n      throw new RangeError(\"Theme style class collision detected.\");\n    }\n    return existing;\n  }\n\n  const entry = {\n    className,\n    declarations,\n    rule: `.${className}{${escapeStyleRawText(declarations)}}`,\n  };\n  return entry;\n}\n\nfunction rememberStyleRule(entry: StyleRule): void {\n  styleCollisionCache.delete(entry.className);\n  styleCollisionCache.set(entry.className, entry);\n  while (styleCollisionCache.size > MAX_COLLISION_CACHE) {\n    const oldest = styleCollisionCache.keys().next().value;\n    if (oldest === undefined) break;\n    styleCollisionCache.delete(oldest);\n  }\n}\n\nfunction registerSSRStyle(entry: StyleRule): void {\n  const register = (\n    Askr as typeof Askr & {\n      registerSSRStyle?: (id: string, cssText: string) => void;\n    }\n  ).registerSSRStyle;\n  register?.(entry.className, entry.rule);\n}\n\nfunction ensureStyleRegistry(nonce: string | undefined): StyleRegistry | null {\n  if (typeof document === \"undefined\") return null;\n  const key = nonce ?? \"\";\n  let documentRegistries = registries.get(document);\n  if (!documentRegistries) {\n    documentRegistries = new Map();\n    registries.set(document, documentRegistries);\n  }\n  const current = documentRegistries.get(key);\n  if (current?.element.isConnected) return current;\n\n  const existingStyleElements = Array.from(\n    document.querySelectorAll<HTMLStyleElement>(`style[${STYLE_REGISTRY_ATTR}]`),\n  );\n  const styleElement =\n    existingStyleElements.find((element) => (element.nonce || undefined) === nonce) ??\n    (nonce === undefined && existingStyleElements.length === 1\n      ? existingStyleElements[0]\n      : undefined) ??\n    document.createElement(\"style\");\n  if (!styleElement.isConnected) {\n    styleElement.setAttribute(STYLE_REGISTRY_ATTR, \"true\");\n    if (nonce !== undefined) styleElement.nonce = nonce;\n    (document.head ?? document.documentElement).append(styleElement);\n  }\n  const registry: StyleRegistry = {\n    element: styleElement,\n    ruleCount: countRegisteredRules(styleElement.textContent),\n    rules: new Map(),\n  };\n  documentRegistries.set(key, registry);\n  return registry;\n}\n\nfunction normalizeDeclarations(declarations: string): string {\n  return serializeCssString(declarations);\n}\n\nexport function styleDeclarationsToClass(declarations: string | undefined): string | undefined {\n  if (typeof declarations !== \"string\") return undefined;\n\n  const normalized = normalizeDeclarations(declarations);\n  if (!normalized) return undefined;\n\n  const entry = styleRuleFor(normalized);\n  const nonce = Askr.cspNonce();\n  const registry = ensureStyleRegistry(nonce);\n  const registered = registry?.rules.get(normalized);\n  if (registered) {\n    registerSSRStyle(registered);\n    return registered.className;\n  }\n\n  if (registry) {\n    if (!registry.rules.has(normalized) && !registry.element.textContent?.includes(entry.rule)) {\n      if (registry.ruleCount >= MAX_STYLE_RULES) {\n        throw new RangeError(\"Theme style registry capacity exceeded.\");\n      }\n    }\n    if (!registry.element.textContent?.includes(entry.rule)) {\n      registry.element.append(entry.rule, \"\\n\");\n      registry.ruleCount += 1;\n    }\n    registry.rules.set(normalized, entry);\n  }\n\n  rememberStyleRule(entry);\n  registerSSRStyle(entry);\n\n  return entry.className;\n}\n"],"mappings":"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"}
+{"version":3,"file":"style.js","names":[],"sources":["../../../src/components/_internal/style.ts"],"sourcesContent":["import * as Askr from \"@askrjs/askr\";\n\nconst cssPropertyNameCache = new Map<string, string>();\nconst MAX_PROPERTY_CACHE = 256;\n\nconst CSS_UNSAFE_RE = /[{}<>\\\\]/;\nconst CSS_COMMENT_DELIMITER_RE = /\\/\\*|\\*\\//;\nconst CSS_URI_SCHEME_RE = /(?:^|[\\s(,])([a-z][a-z0-9+.-]*):/i;\nconst CSS_FUNCTION_NAME_RE = /([a-z-][a-z0-9-]*)\\s*\\(/gi;\nconst CSS_ALLOWED_FUNCTIONS = new Set([\n  \"var\",\n  \"calc\",\n  \"min\",\n  \"max\",\n  \"clamp\",\n  \"minmax\",\n  \"repeat\",\n  \"rgb\",\n  \"rgba\",\n  \"hsl\",\n  \"hsla\",\n  \"lab\",\n  \"lch\",\n  \"oklab\",\n  \"oklch\",\n  \"color\",\n  \"color-mix\",\n  \"translate\",\n  \"translatex\",\n  \"translatey\",\n  \"translatez\",\n  \"scale\",\n  \"scalex\",\n  \"scaley\",\n  \"scalez\",\n  \"rotate\",\n  \"rotatex\",\n  \"rotatey\",\n  \"rotatez\",\n  \"skew\",\n  \"skewx\",\n  \"skewy\",\n  \"matrix\",\n  \"matrix3d\",\n  \"linear-gradient\",\n  \"radial-gradient\",\n  \"conic-gradient\",\n  \"repeating-linear-gradient\",\n  \"repeating-radial-gradient\",\n  \"repeating-conic-gradient\",\n  \"cubic-bezier\",\n  \"steps\",\n]);\n\nfunction isSafeCssPropertyName(name: string): boolean {\n  if (name.startsWith(\"--\")) return /^--[a-zA-Z0-9_-]+$/.test(name);\n  return /^[a-zA-Z_][a-zA-Z0-9_-]*$/.test(name);\n}\n\nfunction isSafeCssValue(value: string): boolean {\n  if (\n    CSS_UNSAFE_RE.test(value) ||\n    CSS_COMMENT_DELIMITER_RE.test(value) ||\n    CSS_URI_SCHEME_RE.test(value)\n  ) {\n    return false;\n  }\n\n  for (const match of value.matchAll(CSS_FUNCTION_NAME_RE)) {\n    if (!CSS_ALLOWED_FUNCTIONS.has(match[1]!.toLowerCase())) return false;\n  }\n\n  return true;\n}\n\nfunction splitCssDeclarations(value: string): string[] {\n  const declarations: string[] = [];\n  let start = 0;\n  let depth = 0;\n  let quote: string | undefined;\n\n  for (let index = 0; index < value.length; index += 1) {\n    const char = value[index]!;\n    if (quote) {\n      if (char === quote && value[index - 1] !== \"\\\\\") quote = undefined;\n      continue;\n    }\n    if (char === '\"' || char === \"'\") {\n      quote = char;\n      continue;\n    }\n    if (char === \"(\") depth += 1;\n    if (char === \")\" && depth > 0) depth -= 1;\n    if (char === \";\" && depth === 0) {\n      declarations.push(value.slice(start, index));\n      start = index + 1;\n    }\n  }\n\n  declarations.push(value.slice(start));\n  return declarations;\n}\n\nfunction serializeCssString(value: string): string {\n  const entries: Array<[string, string]> = [];\n  for (const candidate of splitCssDeclarations(value)) {\n    const separator = candidate.indexOf(\":\");\n    if (separator <= 0) continue;\n    const key = candidate.slice(0, separator).trim();\n    const cssValue = candidate.slice(separator + 1).trim();\n    if (key && cssValue) entries.push([key, cssValue]);\n  }\n  return serializeCssDeclarations(Object.fromEntries(entries));\n}\n\nfunction cssPropertyName(name: string): string {\n  let cached = cssPropertyNameCache.get(name);\n  if (cached !== undefined) {\n    return cached;\n  }\n\n  let result = \"\";\n\n  for (let index = 0; index < name.length; index += 1) {\n    const code = name.charCodeAt(index);\n\n    if (code >= 65 && code <= 90) {\n      result += `-${String.fromCharCode(code + 32)}`;\n    } else {\n      result += name[index];\n    }\n  }\n\n  if (cssPropertyNameCache.size < MAX_PROPERTY_CACHE) {\n    cssPropertyNameCache.set(name, result);\n  }\n  return result;\n}\n\nexport function serializeCssDeclarations(styles: Record<string, unknown>): string {\n  const keys = Object.keys(styles);\n  let result = \"\";\n\n  for (const key of keys) {\n    const value = styles[key];\n    if (value === undefined || value === null) {\n      continue;\n    }\n\n    const rawProperty = key.trim();\n    if (!isSafeCssPropertyName(rawProperty)) {\n      continue;\n    }\n    const property = cssPropertyName(rawProperty).trim();\n    const cssValue = String(value).trim();\n    if (!cssValue || !isSafeCssValue(cssValue)) {\n      continue;\n    }\n\n    const declaration = `${property}:${cssValue}`;\n    result = result ? `${result};${declaration}` : declaration;\n  }\n\n  return result;\n}\n\nexport function mergeCssVar(style: unknown, name: string, value: string): string {\n  const decl = `${name}:${value}`;\n\n  if (typeof style === \"string\") {\n    const trimmed = style.trim();\n    return trimmed ? `${trimmed};${decl}` : decl;\n  }\n\n  if (style && typeof style === \"object\") {\n    const entries = serializeCssDeclarations(style as Record<string, unknown>);\n    return entries ? `${entries};${decl}` : decl;\n  }\n\n  return decl;\n}\n\nconst STYLE_REGISTRY_ATTR = \"data-askr-style-registry\";\nconst STYLE_CLASS_PREFIX = \"ak-style-\";\nconst MAX_STYLE_RULES = 512;\nconst MAX_COLLISION_CACHE = 4096;\n\ntype StyleRule = {\n  className: string;\n  declarations: string;\n  rule: string;\n};\n\nconst styleCollisionCache = new Map<string, StyleRule>();\ntype StyleRegistry = {\n  element: HTMLStyleElement;\n  ruleCount: number;\n  rules: Map<string, StyleRule>;\n};\nconst registries = new WeakMap<Document, Map<string, StyleRegistry>>();\nfunction countRegisteredRules(value: string | null): number {\n  return value?.match(/\\.ak-style-[a-z0-9]+\\{/g)?.length ?? 0;\n}\n\nfunction styleClassName(declarations: string): string {\n  let first = 0xdeadbeef ^ declarations.length;\n  let second = 0x41c6ce57 ^ declarations.length;\n\n  for (let index = 0; index < declarations.length; index += 1) {\n    const code = declarations.charCodeAt(index);\n    first = Math.imul(first ^ code, 2_654_435_761);\n    second = Math.imul(second ^ code, 1_597_334_677);\n  }\n\n  first =\n    Math.imul(first ^ (first >>> 16), 2_246_822_507) ^\n    Math.imul(second ^ (second >>> 13), 3_266_489_909);\n  second =\n    Math.imul(second ^ (second >>> 16), 2_246_822_507) ^\n    Math.imul(first ^ (first >>> 13), 3_266_489_909);\n\n  return `${STYLE_CLASS_PREFIX}${(second >>> 0).toString(36)}${(first >>> 0).toString(36)}`;\n}\n\nfunction escapeStyleRawText(value: string): string {\n  return value.replace(/<\\//g, \"<\\\\/\");\n}\n\nfunction styleRuleFor(declarations: string): StyleRule {\n  const className = styleClassName(declarations);\n  const existing = styleCollisionCache.get(className);\n  if (existing) {\n    if (existing.declarations !== declarations) {\n      throw new RangeError(\"Theme style class collision detected.\");\n    }\n    return existing;\n  }\n\n  const entry = {\n    className,\n    declarations,\n    rule: `.${className}{${escapeStyleRawText(declarations)}}`,\n  };\n  return entry;\n}\n\nfunction rememberStyleRule(entry: StyleRule): void {\n  styleCollisionCache.delete(entry.className);\n  styleCollisionCache.set(entry.className, entry);\n  while (styleCollisionCache.size > MAX_COLLISION_CACHE) {\n    const oldest = styleCollisionCache.keys().next().value;\n    if (oldest === undefined) break;\n    styleCollisionCache.delete(oldest);\n  }\n}\n\nfunction registerSSRStyle(entry: StyleRule): void {\n  const register = (\n    Askr as typeof Askr & {\n      registerSSRStyle?: (id: string, cssText: string) => void;\n    }\n  ).registerSSRStyle;\n  register?.(entry.className, entry.rule);\n}\n\nfunction ensureStyleRegistry(nonce: string | undefined): StyleRegistry | null {\n  if (typeof document === \"undefined\") return null;\n  const key = nonce ?? \"\";\n  let documentRegistries = registries.get(document);\n  if (!documentRegistries) {\n    documentRegistries = new Map();\n    registries.set(document, documentRegistries);\n  }\n  const current = documentRegistries.get(key);\n  if (current?.element.isConnected) return current;\n\n  const existingStyleElements = Array.from(\n    document.querySelectorAll<HTMLStyleElement>(`style[${STYLE_REGISTRY_ATTR}]`),\n  );\n  const styleElement =\n    existingStyleElements.find((element) => (element.nonce || undefined) === nonce) ??\n    (nonce === undefined && existingStyleElements.length === 1\n      ? existingStyleElements[0]\n      : undefined) ??\n    document.createElement(\"style\");\n  if (!styleElement.isConnected) {\n    styleElement.setAttribute(STYLE_REGISTRY_ATTR, \"true\");\n    if (nonce !== undefined) styleElement.nonce = nonce;\n    (document.head ?? document.documentElement).append(styleElement);\n  }\n  const registry: StyleRegistry = {\n    element: styleElement,\n    ruleCount: countRegisteredRules(styleElement.textContent),\n    rules: new Map(),\n  };\n  documentRegistries.set(key, registry);\n  return registry;\n}\n\nfunction normalizeDeclarations(declarations: string): string {\n  return serializeCssString(declarations);\n}\n\nexport function styleDeclarationsToClass(declarations: string | undefined): string | undefined {\n  if (typeof declarations !== \"string\") return undefined;\n\n  const normalized = normalizeDeclarations(declarations);\n  if (!normalized) return undefined;\n\n  const entry = styleRuleFor(normalized);\n  const nonce = Askr.cspNonce();\n  const registry = ensureStyleRegistry(nonce);\n  const registered = registry?.rules.get(normalized);\n  if (registered) {\n    registerSSRStyle(registered);\n    return registered.className;\n  }\n\n  if (registry) {\n    if (!registry.rules.has(normalized) && !registry.element.textContent?.includes(entry.rule)) {\n      if (registry.ruleCount >= MAX_STYLE_RULES) {\n        throw new RangeError(\"Theme style registry capacity exceeded.\");\n      }\n    }\n    if (!registry.element.textContent?.includes(entry.rule)) {\n      registry.element.append(entry.rule, \"\\n\");\n      registry.ruleCount += 1;\n    }\n    registry.rules.set(normalized, entry);\n  }\n\n  rememberStyleRule(entry);\n  registerSSRStyle(entry);\n\n  return entry.className;\n}\n"],"mappings":"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"}

package/dist/components/alert/alert.d.ts

@@ -1,6 +1,11 @@
 import { AlertProps } from "./alert.types.js";
 import { JSX } from "@askrjs/askr/jsx-runtime";
 //#region src/components/alert/alert.d.ts
+/**
+ * Renders an alert/status banner with an optional icon, title, description,
+ * actions, and a dismiss button. Automatically picks an "alert" or "status"
+ * ARIA role from `variant` unless `role` is set explicitly.
+ */
 declare function Alert(props: AlertProps): JSX.Element;
 //#endregion
 export { Alert };

package/dist/components/alert/alert.js

@@ -6,6 +6,11 @@ function resolveAlertRole(variant) {
 	if (variant === "danger" || variant === "warning") return "alert";
 	return "status";
 }
+/**
+* Renders an alert/status banner with an optional icon, title, description,
+* actions, and a dismiss button. Automatically picks an "alert" or "status"
+* ARIA role from `variant` unless `role` is set explicitly.
+*/
 function Alert(props) {
 	const { actions, children, class: className, description, dismissLabel = "Dismiss alert", icon, onDismiss, ref, title, titleAs: TitleTag = "h3", variant = "default", role, ...rest } = props;
 	const shouldRenderDismiss = onDismiss !== void 0;

package/dist/components/alert/alert.js.map

@@ -1 +1 @@
-{"version":3,"file":"alert.js","names":[],"sources":["../../../src/components/alert/alert.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { classes } from \"../_internal/classes\";\nimport { Close } from \"../close\";\nimport type { AlertProps } from \"./alert.types\";\n\nfunction resolveAlertRole(variant: AlertProps[\"variant\"] | undefined): \"alert\" | \"status\" {\n  if (variant === \"danger\" || variant === \"warning\") {\n    return \"alert\";\n  }\n\n  return \"status\";\n}\n\nexport function Alert(props: AlertProps): JSX.Element {\n  const {\n    actions,\n    children,\n    class: className,\n    description,\n    dismissLabel = \"Dismiss alert\",\n    icon,\n    onDismiss,\n    ref,\n    title,\n    titleAs: TitleTag = \"h3\",\n    variant = \"default\",\n    role,\n    ...rest\n  } = props;\n  const shouldRenderDismiss = onDismiss !== undefined;\n  const resolvedRole = role ?? resolveAlertRole(variant);\n  const hasVariant = variant !== \"default\";\n\n  return (\n    <div\n      {...rest}\n      ref={ref}\n      class={classes(\n        \"alert\",\n        hasVariant ? `alert-${variant}` : undefined,\n        shouldRenderDismiss ? \"alert-dismissible\" : undefined,\n        className,\n      )}\n      data-dismissible={shouldRenderDismiss ? \"true\" : undefined}\n      data-slot=\"alert\"\n      data-variant={hasVariant ? variant : undefined}\n      role={resolvedRole as string}\n    >\n      {icon !== undefined ? (\n        <div aria-hidden=\"true\" class=\"alert-icon\" data-slot=\"alert-icon\">\n          {icon}\n        </div>\n      ) : null}\n\n      <div class=\"alert-content\" data-slot=\"alert-content\">\n        {title !== undefined ? (\n          <TitleTag class=\"alert-title\" data-slot=\"alert-title\">\n            {title}\n          </TitleTag>\n        ) : null}\n\n        {description !== undefined ? (\n          <p class=\"alert-description\" data-slot=\"alert-description\">\n            {description}\n          </p>\n        ) : null}\n\n        {children}\n\n        {actions !== undefined ? (\n          <div class=\"alert-actions\" data-slot=\"alert-actions\">\n            {actions}\n          </div>\n        ) : null}\n      </div>\n\n      {shouldRenderDismiss ? (\n        <div class=\"alert-close\" data-slot=\"alert-close\">\n          <Close label={dismissLabel} onPress={onDismiss} />\n        </div>\n      ) : null}\n    </div>\n  );\n}\n"],"mappings":";;;;AAKA,SAAS,iBAAiB,SAAgE;CACxF,IAAI,YAAY,YAAY,YAAY,WACtC,OAAO;CAGT,OAAO;AACT;AAEA,SAAgB,MAAM,OAAgC;CACpD,MAAM,EACJ,SACA,UACA,OAAO,WACP,aACA,eAAe,iBACf,MACA,WACA,KACA,OACA,SAAS,WAAW,MACpB,UAAU,WACV,MACA,GAAG,SACD;CACJ,MAAM,sBAAsB,cAAc,KAAA;CAC1C,MAAM,eAAe,QAAQ,iBAAiB,OAAO;CACrD,MAAM,aAAa,YAAY;CAE/B,OACE,qBAAC,OAAD;EACE,GAAI;EACC;EACL,OAAO,QACL,SACA,aAAa,SAAS,YAAY,KAAA,GAClC,sBAAsB,sBAAsB,KAAA,GAC5C,SACF;EACA,oBAAkB,sBAAsB,SAAS,KAAA;EACjD,aAAU;EACV,gBAAc,aAAa,UAAU,KAAA;EACrC,MAAM;EAZR,UAAA;GAcG,SAAS,KAAA,IACR,oBAAC,OAAD;IAAK,eAAY;IAAO,OAAM;IAAa,aAAU;IAClD,UAAA;GACE,CAAA,IACH;GAEJ,qBAAC,OAAD;IAAK,OAAM;IAAgB,aAAU;IAArC,UAAA;KACG,UAAU,KAAA,IACT,oBAAC,UAAD;MAAU,OAAM;MAAc,aAAU;MACrC,UAAA;KACO,CAAA,IACR;KAEH,gBAAgB,KAAA,IACf,oBAAC,KAAD;MAAG,OAAM;MAAoB,aAAU;MACpC,UAAA;KACA,CAAA,IACD;KAEH;KAEA,YAAY,KAAA,IACX,oBAAC,OAAD;MAAK,OAAM;MAAgB,aAAU;MAClC,UAAA;KACE,CAAA,IACH;IACD;;GAEJ,sBACC,oBAAC,OAAD;IAAK,OAAM;IAAc,aAAU;IACjC,UAAA,oBAAC,OAAD;KAAO,OAAO;KAAc,SAAS;IAAY,CAAA;GAC9C,CAAA,IACH;EACD;;AAET"}
+{"version":3,"file":"alert.js","names":[],"sources":["../../../src/components/alert/alert.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { classes } from \"../_internal/classes\";\nimport { Close } from \"../close\";\nimport type { AlertProps } from \"./alert.types\";\n\nfunction resolveAlertRole(variant: AlertProps[\"variant\"] | undefined): \"alert\" | \"status\" {\n  if (variant === \"danger\" || variant === \"warning\") {\n    return \"alert\";\n  }\n\n  return \"status\";\n}\n\n/**\n * Renders an alert/status banner with an optional icon, title, description,\n * actions, and a dismiss button. Automatically picks an \"alert\" or \"status\"\n * ARIA role from `variant` unless `role` is set explicitly.\n */\nexport function Alert(props: AlertProps): JSX.Element {\n  const {\n    actions,\n    children,\n    class: className,\n    description,\n    dismissLabel = \"Dismiss alert\",\n    icon,\n    onDismiss,\n    ref,\n    title,\n    titleAs: TitleTag = \"h3\",\n    variant = \"default\",\n    role,\n    ...rest\n  } = props;\n  const shouldRenderDismiss = onDismiss !== undefined;\n  const resolvedRole = role ?? resolveAlertRole(variant);\n  const hasVariant = variant !== \"default\";\n\n  return (\n    <div\n      {...rest}\n      ref={ref}\n      class={classes(\n        \"alert\",\n        hasVariant ? `alert-${variant}` : undefined,\n        shouldRenderDismiss ? \"alert-dismissible\" : undefined,\n        className,\n      )}\n      data-dismissible={shouldRenderDismiss ? \"true\" : undefined}\n      data-slot=\"alert\"\n      data-variant={hasVariant ? variant : undefined}\n      role={resolvedRole as string}\n    >\n      {icon !== undefined ? (\n        <div aria-hidden=\"true\" class=\"alert-icon\" data-slot=\"alert-icon\">\n          {icon}\n        </div>\n      ) : null}\n\n      <div class=\"alert-content\" data-slot=\"alert-content\">\n        {title !== undefined ? (\n          <TitleTag class=\"alert-title\" data-slot=\"alert-title\">\n            {title}\n          </TitleTag>\n        ) : null}\n\n        {description !== undefined ? (\n          <p class=\"alert-description\" data-slot=\"alert-description\">\n            {description}\n          </p>\n        ) : null}\n\n        {children}\n\n        {actions !== undefined ? (\n          <div class=\"alert-actions\" data-slot=\"alert-actions\">\n            {actions}\n          </div>\n        ) : null}\n      </div>\n\n      {shouldRenderDismiss ? (\n        <div class=\"alert-close\" data-slot=\"alert-close\">\n          <Close label={dismissLabel} onPress={onDismiss} />\n        </div>\n      ) : null}\n    </div>\n  );\n}\n"],"mappings":";;;;AAKA,SAAS,iBAAiB,SAAgE;CACxF,IAAI,YAAY,YAAY,YAAY,WACtC,OAAO;CAGT,OAAO;AACT;;;;;;AAOA,SAAgB,MAAM,OAAgC;CACpD,MAAM,EACJ,SACA,UACA,OAAO,WACP,aACA,eAAe,iBACf,MACA,WACA,KACA,OACA,SAAS,WAAW,MACpB,UAAU,WACV,MACA,GAAG,SACD;CACJ,MAAM,sBAAsB,cAAc,KAAA;CAC1C,MAAM,eAAe,QAAQ,iBAAiB,OAAO;CACrD,MAAM,aAAa,YAAY;CAE/B,OACE,qBAAC,OAAD;EACE,GAAI;EACC;EACL,OAAO,QACL,SACA,aAAa,SAAS,YAAY,KAAA,GAClC,sBAAsB,sBAAsB,KAAA,GAC5C,SACF;EACA,oBAAkB,sBAAsB,SAAS,KAAA;EACjD,aAAU;EACV,gBAAc,aAAa,UAAU,KAAA;EACrC,MAAM;EAZR,UAAA;GAcG,SAAS,KAAA,IACR,oBAAC,OAAD;IAAK,eAAY;IAAO,OAAM;IAAa,aAAU;IAClD,UAAA;GACE,CAAA,IACH;GAEJ,qBAAC,OAAD;IAAK,OAAM;IAAgB,aAAU;IAArC,UAAA;KACG,UAAU,KAAA,IACT,oBAAC,UAAD;MAAU,OAAM;MAAc,aAAU;MACrC,UAAA;KACO,CAAA,IACR;KAEH,gBAAgB,KAAA,IACf,oBAAC,KAAD;MAAG,OAAM;MAAoB,aAAU;MACpC,UAAA;KACA,CAAA,IACD;KAEH;KAEA,YAAY,KAAA,IACX,oBAAC,OAAD;MAAK,OAAM;MAAgB,aAAU;MAClC,UAAA;KACE,CAAA,IACH;IACD;;GAEJ,sBACC,oBAAC,OAAD;IAAK,OAAM;IAAc,aAAU;IACjC,UAAA,oBAAC,OAAD;KAAO,OAAO;KAAc,SAAS;IAAY,CAAA;GAC9C,CAAA,IACH;EACD;;AAET"}

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

@@ -1,9 +1,12 @@
 import { JSX } from "@askrjs/askr/jsx-runtime";
 import { Ref } from "@askrjs/askr/foundations/utilities";
 //#region src/components/alert/alert.types.d.ts
+/** Visual tone of an {@link AlertProps} alert; `"danger"`/`"warning"` render with `role="alert"`. */
 type AlertVariant = "default" | "info" | "success" | "warning" | "danger";
+/** Heading tag allowed for an alert's title via `titleAs`. */
 type AlertHeadingTag = "h2" | "h3" | "h4" | "h5" | "h6";
 type DivProps = Omit<JSX.IntrinsicElements["div"], "children" | "ref">;
+/** Props for the {@link Alert} component. */
 type AlertProps = DivProps & {
   actions?: unknown;
   children?: unknown;

package/dist/components/aside/aside.d.ts

@@ -1,6 +1,7 @@
 import { AsideProps } from "./aside.types.js";
 import { JSX } from "@askrjs/askr/jsx-runtime";
 //#region src/components/aside/aside.d.ts
+/** Renders a `<aside>`-element {@link Block} tagged with `data-slot="aside"`. */
 declare function Aside(props: AsideProps): JSX.Element;
 //#endregion
 export { Aside };

package/dist/components/aside/aside.js

@@ -1,6 +1,7 @@
 import { Block } from "../block/block.js";
 import { jsx } from "@askrjs/askr/jsx-runtime";
 //#region src/components/aside/aside.tsx
+/** Renders a `<aside>`-element {@link Block} tagged with `data-slot="aside"`. */
 function Aside(props) {
 	const { children, ...rest } = props;
 	return /* @__PURE__ */ jsx(Block, {

package/dist/components/aside/aside.js.map

@@ -1 +1 @@
-{"version":3,"file":"aside.js","names":[],"sources":["../../../src/components/aside/aside.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { Block } from \"../block\";\nimport type { AsideProps } from \"./aside.types\";\n\nexport function Aside(props: AsideProps): JSX.Element {\n  const { children, ...rest } = props;\n\n  return (\n    <Block as=\"aside\" {...rest} data-slot=\"aside\">\n      {children}\n    </Block>\n  );\n}\n"],"mappings":";;;AAIA,SAAgB,MAAM,OAAgC;CACpD,MAAM,EAAE,UAAU,GAAG,SAAS;CAE9B,OACE,oBAAC,OAAD;EAAO,IAAG;EAAQ,GAAI;EAAM,aAAU;EACnC;CACI,CAAA;AAEX"}
+{"version":3,"file":"aside.js","names":[],"sources":["../../../src/components/aside/aside.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { Block } from \"../block\";\nimport type { AsideProps } from \"./aside.types\";\n\n/** Renders a `<aside>`-element {@link Block} tagged with `data-slot=\"aside\"`. */\nexport function Aside(props: AsideProps): JSX.Element {\n  const { children, ...rest } = props;\n\n  return (\n    <Block as=\"aside\" {...rest} data-slot=\"aside\">\n      {children}\n    </Block>\n  );\n}\n"],"mappings":";;;;AAKA,SAAgB,MAAM,OAAgC;CACpD,MAAM,EAAE,UAAU,GAAG,SAAS;CAE9B,OACE,oBAAC,OAAD;EAAO,IAAG;EAAQ,GAAI;EAAM,aAAU;EACnC;CACI,CAAA;AAEX"}

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

@@ -1,6 +1,7 @@
 import { BlockElementProps } from "../block/block.types.js";
 import "../block/index.js";
 //#region src/components/aside/aside.types.d.ts
+/** Props for the {@link Aside} component. */
 type AsideProps = Omit<BlockElementProps<"aside">, "as">;
 //#endregion
 export { AsideProps };

package/dist/components/aspect-ratio/aspect-ratio.d.ts

@@ -1,6 +1,11 @@
 import { AspectRatioAsChildProps, AspectRatioProps } from "./aspect-ratio.types.js";
 import { JSX } from "@askrjs/askr/jsx-runtime";
 //#region src/components/aspect-ratio/aspect-ratio.d.ts
+/**
+ * Constrains its content to a fixed width/height ratio (defaults to `1`)
+ * using a computed `aspect-ratio` style, rendering as a `<div>` or, with
+ * `asChild`, merging its layout into the single child element.
+ */
 declare function AspectRatio(props: AspectRatioProps): JSX.Element;
 declare function AspectRatio(props: AspectRatioAsChildProps): JSX.Element;
 //#endregion

package/dist/components/aspect-ratio/aspect-ratio.js.map

@@ -1 +1 @@
-{"version":3,"file":"aspect-ratio.js","names":[],"sources":["../../../src/components/aspect-ratio/aspect-ratio.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { Slot } from \"@askrjs/askr/foundations\";\nimport { mergeProps } from \"../_internal/merge-props\";\nimport { mergeLayoutStyles } from \"../_internal/block-layout\";\nimport { styleDeclarationsToClass } from \"../_internal/style\";\nimport { intrinsicElement } from \"../_internal/jsx\";\nimport type { AspectRatioAsChildProps, AspectRatioProps } from \"./aspect-ratio.types\";\n\nexport function AspectRatio(props: AspectRatioProps): JSX.Element;\nexport function AspectRatio(props: AspectRatioAsChildProps): JSX.Element;\nexport function AspectRatio(props: AspectRatioProps | AspectRatioAsChildProps) {\n  const { asChild, children, ratio = 1, ref, style, ...rest } = props;\n  const layoutClass = styleDeclarationsToClass(\n    mergeLayoutStyles(\n      {\n        display: \"block\",\n        width: \"100%\",\n        aspectRatio: String(ratio),\n        overflow: \"hidden\",\n      },\n      style,\n    ),\n  );\n\n  const finalProps = mergeProps(rest, {\n    ref,\n    \"data-slot\": \"aspect-ratio\",\n    ...(layoutClass ? { class: layoutClass } : {}),\n  });\n\n  if (asChild) {\n    return <Slot asChild {...finalProps} children={children} />;\n  }\n\n  return intrinsicElement(\"div\", finalProps, children);\n}\n"],"mappings":";;;;;;;AAUA,SAAgB,YAAY,OAAmD;CAC7E,MAAM,EAAE,SAAS,UAAU,QAAQ,GAAG,KAAK,OAAO,GAAG,SAAS;CAC9D,MAAM,cAAc,yBAClB,kBACE;EACE,SAAS;EACT,OAAO;EACP,aAAa,OAAO,KAAK;EACzB,UAAU;CACZ,GACA,KACF,CACF;CAEA,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,aAAa;EACb,GAAI,cAAc,EAAE,OAAO,YAAY,IAAI,CAAC;CAC9C,CAAC;CAED,IAAI,SACF,OAAO,oBAAC,MAAD;EAAM,SAAA;EAAQ,GAAI;EAAsB;CAAW,CAAA;CAG5D,OAAO,iBAAiB,OAAO,YAAY,QAAQ;AACrD"}
+{"version":3,"file":"aspect-ratio.js","names":[],"sources":["../../../src/components/aspect-ratio/aspect-ratio.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { Slot } from \"@askrjs/askr/foundations\";\nimport { mergeProps } from \"../_internal/merge-props\";\nimport { mergeLayoutStyles } from \"../_internal/block-layout\";\nimport { styleDeclarationsToClass } from \"../_internal/style\";\nimport { intrinsicElement } from \"../_internal/jsx\";\nimport type { AspectRatioAsChildProps, AspectRatioProps } from \"./aspect-ratio.types\";\n\n/**\n * Constrains its content to a fixed width/height ratio (defaults to `1`)\n * using a computed `aspect-ratio` style, rendering as a `<div>` or, with\n * `asChild`, merging its layout into the single child element.\n */\nexport function AspectRatio(props: AspectRatioProps): JSX.Element;\nexport function AspectRatio(props: AspectRatioAsChildProps): JSX.Element;\nexport function AspectRatio(props: AspectRatioProps | AspectRatioAsChildProps) {\n  const { asChild, children, ratio = 1, ref, style, ...rest } = props;\n  const layoutClass = styleDeclarationsToClass(\n    mergeLayoutStyles(\n      {\n        display: \"block\",\n        width: \"100%\",\n        aspectRatio: String(ratio),\n        overflow: \"hidden\",\n      },\n      style,\n    ),\n  );\n\n  const finalProps = mergeProps(rest, {\n    ref,\n    \"data-slot\": \"aspect-ratio\",\n    ...(layoutClass ? { class: layoutClass } : {}),\n  });\n\n  if (asChild) {\n    return <Slot asChild {...finalProps} children={children} />;\n  }\n\n  return intrinsicElement(\"div\", finalProps, children);\n}\n"],"mappings":";;;;;;;AAeA,SAAgB,YAAY,OAAmD;CAC7E,MAAM,EAAE,SAAS,UAAU,QAAQ,GAAG,KAAK,OAAO,GAAG,SAAS;CAC9D,MAAM,cAAc,yBAClB,kBACE;EACE,SAAS;EACT,OAAO;EACP,aAAa,OAAO,KAAK;EACzB,UAAU;CACZ,GACA,KACF,CACF;CAEA,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,aAAa;EACb,GAAI,cAAc,EAAE,OAAO,YAAY,IAAI,CAAC;CAC9C,CAAC;CAED,IAAI,SACF,OAAO,oBAAC,MAAD;EAAM,SAAA;EAAQ,GAAI;EAAsB;CAAW,CAAA;CAG5D,OAAO,iBAAiB,OAAO,YAAY,QAAQ;AACrD"}

package/dist/components/aspect-ratio/aspect-ratio.types.d.ts

@@ -2,15 +2,18 @@ import { JSX } from "@askrjs/askr/jsx-runtime";
 import { JSXElement } from "@askrjs/askr/foundations";
 import { Ref } from "@askrjs/askr/foundations/utilities";
 //#region src/components/aspect-ratio/aspect-ratio.types.d.ts
+/** Props shared by both {@link AspectRatio} call signatures. */
 type AspectRatioOwnProps = {
   children?: unknown;
   ratio?: number | string;
   style?: unknown;
 };
+/** Props for {@link AspectRatio} rendered as its default `<div>` element. */
 type AspectRatioProps = Omit<JSX.IntrinsicElements["div"], "children" | "ref"> & AspectRatioOwnProps & {
   asChild?: false;
   ref?: Ref<HTMLDivElement>;
 };
+/** Props for {@link AspectRatio} rendered with `asChild`, merging layout onto a single child element. */
 type AspectRatioAsChildProps = AspectRatioOwnProps & {
   asChild: true;
   children: JSXElement;

package/dist/components/badge/badge.d.ts

@@ -1,6 +1,7 @@
 import { BadgeAsChildProps, BadgeProps } from "./badge.types.js";
 import { JSX } from "@askrjs/askr/jsx-runtime";
 //#region src/components/badge/badge.d.ts
+/** Renders a small status/label badge, defaulting to a `<span>` (or merging onto a child via `asChild`), with a `variant` color modifier. */
 declare function Badge(props: BadgeProps): JSX.Element;
 declare function Badge(props: BadgeAsChildProps): JSX.Element;
 //#endregion

package/dist/components/badge/badge.js.map

@@ -1 +1 @@
-{"version":3,"file":"badge.js","names":[],"sources":["../../../src/components/badge/badge.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { Slot } from \"@askrjs/askr/foundations\";\nimport { classes } from \"../_internal/classes\";\nimport { mergeProps } from \"../_internal/merge-props\";\nimport { intrinsicElement } from \"../_internal/jsx\";\nimport type { BadgeAsChildProps, BadgeProps } from \"./badge.types\";\n\nfunction normalizeBadgeVariant(variant: BadgeProps[\"variant\"] | undefined) {\n  return variant && variant !== \"default\" ? `badge-${variant}` : undefined;\n}\n\nexport function Badge(props: BadgeProps): JSX.Element;\nexport function Badge(props: BadgeAsChildProps): JSX.Element;\nexport function Badge(props: BadgeProps | BadgeAsChildProps) {\n  const { asChild, children, variant, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    class: classes(\"badge\", normalizeBadgeVariant(variant)),\n    ref,\n    \"data-slot\": \"badge\",\n    \"data-badge\": \"true\",\n    \"data-variant\": variant && variant !== \"default\" ? variant : undefined,\n  });\n\n  if (asChild) {\n    return <Slot asChild {...finalProps} children={children} />;\n  }\n\n  return intrinsicElement(\"span\", finalProps, children);\n}\n"],"mappings":";;;;;;AAOA,SAAS,sBAAsB,SAA4C;CACzE,OAAO,WAAW,YAAY,YAAY,SAAS,YAAY,KAAA;AACjE;AAIA,SAAgB,MAAM,OAAuC;CAC3D,MAAM,EAAE,SAAS,UAAU,SAAS,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC,OAAO,QAAQ,SAAS,sBAAsB,OAAO,CAAC;EACtD;EACA,aAAa;EACb,cAAc;EACd,gBAAgB,WAAW,YAAY,YAAY,UAAU,KAAA;CAC/D,CAAC;CAED,IAAI,SACF,OAAO,oBAAC,MAAD;EAAM,SAAA;EAAQ,GAAI;EAAsB;CAAW,CAAA;CAG5D,OAAO,iBAAiB,QAAQ,YAAY,QAAQ;AACtD"}
+{"version":3,"file":"badge.js","names":[],"sources":["../../../src/components/badge/badge.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { Slot } from \"@askrjs/askr/foundations\";\nimport { classes } from \"../_internal/classes\";\nimport { mergeProps } from \"../_internal/merge-props\";\nimport { intrinsicElement } from \"../_internal/jsx\";\nimport type { BadgeAsChildProps, BadgeProps } from \"./badge.types\";\n\nfunction normalizeBadgeVariant(variant: BadgeProps[\"variant\"] | undefined) {\n  return variant && variant !== \"default\" ? `badge-${variant}` : undefined;\n}\n\n/** Renders a small status/label badge, defaulting to a `<span>` (or merging onto a child via `asChild`), with a `variant` color modifier. */\nexport function Badge(props: BadgeProps): JSX.Element;\nexport function Badge(props: BadgeAsChildProps): JSX.Element;\nexport function Badge(props: BadgeProps | BadgeAsChildProps) {\n  const { asChild, children, variant, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    class: classes(\"badge\", normalizeBadgeVariant(variant)),\n    ref,\n    \"data-slot\": \"badge\",\n    \"data-badge\": \"true\",\n    \"data-variant\": variant && variant !== \"default\" ? variant : undefined,\n  });\n\n  if (asChild) {\n    return <Slot asChild {...finalProps} children={children} />;\n  }\n\n  return intrinsicElement(\"span\", finalProps, children);\n}\n"],"mappings":";;;;;;AAOA,SAAS,sBAAsB,SAA4C;CACzE,OAAO,WAAW,YAAY,YAAY,SAAS,YAAY,KAAA;AACjE;AAKA,SAAgB,MAAM,OAAuC;CAC3D,MAAM,EAAE,SAAS,UAAU,SAAS,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC,OAAO,QAAQ,SAAS,sBAAsB,OAAO,CAAC;EACtD;EACA,aAAa;EACb,cAAc;EACd,gBAAgB,WAAW,YAAY,YAAY,UAAU,KAAA;CAC/D,CAAC;CAED,IAAI,SACF,OAAO,oBAAC,MAAD;EAAM,SAAA;EAAQ,GAAI;EAAsB;CAAW,CAAA;CAG5D,OAAO,iBAAiB,QAAQ,YAAY,QAAQ;AACtD"}

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

@@ -2,15 +2,19 @@ import { JSX } from "@askrjs/askr/jsx-runtime";
 import { JSXElement } from "@askrjs/askr/foundations";
 import { Ref } from "@askrjs/askr/foundations/utilities";
 //#region src/components/badge/badge.types.d.ts
+/** Visual tone of a {@link BadgeProps} badge. */
 type BadgeVariant = "default" | "secondary" | "outline" | "success" | "warning" | "danger" | "info";
+/** Props shared by both {@link Badge} call signatures. */
 type BadgeOwnProps = {
   children?: unknown;
   variant?: BadgeVariant;
 };
+/** Props for {@link Badge} rendered as its default `<span>` element. */
 type BadgeProps = Omit<JSX.IntrinsicElements["span"], "children" | "ref"> & BadgeOwnProps & {
   asChild?: false;
   ref?: Ref<HTMLSpanElement>;
 };
+/** Props for {@link Badge} rendered with `asChild`, merging its attributes onto a single child element. */
 type BadgeAsChildProps = BadgeOwnProps & {
   asChild: true;
   children: JSXElement;

package/dist/components/block/block.d.ts

@@ -1,6 +1,12 @@
 import { BlockAsChildProps, BlockNativeProps } from "./block.types.js";
 import { JSX } from "@askrjs/askr/jsx-runtime";
 //#region src/components/block/block.d.ts
+/**
+ * Low-level layout primitive: renders any element in {@link BlockElement}
+ * (default `<div>`) and turns layout-only props (spacing, alignment,
+ * direction, sizing, etc.) into a generated utility class. With `asChild`,
+ * the layout is merged onto a single child element instead of a wrapper.
+ */
 declare function Block(props: BlockNativeProps): JSX.Element;
 declare function Block(props: BlockAsChildProps): JSX.Element;
 //#endregion

package/dist/components/block/block.js.map

@@ -1 +1 @@
-{"version":3,"file":"block.js","names":[],"sources":["../../../src/components/block/block.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { Slot } from \"@askrjs/askr/foundations\";\nimport { classes } from \"../_internal/classes\";\nimport {\n  applyBlockLayoutStyles,\n  mergeLayoutStyles,\n  splitBlockLayoutProps,\n} from \"../_internal/block-layout\";\nimport { mergeProps } from \"../_internal/merge-props\";\nimport { intrinsicElement } from \"../_internal/jsx\";\nimport { styleDeclarationsToClass } from \"../_internal/style\";\nimport type { BlockAsChildProps, BlockNativeProps } from \"./block.types\";\n\nconst DEFAULT_ELEMENT = \"div\";\n\nexport function Block(props: BlockNativeProps): JSX.Element;\nexport function Block(props: BlockAsChildProps): JSX.Element;\nexport function Block(props: BlockNativeProps | BlockAsChildProps) {\n  const {\n    as: asProp,\n    asChild,\n    children,\n    ref,\n    class: classProp,\n    className,\n    style: userStyle,\n    ...rest\n  } = props as (BlockNativeProps | BlockAsChildProps) & {\n    as?: BlockNativeProps[\"as\"];\n    class?: unknown;\n    className?: unknown;\n    style?: unknown;\n  };\n  const as = asProp ?? DEFAULT_ELEMENT;\n\n  const { blockProps, rest: passthroughProps } = splitBlockLayoutProps(rest);\n  const layoutStyle: Record<string, string | number> = {};\n  applyBlockLayoutStyles(layoutStyle, blockProps);\n\n  const layoutClass = styleDeclarationsToClass(mergeLayoutStyles(layoutStyle, userStyle));\n  const slot =\n    typeof (passthroughProps as Record<string, unknown>)[\"data-slot\"] === \"string\"\n      ? String((passthroughProps as Record<string, unknown>)[\"data-slot\"])\n      : \"block\";\n\n  const finalProps = mergeProps(passthroughProps, {\n    ref,\n    class: classes(classProp, className, layoutClass),\n    \"data-slot\": slot,\n    \"data-ak-layout\": \"true\",\n  });\n\n  if (asChild) {\n    return <Slot asChild {...finalProps} children={children as JSX.Element} />;\n  }\n\n  return intrinsicElement(as ?? DEFAULT_ELEMENT, finalProps, children);\n}\n"],"mappings":";;;;;;;;AAaA,MAAM,kBAAkB;AAIxB,SAAgB,MAAM,OAA6C;CACjE,MAAM,EACJ,IAAI,QACJ,SACA,UACA,KACA,OAAO,WACP,WACA,OAAO,WACP,GAAG,SACD;CAMJ,MAAM,KAAK,UAAU;CAErB,MAAM,EAAE,YAAY,MAAM,qBAAqB,sBAAsB,IAAI;CACzE,MAAM,cAA+C,CAAC;CACtD,uBAAuB,aAAa,UAAU;CAE9C,MAAM,cAAc,yBAAyB,kBAAkB,aAAa,SAAS,CAAC;CACtF,MAAM,OACJ,OAAQ,iBAA6C,iBAAiB,WAClE,OAAQ,iBAA6C,YAAY,IACjE;CAEN,MAAM,aAAa,WAAW,kBAAkB;EAC9C;EACA,OAAO,QAAQ,WAAW,WAAW,WAAW;EAChD,aAAa;EACb,kBAAkB;CACpB,CAAC;CAED,IAAI,SACF,OAAO,oBAAC,MAAD;EAAM,SAAA;EAAQ,GAAI;EAAsB;CAA0B,CAAA;CAG3E,OAAO,iBAAiB,MAAM,iBAAiB,YAAY,QAAQ;AACrE"}
+{"version":3,"file":"block.js","names":[],"sources":["../../../src/components/block/block.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { Slot } from \"@askrjs/askr/foundations\";\nimport { classes } from \"../_internal/classes\";\nimport {\n  applyBlockLayoutStyles,\n  mergeLayoutStyles,\n  splitBlockLayoutProps,\n} from \"../_internal/block-layout\";\nimport { mergeProps } from \"../_internal/merge-props\";\nimport { intrinsicElement } from \"../_internal/jsx\";\nimport { styleDeclarationsToClass } from \"../_internal/style\";\nimport type { BlockAsChildProps, BlockNativeProps } from \"./block.types\";\n\nconst DEFAULT_ELEMENT = \"div\";\n\n/**\n * Low-level layout primitive: renders any element in {@link BlockElement}\n * (default `<div>`) and turns layout-only props (spacing, alignment,\n * direction, sizing, etc.) into a generated utility class. With `asChild`,\n * the layout is merged onto a single child element instead of a wrapper.\n */\nexport function Block(props: BlockNativeProps): JSX.Element;\nexport function Block(props: BlockAsChildProps): JSX.Element;\nexport function Block(props: BlockNativeProps | BlockAsChildProps) {\n  const {\n    as: asProp,\n    asChild,\n    children,\n    ref,\n    class: classProp,\n    className,\n    style: userStyle,\n    ...rest\n  } = props as (BlockNativeProps | BlockAsChildProps) & {\n    as?: BlockNativeProps[\"as\"];\n    class?: unknown;\n    className?: unknown;\n    style?: unknown;\n  };\n  const as = asProp ?? DEFAULT_ELEMENT;\n\n  const { blockProps, rest: passthroughProps } = splitBlockLayoutProps(rest);\n  const layoutStyle: Record<string, string | number> = {};\n  applyBlockLayoutStyles(layoutStyle, blockProps);\n\n  const layoutClass = styleDeclarationsToClass(mergeLayoutStyles(layoutStyle, userStyle));\n  const slot =\n    typeof (passthroughProps as Record<string, unknown>)[\"data-slot\"] === \"string\"\n      ? String((passthroughProps as Record<string, unknown>)[\"data-slot\"])\n      : \"block\";\n\n  const finalProps = mergeProps(passthroughProps, {\n    ref,\n    class: classes(classProp, className, layoutClass),\n    \"data-slot\": slot,\n    \"data-ak-layout\": \"true\",\n  });\n\n  if (asChild) {\n    return <Slot asChild {...finalProps} children={children as JSX.Element} />;\n  }\n\n  return intrinsicElement(as ?? DEFAULT_ELEMENT, finalProps, children);\n}\n"],"mappings":";;;;;;;;AAaA,MAAM,kBAAkB;AAUxB,SAAgB,MAAM,OAA6C;CACjE,MAAM,EACJ,IAAI,QACJ,SACA,UACA,KACA,OAAO,WACP,WACA,OAAO,WACP,GAAG,SACD;CAMJ,MAAM,KAAK,UAAU;CAErB,MAAM,EAAE,YAAY,MAAM,qBAAqB,sBAAsB,IAAI;CACzE,MAAM,cAA+C,CAAC;CACtD,uBAAuB,aAAa,UAAU;CAE9C,MAAM,cAAc,yBAAyB,kBAAkB,aAAa,SAAS,CAAC;CACtF,MAAM,OACJ,OAAQ,iBAA6C,iBAAiB,WAClE,OAAQ,iBAA6C,YAAY,IACjE;CAEN,MAAM,aAAa,WAAW,kBAAkB;EAC9C;EACA,OAAO,QAAQ,WAAW,WAAW,WAAW;EAChD,aAAa;EACb,kBAAkB;CACpB,CAAC;CAED,IAAI,SACF,OAAO,oBAAC,MAAD;EAAM,SAAA;EAAQ,GAAI;EAAsB;CAA0B,CAAA;CAG3E,OAAO,iBAAiB,MAAM,iBAAiB,YAAY,QAAQ;AACrE"}

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

@@ -3,25 +3,33 @@ import { JSX } from "@askrjs/askr/jsx-runtime";
 import { JSXElement } from "@askrjs/askr/foundations";
 import { Ref } from "@askrjs/askr/foundations/utilities";
 //#region src/components/block/block.types.d.ts
+/** Element tags {@link Block} can render as via its `as` prop. */
 type BlockElement = "div" | "span" | "main" | "header" | "footer" | "section" | "aside" | "nav" | "a" | "ul" | "ol" | "li" | "form" | "article";
+/** Layout and structural props accepted by {@link Block}, independent of the rendered element. */
 type BlockOwnProps = BlockLayoutProps & {
   as?: BlockElement;
   children?: unknown;
   className?: string;
 };
+/** {@link Block} props specialized for a given {@link BlockElement} tag `TElement`. */
 type BlockElementProps<TElement extends BlockElement> = Omit<JSX.IntrinsicElements[TElement], "children" | "ref"> & BlockOwnProps & {
   as?: TElement;
   asChild?: false;
   ref?: Ref<unknown>;
 };
+/** Union of {@link BlockElementProps} across every {@link BlockElement}, used for {@link Block}'s native (non-`asChild`) overload. */
 type BlockNativeProps = { [TElement in BlockElement]: BlockElementProps<TElement>; }[BlockElement];
+/** Props for {@link Block} rendered with `asChild`, merging layout onto a single child element. */
 type BlockAsChildProps = Omit<BlockOwnProps, "as"> & {
   asChild: true;
   children: JSXElement;
   ref?: Ref<unknown>;
 };
+/** {@link Block} props specialized for a `<div>` element. */
 type BlockDivProps = BlockElementProps<"div">;
+/** {@link Block} props specialized for a `<span>` element. */
 type BlockSpanProps = BlockElementProps<"span">;
+/** Union of all prop shapes accepted by {@link Block}. */
 type BlockProps = BlockNativeProps | BlockAsChildProps;
 //#endregion
 export { type BlockAlign, BlockAsChildProps, type BlockBackground, type BlockDirection, BlockDivProps, BlockElement, BlockElementProps, type BlockJustify, type BlockMargin, BlockNativeProps, BlockOwnProps, BlockProps, type BlockRadius, type ResponsiveValue as BlockResponsiveValue, type BlockRowFrom, type BlockShadow, type BlockSize, type BlockSpace, BlockSpanProps, type BlockZIndex };

package/dist/components/brand/brand.d.ts

@@ -1,8 +1,11 @@
 import { BrandLabelProps, BrandMarkProps, BrandProps } from "./brand.types.js";
 import { JSX } from "@askrjs/askr/jsx-runtime";
 //#region src/components/brand/brand.d.ts
+/** Renders a brand/logo wrapper, defaulting to a `<div>` (or `<a>`/`<span>` via `as`), or merges onto a single child via `asChild`. */
 declare function Brand<TElement extends "div" | "a" | "span" = "div">(props: BrandProps<TElement>): JSX.Element;
+/** Renders the icon/mark portion of a {@link Brand}. */
 declare function BrandMark(props: BrandMarkProps): JSX.Element;
+/** Renders the text label portion of a {@link Brand}. */
 declare function BrandLabel(props: BrandLabelProps): JSX.Element;
 //#endregion
 export { Brand, BrandLabel, BrandMark };

package/dist/components/brand/brand.js

@@ -5,6 +5,7 @@ import { jsx } from "@askrjs/askr/jsx-runtime";
 import { Slot } from "@askrjs/askr/foundations";
 //#region src/components/brand/brand.tsx
 const DEFAULT_ELEMENT = "div";
+/** Renders a brand/logo wrapper, defaulting to a `<div>` (or `<a>`/`<span>` via `as`), or merges onto a single child via `asChild`. */
 function Brand(props) {
 	const { as: asProp, asChild, children, class: classProp, className, ref, ...rest } = props;
 	const as = asProp;
@@ -20,6 +21,7 @@ function Brand(props) {
 	});
 	return intrinsicElement(as ?? DEFAULT_ELEMENT, finalProps, children);
 }
+/** Renders the icon/mark portion of a {@link Brand}. */
 function BrandMark(props) {
 	const { children, class: className, ref, ...rest } = props;
 	const finalProps = mergeProps(rest, {
@@ -32,6 +34,7 @@ function BrandMark(props) {
 		children
 	});
 }
+/** Renders the text label portion of a {@link Brand}. */
 function BrandLabel(props) {
 	const { children, class: className, ref, ...rest } = props;
 	const finalProps = mergeProps(rest, {

package/dist/components/brand/brand.js.map

@@ -1 +1 @@
-{"version":3,"file":"brand.js","names":[],"sources":["../../../src/components/brand/brand.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { Slot } from \"@askrjs/askr/foundations\";\nimport { classes } from \"../_internal/classes\";\nimport { mergeProps } from \"../_internal/merge-props\";\nimport { intrinsicElement } from \"../_internal/jsx\";\nimport type {\n  BrandAsChildProps,\n  BrandLabelProps,\n  BrandMarkProps,\n  BrandNativeProps,\n  BrandProps,\n} from \"./brand.types\";\n\nconst DEFAULT_ELEMENT = \"div\";\n\nexport function Brand<TElement extends \"div\" | \"a\" | \"span\" = \"div\">(\n  props: BrandProps<TElement>,\n): JSX.Element {\n  const {\n    as: asProp,\n    asChild,\n    children,\n    class: classProp,\n    className,\n    ref,\n    ...rest\n  } = props as (BrandNativeProps | BrandAsChildProps) & {\n    as?: \"div\" | \"a\" | \"span\";\n  };\n  const as = asProp;\n\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"brand\", classProp, className),\n    \"data-slot\": \"brand\",\n  });\n\n  if (asChild) {\n    return <Slot asChild {...finalProps} children={children as JSX.Element} />;\n  }\n\n  return intrinsicElement(as ?? DEFAULT_ELEMENT, finalProps, children);\n}\n\nexport function BrandMark(props: BrandMarkProps): JSX.Element {\n  const { children, class: className, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"brand-mark\", className),\n    \"data-slot\": \"brand-mark\",\n  });\n\n  return <span {...finalProps}>{children}</span>;\n}\n\nexport function BrandLabel(props: BrandLabelProps): JSX.Element {\n  const { children, class: className, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"brand-label\", className),\n    \"data-slot\": \"brand-label\",\n  });\n\n  return <span {...finalProps}>{children}</span>;\n}\n"],"mappings":";;;;;;AAaA,MAAM,kBAAkB;AAExB,SAAgB,MACd,OACa;CACb,MAAM,EACJ,IAAI,QACJ,SACA,UACA,OAAO,WACP,WACA,KACA,GAAG,SACD;CAGJ,MAAM,KAAK;CAEX,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,SAAS,WAAW,SAAS;EAC5C,aAAa;CACf,CAAC;CAED,IAAI,SACF,OAAO,oBAAC,MAAD;EAAM,SAAA;EAAQ,GAAI;EAAsB;CAA0B,CAAA;CAG3E,OAAO,iBAAiB,MAAM,iBAAiB,YAAY,QAAQ;AACrE;AAEA,SAAgB,UAAU,OAAoC;CAC5D,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,cAAc,SAAS;EACtC,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,QAAD;EAAM,GAAI;EAAa;CAAe,CAAA;AAC/C;AAEA,SAAgB,WAAW,OAAqC;CAC9D,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,eAAe,SAAS;EACvC,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,QAAD;EAAM,GAAI;EAAa;CAAe,CAAA;AAC/C"}
+{"version":3,"file":"brand.js","names":[],"sources":["../../../src/components/brand/brand.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { Slot } from \"@askrjs/askr/foundations\";\nimport { classes } from \"../_internal/classes\";\nimport { mergeProps } from \"../_internal/merge-props\";\nimport { intrinsicElement } from \"../_internal/jsx\";\nimport type {\n  BrandAsChildProps,\n  BrandLabelProps,\n  BrandMarkProps,\n  BrandNativeProps,\n  BrandProps,\n} from \"./brand.types\";\n\nconst DEFAULT_ELEMENT = \"div\";\n\n/** Renders a brand/logo wrapper, defaulting to a `<div>` (or `<a>`/`<span>` via `as`), or merges onto a single child via `asChild`. */\nexport function Brand<TElement extends \"div\" | \"a\" | \"span\" = \"div\">(\n  props: BrandProps<TElement>,\n): JSX.Element {\n  const {\n    as: asProp,\n    asChild,\n    children,\n    class: classProp,\n    className,\n    ref,\n    ...rest\n  } = props as (BrandNativeProps | BrandAsChildProps) & {\n    as?: \"div\" | \"a\" | \"span\";\n  };\n  const as = asProp;\n\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"brand\", classProp, className),\n    \"data-slot\": \"brand\",\n  });\n\n  if (asChild) {\n    return <Slot asChild {...finalProps} children={children as JSX.Element} />;\n  }\n\n  return intrinsicElement(as ?? DEFAULT_ELEMENT, finalProps, children);\n}\n\n/** Renders the icon/mark portion of a {@link Brand}. */\nexport function BrandMark(props: BrandMarkProps): JSX.Element {\n  const { children, class: className, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"brand-mark\", className),\n    \"data-slot\": \"brand-mark\",\n  });\n\n  return <span {...finalProps}>{children}</span>;\n}\n\n/** Renders the text label portion of a {@link Brand}. */\nexport function BrandLabel(props: BrandLabelProps): JSX.Element {\n  const { children, class: className, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"brand-label\", className),\n    \"data-slot\": \"brand-label\",\n  });\n\n  return <span {...finalProps}>{children}</span>;\n}\n"],"mappings":";;;;;;AAaA,MAAM,kBAAkB;;AAGxB,SAAgB,MACd,OACa;CACb,MAAM,EACJ,IAAI,QACJ,SACA,UACA,OAAO,WACP,WACA,KACA,GAAG,SACD;CAGJ,MAAM,KAAK;CAEX,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,SAAS,WAAW,SAAS;EAC5C,aAAa;CACf,CAAC;CAED,IAAI,SACF,OAAO,oBAAC,MAAD;EAAM,SAAA;EAAQ,GAAI;EAAsB;CAA0B,CAAA;CAG3E,OAAO,iBAAiB,MAAM,iBAAiB,YAAY,QAAQ;AACrE;;AAGA,SAAgB,UAAU,OAAoC;CAC5D,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,cAAc,SAAS;EACtC,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,QAAD;EAAM,GAAI;EAAa;CAAe,CAAA;AAC/C;;AAGA,SAAgB,WAAW,OAAqC;CAC9D,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,eAAe,SAAS;EACvC,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,QAAD;EAAM,GAAI;EAAa;CAAe,CAAA;AAC/C"}

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

@@ -1,15 +1,18 @@
 import { JSX } from "@askrjs/askr/jsx-runtime";
 import { Ref } from "@askrjs/askr/foundations/utilities";
 //#region src/components/brand/brand.types.d.ts
+/** Element tags {@link Brand} can render as via its `as` prop. */
 type BrandElement = "div" | "a" | "span";
 type BrandIntrinsicProps<TElement extends BrandElement> = Omit<JSX.IntrinsicElements[TElement], "children" | "ref">;
 type SpanProps = Omit<JSX.IntrinsicElements["span"], "children" | "ref">;
+/** {@link Brand} props for its native (non-`asChild`) rendering, specialized for a given {@link BrandElement} `TElement`. */
 type BrandNativeProps<TElement extends BrandElement = "div"> = BrandIntrinsicProps<TElement> & {
   as?: TElement;
   asChild?: false;
   children?: unknown;
   ref?: Ref<HTMLElement>;
 };
+/** Props for {@link Brand} rendered with `asChild`, merging its attributes onto a single child element. */
 type BrandAsChildProps = {
   asChild: true;
   children: JSX.Element;
@@ -17,11 +20,14 @@ type BrandAsChildProps = {
   className?: string;
   ref?: Ref<HTMLElement>;
 };
+/** Union of all prop shapes accepted by {@link Brand}. */
 type BrandProps<TElement extends BrandElement = "div"> = BrandNativeProps<TElement> | BrandAsChildProps;
+/** Props for the {@link BrandMark} component. */
 type BrandMarkProps = SpanProps & {
   children?: unknown;
   ref?: Ref<HTMLSpanElement>;
 };
+/** Props for the {@link BrandLabel} component. */
 type BrandLabelProps = SpanProps & {
   children?: unknown;
   ref?: Ref<HTMLSpanElement>;

package/dist/components/button-group/button-group.d.ts

@@ -1,6 +1,7 @@
 import { ButtonGroupProps } from "./button-group.types.js";
 import { JSX } from "@askrjs/askr/jsx-runtime";
 //#region src/components/button-group/button-group.d.ts
+/** Groups related buttons together, optionally visually attached, with a horizontal or vertical orientation and `role="group"` by default. */
 declare function ButtonGroup(props: ButtonGroupProps): JSX.Element;
 //#endregion
 export { ButtonGroup };

package/dist/components/button-group/button-group.js

@@ -1,6 +1,7 @@
 import { classes } from "../_internal/classes.js";
 import { jsx } from "@askrjs/askr/jsx-runtime";
 //#region src/components/button-group/button-group.tsx
+/** Groups related buttons together, optionally visually attached, with a horizontal or vertical orientation and `role="group"` by default. */
 function ButtonGroup(props) {
 	const { attached = true, children, class: className, orientation = "horizontal", ref, role, ...rest } = props;
 	return /* @__PURE__ */ jsx("div", {

package/dist/components/button-group/button-group.js.map

@@ -1 +1 @@
-{"version":3,"file":"button-group.js","names":[],"sources":["../../../src/components/button-group/button-group.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { classes } from \"../_internal/classes\";\nimport { ButtonGroupProps } from \"./button-group.types\";\n\nexport function ButtonGroup(props: ButtonGroupProps): JSX.Element {\n  const {\n    attached = true,\n    children,\n    class: className,\n    orientation = \"horizontal\",\n    ref,\n    role,\n    ...rest\n  } = props;\n\n  return (\n    <div\n      {...rest}\n      ref={ref}\n      class={classes(\n        \"btn-group\",\n        orientation === \"vertical\" ? \"btn-group-vertical\" : undefined,\n        className,\n      )}\n      data-attached={attached ? \"true\" : \"false\"}\n      data-orientation={orientation}\n      data-slot=\"button-group\"\n      role={(role ?? \"group\") as string}\n    >\n      {children}\n    </div>\n  );\n}\n"],"mappings":";;;AAIA,SAAgB,YAAY,OAAsC;CAChE,MAAM,EACJ,WAAW,MACX,UACA,OAAO,WACP,cAAc,cACd,KACA,MACA,GAAG,SACD;CAEJ,OACE,oBAAC,OAAD;EACE,GAAI;EACC;EACL,OAAO,QACL,aACA,gBAAgB,aAAa,uBAAuB,KAAA,GACpD,SACF;EACA,iBAAe,WAAW,SAAS;EACnC,oBAAkB;EAClB,aAAU;EACV,MAAO,QAAQ;EAEd;CACE,CAAA;AAET"}
+{"version":3,"file":"button-group.js","names":[],"sources":["../../../src/components/button-group/button-group.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { classes } from \"../_internal/classes\";\nimport { ButtonGroupProps } from \"./button-group.types\";\n\n/** Groups related buttons together, optionally visually attached, with a horizontal or vertical orientation and `role=\"group\"` by default. */\nexport function ButtonGroup(props: ButtonGroupProps): JSX.Element {\n  const {\n    attached = true,\n    children,\n    class: className,\n    orientation = \"horizontal\",\n    ref,\n    role,\n    ...rest\n  } = props;\n\n  return (\n    <div\n      {...rest}\n      ref={ref}\n      class={classes(\n        \"btn-group\",\n        orientation === \"vertical\" ? \"btn-group-vertical\" : undefined,\n        className,\n      )}\n      data-attached={attached ? \"true\" : \"false\"}\n      data-orientation={orientation}\n      data-slot=\"button-group\"\n      role={(role ?? \"group\") as string}\n    >\n      {children}\n    </div>\n  );\n}\n"],"mappings":";;;;AAKA,SAAgB,YAAY,OAAsC;CAChE,MAAM,EACJ,WAAW,MACX,UACA,OAAO,WACP,cAAc,cACd,KACA,MACA,GAAG,SACD;CAEJ,OACE,oBAAC,OAAD;EACE,GAAI;EACC;EACL,OAAO,QACL,aACA,gBAAgB,aAAa,uBAAuB,KAAA,GACpD,SACF;EACA,iBAAe,WAAW,SAAS;EACnC,oBAAkB;EAClB,aAAU;EACV,MAAO,QAAQ;EAEd;CACE,CAAA;AAET"}

package/dist/components/button-group/button-group.types.d.ts

@@ -1,8 +1,10 @@
 import { JSX } from "@askrjs/askr/jsx-runtime";
 import { Ref } from "@askrjs/askr/foundations/utilities";
 //#region src/components/button-group/button-group.types.d.ts
+/** Layout direction of a {@link ButtonGroup}. */
 type ButtonGroupOrientation = "horizontal" | "vertical";
 type DivProps = Omit<JSX.IntrinsicElements["div"], "children" | "ref">;
+/** Props for the {@link ButtonGroup} component. */
 type ButtonGroupProps = DivProps & {
   children?: unknown;
   attached?: boolean;

package/dist/components/card/card.d.ts

@@ -1,12 +1,19 @@
 import { CardActionProps, CardContentProps, CardDescriptionProps, CardFooterProps, CardHeaderProps, CardProps, CardTitleProps } from "./card.types.js";
 import { JSX } from "@askrjs/askr/jsx-runtime";
 //#region src/components/card/card.d.ts
+/** Root card container; applies the `card` class and an optional `variant` modifier. */
 declare function Card(props: CardProps): JSX.Element;
+/** Renders the header region of a {@link Card}. */
 declare function CardHeader(props: CardHeaderProps): JSX.Element;
+/** Renders a {@link Card}'s title, defaulting to an `<h3>` (override with `titleAs`). */
 declare function CardTitle(props: CardTitleProps): JSX.Element;
+/** Renders a {@link Card}'s supporting description text. */
 declare function CardDescription(props: CardDescriptionProps): JSX.Element;
+/** Renders the main content region of a {@link Card}. */
 declare function CardContent(props: CardContentProps): JSX.Element;
+/** Renders the footer region of a {@link Card}. */
 declare function CardFooter(props: CardFooterProps): JSX.Element;
+/** Renders an action/control region of a {@link Card}, typically positioned alongside the header. */
 declare function CardAction(props: CardActionProps): JSX.Element;
 //#endregion
 export { Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle };

package/dist/components/card/card.js

@@ -5,6 +5,7 @@ import { jsx } from "@askrjs/askr/jsx-runtime";
 function normalizeVariant(variant) {
 	return variant && variant !== "default" ? variant : void 0;
 }
+/** Root card container; applies the `card` class and an optional `variant` modifier. */
 function Card(props) {
 	const { children, class: className, variant, ref, ...rest } = props;
 	const normalizedVariant = normalizeVariant(variant);
@@ -19,6 +20,7 @@ function Card(props) {
 		children
 	});
 }
+/** Renders the header region of a {@link Card}. */
 function CardHeader(props) {
 	const { children, class: className, ref, ...rest } = props;
 	const finalProps = mergeProps(rest, {
@@ -31,6 +33,7 @@ function CardHeader(props) {
 		children
 	});
 }
+/** Renders a {@link Card}'s title, defaulting to an `<h3>` (override with `titleAs`). */
 function CardTitle(props) {
 	const { children, class: className, ref, titleAs: TitleTag = "h3", ...rest } = props;
 	const finalProps = mergeProps(rest, {
@@ -43,6 +46,7 @@ function CardTitle(props) {
 		children
 	});
 }
+/** Renders a {@link Card}'s supporting description text. */
 function CardDescription(props) {
 	const { children, class: className, ref, ...rest } = props;
 	const finalProps = mergeProps(rest, {
@@ -55,6 +59,7 @@ function CardDescription(props) {
 		children
 	});
 }
+/** Renders the main content region of a {@link Card}. */
 function CardContent(props) {
 	const { children, class: className, ref, ...rest } = props;
 	const finalProps = mergeProps(rest, {
@@ -67,6 +72,7 @@ function CardContent(props) {
 		children
 	});
 }
+/** Renders the footer region of a {@link Card}. */
 function CardFooter(props) {
 	const { children, class: className, ref, ...rest } = props;
 	const finalProps = mergeProps(rest, {
@@ -79,6 +85,7 @@ function CardFooter(props) {
 		children
 	});
 }
+/** Renders an action/control region of a {@link Card}, typically positioned alongside the header. */
 function CardAction(props) {
 	const { children, class: className, ref, ...rest } = props;
 	const finalProps = mergeProps(rest, {

package/dist/components/card/card.js.map

@@ -1 +1 @@
-{"version":3,"file":"card.js","names":[],"sources":["../../../src/components/card/card.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { classes } from \"../_internal/classes\";\nimport { mergeProps } from \"../_internal/merge-props\";\nimport type {\n  CardActionProps,\n  CardContentProps,\n  CardDescriptionProps,\n  CardFooterProps,\n  CardHeaderProps,\n  CardProps,\n  CardTitleProps,\n  CardVariant,\n} from \"./card.types\";\n\nfunction normalizeVariant(variant: CardVariant | undefined) {\n  return variant && variant !== \"default\" ? variant : undefined;\n}\n\nexport function Card(props: CardProps): JSX.Element {\n  const { children, class: className, variant, ref, ...rest } = props;\n  const normalizedVariant = normalizeVariant(variant);\n\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"card\", normalizedVariant && `card-${normalizedVariant}`, className),\n    \"data-slot\": \"card\",\n    \"data-variant\": normalizedVariant,\n  });\n\n  return <div {...finalProps}>{children}</div>;\n}\n\nexport function CardHeader(props: CardHeaderProps): JSX.Element {\n  const { children, class: className, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"card-header\", className),\n    \"data-slot\": \"card-header\",\n  });\n\n  return <div {...finalProps}>{children}</div>;\n}\n\nexport function CardTitle(props: CardTitleProps): JSX.Element {\n  const { children, class: className, ref, titleAs: TitleTag = \"h3\", ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"card-title\", className),\n    \"data-slot\": \"card-title\",\n  });\n\n  return <TitleTag {...finalProps}>{children}</TitleTag>;\n}\n\nexport function CardDescription(props: CardDescriptionProps): JSX.Element {\n  const { children, class: className, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"card-description\", className),\n    \"data-slot\": \"card-description\",\n  });\n\n  return <p {...finalProps}>{children}</p>;\n}\n\nexport function CardContent(props: CardContentProps): JSX.Element {\n  const { children, class: className, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"card-content\", className),\n    \"data-slot\": \"card-content\",\n  });\n\n  return <div {...finalProps}>{children}</div>;\n}\n\nexport function CardFooter(props: CardFooterProps): JSX.Element {\n  const { children, class: className, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"card-footer\", className),\n    \"data-slot\": \"card-footer\",\n  });\n\n  return <div {...finalProps}>{children}</div>;\n}\n\nexport function CardAction(props: CardActionProps): JSX.Element {\n  const { children, class: className, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"card-action\", className),\n    \"data-slot\": \"card-action\",\n  });\n\n  return <div {...finalProps}>{children}</div>;\n}\n"],"mappings":";;;;AAcA,SAAS,iBAAiB,SAAkC;CAC1D,OAAO,WAAW,YAAY,YAAY,UAAU,KAAA;AACtD;AAEA,SAAgB,KAAK,OAA+B;CAClD,MAAM,EAAE,UAAU,OAAO,WAAW,SAAS,KAAK,GAAG,SAAS;CAC9D,MAAM,oBAAoB,iBAAiB,OAAO;CAElD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,QAAQ,qBAAqB,QAAQ,qBAAqB,SAAS;EAClF,aAAa;EACb,gBAAgB;CAClB,CAAC;CAED,OAAO,oBAAC,OAAD;EAAK,GAAI;EAAa;CAAc,CAAA;AAC7C;AAEA,SAAgB,WAAW,OAAqC;CAC9D,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,eAAe,SAAS;EACvC,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,OAAD;EAAK,GAAI;EAAa;CAAc,CAAA;AAC7C;AAEA,SAAgB,UAAU,OAAoC;CAC5D,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,SAAS,WAAW,MAAM,GAAG,SAAS;CAC/E,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,cAAc,SAAS;EACtC,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,UAAD;EAAU,GAAI;EAAa;CAAmB,CAAA;AACvD;AAEA,SAAgB,gBAAgB,OAA0C;CACxE,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,oBAAoB,SAAS;EAC5C,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,KAAD;EAAG,GAAI;EAAa;CAAY,CAAA;AACzC;AAEA,SAAgB,YAAY,OAAsC;CAChE,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,gBAAgB,SAAS;EACxC,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,OAAD;EAAK,GAAI;EAAa;CAAc,CAAA;AAC7C;AAEA,SAAgB,WAAW,OAAqC;CAC9D,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,eAAe,SAAS;EACvC,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,OAAD;EAAK,GAAI;EAAa;CAAc,CAAA;AAC7C;AAEA,SAAgB,WAAW,OAAqC;CAC9D,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,eAAe,SAAS;EACvC,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,OAAD;EAAK,GAAI;EAAa;CAAc,CAAA;AAC7C"}
+{"version":3,"file":"card.js","names":[],"sources":["../../../src/components/card/card.tsx"],"sourcesContent":["import type { JSX } from \"@askrjs/askr/jsx-runtime\";\nimport { classes } from \"../_internal/classes\";\nimport { mergeProps } from \"../_internal/merge-props\";\nimport type {\n  CardActionProps,\n  CardContentProps,\n  CardDescriptionProps,\n  CardFooterProps,\n  CardHeaderProps,\n  CardProps,\n  CardTitleProps,\n  CardVariant,\n} from \"./card.types\";\n\nfunction normalizeVariant(variant: CardVariant | undefined) {\n  return variant && variant !== \"default\" ? variant : undefined;\n}\n\n/** Root card container; applies the `card` class and an optional `variant` modifier. */\nexport function Card(props: CardProps): JSX.Element {\n  const { children, class: className, variant, ref, ...rest } = props;\n  const normalizedVariant = normalizeVariant(variant);\n\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"card\", normalizedVariant && `card-${normalizedVariant}`, className),\n    \"data-slot\": \"card\",\n    \"data-variant\": normalizedVariant,\n  });\n\n  return <div {...finalProps}>{children}</div>;\n}\n\n/** Renders the header region of a {@link Card}. */\nexport function CardHeader(props: CardHeaderProps): JSX.Element {\n  const { children, class: className, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"card-header\", className),\n    \"data-slot\": \"card-header\",\n  });\n\n  return <div {...finalProps}>{children}</div>;\n}\n\n/** Renders a {@link Card}'s title, defaulting to an `<h3>` (override with `titleAs`). */\nexport function CardTitle(props: CardTitleProps): JSX.Element {\n  const { children, class: className, ref, titleAs: TitleTag = \"h3\", ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"card-title\", className),\n    \"data-slot\": \"card-title\",\n  });\n\n  return <TitleTag {...finalProps}>{children}</TitleTag>;\n}\n\n/** Renders a {@link Card}'s supporting description text. */\nexport function CardDescription(props: CardDescriptionProps): JSX.Element {\n  const { children, class: className, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"card-description\", className),\n    \"data-slot\": \"card-description\",\n  });\n\n  return <p {...finalProps}>{children}</p>;\n}\n\n/** Renders the main content region of a {@link Card}. */\nexport function CardContent(props: CardContentProps): JSX.Element {\n  const { children, class: className, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"card-content\", className),\n    \"data-slot\": \"card-content\",\n  });\n\n  return <div {...finalProps}>{children}</div>;\n}\n\n/** Renders the footer region of a {@link Card}. */\nexport function CardFooter(props: CardFooterProps): JSX.Element {\n  const { children, class: className, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"card-footer\", className),\n    \"data-slot\": \"card-footer\",\n  });\n\n  return <div {...finalProps}>{children}</div>;\n}\n\n/** Renders an action/control region of a {@link Card}, typically positioned alongside the header. */\nexport function CardAction(props: CardActionProps): JSX.Element {\n  const { children, class: className, ref, ...rest } = props;\n  const finalProps = mergeProps(rest, {\n    ref,\n    class: classes(\"card-action\", className),\n    \"data-slot\": \"card-action\",\n  });\n\n  return <div {...finalProps}>{children}</div>;\n}\n"],"mappings":";;;;AAcA,SAAS,iBAAiB,SAAkC;CAC1D,OAAO,WAAW,YAAY,YAAY,UAAU,KAAA;AACtD;;AAGA,SAAgB,KAAK,OAA+B;CAClD,MAAM,EAAE,UAAU,OAAO,WAAW,SAAS,KAAK,GAAG,SAAS;CAC9D,MAAM,oBAAoB,iBAAiB,OAAO;CAElD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,QAAQ,qBAAqB,QAAQ,qBAAqB,SAAS;EAClF,aAAa;EACb,gBAAgB;CAClB,CAAC;CAED,OAAO,oBAAC,OAAD;EAAK,GAAI;EAAa;CAAc,CAAA;AAC7C;;AAGA,SAAgB,WAAW,OAAqC;CAC9D,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,eAAe,SAAS;EACvC,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,OAAD;EAAK,GAAI;EAAa;CAAc,CAAA;AAC7C;;AAGA,SAAgB,UAAU,OAAoC;CAC5D,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,SAAS,WAAW,MAAM,GAAG,SAAS;CAC/E,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,cAAc,SAAS;EACtC,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,UAAD;EAAU,GAAI;EAAa;CAAmB,CAAA;AACvD;;AAGA,SAAgB,gBAAgB,OAA0C;CACxE,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,oBAAoB,SAAS;EAC5C,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,KAAD;EAAG,GAAI;EAAa;CAAY,CAAA;AACzC;;AAGA,SAAgB,YAAY,OAAsC;CAChE,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,gBAAgB,SAAS;EACxC,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,OAAD;EAAK,GAAI;EAAa;CAAc,CAAA;AAC7C;;AAGA,SAAgB,WAAW,OAAqC;CAC9D,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,eAAe,SAAS;EACvC,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,OAAD;EAAK,GAAI;EAAa;CAAc,CAAA;AAC7C;;AAGA,SAAgB,WAAW,OAAqC;CAC9D,MAAM,EAAE,UAAU,OAAO,WAAW,KAAK,GAAG,SAAS;CACrD,MAAM,aAAa,WAAW,MAAM;EAClC;EACA,OAAO,QAAQ,eAAe,SAAS;EACvC,aAAa;CACf,CAAC;CAED,OAAO,oBAAC,OAAD;EAAK,GAAI;EAAa;CAAc,CAAA;AAC7C"}