@urbicon-ui/blocks 6.21.1 → 6.21.3

package/dist/utils/use-form-field.svelte.d.ts

@@ -1,9 +1,9 @@
 /**
  * `useFormField` — Single source of truth for the ARIA wiring that every
- * Form primitive duplicates: error/hint id derivation, `aria-describedby`,
- * `aria-invalid`, and the mutually-exclusive error-over-hint convention.
+ * Form primitive duplicates: error/helper id derivation, `aria-describedby`,
+ * `aria-invalid`, and the mutually-exclusive error-over-helper convention.
  *
- * Layout (label position, error/hint placement, required marker) stays
+ * Layout (label position, error/helper placement, required marker) stays
  * component-specific because real Form primitives differ in shape — Input
  * stacks the label on top, Checkbox/Toggle put it inline, RadioGroup and
  * SegmentGroup have a group caption + per-item labels. The hook does not
@@ -23,11 +23,11 @@
  * ```svelte
  * <script lang="ts">
  *   import { useFormField } from './index.js';
- *   let { id: idProp, hint, error, required, disabled, label } = $props();
+ *   let { id: idProp, helper, error, required, disabled, label } = $props();
  *   const propsId = $props.id();
  *   const ff = useFormField(() => ({
  *     fieldId: idProp ?? `field-${propsId}`,
- *     hint,
+ *     helper,
  *     error,
  *     required,
  *     disabled
@@ -47,8 +47,8 @@ export interface UseFormFieldInputs {
     /** The DOM id to apply to the field element. Compute once in the caller via `$props.id()`. */
     fieldId: string;
     /** Helper text shown below the field when no error is set. */
-    hint?: string;
-    /** Error message — when truthy, replaces `hint` and flags the field invalid. */
+    helper?: string;
+    /** Error message — when truthy, replaces `helper` and flags the field invalid. */
     error?: string;
     /** Required flag — exposed verbatim for the caller's label markup. */
     required?: boolean;
@@ -60,8 +60,8 @@ export interface UseFormFieldReturn {
     readonly fieldId: string;
     /** Id of the error description, or undefined when no error is set. */
     readonly errorId: string | undefined;
-    /** Id of the hint description, or undefined when error is set or no hint is given. */
-    readonly hintId: string | undefined;
+    /** Id of the helper description, or undefined when error is set or no helper is given. */
+    readonly helperId: string | undefined;
     /** Concatenation suitable for `aria-describedby` (`undefined` when both are unset). */
     readonly describedBy: string | undefined;
     /** `true` iff `error` is truthy. Use for `aria-invalid={ff.invalid || undefined}`. */

package/dist/utils/use-form-field.svelte.js

@@ -1,9 +1,9 @@
 /**
  * `useFormField` — Single source of truth for the ARIA wiring that every
- * Form primitive duplicates: error/hint id derivation, `aria-describedby`,
- * `aria-invalid`, and the mutually-exclusive error-over-hint convention.
+ * Form primitive duplicates: error/helper id derivation, `aria-describedby`,
+ * `aria-invalid`, and the mutually-exclusive error-over-helper convention.
  *
- * Layout (label position, error/hint placement, required marker) stays
+ * Layout (label position, error/helper placement, required marker) stays
  * component-specific because real Form primitives differ in shape — Input
  * stacks the label on top, Checkbox/Toggle put it inline, RadioGroup and
  * SegmentGroup have a group caption + per-item labels. The hook does not
@@ -23,11 +23,11 @@
  * ```svelte
  * <script lang="ts">
  *   import { useFormField } from './index.js';
- *   let { id: idProp, hint, error, required, disabled, label } = $props();
+ *   let { id: idProp, helper, error, required, disabled, label } = $props();
  *   const propsId = $props.id();
  *   const ff = useFormField(() => ({
  *     fieldId: idProp ?? `field-${propsId}`,
- *     hint,
+ *     helper,
  *     error,
  *     required,
  *     disabled
@@ -51,20 +51,20 @@
 export function computeFormFieldAria(input) {
     const fieldId = input.fieldId;
     const errorId = input.error ? `${fieldId}-error` : undefined;
-    // Hint is suppressed when an error is present — the error message is
+    // Helper is suppressed when an error is present — the error message is
     // the more important description at that point. This is the same
     // exclusive convention as Material / Carbon / Polaris.
-    const hintId = !input.error && input.hint ? `${fieldId}-hint` : undefined;
-    // Error first, hint second — error is the more semantically urgent
+    const helperId = !input.error && input.helper ? `${fieldId}-helper` : undefined;
+    // Error first, helper second — error is the more semantically urgent
     // description and should reach assistive tech first.
-    const describedBy = [errorId, hintId].filter(Boolean).join(' ') || undefined;
+    const describedBy = [errorId, helperId].filter(Boolean).join(' ') || undefined;
     const invalid = !!input.error;
     const required = !!input.required;
     const disabled = !!input.disabled;
     return {
         fieldId,
         errorId,
-        hintId,
+        helperId,
         describedBy,
         invalid,
         required,
@@ -80,8 +80,8 @@ export function useFormField(inputs) {
         get errorId() {
             return result.errorId;
         },
-        get hintId() {
-            return result.hintId;
+        get helperId() {
+            return result.helperId;
         },
         get describedBy() {
             return result.describedBy;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@urbicon-ui/blocks",
-  "version": "6.21.1",
+  "version": "6.21.3",
   "description": "Svelte 5 UI component library with Tailwind CSS 4, OKLCH design tokens and zero runtime dependencies",
   "license": "MIT",
   "repository": {
@@ -91,8 +91,8 @@
     "@sveltejs/package": "^2.5.8",
     "@sveltejs/vite-plugin-svelte": "^7.0.0",
     "@tailwindcss/vite": "^4.3.1",
-    "@urbicon-ui/i18n": "6.21.1",
-    "@urbicon-ui/shared-types": "6.21.1",
+    "@urbicon-ui/i18n": "6.21.3",
+    "@urbicon-ui/shared-types": "6.21.3",
     "prettier": "^3.8.4",
     "prettier-plugin-svelte": "^4.1.1",
     "prettier-plugin-tailwindcss": "^0.8.0",