@kouji-ui/core 0.3.0 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kouji-ui/core",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Headless Angular 21 UI primitives — directives over CDK with WCAG 2.1 AAA semantics and zero CSS.",
   "license": "MIT",
   "repository": {

package/types/kouji-ui-core.d.ts

@@ -9008,11 +9008,15 @@ declare class KjFieldHelp {
  *
  * Carries `role="alert"` + `aria-live="polite"` so newly-shown errors
  * are announced. Hidden via `[hidden]` when the field is not in error
- * state.
+ * state — unless `kjFieldErrorReserve` is set, in which case the element
+ * keeps its box (`data-hidden` + `visibility: hidden` styling) so error
+ * text can appear and disappear without shifting the surrounding layout.
  *
  * @example
  * ```html
  * <span kjFieldError>Please enter a valid email.</span>
+ * <!-- Reserve the line so showing the error never moves the layout: -->
+ * <span kjFieldError kjFieldErrorReserve>Please enter a valid email.</span>
  * ```
  * @doc-category Core/Inputs
  * @doc
@@ -9022,10 +9026,16 @@ declare class KjFieldError {
     /** @internal */ readonly ctx: _kouji_ui_core.KjFieldContext;
     /** Override the auto-minted host id. */
     readonly kjFieldErrorId: _angular_core.InputSignal<string | undefined>;
+    /**
+     * When set, the element keeps its layout box while the field is valid
+     * (`visibility: hidden` via `data-hidden` instead of `display: none`),
+     * so the error appearing never repositions the fields around it.
+     */
+    readonly kjFieldErrorReserve: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** @internal */ readonly id: () => string;
     constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KjFieldError, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KjFieldError, "[kjFieldError]", never, { "kjFieldErrorId": { "alias": "kjFieldErrorId"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KjFieldError, "[kjFieldError]", never, { "kjFieldErrorId": { "alias": "kjFieldErrorId"; "required": false; "isSignal": true; }; "kjFieldErrorReserve": { "alias": "kjFieldErrorReserve"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /**