@kouji-ui/components 0.6.3 → 0.7.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kouji-ui/components",
-  "version": "0.6.3",
+  "version": "0.7.1",
   "description": "Opinionated styled Angular components built on @kouji-ui/core directives. Themed at runtime via @kouji-ui/themes.",
   "license": "MIT",
   "repository": {

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

@@ -726,9 +726,9 @@ declare class KjBadgeComponent {
  */
 declare class KjBreadcrumbComponent {
     /** Size preset cascaded onto descendants. Default `'md'`. */
-    readonly kjSize: _angular_core.InputSignal<string>;
+    readonly kjSize: _angular_core.InputSignal<string | undefined>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KjBreadcrumbComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KjBreadcrumbComponent, "nav[kj-breadcrumb], kj-breadcrumb", never, { "kjSize": { "alias": "kjSize"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, [{ directive: typeof i1.KjBreadcrumb; inputs: { "kjAriaLabel": "kjAriaLabel"; "kjSeparator": "kjSeparator"; "kjMaxItems": "kjMaxItems"; "kjOverflow": "kjOverflow"; }; outputs: {}; }]>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KjBreadcrumbComponent, "nav[kj-breadcrumb], kj-breadcrumb", never, { "kjSize": { "alias": "kjSize"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, [{ directive: typeof i1.KjBreadcrumb; inputs: { "kjAriaLabel": "kjAriaLabel"; "kjSeparator": "kjSeparator"; "kjMaxItems": "kjMaxItems"; "kjOverflow": "kjOverflow"; }; outputs: {}; }, { directive: typeof i1.KjSize; inputs: { "kjSize": "kjSize"; }; outputs: {}; }]>;
 }
 /**
  * Wraps `KjBreadcrumbList`. Renders an `<ol>` host inside the breadcrumb
@@ -772,11 +772,12 @@ declare class KjBreadcrumbLinkComponent {
     readonly kjTarget: _angular_core.InputSignal<string | undefined>;
     /** Bound to `[attr.aria-label]` on the inner `<a>`. */
     readonly kjAriaLabel: _angular_core.InputSignal<string | undefined>;
-    /** KjLink variant. Defaults to `'muted'` (the breadcrumb default). */
+    private readonly config;
+    /** KjLink variant. Defaults to `provideKjBreadcrumb(…)`'s `linkVariant` (`'muted'`). */
     readonly kjVariant: _angular_core.InputSignal<string>;
-    /** KjLink size. Defaults to `'sm'` (the breadcrumb default). */
+    /** KjLink size. Defaults to `provideKjBreadcrumb(…)`'s `linkSize` (`'sm'`). */
     readonly kjSize: _angular_core.InputSignal<string>;
-    /** Underline mode. Defaults to `'hover'`. */
+    /** Underline mode. Defaults to `provideKjBreadcrumb(…)`'s `linkUnderline` (`'hover'`). */
     readonly kjUnderline: _angular_core.InputSignal<"always" | "hover" | "none">;
     /** External-link tri-state. Forwarded to `KjLink`. */
     readonly kjExternal: _angular_core.InputSignal<boolean>;
@@ -929,8 +930,15 @@ declare class KjBreadcrumbEllipsisComponent {
  * @doc-description Themed button with variants, sizes, and built-in disabled, loading, and pressed states.
  */
 declare class KjButtonComponent {
-    readonly kjVariant: _angular_core.InputSignal<string>;
-    readonly kjSize: _angular_core.InputSignal<string>;
+    /**
+     * Visual variant. Left unset, the inner `[kjButton]` resolves it:
+     * enclosing button-group cascade, else the `provideKjButton(…)` default,
+     * else `'default'`. Binding a hardcoded default here would clobber that
+     * chain — keep it `undefined` when the consumer didn't choose one.
+     */
+    readonly kjVariant: _angular_core.InputSignal<string | undefined>;
+    /** Size preset. Resolution mirrors {@link kjVariant} (default `'md'`). */
+    readonly kjSize: _angular_core.InputSignal<string | undefined>;
     readonly kjDisabled: _angular_core.InputSignal<boolean>;
     readonly kjLoading: _angular_core.InputSignal<boolean>;
     readonly kjFullWidth: _angular_core.InputSignal<boolean>;
@@ -1699,10 +1707,10 @@ declare class KjChatHeaderComponent {
  * @doc-name chat
  */
 declare class KjChatBubbleComponent {
-    /** Visual register. Validated against `KJ_CHAT_BUBBLE_CONFIG`. */
-    readonly kjVariant: _angular_core.InputSignal<KjChatBubbleVariant>;
-    /** Density preset. Drives padding + font-size on the bubble. */
-    readonly kjSize: _angular_core.InputSignal<KjChatBubbleSize>;
+    /** Visual register. Validated against `KJ_CHAT_BUBBLE_CONFIG`. Unset falls back to the `provideKjChatBubble(…)` default (`'default'`). */
+    readonly kjVariant: _angular_core.InputSignal<KjChatBubbleVariant | undefined>;
+    /** Density preset. Drives padding + font-size on the bubble. Unset falls back to the configured default (`'md'`). */
+    readonly kjSize: _angular_core.InputSignal<KjChatBubbleSize | undefined>;
     /** Suppresses the tail unconditionally. Auto-suppression on grouped rows is independent. */
     readonly kjChatBubbleNoTail: _angular_core.InputSignal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KjChatBubbleComponent, never>;
@@ -4527,10 +4535,10 @@ declare class KjLinkComponent {
     readonly kjTarget: _angular_core.InputSignal<string | undefined>;
     /** Bound to `[attr.aria-label]` on the inner `<a>`. When set, suppresses the AT suffix injection. */
     readonly kjAriaLabel: _angular_core.InputSignal<string | undefined>;
-    /** Forwarded to the directive's `KjVariant` host directive. */
-    readonly kjVariant: _angular_core.InputSignal<string>;
-    /** Forwarded to the directive's `KjSize` host directive. */
-    readonly kjSize: _angular_core.InputSignal<string>;
+    /** Forwarded to the directive's `KjVariant` host directive. Unset falls back to the `provideKjLink(…)` default (`'primary'`). */
+    readonly kjVariant: _angular_core.InputSignal<string | undefined>;
+    /** Forwarded to the directive's `KjSize` host directive. Unset falls back to the configured default (`'inherit'`). */
+    readonly kjSize: _angular_core.InputSignal<string | undefined>;
     /** Forwarded to the directive's underline-mode reflection. */
     readonly kjUnderline: _angular_core.InputSignal<"always" | "hover" | "none">;
     /** Forwarded to the directive's external-link tri-state. */
@@ -5304,8 +5312,10 @@ declare class KjPaginationDefaultComponent {
     readonly kjTotalPages: _angular_core.InputSignal<number>;
     readonly kjSiblingCount: _angular_core.InputSignal<number>;
     readonly kjBoundaryCount: _angular_core.InputSignal<number>;
-    readonly kjVariant: _angular_core.InputSignal<string>;
-    readonly kjSize: _angular_core.InputSignal<string>;
+    /** Cascaded onto items/boundaries. Unset falls back to the `provideKjPagination(…)` default (`'default'`). */
+    readonly kjVariant: _angular_core.InputSignal<string | undefined>;
+    /** Cascaded onto items/boundaries. Unset falls back to the configured default (`'md'`). */
+    readonly kjSize: _angular_core.InputSignal<string | undefined>;
     /** Render the First / Last boundary buttons. Default `true`. */
     readonly kjShowFirstLast: _angular_core.InputSignal<boolean>;
     /** Render the trailing "Page N of M" info span. Default `false`. */
@@ -5616,14 +5626,16 @@ declare class KjProgressBarComponent {
     readonly kjAriaValuetext: _angular_core.InputSignal<string>;
     /**
      * Variant — one of the configured presets (`primary` | `success` |
-     * `warning` | `error` by default). @default 'primary'
+     * `warning` | `error` by default). Unset falls back to the
+     * `provideKjProgressBar(…)` default. @default 'primary'
      */
-    readonly kjVariant: _angular_core.InputSignal<string>;
+    readonly kjVariant: _angular_core.InputSignal<string | undefined>;
     /**
      * Size — one of the configured presets (`xs` | `sm` | `md` | `lg` by
-     * default). Drives the bar height. @default 'md'
+     * default). Drives the bar height. Unset falls back to the configured
+     * default. @default 'md'
      */
-    readonly kjSize: _angular_core.InputSignal<string>;
+    readonly kjSize: _angular_core.InputSignal<string | undefined>;
     /**
      * Accessible label for the bar. At least one of `kjAriaLabel` or
      * `kjAriaLabelledby` must be set — a progress bar without a name announces
@@ -6583,17 +6595,19 @@ declare class KjSpeedDialActionComponent {
  */
 declare class KjSpinnerComponent {
     /**
-     * Color preset reflected to `data-variant` on the host. Defaults to
-     * `'neutral'`, which resolves to `currentColor` in shipped themes — so a
-     * spinner inside a coloured surface inherits its parent's text colour.
+     * Color preset reflected to `data-variant` on the host. Unset falls back
+     * to the `provideKjSpinner(…)` default (`'neutral'`, which resolves to
+     * `currentColor` in shipped themes — so a spinner inside a coloured
+     * surface inherits its parent's text colour).
      */
-    readonly kjVariant: _angular_core.InputSignal<string>;
+    readonly kjVariant: _angular_core.InputSignal<string | undefined>;
     /**
-     * Size preset reflected to `data-size` on the host. Defaults to `'md'`.
-     * Sizes ship as `xs | sm | md | lg`; an `xl` is intentionally absent — a
-     * spinner that big almost always wants a determinate Progress Bar instead.
+     * Size preset reflected to `data-size` on the host. Unset falls back to
+     * the configured default (`'md'`). Sizes ship as `xs | sm | md | lg`; an
+     * `xl` is intentionally absent — a spinner that big almost always wants a
+     * determinate Progress Bar instead.
      */
-    readonly kjSize: _angular_core.InputSignal<string>;
+    readonly kjSize: _angular_core.InputSignal<string | undefined>;
     /**
      * Animation shape preset forwarded to `KjSpinner.kjAnimation` via the
      * composed host directive. Reflects on the host as `data-animation`.
@@ -6628,7 +6642,7 @@ declare class KjSpinnerComponent {
     protected readonly shouldRenderHiddenLabel: _angular_core.Signal<boolean>;
     constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KjSpinnerComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KjSpinnerComponent, "kj-spinner", never, { "kjVariant": { "alias": "kjVariant"; "required": false; "isSignal": true; }; "kjSize": { "alias": "kjSize"; "required": false; "isSignal": true; }; "kjAnimation": { "alias": "kjAnimation"; "required": false; "isSignal": true; }; "kjAriaLabel": { "alias": "kjAriaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1.KjSpinner; inputs: { "kjAnimation": "kjAnimation"; "kjAriaLabel": "kjAriaLabel"; }; outputs: {}; }]>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KjSpinnerComponent, "kj-spinner", never, { "kjVariant": { "alias": "kjVariant"; "required": false; "isSignal": true; }; "kjSize": { "alias": "kjSize"; "required": false; "isSignal": true; }; "kjAnimation": { "alias": "kjAnimation"; "required": false; "isSignal": true; }; "kjAriaLabel": { "alias": "kjAriaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1.KjSpinner; inputs: { "kjAnimation": "kjAnimation"; "kjAriaLabel": "kjAriaLabel"; }; outputs: {}; }, { directive: typeof i1.KjVariant; inputs: { "kjVariant": "kjVariant"; }; outputs: {}; }, { directive: typeof i1.KjSize; inputs: { "kjSize": "kjSize"; }; outputs: {}; }]>;
 }
 
 /**
@@ -8006,10 +8020,19 @@ declare class KjTableErrorTemplate {
  * @doc-is-main
  */
 declare class KjTabsComponent {
-    /** Visual chrome for the tab strip. Reflected as `data-variant` on the host. */
-    readonly variant: _angular_core.InputSignal<"default" | "pills">;
+    /**
+     * Visual chrome for the tab strip, reflected as `data-variant` on the host.
+     * Ships `'default'` (underline strip) and `'pills'` (recessed chip tray);
+     * register more with `provideKjTabs({ variants: [...] })` and key a CSS rule
+     * on `.kj-tabs[data-variant="…"]`.
+     *
+     * Declared here for the docs extractor only — the value is owned by the
+     * composed `KjVariant` preset directive (see `hostDirectives`), which is
+     * what actually resolves and reflects it.
+     */
+    readonly variant: _angular_core.InputSignal<string | undefined>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KjTabsComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KjTabsComponent, "kj-tabs", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, [{ directive: typeof i1.KjTabs; inputs: { "kjValue": "value"; "kjOrientation": "orientation"; "kjActivationMode": "activationMode"; }; outputs: { "kjValueChange": "valueChange"; }; }]>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KjTabsComponent, "kj-tabs", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, [{ directive: typeof i1.KjTabs; inputs: { "kjValue": "value"; "kjOrientation": "orientation"; "kjActivationMode": "activationMode"; }; outputs: { "kjValueChange": "valueChange"; }; }, { directive: typeof i1.KjVariant; inputs: { "kjVariant": "variant"; }; outputs: {}; }]>;
 }
 /**
  * Styled wrapper around `KjTabList`. Hosts `role="tablist"` (provided by the
@@ -8294,10 +8317,10 @@ declare class KjTextareaComponent implements ControlValueAccessor {
     readonly kjInvalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Disables the textarea. Reflects `aria-disabled` and native `disabled`. */
     readonly kjDisabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Theme variant. Configurable via `provideKjTextarea(...)`. */
-    readonly kjVariant: _angular_core.InputSignal<string>;
-    /** Theme size. Configurable via `provideKjTextarea(...)`. */
-    readonly kjSize: _angular_core.InputSignal<string>;
+    /** Theme variant. Unset falls back to the `provideKjTextarea(...)` default (`'outlined'`). */
+    readonly kjVariant: _angular_core.InputSignal<string | undefined>;
+    /** Theme size. Unset falls back to the `provideKjTextarea(...)` default (`'md'`). */
+    readonly kjSize: _angular_core.InputSignal<string | undefined>;
     /** @internal stable id for the counter / aria-describedby wiring. */
     protected readonly counterId: string;
     private readonly cvaValue;