@aviala-design/spiral 2.9.0 → 3.0.0

package/dist/chunk-CXGFGGGI.cjs

@@ -0,0 +1,174 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }"use client";
+
+// src/lib/utils.ts
+var _clsx = require('clsx');
+var _tailwindmerge = require('tailwind-merge');
+function cn(...inputs) {
+  return _tailwindmerge.twMerge.call(void 0, _clsx.clsx.call(void 0, inputs));
+}
+
+// src/components/form-field-context.ts
+var _react = require('react');
+var FormFieldControlContext = _react.createContext.call(void 0, null);
+function useResolvedControlError(errorProp) {
+  const ctx = _react.useContext.call(void 0, FormFieldControlContext);
+  return _nullishCoalesce(_nullishCoalesce(errorProp, () => ( _optionalChain([ctx, 'optionalAccess', _ => _.invalid]))), () => ( false));
+}
+
+// src/components/typography.tsx
+var _reactslot = require('@radix-ui/react-slot');
+var _classvarianceauthority = require('class-variance-authority');
+
+var _jsxruntime = require('react/jsx-runtime');
+var typographyVariants = _classvarianceauthority.cva.call(void 0, "aviala-typography", {
+  variants: {
+    level: {
+      display: "aviala-typography--display",
+      headline1: "aviala-typography--headline1",
+      headline2: "aviala-typography--headline2",
+      title: "aviala-typography--title",
+      subtitle: "aviala-typography--subtitle",
+      text: "aviala-typography--text",
+      caption: "aviala-typography--caption"
+    }
+  },
+  defaultVariants: {
+    level: "text"
+  }
+});
+var Typography = _react.forwardRef.call(void 0, 
+  ({
+    className,
+    level = "text",
+    content = "text",
+    tone = "default",
+    as: Tag = "span",
+    asChild = false,
+    ...props
+  }, ref) => {
+    const hostProps = {
+      ...props,
+      ref,
+      className: cn(typographyVariants({ level }), className),
+      "data-content": content,
+      "data-tone": tone === "white" ? "white" : void 0
+    };
+    if (asChild) return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _reactslot.Slot, { ...hostProps });
+    return _react.createElement.call(void 0, Tag, hostProps);
+  }
+);
+Typography.displayName = "Typography";
+
+// src/components/typeface.tsx
+
+
+var typefaceLayouts = {
+  allCustom: [
+    { level: "text", children: null },
+    { level: "caption", children: null }
+  ],
+  textCaption: [
+    { level: "text", children: null },
+    { level: "caption", children: null }
+  ],
+  textCaptionSubtitle: [
+    { level: "subtitle", children: null },
+    { level: "text", children: null },
+    { level: "caption", children: null }
+  ],
+  textTitle: [
+    { level: "title", children: null },
+    { level: "text", children: null }
+  ],
+  textHeadline2: [
+    { level: "headline2", children: null },
+    { level: "text", children: null }
+  ],
+  textHeadline1: [
+    { level: "headline1", children: null },
+    { level: "text", children: null }
+  ]
+};
+var Typeface = _react.forwardRef.call(void 0, 
+  ({
+    className,
+    content = "allCustom",
+    primary,
+    secondary,
+    tertiary,
+    primaryContent = "text",
+    secondaryContent = "text",
+    tertiaryContent = "text",
+    tone = "default",
+    children,
+    ...props
+  }, ref) => {
+    const layout = typefaceLayouts[content];
+    const values = resolveTypefaceValues(
+      primary,
+      secondary,
+      tertiary,
+      children
+    );
+    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+      "div",
+      {
+        ref,
+        className: cn("aviala-typeface", className),
+        "data-content": content,
+        ...props,
+        children: layout.map((line, index) => {
+          const value = values[index];
+          if (value === void 0 || value === null || value === false)
+            return null;
+          const lineContent = index === 0 ? primaryContent : index === 1 ? secondaryContent : tertiaryContent;
+          return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+            "span",
+            {
+              className: "aviala-typeface__line",
+              children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, Typography, { level: line.level, content: lineContent, tone, children: value })
+            },
+            `${line.level}-${index}`
+          );
+        })
+      }
+    );
+  }
+);
+Typeface.displayName = "Typeface";
+function resolveTypefaceValues(primary, secondary, tertiary, children) {
+  if (primary !== void 0 || secondary !== void 0 || tertiary !== void 0) {
+    return [primary, secondary, tertiary];
+  }
+  if (children == null || children === false) {
+    return [];
+  }
+  if (Array.isArray(children)) {
+    return children;
+  }
+  return [children];
+}
+var TypefacePair = _react.forwardRef.call(void 0, 
+  ({ title, description, ...props }, ref) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+    Typeface,
+    {
+      ref,
+      content: "textCaption",
+      primary: title,
+      secondary: description,
+      ...props
+    }
+  )
+);
+TypefacePair.displayName = "TypefacePair";
+
+
+
+
+
+
+
+
+
+exports.cn = cn; exports.FormFieldControlContext = FormFieldControlContext; exports.useResolvedControlError = useResolvedControlError; exports.typographyVariants = typographyVariants; exports.Typography = Typography; exports.Typeface = Typeface; exports.TypefacePair = TypefacePair;
+//# sourceMappingURL=chunk-CXGFGGGI.cjs.map

package/dist/chunk-CXGFGGGI.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/spiral-2/spiral-2/packages/ui/dist/chunk-CXGFGGGI.cjs","../src/lib/utils.ts","../src/components/form-field-context.ts","../src/components/typography.tsx","../src/components/typeface.tsx"],"names":["forwardRef","jsx"],"mappings":"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","file":"/home/runner/work/spiral-2/spiral-2/packages/ui/dist/chunk-CXGFGGGI.cjs","sourcesContent":[null,"import { type ClassValue, clsx } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs));\n}\n","import { createContext, useContext } from \"react\";\n\n/**\n * Kept free of `react-hook-form` imports so the controls that consume it\n * (Input, Textarea, Select, …) stay usable from the main entry without the\n * peer dependency installed. The RHF-aware pieces live in `form-field.tsx`,\n * which is only reachable through `@aviala-design/spiral/form`.\n */\ntype FormFieldControlContextValue = {\n  /** True when FormField is showing an error tip (layout `error` or RHF message). */\n  invalid: boolean;\n};\n\nexport const FormFieldControlContext =\n  createContext<FormFieldControlContextValue | null>(null);\n\n/**\n * Resolve a control `error` prop against the surrounding FormField.\n * Explicit `error={true|false}` wins; otherwise inherits FormField tip invalidity.\n */\nexport function useResolvedControlError(errorProp?: boolean): boolean {\n  const ctx = useContext(FormFieldControlContext);\n  return errorProp ?? ctx?.invalid ?? false;\n}\n","import { Slot } from \"@radix-ui/react-slot\";\nimport { cva, type VariantProps } from \"class-variance-authority\";\nimport { createElement, forwardRef, type HTMLAttributes } from \"react\";\nimport { cn } from \"../lib/utils\";\n\n/** Figma Components → System Composition → Typography (128:85) */\nexport type TypographyLevel =\n  | \"display\"\n  | \"headline1\"\n  | \"headline2\"\n  | \"title\"\n  | \"subtitle\"\n  | \"text\"\n  | \"caption\";\n\nexport type TypographyContent = \"text\" | \"number\";\nexport type TypographyTone = \"default\" | \"white\";\n\nexport const typographyVariants = cva(\"aviala-typography\", {\n  variants: {\n    level: {\n      display: \"aviala-typography--display\",\n      headline1: \"aviala-typography--headline1\",\n      headline2: \"aviala-typography--headline2\",\n      title: \"aviala-typography--title\",\n      subtitle: \"aviala-typography--subtitle\",\n      text: \"aviala-typography--text\",\n      caption: \"aviala-typography--caption\",\n    },\n  },\n  defaultVariants: {\n    level: \"text\",\n  },\n});\n\nexport type TypographyProps = HTMLAttributes<HTMLElement> &\n  VariantProps<typeof typographyVariants> & {\n    /** Figma `Content` — text vs numeric styling */\n    content?: TypographyContent;\n    /** Figma `White` — light text on dark surfaces */\n    tone?: TypographyTone;\n    asChild?: boolean;\n    as?:\n      \"p\" | \"span\" | \"div\" | \"h1\" | \"h2\" | \"h3\" | \"h4\" | \"h5\" | \"h6\" | \"label\";\n  };\n\nexport const Typography = forwardRef<HTMLSpanElement, TypographyProps>(\n  (\n    {\n      className,\n      level = \"text\",\n      content = \"text\",\n      tone = \"default\",\n      as: Tag = \"span\",\n      asChild = false,\n      ...props\n    },\n    ref\n  ) => {\n    const hostProps = {\n      ...props,\n      ref,\n      className: cn(typographyVariants({ level }), className),\n      \"data-content\": content,\n      \"data-tone\": tone === \"white\" ? \"white\" : undefined,\n    };\n\n    if (asChild) return <Slot {...hostProps} />;\n\n    // JSX resolves a union `as` tag to the intersection of every member's props,\n    // which no single element ref can satisfy. createElement keeps the ref typed\n    // as HTMLElement.\n    return createElement(Tag, hostProps);\n  }\n);\nTypography.displayName = \"Typography\";\n","import { forwardRef, type HTMLAttributes, type ReactNode } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport {\n  Typography,\n  type TypographyContent,\n  type TypographyLevel,\n  type TypographyTone,\n} from \"./typography\";\n\n/** Figma Components → System Composition → Typeface (527:56311) */\nexport type TypefaceContent =\n  | \"allCustom\"\n  | \"textCaption\"\n  | \"textCaptionSubtitle\"\n  | \"textTitle\"\n  | \"textHeadline2\"\n  | \"textHeadline1\";\n\ntype TypefaceLine = {\n  level: TypographyLevel;\n  content?: TypographyContent;\n  tone?: TypographyTone;\n  children: ReactNode;\n};\n\nconst typefaceLayouts: Record<TypefaceContent, TypefaceLine[]> = {\n  allCustom: [\n    { level: \"text\", children: null },\n    { level: \"caption\", children: null },\n  ],\n  textCaption: [\n    { level: \"text\", children: null },\n    { level: \"caption\", children: null },\n  ],\n  textCaptionSubtitle: [\n    { level: \"subtitle\", children: null },\n    { level: \"text\", children: null },\n    { level: \"caption\", children: null },\n  ],\n  textTitle: [\n    { level: \"title\", children: null },\n    { level: \"text\", children: null },\n  ],\n  textHeadline2: [\n    { level: \"headline2\", children: null },\n    { level: \"text\", children: null },\n  ],\n  textHeadline1: [\n    { level: \"headline1\", children: null },\n    { level: \"text\", children: null },\n  ],\n};\n\nexport type TypefaceProps = Omit<HTMLAttributes<HTMLDivElement>, \"content\"> & {\n  /** Figma `Content` preset */\n  content?: TypefaceContent;\n  /** Primary line — overrides preset first line */\n  primary?: ReactNode;\n  /** Secondary line — overrides preset second line */\n  secondary?: ReactNode;\n  /** Tertiary line — used by `textCaptionSubtitle` */\n  tertiary?: ReactNode;\n  /** Per-line content mode for numeric text */\n  primaryContent?: TypographyContent;\n  secondaryContent?: TypographyContent;\n  tertiaryContent?: TypographyContent;\n  tone?: TypographyTone;\n};\n\nexport const Typeface = forwardRef<HTMLDivElement, TypefaceProps>(\n  (\n    {\n      className,\n      content = \"allCustom\",\n      primary,\n      secondary,\n      tertiary,\n      primaryContent = \"text\",\n      secondaryContent = \"text\",\n      tertiaryContent = \"text\",\n      tone = \"default\",\n      children,\n      ...props\n    },\n    ref\n  ) => {\n    const layout = typefaceLayouts[content];\n    const values = resolveTypefaceValues(\n      primary,\n      secondary,\n      tertiary,\n      children\n    );\n\n    return (\n      <div\n        ref={ref}\n        className={cn(\"aviala-typeface\", className)}\n        data-content={content}\n        {...props}\n      >\n        {layout.map((line, index) => {\n          const value = values[index];\n          if (value === undefined || value === null || value === false)\n            return null;\n\n          const lineContent =\n            index === 0\n              ? primaryContent\n              : index === 1\n                ? secondaryContent\n                : tertiaryContent;\n\n          return (\n            <span\n              key={`${line.level}-${index}`}\n              className=\"aviala-typeface__line\"\n            >\n              <Typography level={line.level} content={lineContent} tone={tone}>\n                {value}\n              </Typography>\n            </span>\n          );\n        })}\n      </div>\n    );\n  }\n);\nTypeface.displayName = \"Typeface\";\n\nfunction resolveTypefaceValues(\n  primary?: ReactNode,\n  secondary?: ReactNode,\n  tertiary?: ReactNode,\n  children?: ReactNode\n): ReactNode[] {\n  if (\n    primary !== undefined ||\n    secondary !== undefined ||\n    tertiary !== undefined\n  ) {\n    return [primary, secondary, tertiary];\n  }\n\n  if (children == null || children === false) {\n    return [];\n  }\n\n  if (Array.isArray(children)) {\n    return children;\n  }\n\n  return [children];\n}\n\n/** Convenience helper for two-line label + caption pairs (Radio, Checkbox, etc.) */\nexport type TypefacePairProps = Omit<TypefaceProps, \"content\"> & {\n  title: ReactNode;\n  description?: ReactNode;\n};\n\nexport const TypefacePair = forwardRef<HTMLDivElement, TypefacePairProps>(\n  ({ title, description, ...props }, ref) => (\n    <Typeface\n      ref={ref}\n      content=\"textCaption\"\n      primary={title}\n      secondary={description}\n      {...props}\n    />\n  )\n);\nTypefacePair.displayName = \"TypefacePair\";\n"]}

package/dist/chunk-XVABQUTX.js

@@ -0,0 +1,174 @@
+"use client";
+
+// src/lib/utils.ts
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
+
+// src/components/form-field-context.ts
+import { createContext, useContext } from "react";
+var FormFieldControlContext = createContext(null);
+function useResolvedControlError(errorProp) {
+  const ctx = useContext(FormFieldControlContext);
+  return errorProp ?? ctx?.invalid ?? false;
+}
+
+// src/components/typography.tsx
+import { Slot } from "@radix-ui/react-slot";
+import { cva } from "class-variance-authority";
+import { createElement, forwardRef } from "react";
+import { jsx } from "react/jsx-runtime";
+var typographyVariants = cva("aviala-typography", {
+  variants: {
+    level: {
+      display: "aviala-typography--display",
+      headline1: "aviala-typography--headline1",
+      headline2: "aviala-typography--headline2",
+      title: "aviala-typography--title",
+      subtitle: "aviala-typography--subtitle",
+      text: "aviala-typography--text",
+      caption: "aviala-typography--caption"
+    }
+  },
+  defaultVariants: {
+    level: "text"
+  }
+});
+var Typography = forwardRef(
+  ({
+    className,
+    level = "text",
+    content = "text",
+    tone = "default",
+    as: Tag = "span",
+    asChild = false,
+    ...props
+  }, ref) => {
+    const hostProps = {
+      ...props,
+      ref,
+      className: cn(typographyVariants({ level }), className),
+      "data-content": content,
+      "data-tone": tone === "white" ? "white" : void 0
+    };
+    if (asChild) return /* @__PURE__ */ jsx(Slot, { ...hostProps });
+    return createElement(Tag, hostProps);
+  }
+);
+Typography.displayName = "Typography";
+
+// src/components/typeface.tsx
+import { forwardRef as forwardRef2 } from "react";
+import { jsx as jsx2 } from "react/jsx-runtime";
+var typefaceLayouts = {
+  allCustom: [
+    { level: "text", children: null },
+    { level: "caption", children: null }
+  ],
+  textCaption: [
+    { level: "text", children: null },
+    { level: "caption", children: null }
+  ],
+  textCaptionSubtitle: [
+    { level: "subtitle", children: null },
+    { level: "text", children: null },
+    { level: "caption", children: null }
+  ],
+  textTitle: [
+    { level: "title", children: null },
+    { level: "text", children: null }
+  ],
+  textHeadline2: [
+    { level: "headline2", children: null },
+    { level: "text", children: null }
+  ],
+  textHeadline1: [
+    { level: "headline1", children: null },
+    { level: "text", children: null }
+  ]
+};
+var Typeface = forwardRef2(
+  ({
+    className,
+    content = "allCustom",
+    primary,
+    secondary,
+    tertiary,
+    primaryContent = "text",
+    secondaryContent = "text",
+    tertiaryContent = "text",
+    tone = "default",
+    children,
+    ...props
+  }, ref) => {
+    const layout = typefaceLayouts[content];
+    const values = resolveTypefaceValues(
+      primary,
+      secondary,
+      tertiary,
+      children
+    );
+    return /* @__PURE__ */ jsx2(
+      "div",
+      {
+        ref,
+        className: cn("aviala-typeface", className),
+        "data-content": content,
+        ...props,
+        children: layout.map((line, index) => {
+          const value = values[index];
+          if (value === void 0 || value === null || value === false)
+            return null;
+          const lineContent = index === 0 ? primaryContent : index === 1 ? secondaryContent : tertiaryContent;
+          return /* @__PURE__ */ jsx2(
+            "span",
+            {
+              className: "aviala-typeface__line",
+              children: /* @__PURE__ */ jsx2(Typography, { level: line.level, content: lineContent, tone, children: value })
+            },
+            `${line.level}-${index}`
+          );
+        })
+      }
+    );
+  }
+);
+Typeface.displayName = "Typeface";
+function resolveTypefaceValues(primary, secondary, tertiary, children) {
+  if (primary !== void 0 || secondary !== void 0 || tertiary !== void 0) {
+    return [primary, secondary, tertiary];
+  }
+  if (children == null || children === false) {
+    return [];
+  }
+  if (Array.isArray(children)) {
+    return children;
+  }
+  return [children];
+}
+var TypefacePair = forwardRef2(
+  ({ title, description, ...props }, ref) => /* @__PURE__ */ jsx2(
+    Typeface,
+    {
+      ref,
+      content: "textCaption",
+      primary: title,
+      secondary: description,
+      ...props
+    }
+  )
+);
+TypefacePair.displayName = "TypefacePair";
+
+export {
+  cn,
+  FormFieldControlContext,
+  useResolvedControlError,
+  typographyVariants,
+  Typography,
+  Typeface,
+  TypefacePair
+};
+//# sourceMappingURL=chunk-XVABQUTX.js.map

package/dist/chunk-XVABQUTX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/utils.ts","../src/components/form-field-context.ts","../src/components/typography.tsx","../src/components/typeface.tsx"],"sourcesContent":["import { type ClassValue, clsx } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs));\n}\n","import { createContext, useContext } from \"react\";\n\n/**\n * Kept free of `react-hook-form` imports so the controls that consume it\n * (Input, Textarea, Select, …) stay usable from the main entry without the\n * peer dependency installed. The RHF-aware pieces live in `form-field.tsx`,\n * which is only reachable through `@aviala-design/spiral/form`.\n */\ntype FormFieldControlContextValue = {\n  /** True when FormField is showing an error tip (layout `error` or RHF message). */\n  invalid: boolean;\n};\n\nexport const FormFieldControlContext =\n  createContext<FormFieldControlContextValue | null>(null);\n\n/**\n * Resolve a control `error` prop against the surrounding FormField.\n * Explicit `error={true|false}` wins; otherwise inherits FormField tip invalidity.\n */\nexport function useResolvedControlError(errorProp?: boolean): boolean {\n  const ctx = useContext(FormFieldControlContext);\n  return errorProp ?? ctx?.invalid ?? false;\n}\n","import { Slot } from \"@radix-ui/react-slot\";\nimport { cva, type VariantProps } from \"class-variance-authority\";\nimport { createElement, forwardRef, type HTMLAttributes } from \"react\";\nimport { cn } from \"../lib/utils\";\n\n/** Figma Components → System Composition → Typography (128:85) */\nexport type TypographyLevel =\n  | \"display\"\n  | \"headline1\"\n  | \"headline2\"\n  | \"title\"\n  | \"subtitle\"\n  | \"text\"\n  | \"caption\";\n\nexport type TypographyContent = \"text\" | \"number\";\nexport type TypographyTone = \"default\" | \"white\";\n\nexport const typographyVariants = cva(\"aviala-typography\", {\n  variants: {\n    level: {\n      display: \"aviala-typography--display\",\n      headline1: \"aviala-typography--headline1\",\n      headline2: \"aviala-typography--headline2\",\n      title: \"aviala-typography--title\",\n      subtitle: \"aviala-typography--subtitle\",\n      text: \"aviala-typography--text\",\n      caption: \"aviala-typography--caption\",\n    },\n  },\n  defaultVariants: {\n    level: \"text\",\n  },\n});\n\nexport type TypographyProps = HTMLAttributes<HTMLElement> &\n  VariantProps<typeof typographyVariants> & {\n    /** Figma `Content` — text vs numeric styling */\n    content?: TypographyContent;\n    /** Figma `White` — light text on dark surfaces */\n    tone?: TypographyTone;\n    asChild?: boolean;\n    as?:\n      \"p\" | \"span\" | \"div\" | \"h1\" | \"h2\" | \"h3\" | \"h4\" | \"h5\" | \"h6\" | \"label\";\n  };\n\nexport const Typography = forwardRef<HTMLSpanElement, TypographyProps>(\n  (\n    {\n      className,\n      level = \"text\",\n      content = \"text\",\n      tone = \"default\",\n      as: Tag = \"span\",\n      asChild = false,\n      ...props\n    },\n    ref\n  ) => {\n    const hostProps = {\n      ...props,\n      ref,\n      className: cn(typographyVariants({ level }), className),\n      \"data-content\": content,\n      \"data-tone\": tone === \"white\" ? \"white\" : undefined,\n    };\n\n    if (asChild) return <Slot {...hostProps} />;\n\n    // JSX resolves a union `as` tag to the intersection of every member's props,\n    // which no single element ref can satisfy. createElement keeps the ref typed\n    // as HTMLElement.\n    return createElement(Tag, hostProps);\n  }\n);\nTypography.displayName = \"Typography\";\n","import { forwardRef, type HTMLAttributes, type ReactNode } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport {\n  Typography,\n  type TypographyContent,\n  type TypographyLevel,\n  type TypographyTone,\n} from \"./typography\";\n\n/** Figma Components → System Composition → Typeface (527:56311) */\nexport type TypefaceContent =\n  | \"allCustom\"\n  | \"textCaption\"\n  | \"textCaptionSubtitle\"\n  | \"textTitle\"\n  | \"textHeadline2\"\n  | \"textHeadline1\";\n\ntype TypefaceLine = {\n  level: TypographyLevel;\n  content?: TypographyContent;\n  tone?: TypographyTone;\n  children: ReactNode;\n};\n\nconst typefaceLayouts: Record<TypefaceContent, TypefaceLine[]> = {\n  allCustom: [\n    { level: \"text\", children: null },\n    { level: \"caption\", children: null },\n  ],\n  textCaption: [\n    { level: \"text\", children: null },\n    { level: \"caption\", children: null },\n  ],\n  textCaptionSubtitle: [\n    { level: \"subtitle\", children: null },\n    { level: \"text\", children: null },\n    { level: \"caption\", children: null },\n  ],\n  textTitle: [\n    { level: \"title\", children: null },\n    { level: \"text\", children: null },\n  ],\n  textHeadline2: [\n    { level: \"headline2\", children: null },\n    { level: \"text\", children: null },\n  ],\n  textHeadline1: [\n    { level: \"headline1\", children: null },\n    { level: \"text\", children: null },\n  ],\n};\n\nexport type TypefaceProps = Omit<HTMLAttributes<HTMLDivElement>, \"content\"> & {\n  /** Figma `Content` preset */\n  content?: TypefaceContent;\n  /** Primary line — overrides preset first line */\n  primary?: ReactNode;\n  /** Secondary line — overrides preset second line */\n  secondary?: ReactNode;\n  /** Tertiary line — used by `textCaptionSubtitle` */\n  tertiary?: ReactNode;\n  /** Per-line content mode for numeric text */\n  primaryContent?: TypographyContent;\n  secondaryContent?: TypographyContent;\n  tertiaryContent?: TypographyContent;\n  tone?: TypographyTone;\n};\n\nexport const Typeface = forwardRef<HTMLDivElement, TypefaceProps>(\n  (\n    {\n      className,\n      content = \"allCustom\",\n      primary,\n      secondary,\n      tertiary,\n      primaryContent = \"text\",\n      secondaryContent = \"text\",\n      tertiaryContent = \"text\",\n      tone = \"default\",\n      children,\n      ...props\n    },\n    ref\n  ) => {\n    const layout = typefaceLayouts[content];\n    const values = resolveTypefaceValues(\n      primary,\n      secondary,\n      tertiary,\n      children\n    );\n\n    return (\n      <div\n        ref={ref}\n        className={cn(\"aviala-typeface\", className)}\n        data-content={content}\n        {...props}\n      >\n        {layout.map((line, index) => {\n          const value = values[index];\n          if (value === undefined || value === null || value === false)\n            return null;\n\n          const lineContent =\n            index === 0\n              ? primaryContent\n              : index === 1\n                ? secondaryContent\n                : tertiaryContent;\n\n          return (\n            <span\n              key={`${line.level}-${index}`}\n              className=\"aviala-typeface__line\"\n            >\n              <Typography level={line.level} content={lineContent} tone={tone}>\n                {value}\n              </Typography>\n            </span>\n          );\n        })}\n      </div>\n    );\n  }\n);\nTypeface.displayName = \"Typeface\";\n\nfunction resolveTypefaceValues(\n  primary?: ReactNode,\n  secondary?: ReactNode,\n  tertiary?: ReactNode,\n  children?: ReactNode\n): ReactNode[] {\n  if (\n    primary !== undefined ||\n    secondary !== undefined ||\n    tertiary !== undefined\n  ) {\n    return [primary, secondary, tertiary];\n  }\n\n  if (children == null || children === false) {\n    return [];\n  }\n\n  if (Array.isArray(children)) {\n    return children;\n  }\n\n  return [children];\n}\n\n/** Convenience helper for two-line label + caption pairs (Radio, Checkbox, etc.) */\nexport type TypefacePairProps = Omit<TypefaceProps, \"content\"> & {\n  title: ReactNode;\n  description?: ReactNode;\n};\n\nexport const TypefacePair = forwardRef<HTMLDivElement, TypefacePairProps>(\n  ({ title, description, ...props }, ref) => (\n    <Typeface\n      ref={ref}\n      content=\"textCaption\"\n      primary={title}\n      secondary={description}\n      {...props}\n    />\n  )\n);\nTypefacePair.displayName = \"TypefacePair\";\n"],"mappings":"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","names":["forwardRef","jsx","forwardRef"]}

package/dist/component-changelogs.json

@@ -25,7 +25,30 @@
       }
     }
   ],
+  "Card": [
+    {
+      "version": "3.0.0",
+      "sections": {
+        "Removed": [
+          "`CardHead` / `CardBottom` `actionLabel` 的 `Text` 默认值；未传 `actionLabel` 且未传 `action` 时不再渲染主操作按钮"
+        ]
+      }
+    }
+  ],
   "CascaderField": [
+    {
+      "version": "3.0.0",
+      "sections": {
+        "Added": [
+          "`CascaderItem`：Up / Down 在同一列的选项之间移动焦点，Home / End 跳到该列首尾；`title` 行与禁用项自动跳过，跨列仍由展开方向键负责",
+          "`CascaderOptionsMenu` `groupTitle`：可选的列分组标题，透传给 `CascaderItemGroup` 的 `label`；默认不传即不渲染标题行"
+        ],
+        "Removed": [
+          "`CascaderOptionsMenu` 不再输出硬编码的 `Title` 分组标题",
+          "`CascaderItem` 开启 `showBadge` 但未传 `badge` 时不再回填 `Text` 占位 Badge"
+        ]
+      }
+    },
     {
       "version": "2.8.0",
       "sections": {
@@ -117,6 +140,15 @@
     }
   ],
   "DatePickerField": [
+    {
+      "version": "3.0.0",
+      "sections": {
+        "Fixed": [
+          "日历面板不再使用 `role=\"application\"`，改为 `role=\"group\"`，屏幕阅读器恢复常规浏览模式",
+          "日期网格补齐 `role=\"row\"` 行语义，配合已有的 `role=\"gridcell\"` 与方向键 / Home / End / PageUp / PageDown 导航"
+        ]
+      }
+    },
     {
       "version": "2.8.0",
       "sections": {
@@ -166,7 +198,31 @@
       }
     }
   ],
+  "Form": [
+    {
+      "version": "3.0.0",
+      "sections": {
+        "Changed": [
+          "**BREAKING** `Form` 与 `FormField` 移至子路径入口 `@aviala-design/spiral/form`，主入口不再导出它们。迁移方式：`import { Form, FormField } from \"@aviala-design/spiral/form\";`。",
+          "主入口 `@aviala-design/spiral` 不再引用 `react-hook-form`，未安装该 peer 的项目可以正常引入包内任意组件。",
+          "`react-hook-form` peer 区间保持 `>=7.50`，并标记为 `peerDependenciesMeta.optional`，仅使用 `/form` 入口时才需要安装。"
+        ],
+        "Added": [
+          "新增 `./form` 导出条件（`types` / `import` / `require`，并附 `development` 指向 `./src/form.ts`），与主入口保持一致的解析方式。"
+        ]
+      }
+    }
+  ],
   "FormField": [
+    {
+      "version": "3.0.0",
+      "sections": {
+        "Changed": [
+          "**BREAKING** `FormField` 从主入口移至 `@aviala-design/spiral/form`（layout 模式与 react-hook-form 模式均在此入口）。迁移方式：`import { FormField } from \"@aviala-design/spiral/form\";`。",
+          "`useResolvedControlError` 仍从主入口导出，Input / Textarea / Select / NumberInput / Cascader / DatePicker / TimePicker 的 error 联动行为不变。"
+        ]
+      }
+    },
     {
       "version": "2.7.2",
       "sections": {
@@ -177,6 +233,18 @@
     }
   ],
   "List": [
+    {
+      "version": "3.0.0",
+      "sections": {
+        "Fixed": [
+          "可交互的 `ListItem`（传入 `onClick` 或 `interactive`）现在可以获得焦点：补上 `tabIndex`、`role=\"button\"` 与 Enter / Space 触发，行内 Switch、Button、Select 等控件仍各自响应按键",
+          "`disabled` 的可交互行标记 `aria-disabled`；`href` 链接行的行为保持不变"
+        ],
+        "Removed": [
+          "`ListItem` `actionLabel` 的 `Text` 默认值；未传 `actionLabel` 且未传 `action` 时不再渲染主操作按钮"
+        ]
+      }
+    },
     {
       "version": "2.6.2",
       "sections": {
@@ -394,6 +462,14 @@
     }
   ],
   "ScrollPicker": [
+    {
+      "version": "3.0.0",
+      "sections": {
+        "Fixed": [
+          "`loop={false}` 的列滚到首尾后不再吞掉滚轮事件，页面可以继续滚动；loop 列行为不变"
+        ]
+      }
+    },
     {
       "version": "2.6.1",
       "sections": {
@@ -405,6 +481,17 @@
     }
   ],
   "SegmentatorGroup": [
+    {
+      "version": "3.0.0",
+      "sections": {
+        "Added": [
+          "键盘操作对齐 radiogroup 规范：方向键（horizontal 用 Left/Right，vertical 用 Up/Down，RTL 自动镜像）在项之间移动并同步选中，Home/End 跳到首尾"
+        ],
+        "Changed": [
+          "改为 roving tabindex：仅选中项参与 Tab 序列（未选中时由首个可用项接管），进入分段控件后用方向键切换"
+        ]
+      }
+    },
     {
       "version": "2.8.0",
       "sections": {
@@ -461,6 +548,20 @@
     }
   ],
   "Select": [
+    {
+      "version": "3.0.0",
+      "sections": {
+        "Added": [
+          "`SelectSubItem`：焦点在子菜单行上时可用 Up / Down / Home / End 在同层菜单项之间移动；展开方向键（RTL 下镜像）打开子菜单并把焦点送入首项，收起方向键或 Esc 关闭并把焦点送回该行",
+          "主菜单在 `SelectSubItem` 与 Radix `SelectItem` 混排时，方向键会把焦点送入/送出子菜单行（Radix 集合本身会跳过这些行）",
+          "子菜单面板内同样支持 Up / Down / Home / End，导航范围限定在当前面板"
+        ],
+        "Removed": [
+          "`SelectItem` / `SelectSubItem` 开启 `showBadge` 但未传 `badge` 时不再回填 `Text` 占位 Badge",
+          "`SelectItem` / `SelectSubItem` 开启 `showMoreFunction` 但未传 `moreAction` 时不再回填 `Text` 占位 Link，尾部槽位整体不渲染"
+        ]
+      }
+    },
     {
       "version": "2.8.0",
       "sections": {
@@ -546,6 +647,18 @@
     }
   ],
   "Table": [
+    {
+      "version": "3.0.0",
+      "sections": {
+        "Changed": [
+          "`TableCell` `content=\"people\"` 未传 `people` 时，默认头像改用 `users_user` 图标，不再显示 `A` 占位字母"
+        ],
+        "Removed": [
+          "`TableCell` `content=\"badge\"` 未传 `badge` / `badgeLabel` 时不再回填 `Text` 占位 Badge",
+          "`TableCell` `content=\"icon-place+text\"` 未传 `iconPlace` / `icon` 时不再渲染 `A` 占位形底，图标位整体省略"
+        ]
+      }
+    },
     {
       "version": "2.7.0",
       "sections": {
@@ -563,6 +676,14 @@
     }
   ],
   "TimePickerField": [
+    {
+      "version": "3.0.0",
+      "sections": {
+        "Fixed": [
+          "时间面板不再使用 `role=\"application\"`，改为 `role=\"group\"`；面板内的时 / 分列仍是可 Tab 到达的 listbox，支持 Up / Down / Home / End"
+        ]
+      }
+    },
     {
       "version": "2.8.0",
       "sections": {
@@ -624,6 +745,14 @@
     }
   ],
   "Typeface": [
+    {
+      "version": "3.0.0",
+      "sections": {
+        "Removed": [
+          "未传 `children` / `primary` / `secondary` / `tertiary` 时不再回填 `Text` 占位文案，改为不渲染任何文本行"
+        ]
+      }
+    },
     {
       "version": "2.0.0",
       "sections": {
@@ -634,6 +763,14 @@
     }
   ],
   "Video": [
+    {
+      "version": "3.0.0",
+      "sections": {
+        "Fixed": [
+          "倍速菜单补齐 listbox 键盘模型：roving tabindex 让当前倍速成为唯一 Tab 落点，Up / Down / Home / End 在选项间移动，`aria-activedescendant` 指向焦点项"
+        ]
+      }
+    },
     {
       "version": "2.8.0",
       "sections": {

package/dist/form-field-context-XYh-G1KL.d.cts

@@ -0,0 +1,7 @@
+/**
+ * Resolve a control `error` prop against the surrounding FormField.
+ * Explicit `error={true|false}` wins; otherwise inherits FormField tip invalidity.
+ */
+declare function useResolvedControlError(errorProp?: boolean): boolean;
+
+export { useResolvedControlError as u };

package/dist/form-field-context-XYh-G1KL.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Resolve a control `error` prop against the surrounding FormField.
+ * Explicit `error={true|false}` wins; otherwise inherits FormField tip invalidity.
+ */
+declare function useResolvedControlError(errorProp?: boolean): boolean;
+
+export { useResolvedControlError as u };