@tribepad/themis 1.0.0

package/dist/elements/TextField/index.mjs

@@ -0,0 +1,207 @@
+export { TextField, TextFieldDescription, TextFieldError, TextFieldInput, TextFieldLabel, TextFieldSuccess, inputVariants, labelVariants, successMessageVariants, inputVariants as textFieldInputVariants, labelVariants as textFieldLabelVariants } from '../../chunk-HSGBJPJO.mjs';
+import '../../chunk-BDXKKMBZ.mjs';
+import '../../chunk-FPKEAJRZ.mjs';
+import '../../chunk-HK46BT5U.mjs';
+import '../../chunk-E2KQFV3O.mjs';
+import { BaseComponentPropsSchema } from '../../chunk-5SVLJN2C.mjs';
+import { z } from 'zod';
+
+var AutoCompleteValue = z.enum([
+  // Control tokens
+  "off",
+  "on",
+  // Name-related
+  "name",
+  "honorific-prefix",
+  "given-name",
+  "additional-name",
+  "family-name",
+  "honorific-suffix",
+  "nickname",
+  // Contact
+  "email",
+  "username",
+  // Authentication
+  "new-password",
+  "current-password",
+  "one-time-code",
+  // Organization
+  "organization-title",
+  "organization",
+  // Address
+  "street-address",
+  "address-line1",
+  "address-line2",
+  "address-line3",
+  "address-level4",
+  "address-level3",
+  "address-level2",
+  "address-level1",
+  "country",
+  "country-name",
+  "postal-code",
+  // Payment
+  "cc-name",
+  "cc-given-name",
+  "cc-additional-name",
+  "cc-family-name",
+  "cc-number",
+  "cc-exp",
+  "cc-exp-month",
+  "cc-exp-year",
+  "cc-csc",
+  "cc-type",
+  // Transaction
+  "transaction-currency",
+  "transaction-amount",
+  // Personal
+  "language",
+  "bday",
+  "bday-day",
+  "bday-month",
+  "bday-year",
+  "sex",
+  // Telephone
+  "tel",
+  "tel-country-code",
+  "tel-national",
+  "tel-area-code",
+  "tel-local",
+  "tel-extension",
+  // Other
+  "impp",
+  "url",
+  "photo"
+]);
+var DANGEROUS_REGEX_PATTERNS = [
+  /\(\.\*\)\+/,
+  // Catastrophic backtracking: (.*)+
+  /\(\.\+\)\+/,
+  // Catastrophic backtracking: (.+)+
+  /\([^)]*\)\{.*,.*\}/,
+  // Excessive quantifiers: (x){10,1000}
+  /\(\?!\)/,
+  // Negative lookahead (can be slow)
+  /\(\?<=\)/
+  // Positive lookbehind (can be slow)
+];
+var validatePatternSafety = (pattern) => {
+  for (const dangerous of DANGEROUS_REGEX_PATTERNS) {
+    if (dangerous.test(pattern)) {
+      return false;
+    }
+  }
+  const quantifierCount = (pattern.match(/[*+{}]/g) || []).length;
+  if (quantifierCount > 5) {
+    return false;
+  }
+  return true;
+};
+var TextFieldPropsSchema = BaseComponentPropsSchema.extend({
+  // Size variants (matching Button sizes: sm, default, lg)
+  size: z.enum(["sm", "default", "lg"]).optional().default("default"),
+  // Text content
+  label: z.string().optional(),
+  description: z.string().optional(),
+  errorMessage: z.string().optional(),
+  successMessage: z.string().optional(),
+  // Input type - BREAKING: removed 'tel' (use TelField component instead)
+  // @see DECISIONS.md Decision 14
+  type: z.enum(["text", "email", "password", "url", "search"]).optional().default("text"),
+  // State props
+  isRequired: z.boolean().optional(),
+  isReadOnly: z.boolean().optional(),
+  isDisabled: z.boolean().optional(),
+  isInvalid: z.boolean().optional(),
+  isValid: z.boolean().optional(),
+  // Input attributes
+  placeholder: z.string().optional(),
+  value: z.string().optional(),
+  defaultValue: z.string().optional(),
+  name: z.string().optional(),
+  autoFocus: z.boolean().optional(),
+  // AutoComplete - BREAKING: strict MDN enum instead of string
+  // @see DECISIONS.md Decision 13
+  autoComplete: AutoCompleteValue.optional(),
+  maxLength: z.number().optional(),
+  minLength: z.number().optional(),
+  // Pattern validation with security check
+  // @see DECISIONS.md Decision 15, 18
+  // @warning SECURITY: Only use patterns defined in source code, never from user input
+  pattern: z.string().optional(),
+  patternDescription: z.string().optional(),
+  // Feature: Copy/Paste Restriction
+  // @see DECISIONS.md Decision 4
+  disableCopyPaste: z.boolean().optional().default(false),
+  // Feature: Prefix/Suffix
+  // @see DECISIONS.md Decision 9
+  prefix: z.any().optional(),
+  // ReactNode - can't validate with Zod
+  suffix: z.any().optional(),
+  // ReactNode - can't validate with Zod
+  prefixSize: z.number().optional().default(16),
+  suffixSize: z.number().optional().default(16),
+  // Feature: Expand on Focus
+  // @see DECISIONS.md Decision 6, 17
+  expandOnFocus: z.boolean().optional().default(false),
+  collapsedWidth: z.string().optional().default("200px"),
+  // Feature: Password Toggle
+  // @see DECISIONS.md Decision 8
+  showPasswordToggle: z.boolean().optional()
+  // Event handlers (onChange, onBlur, onFocus inherited from AriaTextFieldProps)
+  // Custom validate function added in TypeScript type below (not in Zod schema)
+}).refine(
+  (data) => !data.pattern || data.patternDescription,
+  {
+    message: "patternDescription is required when pattern is provided",
+    path: ["patternDescription"]
+  }
+).refine(
+  (data) => !data.pattern || validatePatternSafety(data.pattern),
+  {
+    message: "Unsafe regex pattern detected. Pattern may cause ReDoS vulnerability. Avoid patterns like (.*)+, (.+)+, or excessive quantifiers.",
+    path: ["pattern"]
+  }
+).refine(
+  (data) => !(data.successMessage && data.errorMessage),
+  {
+    message: "Cannot provide both successMessage and errorMessage. Use one based on validation state.",
+    path: ["successMessage"]
+  }
+).refine(
+  (data) => {
+    if (typeof process !== "undefined" && process.env.NODE_ENV === "development") {
+      if (data.isValid && data.isInvalid) {
+        console.error("[TextField] Both isValid and isInvalid are true. isInvalid takes precedence.");
+      }
+    }
+    return true;
+  }
+);
+var TextFieldLabelPropsSchema = z.object({
+  children: z.any().optional(),
+  className: z.string().optional(),
+  htmlFor: z.string().optional(),
+  state: z.enum(["default", "error", "disabled"]).optional().default("default")
+});
+var TextFieldInputPropsSchema = z.object({
+  className: z.string().optional(),
+  size: z.enum(["sm", "default", "lg"]).optional().default("default"),
+  state: z.enum(["default", "error", "success", "disabled", "readonly"]).optional().default("default")
+});
+var TextFieldDescriptionPropsSchema = z.object({
+  children: z.any().optional(),
+  className: z.string().optional()
+});
+var TextFieldErrorPropsSchema = z.object({
+  children: z.any().optional(),
+  className: z.string().optional()
+});
+var TextFieldSuccessPropsSchema = z.object({
+  children: z.any().optional(),
+  className: z.string().optional()
+});
+
+export { AutoCompleteValue as AutoCompleteValueSchema, TextFieldDescriptionPropsSchema, TextFieldErrorPropsSchema, TextFieldInputPropsSchema, TextFieldLabelPropsSchema, TextFieldPropsSchema, TextFieldSuccessPropsSchema, validatePatternSafety };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/elements/TextField/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/elements/TextField/TextField.types.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import { z } from 'zod';\nimport type { ReactNode } from 'react';\nimport { BaseComponentPropsSchema } from '../../schemas/BaseComponentProps';\nimport type {\n  TextFieldProps as AriaTextFieldProps,\n  LabelProps as AriaLabelProps,\n  InputProps as AriaInputProps,\n  TextProps as AriaTextProps,\n} from 'react-aria-components';\n\n/**\n * AutoComplete values from MDN spec\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/autocomplete\n */\nexport const AutoCompleteValue = z.enum([\n  // Control tokens\n  'off',\n  'on',\n  // Name-related\n  'name',\n  'honorific-prefix',\n  'given-name',\n  'additional-name',\n  'family-name',\n  'honorific-suffix',\n  'nickname',\n  // Contact\n  'email',\n  'username',\n  // Authentication\n  'new-password',\n  'current-password',\n  'one-time-code',\n  // Organization\n  'organization-title',\n  'organization',\n  // Address\n  'street-address',\n  'address-line1',\n  'address-line2',\n  'address-line3',\n  'address-level4',\n  'address-level3',\n  'address-level2',\n  'address-level1',\n  'country',\n  'country-name',\n  'postal-code',\n  // Payment\n  'cc-name',\n  'cc-given-name',\n  'cc-additional-name',\n  'cc-family-name',\n  'cc-number',\n  'cc-exp',\n  'cc-exp-month',\n  'cc-exp-year',\n  'cc-csc',\n  'cc-type',\n  // Transaction\n  'transaction-currency',\n  'transaction-amount',\n  // Personal\n  'language',\n  'bday',\n  'bday-day',\n  'bday-month',\n  'bday-year',\n  'sex',\n  // Telephone\n  'tel',\n  'tel-country-code',\n  'tel-national',\n  'tel-area-code',\n  'tel-local',\n  'tel-extension',\n  // Other\n  'impp',\n  'url',\n  'photo',\n]);\n\nexport type AutoCompleteValueType = z.infer<typeof AutoCompleteValue>;\n\n/**\n * Dangerous regex patterns that can cause ReDoS attacks\n * @see DECISIONS.md Decision 21\n */\nconst DANGEROUS_REGEX_PATTERNS = [\n  /\\(\\.\\*\\)\\+/, // Catastrophic backtracking: (.*)+\n  /\\(\\.\\+\\)\\+/, // Catastrophic backtracking: (.+)+\n  /\\([^)]*\\)\\{.*,.*\\}/, // Excessive quantifiers: (x){10,1000}\n  /\\(\\?!\\)/, // Negative lookahead (can be slow)\n  /\\(\\?<=\\)/, // Positive lookbehind (can be slow)\n];\n\n/**\n * Validates regex pattern for ReDoS safety\n * @param pattern - Regular expression pattern string\n * @returns true if pattern is safe, false if potentially dangerous\n */\nexport const validatePatternSafety = (pattern: string): boolean => {\n  // Check for known dangerous patterns\n  for (const dangerous of DANGEROUS_REGEX_PATTERNS) {\n    if (dangerous.test(pattern)) {\n      return false;\n    }\n  }\n\n  // Check for excessive nested quantifiers\n  const quantifierCount = (pattern.match(/[*+{}]/g) || []).length;\n  if (quantifierCount > 5) {\n    return false;\n  }\n\n  return true;\n};\n\n/**\n * TextField props schema extending BaseComponentProps\n *\n * @see spec.md FR-009 to FR-014 (Accessibility Requirements - WCAG 2.2 AAA)\n * @see React Aria TextField: https://react-spectrum.adobe.com/react-aria/TextField.html\n * @see ShadCN Input: https://ui.shadcn.com/docs/components/input\n * @see ShadCN Label: https://ui.shadcn.com/docs/components/label\n */\nexport const TextFieldPropsSchema = BaseComponentPropsSchema.extend({\n  // Size variants (matching Button sizes: sm, default, lg)\n  size: z.enum(['sm', 'default', 'lg']).optional().default('default'),\n\n  // Text content\n  label: z.string().optional(),\n  description: z.string().optional(),\n  errorMessage: z.string().optional(),\n  successMessage: z.string().optional(),\n\n  // Input type - BREAKING: removed 'tel' (use TelField component instead)\n  // @see DECISIONS.md Decision 14\n  type: z\n    .enum(['text', 'email', 'password', 'url', 'search'])\n    .optional()\n    .default('text'),\n\n  // State props\n  isRequired: z.boolean().optional(),\n  isReadOnly: z.boolean().optional(),\n  isDisabled: z.boolean().optional(),\n  isInvalid: z.boolean().optional(),\n  isValid: z.boolean().optional(),\n\n  // Input attributes\n  placeholder: z.string().optional(),\n  value: z.string().optional(),\n  defaultValue: z.string().optional(),\n  name: z.string().optional(),\n  autoFocus: z.boolean().optional(),\n\n  // AutoComplete - BREAKING: strict MDN enum instead of string\n  // @see DECISIONS.md Decision 13\n  autoComplete: AutoCompleteValue.optional(),\n\n  maxLength: z.number().optional(),\n  minLength: z.number().optional(),\n\n  // Pattern validation with security check\n  // @see DECISIONS.md Decision 15, 18\n  // @warning SECURITY: Only use patterns defined in source code, never from user input\n  pattern: z.string().optional(),\n  patternDescription: z.string().optional(),\n\n  // Feature: Copy/Paste Restriction\n  // @see DECISIONS.md Decision 4\n  disableCopyPaste: z.boolean().optional().default(false),\n\n  // Feature: Prefix/Suffix\n  // @see DECISIONS.md Decision 9\n  prefix: z.any().optional(), // ReactNode - can't validate with Zod\n  suffix: z.any().optional(), // ReactNode - can't validate with Zod\n  prefixSize: z.number().optional().default(16),\n  suffixSize: z.number().optional().default(16),\n\n  // Feature: Expand on Focus\n  // @see DECISIONS.md Decision 6, 17\n  expandOnFocus: z.boolean().optional().default(false),\n  collapsedWidth: z.string().optional().default('200px'),\n\n  // Feature: Password Toggle\n  // @see DECISIONS.md Decision 8\n  showPasswordToggle: z.boolean().optional(),\n\n  // Event handlers (onChange, onBlur, onFocus inherited from AriaTextFieldProps)\n  // Custom validate function added in TypeScript type below (not in Zod schema)\n})\n.refine(\n  (data) => !data.pattern || data.patternDescription,\n  {\n    message: \"patternDescription is required when pattern is provided\",\n    path: [\"patternDescription\"]\n  }\n)\n.refine(\n  (data) => !data.pattern || validatePatternSafety(data.pattern),\n  {\n    message: \"Unsafe regex pattern detected. Pattern may cause ReDoS vulnerability. Avoid patterns like (.*)+, (.+)+, or excessive quantifiers.\",\n    path: [\"pattern\"]\n  }\n)\n.refine(\n  (data) => !(data.successMessage && data.errorMessage),\n  {\n    message: \"Cannot provide both successMessage and errorMessage. Use one based on validation state.\",\n    path: [\"successMessage\"]\n  }\n)\n.refine(\n  (data) => {\n    // Development mode warning for conflicting validation states\n    if (typeof process !== 'undefined' && process.env.NODE_ENV === 'development') {\n      if (data.isValid && data.isInvalid) {\n        console.error('[TextField] Both isValid and isInvalid are true. isInvalid takes precedence.');\n      }\n    }\n    return true;\n  }\n);\n\nexport type TextFieldProps = Partial<z.infer<typeof TextFieldPropsSchema>> &\n  Omit<AriaTextFieldProps, keyof z.infer<typeof TextFieldPropsSchema>> & {\n    // Explicitly type onChange for better IntelliSense\n    onChange?: (value: string) => void;\n\n    // Custom validation function\n    // @see DECISIONS.md Decision 7, 18\n    // Pattern validation runs first, then custom validate\n    validate?: (value: string) => string | undefined | null;\n\n    // Prefix/Suffix with proper typing\n    prefix?: ReactNode;\n    suffix?: ReactNode;\n  };\n\n/**\n * Label props schema for TextField label sub-component\n */\nexport const TextFieldLabelPropsSchema = z.object({\n  children: z.any().optional(),\n  className: z.string().optional(),\n  htmlFor: z.string().optional(),\n  state: z.enum(['default', 'error', 'disabled']).optional().default('default'),\n});\n\nexport type TextFieldLabelProps = z.infer<typeof TextFieldLabelPropsSchema> &\n  Omit<AriaLabelProps, keyof z.infer<typeof TextFieldLabelPropsSchema>>;\n\n/**\n * Input props schema for TextField input sub-component\n */\nexport const TextFieldInputPropsSchema = z.object({\n  className: z.string().optional(),\n  size: z.enum(['sm', 'default', 'lg']).optional().default('default'),\n  state: z\n    .enum(['default', 'error', 'success', 'disabled', 'readonly'])\n    .optional()\n    .default('default'),\n});\n\nexport type TextFieldInputProps = z.infer<typeof TextFieldInputPropsSchema> &\n  Omit<AriaInputProps, keyof z.infer<typeof TextFieldInputPropsSchema>>;\n\n/**\n * Description text props schema for TextField description sub-component\n */\nexport const TextFieldDescriptionPropsSchema = z.object({\n  children: z.any().optional(),\n  className: z.string().optional(),\n});\n\nexport type TextFieldDescriptionProps = z.infer<typeof TextFieldDescriptionPropsSchema> &\n  Omit<AriaTextProps, keyof z.infer<typeof TextFieldDescriptionPropsSchema>>;\n\n/**\n * Error message props schema for TextField error sub-component\n */\nexport const TextFieldErrorPropsSchema = z.object({\n  children: z.any().optional(),\n  className: z.string().optional(),\n});\n\nexport type TextFieldErrorProps = z.infer<typeof TextFieldErrorPropsSchema> &\n  Omit<AriaTextProps, keyof z.infer<typeof TextFieldErrorPropsSchema>>;\n\n/**\n * Success message props schema for TextField success sub-component\n * @see DECISIONS.md Decision 5\n */\nexport const TextFieldSuccessPropsSchema = z.object({\n  children: z.any().optional(),\n  className: z.string().optional(),\n});\n\nexport type TextFieldSuccessProps = z.infer<typeof TextFieldSuccessPropsSchema> &\n  Omit<AriaTextProps, keyof z.infer<typeof TextFieldSuccessPropsSchema>>;\n\n/**\n * CVA variant configuration types\n */\nexport type TextFieldSize = z.infer<typeof TextFieldPropsSchema>['size'];\nexport type InputState = z.infer<typeof TextFieldInputPropsSchema>['state'];\nexport type LabelState = z.infer<typeof TextFieldLabelPropsSchema>['state'];\n"]}

package/dist/elements/TimeField/TimeField.d.ts

@@ -0,0 +1,34 @@
+/**
+ * TimeField component for time input with keyboard-editable segments.
+ *
+ * @example
+ * ```tsx
+ * import { TimeField, Time } from '@tribepad/themis/elements/TimeField';
+ *
+ * // Basic usage
+ * <TimeField label="Meeting Time" />
+ *
+ * // With default value
+ * <TimeField
+ *   label="Start Time"
+ *   defaultValue={new Time(14, 30)}
+ * />
+ *
+ * // 12-hour format with step
+ * <TimeField
+ *   label="Appointment"
+ *   hourCycle={12}
+ *   step={15}
+ * />
+ *
+ * // With validation
+ * <TimeField
+ *   label="Office Hours"
+ *   minValue={new Time(9, 0)}
+ *   maxValue={new Time(17, 0)}
+ *   errorMessage="Please select a time within office hours"
+ * />
+ * ```
+ */
+export declare const TimeField: import("react").ForwardRefExoticComponent<import("react-aria-components").TimeFieldProps<import("react-aria").TimeValue> & import("./TimeField.types").ThemisTimeFieldCustomProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=TimeField.d.ts.map

package/dist/elements/TimeField/TimeField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeField.d.ts","sourceRoot":"","sources":["../../../src/elements/TimeField/TimeField.tsx"],"names":[],"mappings":"AA4CA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,SAAS,oOAmErB,CAAC"}

package/dist/elements/TimeField/TimeField.types.d.ts

@@ -0,0 +1,151 @@
+/**
+ * TimeField Component Types
+ *
+ * Zod schemas and TypeScript types for the TimeField component.
+ * Includes CVA variant definitions for styling.
+ *
+ * Note: Zod schemas are used for contract tests and developer guardrails,
+ * not runtime validation. This follows the established Themis pattern.
+ *
+ * @see {@link ../../docs/prd/timefield-prd.md} for full requirements
+ */
+import { z } from 'zod';
+import { type VariantProps } from 'class-variance-authority';
+import type { TimeFieldProps as AriaTimeFieldProps, TimeValue } from 'react-aria-components';
+/**
+ * Union type for all time values supported by the TimeField.
+ * - Time: Time only (no date, no timezone)
+ * - CalendarDateTime: Date and time (no timezone)
+ * - ZonedDateTime: Date, time, and timezone
+ */
+export type { TimeValue } from 'react-aria-components';
+/**
+ * Controls which time segments are displayed.
+ * - 'hour': Hour only (+ AM/PM in 12-hour mode)
+ * - 'minute': Hour + minute (default)
+ * - 'second': Hour + minute + second
+ *
+ * Note: Millisecond granularity is intentionally excluded - no common UI use case.
+ */
+export type TimeGranularity = 'hour' | 'minute' | 'second';
+/**
+ * Size variants for TimeField component.
+ * - 'sm': Compact size (36px height) - AA compliant only, not AAA
+ * - 'default': Standard size (44px height) - AAA compliant
+ * - 'lg': Large size (56px height) - AAA compliant
+ */
+export type TimeFieldSize = 'sm' | 'default' | 'lg';
+/**
+ * Hour cycle format.
+ * - 12: 12-hour format with AM/PM
+ * - 24: 24-hour format
+ */
+export type HourCycle = 12 | 24;
+/**
+ * Zod schema for TimeField props validation.
+ * Used for contract tests and developer guardrails, not runtime validation.
+ */
+export declare const TimeFieldPropsSchema: z.ZodObject<{
+    value: z.ZodOptional<z.ZodCustom<TimeValue, TimeValue>>;
+    defaultValue: z.ZodOptional<z.ZodCustom<TimeValue, TimeValue>>;
+    placeholderValue: z.ZodOptional<z.ZodCustom<TimeValue, TimeValue>>;
+    granularity: z.ZodDefault<z.ZodEnum<{
+        hour: "hour";
+        minute: "minute";
+        second: "second";
+    }>>;
+    hourCycle: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<12>, z.ZodLiteral<24>]>>;
+    hideTimeZone: z.ZodOptional<z.ZodBoolean>;
+    shouldForceLeadingZeros: z.ZodOptional<z.ZodBoolean>;
+    minValue: z.ZodOptional<z.ZodCustom<TimeValue, TimeValue>>;
+    maxValue: z.ZodOptional<z.ZodCustom<TimeValue, TimeValue>>;
+    isDisabled: z.ZodOptional<z.ZodBoolean>;
+    isReadOnly: z.ZodOptional<z.ZodBoolean>;
+    isRequired: z.ZodOptional<z.ZodBoolean>;
+    isInvalid: z.ZodOptional<z.ZodBoolean>;
+    validate: z.ZodOptional<z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>>;
+    validationBehavior: z.ZodDefault<z.ZodEnum<{
+        native: "native";
+        aria: "aria";
+    }>>;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    errorMessage: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>]>>;
+    name: z.ZodOptional<z.ZodString>;
+    size: z.ZodDefault<z.ZodEnum<{
+        default: "default";
+        sm: "sm";
+        lg: "lg";
+    }>>;
+    onChange: z.ZodOptional<z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>>;
+    onFocus: z.ZodOptional<z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>>;
+    onBlur: z.ZodOptional<z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>>;
+    onFocusChange: z.ZodOptional<z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>>;
+    className: z.ZodOptional<z.ZodString>;
+    autoFocus: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Custom props added to TimeField (not from React Aria).
+ */
+export interface ThemisTimeFieldCustomProps {
+    /** Size variant: 'sm', 'default', or 'lg' */
+    size?: TimeFieldSize;
+    /** Field label */
+    label?: string;
+    /** Description text below the field */
+    description?: string;
+    /** Error message when field is invalid */
+    errorMessage?: string;
+}
+/**
+ * Props for the TimeField component.
+ * Uses React Aria's TimeFieldProps directly to ensure correct function types.
+ */
+export type TimeFieldProps = AriaTimeFieldProps<TimeValue> & ThemisTimeFieldCustomProps;
+/**
+ * Variants for the TimeField input container.
+ * Applies to the DateInput element wrapping time segments.
+ *
+ * Size notes:
+ * - sm (36px): Desktop-only, AA compliant only (not AAA touch target)
+ * - default (44px): AAA compliant, recommended for most use cases
+ * - lg (56px): AAA compliant, enhanced touch targets
+ */
+export declare const timeFieldVariants: (props?: ({
+    size?: "default" | "sm" | "lg" | null | undefined;
+    isInvalid?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * Variants for individual time segment elements.
+ * Each segment (hour, minute, second, dayPeriod) uses these styles.
+ */
+export declare const timeSegmentVariants: (props?: ({
+    size?: "default" | "sm" | "lg" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * Variants for the TimeField label.
+ */
+export declare const timeFieldLabelVariants: (props?: ({
+    size?: "default" | "sm" | "lg" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * Variants for the description text below the field.
+ */
+export declare const timeFieldDescriptionVariants: (props?: ({
+    size?: "default" | "sm" | "lg" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * Variants for the error message display.
+ */
+export declare const timeFieldErrorVariants: (props?: ({
+    size?: "default" | "sm" | "lg" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * Variant props for timeFieldVariants CVA function.
+ */
+export type TimeFieldVariantProps = VariantProps<typeof timeFieldVariants>;
+/**
+ * Variant props for timeSegmentVariants CVA function.
+ */
+export type TimeSegmentVariantProps = VariantProps<typeof timeSegmentVariants>;
+//# sourceMappingURL=TimeField.types.d.ts.map

package/dist/elements/TimeField/TimeField.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeField.types.d.ts","sourceRoot":"","sources":["../../../src/elements/TimeField/TimeField.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EACV,cAAc,IAAI,kBAAkB,EACpC,SAAS,EACV,MAAM,uBAAuB,CAAC;AAM/B;;;;;GAKG;AACH,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAMvD;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAM3D;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;AAMpD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,EAAE,GAAG,EAAE,CAAC;AAMhC;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoD/B,CAAC;AAMH;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,6CAA6C;IAC7C,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,kBAAkB,CAAC,SAAS,CAAC,GACxD,0BAA0B,CAAC;AAM7B;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB;;;8EA4B7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;8EAyB/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB;;8EAoBlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,4BAA4B;;8EAiBxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB;;8EAkBlC,CAAC;AAMF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,YAAY,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,YAAY,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/elements/TimeField/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * TimeField Component Exports
+ *
+ * Main entry point for the TimeField component.
+ * Re-exports time utilities from @internationalized/date for convenience.
+ *
+ * @example
+ * ```tsx
+ * import { TimeField, Time, parseTime } from '@tribepad/themis/elements/TimeField';
+ *
+ * <TimeField
+ *   label="Meeting Time"
+ *   defaultValue={new Time(14, 30)}
+ *   granularity="minute"
+ *   hourCycle={12}
+ * />
+ * ```
+ */
+export { TimeField } from './TimeField';
+export type { TimeFieldProps, TimeFieldSize, TimeGranularity, HourCycle } from './TimeField.types';
+export { TimeFieldPropsSchema } from './TimeField.types';
+export { timeFieldVariants, timeSegmentVariants, timeFieldLabelVariants, timeFieldDescriptionVariants, timeFieldErrorVariants, } from './TimeField.types';
+export { Time, parseTime } from '@internationalized/date';
+//# sourceMappingURL=index.d.ts.map

package/dist/elements/TimeField/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/elements/TimeField/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/elements/TimeField/index.js

@@ -0,0 +1,45 @@
+'use strict';
+
+var chunk3H7ASYR7_js = require('../../chunk-3H7ASYR7.js');
+require('../../chunk-VIREG536.js');
+
+
+
+Object.defineProperty(exports, "Time", {
+  enumerable: true,
+  get: function () { return chunk3H7ASYR7_js.Time; }
+});
+Object.defineProperty(exports, "TimeField", {
+  enumerable: true,
+  get: function () { return chunk3H7ASYR7_js.TimeField; }
+});
+Object.defineProperty(exports, "TimeFieldPropsSchema", {
+  enumerable: true,
+  get: function () { return chunk3H7ASYR7_js.TimeFieldPropsSchema; }
+});
+Object.defineProperty(exports, "parseTime", {
+  enumerable: true,
+  get: function () { return chunk3H7ASYR7_js.parseTime; }
+});
+Object.defineProperty(exports, "timeFieldDescriptionVariants", {
+  enumerable: true,
+  get: function () { return chunk3H7ASYR7_js.timeFieldDescriptionVariants; }
+});
+Object.defineProperty(exports, "timeFieldErrorVariants", {
+  enumerable: true,
+  get: function () { return chunk3H7ASYR7_js.timeFieldErrorVariants; }
+});
+Object.defineProperty(exports, "timeFieldLabelVariants", {
+  enumerable: true,
+  get: function () { return chunk3H7ASYR7_js.timeFieldLabelVariants; }
+});
+Object.defineProperty(exports, "timeFieldVariants", {
+  enumerable: true,
+  get: function () { return chunk3H7ASYR7_js.timeFieldVariants; }
+});
+Object.defineProperty(exports, "timeSegmentVariants", {
+  enumerable: true,
+  get: function () { return chunk3H7ASYR7_js.timeSegmentVariants; }
+});
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/elements/TimeField/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/elements/TimeField/index.mjs

@@ -0,0 +1,4 @@
+export { Time, TimeField, TimeFieldPropsSchema, parseTime, timeFieldDescriptionVariants, timeFieldErrorVariants, timeFieldLabelVariants, timeFieldVariants, timeSegmentVariants } from '../../chunk-2HIUTHMU.mjs';
+import '../../chunk-E2KQFV3O.mjs';
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/elements/TimeField/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}

package/dist/elements/Toast/Toast.d.ts

@@ -0,0 +1,105 @@
+import { ToastQueue, type QueuedToast, type ToastState as AriaToastState } from 'react-stately';
+import { type VariantProps } from 'class-variance-authority';
+import type { ToastContent, ToastState, ToastConfig } from './Toast.types';
+/**
+ * Toast container variants with theme-aligned styling
+ * Fixed 356px width for consistent appearance across all toasts
+ */
+export declare const toastVariants: (props?: ({
+    variant?: "default" | "primary" | "accent" | "destructive" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * Toaster position variants for the toast region container
+ */
+export declare const toasterVariants: (props?: ({
+    position?: "top-right" | "top-left" | "bottom-right" | "bottom-left" | "top-center" | "bottom-center" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * Get the total number of active toasts (visible + queued)
+ */
+export declare function getTotalActiveToasts(): number;
+/**
+ * Subscribe to total toast count changes
+ */
+export declare function subscribeToTotalCount(fn: () => void): () => void;
+/**
+ * Enhanced toast queue API with additional methods
+ * Provides closeAll, pauseAll, resumeAll on top of base ToastQueue
+ */
+export declare const toastQueue: {
+    /**
+     * Add a toast to the queue
+     */
+    add: (content: ToastState, options?: {
+        timeout?: number;
+        onClose?: () => void;
+    }) => string;
+    /**
+     * Close a specific toast by key
+     */
+    close: (key: string) => void;
+    /**
+     * Close all toasts (visible and queued)
+     */
+    closeAll: () => void;
+    /**
+     * Pause all toast timers
+     */
+    pauseAll: () => void;
+    /**
+     * Resume all toast timers
+     */
+    resumeAll: () => void;
+    /**
+     * Get the visible toasts
+     */
+    readonly visibleToasts: QueuedToast<ToastState>[];
+    /**
+     * Subscribe to queue changes
+     */
+    subscribe: (fn: () => void) => () => void;
+    /**
+     * Get total active toasts (visible + queued)
+     */
+    readonly totalCount: number;
+};
+/**
+ * Get the internal queue for use in components
+ */
+export declare function getInternalQueue(): ToastQueue<ToastState>;
+/**
+ * Add a toast notification programmatically
+ *
+ * @param content - Content to display (string or ReactNode)
+ * @param options - Toast configuration options
+ * @returns Unique key for the created toast
+ *
+ * @example
+ * ```tsx
+ * // Simple string
+ * toast("Message saved!");
+ *
+ * // With variant
+ * toast("Error occurred", { variant: "destructive" });
+ *
+ * // With callback
+ * toast("Action completed", {
+ *   variant: "primary",
+ *   onClose: (key, reason) => console.log(`Closed: ${reason}`)
+ * });
+ * ```
+ */
+export declare function toast(content: ToastContent, options?: ToastConfig): string;
+export interface ToastItemProps {
+    /** Toast from the queue */
+    toast: QueuedToast<ToastState>;
+    /** Toast state for managing dismissal */
+    state: AriaToastState<ToastState>;
+}
+/**
+ * Individual toast notification component
+ * Uses React Aria useToast hook for accessibility
+ */
+export declare const ToastItem: import("react").NamedExoticComponent<ToastItemProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { VariantProps };
+//# sourceMappingURL=Toast.d.ts.map

package/dist/elements/Toast/Toast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Toast.d.ts","sourceRoot":"","sources":["../../../src/elements/Toast/Toast.tsx"],"names":[],"mappings":"AAoBA,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,IAAI,cAAc,EAAE,MAAM,eAAe,CAAC;AAChG,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIlE,OAAO,KAAK,EAEV,YAAY,EACZ,UAAU,EAEV,WAAW,EACZ,MAAM,eAAe,CAAC;AAOvB;;;GAGG;AACH,eAAO,MAAM,aAAa;;8EA2CzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe;;8EAqB3B,CAAC;AA2EF;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAGhE;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;mBACY,UAAU,YAAY;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE;IAG/E;;OAEG;iBACU,MAAM;IAInB;;OAEG;;IAQH;;OAEG;;IAKH;;OAEG;;IAKH;;OAEG;;IAKH;;OAEG;oBACa,MAAM,IAAI;IAE1B;;OAEG;;CAIJ,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAAC,UAAU,CAAC,CAEzD;AAgBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,CAyC1E;AAMD,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,KAAK,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IAC/B,yCAAyC;IACzC,KAAK,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,sGA4FrB,CAAC;AAQF,YAAY,EAAE,YAAY,EAAE,CAAC"}