@skra/ui 0.3.1 → 0.5.0

package/types/skra-ui-datepicker.d.ts

@@ -10,40 +10,70 @@ interface WeekdayHeader {
     readonly long: string;
 }
 
-interface DayCell {
+/** The granularity of the emitted value (ADR 0057 R1). `'year'` is reserved, not yet implemented. */
+type SkraDatePrecision = 'day' | 'month';
+
+/**
+ * One cell of the calendar grid — a day in `day` view, a month in `month` view. ONE model for both
+ * (ADR 0057 R8): the views differ in what a cell means, never in how a cell behaves.
+ */
+interface GridCell {
     readonly key: string;
+    /** The value this cell commits, at the active precision. `null` = layout padding (day view only). */
     readonly iso: string | null;
-    readonly dayNum: string;
-    readonly srName: string;
+    /** Visible text — the localized day number, or the localized full month name. */
+    readonly label: string;
+    /**
+     * The ADR 033 Path-2 `[skra-sr-only]` extension, INCLUDING its leading separator, and never a
+     * restatement of `label` (ADR 0057 R6).
+     */
+    readonly srExt: string;
     readonly today: boolean;
     readonly selected: boolean;
     readonly disabled: boolean;
     readonly focused: boolean;
 }
-interface WeekRow {
+interface GridRow {
     readonly key: number;
-    readonly days: DayCell[];
+    readonly cells: GridCell[];
 }
 /**
- * SkraDatePicker — pick a single **calendar date** from an APG Date Picker grid in the native top layer.
- * Second Tier-3 component. A value-display **trigger** (`<button>`) opens a non-modal top-layer **calendar
- * panel** (Popover API, `popover="auto"`, ADR 0044). The value is an **ISO 8601 date-only string**
- * (`YYYY-MM-DD`), consumer-owned (ADR 0050/037 — NO `@angular/forms`); all date math is the zoneless
- * UTC-calculator discipline in `calendar-math` (no date library). Localization (month/weekday names,
- * first-day-of-week, digits) is `Intl`-derived in `calendar-intl`; the 2-D grid keyboard is the
- * hand-rolled `SkraCalendarKeyboard` (ADR 0044 §7 — roving REAL focus, not aria-activedescendant).
+ * SkraDatePicker — pick a **calendar date** or a **calendar month** from an APG Date Picker grid in the
+ * native top layer. Second Tier-3 component. A value-display **trigger** (`<button>`) opens a non-modal
+ * top-layer **calendar panel** (Popover API, `popover="auto"`, ADR 0044). The value is an **ISO 8601 string**
+ * truncated to the active `precision` (`YYYY-MM-DD` / `YYYY-MM`), consumer-owned (ADR 0050/0057/037 — NO
+ * `@angular/forms`); all date math is the zoneless UTC-calculator discipline in `calendar-math` (no date
+ * library). Localization (month/weekday names, first-day-of-week, digits) is `Intl`-derived in
+ * `calendar-intl`; the 2-D grid keyboard is the hand-rolled `SkraCalendarKeyboard` (ADR 0044 §7 — roving
+ * REAL focus, not aria-activedescendant).
+ *
+ * **Precision is a runtime axis, not a second component (ADR 0057).** `precision="month"` swaps the 7×N day
+ * grid for a 3×4 quarter-aligned month grid inside the SAME trigger, panel, positioner, field DI wiring,
+ * dismissal model, selection model and keyboard controller. The value channel does not widen — `YYYY-MM` is
+ * a truncation of `YYYY-MM-DD`, both `string` — which is exactly why this is an input and cardinality
+ * (ADR 0046) is not. `week` / `time` / `datetime-local` are excluded by rule (ADR 0057 R5): they need a
+ * second calendar coordinate system or are not grids at all, and stay the native `skraInput` path.
  *
- * No projected content: the calendar days are GENERATED (the structural divergence from select/combobox —
- * there is no `skra-option` reuse). The only focusable element in the open panel is the roving day cell;
- * the month-nav buttons are pointer affordances (`tabindex="-1"`, driven by PageUp/PageDown on keyboard),
- * and Tab dismisses — so no focus-containment machinery is needed (spec Q-1).
+ * No projected content: the cells are GENERATED (the structural divergence from select/combobox — there is
+ * no `skra-option` reuse). The only focusable element in the open panel is the roving cell; the period-nav
+ * buttons are pointer affordances (`tabindex="-1"`, driven by PageUp/PageDown on keyboard), and Tab
+ * dismisses — so no focus-containment machinery is needed (spec Q-1).
  *
  * Full contract: adr/specs/component-datepicker-spec.md.
  */
 declare class SkraDatePicker {
-    /** Consumer-owned value: ISO 8601 date-only (`YYYY-MM-DD`); `''` = unset. NEVER a Date (ADR 0050/037). */
+    /**
+     * Consumer-owned value: an ISO 8601 key truncated to `precision` — `YYYY-MM-DD` (`day`) or `YYYY-MM`
+     * (`month`); `''` = unset. NEVER a Date (ADR 0050/0057/037).
+     */
     readonly value: _angular_core.InputSignal<string>;
-    /** Inclusive lower bound (ISO); `''` = unbounded (ADR 0050 §2). */
+    /**
+     * Value granularity (ADR 0057 R1). `'day'` (default) emits `YYYY-MM-DD` over a 7×N day grid; `'month'`
+     * emits `YYYY-MM` over a 3×4 quarter-aligned month grid. NOT a look input, NOT a cardinality flag, and
+     * NOT reflected to a `data-skra-*` attribute — precision is configuration, not state.
+     */
+    readonly precision: _angular_core.InputSignal<SkraDatePrecision>;
+    /** Inclusive lower bound (ISO); `''` = unbounded (ADR 0050 §2, truncated to `precision` per ADR 0057 R4). */
     readonly min: _angular_core.InputSignal<string>;
     /** Inclusive upper bound (ISO); `''` = unbounded. */
     readonly max: _angular_core.InputSignal<string>;
@@ -58,7 +88,7 @@ declare class SkraDatePicker {
     /** Standalone availability source — `SkraFieldContext` wins when present. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Fires ONLY on user date selection — never on a programmatic `value()` change (ADR 037/0050). */
+    /** Fires ONLY on user selection — never on a programmatic `value()`/`precision()` change (ADR 037/0057 R3). */
     readonly valueChange: _angular_core.OutputEmitterRef<string>;
     private readonly triggerRef;
     private readonly panelRef;
@@ -66,12 +96,28 @@ declare class SkraDatePicker {
     private readonly injector;
     private readonly keyboard;
     readonly panelId: string;
-    readonly monthYearId: string;
+    readonly periodId: string;
     protected readonly isOpen: _angular_core.WritableSignal<boolean>;
+    /**
+     * Which grid is on screen. Seeded from `precision` and writable in between (ADR 0057 R9) so the deferred
+     * month/year quick-pick — stepping UP from the day grid to pick a month, then back down — is an additive
+     * change rather than a rewrite. In MVP nothing writes it, so `view() === precision()` always.
+     *
+     * NOTE for whoever lands quick-pick: it adds a second focusable element to the open panel and therefore
+     * RE-OPENS spec Q-1, which was resolved on the premise that the panel holds exactly one focusable stop
+     * and Tab dismisses. Re-resolve Q-1 first.
+     */
+    protected readonly view: _angular_core.WritableSignal<SkraDatePrecision>;
     /** Today's LOCAL date (ADR 0050 §3) — stable for the session. */
     private readonly todayIso;
-    /** The roving-focus day; SINGLE source of truth for what the grid shows AND which cell is focusable. */
-    private readonly focusedIso;
+    /** The roving-focus cell; SINGLE source of truth for what the grid shows AND which cell is focusable. */
+    private readonly focusedKey;
+    /**
+     * The focused key re-keyed to the active view. A `precision` flip while the panel is closed leaves a key
+     * at the previous granularity behind; re-keying defensively keeps every downstream `computed` total
+     * without an effect or a reset cascade. `onOpen` re-seeds properly from the value.
+     */
+    private readonly focusedAt;
     private positioner?;
     /** Set when a close should return focus to the trigger (keyboard/select), not on outside-click. */
     private returnFocus;
@@ -81,50 +127,80 @@ declare class SkraDatePicker {
     protected readonly isRequired: _angular_core.Signal<boolean>;
     protected readonly triggerId: _angular_core.Signal<string | null>;
     protected readonly describedBy: _angular_core.Signal<string | null>;
-    /** The committed value, defensively normalized: invalid/out-of-range → `''` for display (ADR 0050 §1). */
-    protected readonly selectedIso: _angular_core.Signal<string>;
+    /**
+     * The committed value, defensively normalized: wrong-format-for-precision, invalid or out-of-range → `''`
+     * for display (ADR 0050 §1 as amended by ADR 0057 R3). Keyed on `precision` (what the value IS), not on
+     * `view` (what is on screen) — the two only diverge once quick-pick lands.
+     */
+    protected readonly selectedKey: _angular_core.Signal<string>;
     protected readonly formattedValue: _angular_core.Signal<string>;
     private readonly firstDow;
-    /** The month being shown — always the focused day's month (keeps the roving tabindex valid). */
-    private readonly displayedMonth;
-    protected readonly monthYearLabel: _angular_core.Signal<string>;
-    protected readonly prevMonthLabel: _angular_core.Signal<string>;
-    protected readonly nextMonthLabel: _angular_core.Signal<string>;
+    /**
+     * The container the grid shows — the focused cell's MONTH in day view, its YEAR in month view (`m` is
+     * then meaningless). Always derived from the focused cell, which keeps the roving tabindex valid.
+     */
+    private readonly displayed;
+    protected readonly periodLabel: _angular_core.Signal<string>;
+    protected readonly prevPeriodLabel: _angular_core.Signal<string>;
+    protected readonly nextPeriodLabel: _angular_core.Signal<string>;
+    /**
+     * `aria-current` token for the cell holding today. ARIA 1.2 has no `month` value, and `date` is
+     * defined as the current DATE within a collection of dates — accurate for a day cell, a stretch for a
+     * month cell, where the generic `true` ("current item within a set") is the honest mapping.
+     */
+    protected readonly currentToken: _angular_core.Signal<"true" | "date">;
     protected readonly weekdayHeadersView: _angular_core.Signal<WeekdayHeader[]>;
-    protected readonly weeks: _angular_core.Signal<WeekRow[]>;
+    /** ONE grid renderer, parameterized by view — the ADR 0057 R8 claim, made structural. */
+    protected readonly rows: _angular_core.Signal<GridRow[]>;
     constructor();
+    /**
+     * The dev-mode diagnostic, or `null` when the inputs are coherent. Split out of the constructor so it
+     * is a plain reactive expression rather than a closure buried in a lifecycle hook.
+     */
+    private readonly devWarning;
     protected onTriggerClick(event: MouseEvent): void;
     protected onTriggerKeydown(event: KeyboardEvent): void;
     protected onGridKeydown(event: KeyboardEvent): void;
-    protected goToPreviousMonth(): void;
-    protected goToNextMonth(): void;
-    protected selectDate(iso: string): void;
+    protected goToPreviousPeriod(): void;
+    protected goToNextPeriod(): void;
+    /** One period = one month (day view) / one year (month view). */
+    private stepPeriod;
+    protected selectCell(iso: string): void;
     protected onPanelToggle(event: Event): void;
     private onOpen;
     private onClose;
     private open;
     private close;
-    /** Seed the focused day on open: the valid current value, else today, clamped into `[min,max]`. */
+    /** Seed the focused cell on open: the valid current value, else today, clamped into `[min,max]`. */
     private seedFocus;
-    private monthOffsetLabel;
+    private buildDayRows;
+    private buildMonthRows;
+    /**
+     * The accessible-name separator is baked into the extension rather than left to the template or to the
+     * engine: `[skra-sr-only]` is absolutely positioned, so whether the name computation inserts a space
+     * between the visible text and the extension is engine-dependent. One explicit space, asserted by test.
+     */
+    private srExtension;
+    private periodOffsetLabel;
     private emptyCell;
     private scheduleFocus;
-    private focusActiveDay;
+    private focusActiveCell;
     /** Read a length comp token (px/rem) off the panel computed style for the positioner. */
     private cssLenPx;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SkraDatePicker, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SkraDatePicker, "skra-datepicker", ["skraDatePicker"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SkraDatePicker, "skra-datepicker", ["skraDatePicker"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "precision": { "alias": "precision"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
 }
 
 /**
  * The intent a key produces in the calendar grid. The controller is PURE (no DOM, no focus, no signals);
- * the `skra-datepicker` component applies the intent — sets `focusedIso`/`displayedMonth` and moves REAL
- * DOM focus (roving). `monthChanged` tells the component the grid will re-stamp so it must re-`focus()`.
+ * the `skra-datepicker` component applies the intent — sets `focusedKey`/the displayed period and moves REAL
+ * DOM focus (roving). The component re-focuses unconditionally after a `focus` intent, so the intent
+ * carries no "did the period change" hint: a field nothing reads is public API that only costs (dropped
+ * in the ADR 0057 review, together with its `monthChanged` predecessor).
  */
 type CalendarKeyIntent = {
     readonly type: 'focus';
     readonly iso: string;
-    readonly monthChanged: boolean;
 } | {
     readonly type: 'select';
 } | {
@@ -133,20 +209,37 @@ type CalendarKeyIntent = {
     readonly type: 'none';
 };
 interface CalendarKeyContext {
-    /** The currently focused day (ISO). */
+    /** The currently focused cell, as an ISO key AT `view` precision (`YYYY-MM-DD` or `YYYY-MM`). */
     readonly focusedIso: string;
-    /** First day of week, ISO 1=Mon … 7=Sun (already resolved by `calendar-intl`). */
+    /** First day of week, ISO 1=Mon … 7=Sun (already resolved by `calendar-intl`). Day view only. */
     readonly firstDayOfWeek: number;
+    /** Which grid is on screen — the ADR 0057 precision axis. */
+    readonly view: SkraDatePrecision;
 }
 /**
  * SkraCalendarKeyboard — the WAI-ARIA APG **Date Picker Dialog** grid keyboard model (2-D), confined to
  * ONE file. The THIRD per-pattern keyboard controller and the FIRST that does NOT wrap a CDK key manager:
  * neither `FocusKeyManager` (Menu) nor `ActiveDescendantKeyManager` (Select/Combobox) models a 2-D grid
- * whose focusable cell set is recomputed on month change (ADR 0044 §7 note, 2026-06-14). Date arithmetic
+ * whose focusable cell set is recomputed on period change (ADR 0044 §7 note, 2026-06-14). Date arithmetic
  * is delegated to `calendar-math` (the ADR 0050 single math site); this controller only maps keys to
  * intents. Roving REAL focus (NOT `aria-activedescendant`) — the divergence from Select/Combobox.
  *
- * Navigation is unclamped (a user may move onto a disabled out-of-range day — APG-discoverable); only
+ * **One model, two unit sets (ADR 0057 R8).** The `day` and `month` views share every key, every intent and
+ * the whole `switch` below; they differ ONLY in what a step, a row and a page mean. That parameterization is
+ * the falsifiable claim behind treating precision as a runtime axis rather than a second component — if this
+ * ever needs a second `resolve`, the classification was wrong and the feature splits.
+ *
+ * | Key                   | `day` view                    | `month` view                  |
+ * | --------------------- | ----------------------------- | ----------------------------- |
+ * | Left / Right          | ∓1 day                        | ∓1 month                      |
+ * | Up / Down             | ∓7 days (one week row)        | ∓3 months (one quarter row)   |
+ * | Home / End            | first / last day of the week   | first / last month of the quarter |
+ * | PageUp / PageDown     | ∓1 month (clamped)            | ∓1 year                       |
+ * | Shift+PageUp / -Down  | ∓1 year (clamped)             | ∓10 years                     |
+ *
+ * Home/End stay ROW-scoped in both views — APG grid semantics, and one rule beats two.
+ *
+ * Navigation is unclamped (a user may move onto a disabled out-of-range cell — APG-discoverable); only
  * SELECTION is range-guarded, and that guard lives in the component (one place, shared with pointer click).
  */
 declare class SkraCalendarKeyboard {
@@ -154,11 +247,18 @@ declare class SkraCalendarKeyboard {
         key: string;
         shiftKey: boolean;
     }, ctx: CalendarKeyContext): CalendarKeyIntent;
+    /** One cell = one day / one month. */
+    private step;
+    /** Row start: the week (day view) / the calendar quarter (month view). */
+    private rowStart;
+    /** Row end: last day of the week / last month of the quarter. */
+    private rowEnd;
+    /** Page = the next container up; Shift = the one above that. Day math stays clamped (ADR 0050 §4). */
+    private page;
     private toFocus;
-    private monthChanged;
     private weekStart;
 }
 
 export { SkraCalendarKeyboard, SkraDatePicker };
-export type { CalendarKeyContext, CalendarKeyIntent };
+export type { CalendarKeyContext, CalendarKeyIntent, SkraDatePrecision };
 //# sourceMappingURL=skra-ui-datepicker.d.ts.map

package/types/skra-ui-datepicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skra-ui-datepicker.d.ts","sources":["../../../../libs/ui/datepicker/src/lib/datepicker/calendar-intl.ts","../../../../libs/ui/datepicker/src/lib/datepicker/datepicker.ts","../../../../libs/ui/datepicker/src/lib/datepicker/calendar-keyboard.ts"],"mappings":";;;;AAWA;UACiB,aAAa;;AAE5B;AACA;AACA;AACD;;AC2BD,UAAU,OAAO;AACf;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACD;AAED,UAAU,OAAO;AACf;AACA,mBAAe,OAAO;AACvB;AAID;;;;;;;;;;;;;;;AAeG;AACH,cAyJa,cAAc;;oBAEX,aAAA,CAAA,WAAA;;kBAEF,aAAA,CAAA,WAAA;;kBAEA,aAAA,CAAA,WAAA;;qBAEG,aAAA,CAAA,WAAA;;6BAEQ,aAAA,CAAA,WAAA;;0BAEH,aAAA,CAAA,WAAA;;wBAEF,aAAA,CAAA,WAAA,CAAA,aAAA;;uBAED,aAAA,CAAA,wBAAA;uBACA,aAAA,CAAA,wBAAA;;0BAGG,aAAA,CAAA,gBAAA;AAEpB;AAEA;AAEA;AACA;AACA;;;AAIA,+BAAyB,aAAA,CAAA,cAAA;;AAGzB;;AAEA;;;;AAOA,mCAA6B,aAAA,CAAA,MAAA;AAG7B,mCAA6B,aAAA,CAAA,MAAA;AAG7B,iCAA2B,aAAA,CAAA,MAAA;AAG3B,mCAA6B,aAAA,CAAA,MAAA;AAG7B,kCAA4B,aAAA,CAAA,MAAA;AAG5B,oCAA8B,aAAA,CAAA,MAAA;;AAM9B,oCAA8B,aAAA,CAAA,MAAA;AAI9B,uCAAiC,aAAA,CAAA,MAAA;AAGjC;;AAIA;AAIA,uCAAiC,aAAA,CAAA,MAAA;AAOjC,uCAAiC,aAAA,CAAA,MAAA;AACjC,uCAAiC,aAAA,CAAA,MAAA;AACjC,2CAAqC,aAAA,CAAA,MAAA,CAAAA,aAAA;AAGrC,8BAAwB,aAAA,CAAA,MAAA,CAAA,OAAA;;AAqDxB,oCAAgC,UAAU;AAI1C,sCAAkC,aAAa;AAS/C,mCAA+B,aAAa;;;AAwC5C;AAQA,mCAA+B,KAAK;AAOpC;AAiBA;AASA;AAGA;;AAKA;AAMA;AAMA;AAaA;AAIA;;AASA;oDA7RW,cAAc;sDAAd,cAAc;AAyS1B;;ACxgBD;;;;AAIG;AACG,KAAM,iBAAiB;AAEvB;AACA;AACA;;AAEA;;AACA;;AACA;;UAEW,kBAAkB;;AAEjC;;AAEA;AACD;AAID;;;;;;;;;;AAUG;AACH,cAAa,oBAAoB;;;;AAEY,YACpC,kBAAkB,GACtB,iBAAiB;AA8CpB;AAQA;AAMA;AAMD;;;;","names":["__calendar_intl.WeekdayHeader"]}
+{"version":3,"file":"skra-ui-datepicker.d.ts","sources":["../../../../libs/ui/datepicker/src/lib/datepicker/calendar-intl.ts","../../../../libs/ui/datepicker/src/lib/datepicker/calendar-math.ts","../../../../libs/ui/datepicker/src/lib/datepicker/datepicker.ts","../../../../libs/ui/datepicker/src/lib/datepicker/calendar-keyboard.ts"],"mappings":";;;;AA6BA;UACiB,aAAa;;AAE5B;AACA;AACA;AACD;;ACsID;KACY,iBAAiB;;AChH7B;;;AAGG;AACH,UAAU,QAAQ;AAChB;;AAEA;;AAEA;AACA;;;AAGG;AACH;AACA;AACA;AACA;AACA;AACD;AAED,UAAU,OAAO;AACf;AACA,oBAAgB,QAAQ;AACzB;AAID;;;;;;;;;;;;;;;;;;;;;;;AAuBG;AACH,cA+Ja,cAAc;AACzB;;;AAGG;oBACW,aAAA,CAAA,WAAA;AACd;;;;AAIG;wBACe,aAAA,CAAA,WAAA,CAAA,iBAAA;;kBAEN,aAAA,CAAA,WAAA;;kBAEA,aAAA,CAAA,WAAA;;qBAEG,aAAA,CAAA,WAAA;;6BAEQ,aAAA,CAAA,WAAA;;0BAEH,aAAA,CAAA,WAAA;;wBAEF,aAAA,CAAA,WAAA,CAAA,aAAA;;uBAED,aAAA,CAAA,wBAAA;uBACA,aAAA,CAAA,wBAAA;;0BAGG,aAAA,CAAA,gBAAA;AAEpB;AAEA;AAEA;AACA;AACA;;;AAIA,+BAAyB,aAAA,CAAA,cAAA;AAEzB;;;;;;;;AAQG;AACH,6BAAuB,aAAA,CAAA,cAAA,CAAA,iBAAA;;AAGvB;;AAEA;AACA;;;;AAIG;AACH;;;;AAUA,mCAA6B,aAAA,CAAA,MAAA;AAG7B,mCAA6B,aAAA,CAAA,MAAA;AAG7B,iCAA2B,aAAA,CAAA,MAAA;AAG3B,mCAA6B,aAAA,CAAA,MAAA;AAG7B,kCAA4B,aAAA,CAAA,MAAA;AAG5B,oCAA8B,aAAA,CAAA,MAAA;AAK9B;;;;AAIG;AACH,oCAA8B,aAAA,CAAA,MAAA;AAQ9B,uCAAiC,aAAA,CAAA,MAAA;AAKjC;AAGA;;;AAGG;AACH;AASA,oCAA8B,aAAA,CAAA,MAAA;AAM9B,wCAAkC,aAAA,CAAA,MAAA;AAGlC,wCAAkC,aAAA,CAAA,MAAA;AAGlC;;;;AAIG;AACH,qCAA+B,aAAA,CAAA,MAAA;AAG/B,2CAAqC,aAAA,CAAA,MAAA,CAAAA,aAAA;;AAIrC,6BAAuB,aAAA,CAAA,MAAA,CAAA,OAAA;;AAgCvB;;;AAGG;AACH;AAsCA,oCAAgC,UAAU;AAI1C,sCAAkC,aAAa;AAS/C,mCAA+B,aAAa;;;;AAwC5C;AAUA;AAuBA,mCAA+B,KAAK;AAOpC;AAiBA;AASA;AAGA;;AAKA;AAQA;AA0BA;AAwBA;;;;AAIG;AACH;AAIA;AAQA;AAaA;AAIA;;AASA;oDArcW,cAAc;sDAAd,cAAc;AAid1B;;ACjtBD;;;;;;AAMG;AACG,KAAM,iBAAiB;AAEvB;AACA;;AAEA;;AACA;;AACA;;UAEW,kBAAkB;;AAEjC;;AAEA;;AAEA,mBAAe,iBAAiB;AACjC;AAOD;;;;;;;;;;;;;;;;;;;;;;;;;AAyBG;AACH,cAAa,oBAAoB;;;;AAEY,YACpC,kBAAkB,GACtB,iBAAiB;;AA+BpB;;AAOA;;AAOA;;AAOA;AAYA;AAIA;AAMD;;;;","names":["__calendar_intl.WeekdayHeader"]}

package/types/skra-ui-layout.d.ts

@@ -81,6 +81,37 @@ declare class SkraGrid {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SkraGrid, "div[skraGrid], section[skraGrid], article[skraGrid], main[skraGrid], nav[skraGrid], aside[skraGrid], header[skraGrid], footer[skraGrid], form[skraGrid], figure[skraGrid], ul[skraGrid], ol[skraGrid], menu[skraGrid]", never, { "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "gap": { "alias": "gap"; "required": false; "isSignal": true; }; "flow": { "alias": "flow"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; "justifyItems": { "alias": "justifyItems"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
-export { SkraBox, SkraGrid, SkraStack };
-export type { BoxDisplay, BoxPadding, GridAlign, GridColumns, GridFlow, GridGap, GridMin, StackAlign, StackDirection, StackGap, StackJustify };
+type SurfacePadding = 'none' | 'sm' | 'md' | 'lg';
+/**
+ * SkraSurface — the painted container primitive (ADR 0053), Box's painting sibling.
+ *
+ * Component-on-native-host: layers onto a generic flow/sectioning container via the
+ * bounded host allowlist below — NEVER a `<skra-surface>` custom element, and never
+ * an interactive host (ADR 0055 R3.1: `a[skraSurface]` / `button[skraSurface]` are
+ * unsupported). "Card", "Panel" and "Tile" are consumer compositions of Surface +
+ * `[skraStack]`/`[skraBox]` + a heading — not Skra components (ADR 0053 rule 1).
+ *
+ * **State-reading doctrine (ADR 0055).** Surface is a READER of state, never an
+ * OWNER of state. It exposes no `interactive`/`hoverable`/`selected`/`elevation`
+ * input and emits no `role`/`tabindex`/`aria-*`. Focus and selection are READ from
+ * the markup the consumer authored (see surface.scss) — which is why an
+ * informational card gets no interactive paint with zero API, and why a selected
+ * card can never disagree with what assistive technology announces.
+ *
+ * Zero baked semantics: sectioning role and accessible name are 100% consumer-owned
+ * (ADR 0053 rule 6). No `container-type` in v1 (ADR 0055 R7.1).
+ */
+declare class SkraSurface {
+    /**
+     * Semantic padding preset, reusing Box's enum for cross-atom consistency
+     * (ADR 0053 rule 4). Defaults to `md` rather than Box's `none` — Box is
+     * spacing-neutral by construction, a painted container is not (ADR 0055 R1).
+     */
+    readonly padding: _angular_core.InputSignal<SurfacePadding>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SkraSurface, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SkraSurface, "div[skraSurface], section[skraSurface], article[skraSurface], main[skraSurface], nav[skraSurface], aside[skraSurface], header[skraSurface], footer[skraSurface], figure[skraSurface]", never, { "padding": { "alias": "padding"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+export { SkraBox, SkraGrid, SkraStack, SkraSurface };
+export type { BoxDisplay, BoxPadding, GridAlign, GridColumns, GridFlow, GridGap, GridMin, StackAlign, StackDirection, StackGap, StackJustify, SurfacePadding };
 //# sourceMappingURL=skra-ui-layout.d.ts.map

package/types/skra-ui-layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skra-ui-layout.d.ts","sources":["../../../../libs/ui/layout/src/lib/box/box.ts","../../../../libs/ui/layout/src/lib/stack/stack.ts","../../../../libs/ui/layout/src/lib/grid/grid.ts"],"mappings":";;AAOM,KAAM,UAAU;AAChB,KAAM,UAAU;AAEtB;;;;;;;;;;;AAWG;AACH,cAiBa,OAAO;sBACF,aAAA,CAAA,WAAA,CAAA,UAAA;sBACA,aAAA,CAAA,WAAA,CAAA,UAAA;oDAFL,OAAO;sDAAP,OAAO;AAGnB;;KClCW,cAAc;AACpB,KAAM,QAAQ;AACd,KAAM,UAAU;AAChB,KAAM,YAAY;AAExB;;;;;;;;;;;AAWG;AACH,cAoBa,SAAS;wBACF,aAAA,CAAA,WAAA,CAAA,cAAA;kBACN,aAAA,CAAA,WAAA,CAAA,QAAA;oBACE,aAAA,CAAA,WAAA,CAAA,UAAA;sBACE,aAAA,CAAA,WAAA,CAAA,YAAA;mBACH,aAAA,CAAA,wBAAA;oDALF,SAAS;sDAAT,SAAS;AAMrB;;KC5CW,WAAW;AASjB,KAAM,OAAO;AACb,KAAM,OAAO;AACb,KAAM,QAAQ;AACd,KAAM,SAAS;AAErB;;;;;;;;;;;;;;;;;AAiBG;AACH,cAqBa,QAAQ;sBACH,aAAA,CAAA,WAAA,CAAA,WAAA;kBACJ,aAAA,CAAA,WAAA,CAAA,OAAA;kBACA,aAAA,CAAA,WAAA,CAAA,OAAA;mBACC,aAAA,CAAA,WAAA,CAAA,QAAA;oBACC,aAAA,CAAA,WAAA,CAAA,SAAA;2BACO,aAAA,CAAA,WAAA,CAAA,SAAA;oDANV,QAAQ;sDAAR,QAAQ;AAOpB;;;;","names":[]}
+{"version":3,"file":"skra-ui-layout.d.ts","sources":["../../../../libs/ui/layout/src/lib/box/box.ts","../../../../libs/ui/layout/src/lib/stack/stack.ts","../../../../libs/ui/layout/src/lib/grid/grid.ts","../../../../libs/ui/layout/src/lib/surface/surface.ts"],"mappings":";;AAOM,KAAM,UAAU;AAChB,KAAM,UAAU;AAEtB;;;;;;;;;;;AAWG;AACH,cAiBa,OAAO;sBACF,aAAA,CAAA,WAAA,CAAA,UAAA;sBACA,aAAA,CAAA,WAAA,CAAA,UAAA;oDAFL,OAAO;sDAAP,OAAO;AAGnB;;KClCW,cAAc;AACpB,KAAM,QAAQ;AACd,KAAM,UAAU;AAChB,KAAM,YAAY;AAExB;;;;;;;;;;;AAWG;AACH,cAoBa,SAAS;wBACF,aAAA,CAAA,WAAA,CAAA,cAAA;kBACN,aAAA,CAAA,WAAA,CAAA,QAAA;oBACE,aAAA,CAAA,WAAA,CAAA,UAAA;sBACE,aAAA,CAAA,WAAA,CAAA,YAAA;mBACH,aAAA,CAAA,wBAAA;oDALF,SAAS;sDAAT,SAAS;AAMrB;;KC5CW,WAAW;AASjB,KAAM,OAAO;AACb,KAAM,OAAO;AACb,KAAM,QAAQ;AACd,KAAM,SAAS;AAErB;;;;;;;;;;;;;;;;;AAiBG;AACH,cAqBa,QAAQ;sBACH,aAAA,CAAA,WAAA,CAAA,WAAA;kBACJ,aAAA,CAAA,WAAA,CAAA,OAAA;kBACA,aAAA,CAAA,WAAA,CAAA,OAAA;mBACC,aAAA,CAAA,WAAA,CAAA,QAAA;oBACC,aAAA,CAAA,WAAA,CAAA,SAAA;2BACO,aAAA,CAAA,WAAA,CAAA,SAAA;oDANV,QAAQ;sDAAR,QAAQ;AAOpB;;AC5DK,KAAM,cAAc;AAE1B;;;;;;;;;;;;;;;;;;AAkBG;AACH,cAca,WAAW;AACtB;;;;AAIG;sBACa,aAAA,CAAA,WAAA,CAAA,cAAA;oDANL,WAAW;sDAAX,WAAW;AAOvB;;;;","names":[]}