@atelier-ui/angular 0.3.9 → 0.3.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@atelier-ui/angular",
3
- "version": "0.3.9",
3
+ "version": "0.3.11",
4
4
  "description": "Atelier component library for Angular — LLM-optimised, accessible, design-token-driven",
5
5
  "keywords": [
6
6
  "angular",
@@ -18,6 +18,18 @@ import * as i1$1 from '@angular/cdk/menu';
18
18
  */
19
19
  type AtlButtonVariant = 'primary' | 'secondary' | 'outline' | 'danger';
20
20
  type AtlButtonSize = 'sm' | 'md' | 'lg';
21
+ /**
22
+ * One validation error. Structurally the same as Angular Signal Forms'
23
+ * `ValidationError` (`kind` plus an optional `message`), so Angular's
24
+ * `[formField]` binding passes its errors straight through, and React and Vue
25
+ * consumers can build the same shape by hand.
26
+ */
27
+ interface AtlErrorItem {
28
+ /** Identifies the kind of error, e.g. `'required'`. */
29
+ readonly kind: string;
30
+ /** Human readable message, rendered under the field. */
31
+ readonly message?: string;
32
+ }
21
33
  interface AtlComboboxOption {
22
34
  value: string;
23
35
  label: string;
@@ -418,8 +430,15 @@ declare class AtlCheckbox implements FormCheckboxControl {
418
430
  readonly name: _angular_core.InputSignal<string>;
419
431
  /** Validation errors from the form system. Bound by [formField] directive. */
420
432
  readonly errors: _angular_core.InputSignal<readonly WithOptionalFieldTree<ValidationError>[]>;
433
+ /**
434
+ * Explicit id for the native input. Wins over the generated id — set this
435
+ * when something outside the component (an external `<label for>`, or
436
+ * `aria-describedby` from elsewhere on the page) needs a stable id to point at.
437
+ */
438
+ readonly id: _angular_core.InputSignal<string>;
439
+ private readonly generatedId;
421
440
  /** @internal */
422
- protected readonly inputId: string;
441
+ protected readonly inputId: _angular_core.Signal<string>;
423
442
  /** @internal */
424
443
  protected readonly errorId: string;
425
444
  /** @internal */
@@ -439,7 +458,7 @@ declare class AtlCheckbox implements FormCheckboxControl {
439
458
  /** @internal */
440
459
  protected onChange(event: Event): void;
441
460
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AtlCheckbox, never>;
442
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<AtlCheckbox, "atl-checkbox", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; "touched": "touchedChange"; }, never, ["*"], true, never>;
461
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<AtlCheckbox, "atl-checkbox", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; "touched": "touchedChange"; }, never, ["*"], true, never>;
443
462
  }
444
463
 
445
464
  /** @internal — shape required by AtlRadioGroup's FocusKeyManager */
@@ -608,8 +627,15 @@ declare class AtlToggle implements FormCheckboxControl {
608
627
  readonly name: _angular_core.InputSignal<string>;
609
628
  /** Validation errors from the form system. Bound by [formField] directive. */
610
629
  readonly errors: _angular_core.InputSignal<readonly WithOptionalFieldTree<ValidationError>[]>;
630
+ /**
631
+ * Explicit id for the native input. Wins over the generated id — set this
632
+ * when something outside the component (an external `<label for>`, or
633
+ * `aria-describedby` from elsewhere on the page) needs a stable id to point at.
634
+ */
635
+ readonly id: _angular_core.InputSignal<string>;
636
+ private readonly generatedId;
611
637
  /** @internal */
612
- protected readonly inputId: string;
638
+ protected readonly inputId: _angular_core.Signal<string>;
613
639
  /** @internal */
614
640
  protected readonly errorId: string;
615
641
  /** @internal */
@@ -626,7 +652,7 @@ declare class AtlToggle implements FormCheckboxControl {
626
652
  /** @internal */
627
653
  protected onChange(event: Event): void;
628
654
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AtlToggle, never>;
629
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<AtlToggle, "atl-toggle", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; "touched": "touchedChange"; }, never, ["*"], true, never>;
655
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<AtlToggle, "atl-toggle", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; "touched": "touchedChange"; }, never, ["*"], true, never>;
630
656
  }
631
657
 
632
658
  declare class AtlAlert {
@@ -1488,7 +1514,10 @@ declare class AtlProgress {
1488
1514
 
1489
1515
  /**
1490
1516
  * Accessible breadcrumb navigation. Wrap `atl-breadcrumb-item` elements inside.
1491
- * The last item is automatically marked as the current page.
1517
+ * The last item is automatically marked as the current page, unless an item sets
1518
+ * `current` itself. If any item does, only explicit values count: `[current]="true"`
1519
+ * on the item that is the page, or `[current]="false"` for a trail with no current
1520
+ * page.
1492
1521
  *
1493
1522
  * Usage:
1494
1523
  * ```html
@@ -1502,13 +1531,15 @@ declare class AtlProgress {
1502
1531
  declare class AtlBreadcrumbs {
1503
1532
  /** Separator character shown between breadcrumb items. Default `/`. */
1504
1533
  readonly separator: _angular_core.InputSignal<string | undefined>;
1505
- protected readonly separatorCssVar: _angular_core.Signal<string>;
1506
- private readonly _itemIds;
1534
+ protected readonly separatorCssVar: Signal<string>;
1535
+ private readonly _items;
1507
1536
  private _nextId;
1508
1537
  /** @internal — used by AtlBreadcrumbItem via ATL_BREADCRUMBS token */
1509
- readonly lastItemId: _angular_core.Signal<number>;
1538
+ readonly lastItemId: Signal<number>;
1510
1539
  /** @internal */
1511
- registerItem(): number;
1540
+ readonly hasExplicitCurrent: Signal<boolean>;
1541
+ /** @internal */
1542
+ registerItem(explicit: Signal<boolean | undefined>): number;
1512
1543
  /** @internal */
1513
1544
  unregisterItem(id: number): void;
1514
1545
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AtlBreadcrumbs, never>;
@@ -1516,24 +1547,33 @@ declare class AtlBreadcrumbs {
1516
1547
  }
1517
1548
  /**
1518
1549
  * A single breadcrumb step. The last item is automatically treated as
1519
- * `aria-current="page"` and rendered as plain text (no link).
1550
+ * `aria-current="page"` and rendered as plain text (no link), unless `current`
1551
+ * is set on any item (see `AtlBreadcrumbs`).
1520
1552
  */
1521
1553
  declare class AtlBreadcrumbItem implements OnInit, OnDestroy {
1522
- /** Optional href for navigation. Ignored on the last (current) item. */
1554
+ /** Optional href for navigation. Ignored on the current item. */
1523
1555
  readonly href: _angular_core.InputSignal<string>;
1556
+ /**
1557
+ * Whether this is the current page. Leave it unset and the last item is the
1558
+ * current page; set it on any item and only explicit values count.
1559
+ */
1560
+ readonly current: _angular_core.InputSignalWithTransform<boolean | undefined, string | boolean | undefined>;
1524
1561
  private readonly context;
1525
1562
  private readonly myIndex;
1526
- protected readonly isCurrent: _angular_core.Signal<boolean>;
1563
+ protected readonly isCurrent: Signal<boolean>;
1527
1564
  ngOnInit(): void;
1528
1565
  ngOnDestroy(): void;
1529
1566
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AtlBreadcrumbItem, never>;
1530
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<AtlBreadcrumbItem, "atl-breadcrumb-item", never, { "href": { "alias": "href"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
1567
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<AtlBreadcrumbItem, "atl-breadcrumb-item", never, { "href": { "alias": "href"; "required": false; "isSignal": true; }; "current": { "alias": "current"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
1531
1568
  }
1532
1569
 
1533
1570
  interface AtlBreadcrumbsContext {
1534
- registerItem(): number;
1571
+ /** Registers an item with the signal holding its explicit `current`, if any. */
1572
+ registerItem(explicit: Signal<boolean | undefined>): number;
1535
1573
  unregisterItem(id: number): void;
1536
1574
  readonly lastItemId: Signal<number>;
1575
+ /** Whether any registered item set `current` itself; if so the last-item default is off. */
1576
+ readonly hasExplicitCurrent: Signal<boolean>;
1537
1577
  }
1538
1578
  declare const ATL_BREADCRUMBS: InjectionToken<AtlBreadcrumbsContext>;
1539
1579
 
@@ -1553,7 +1593,11 @@ type PageItem = {
1553
1593
  * ```
1554
1594
  */
1555
1595
  declare class AtlPagination {
1556
- /** Current page (1-based). Supports two-way binding: [(page)]="currentPage". */
1596
+ /**
1597
+ * Current page (1-based). Two-way: `[(page)]="currentPage"`. The component owns the
1598
+ * state, so it also works unbound or with `[page]` plus `(pageChange)`. React and Vue
1599
+ * are controlled instead: they keep no page state and expect the new page fed back in.
1600
+ */
1557
1601
  readonly page: _angular_core.ModelSignal<number>;
1558
1602
  /** Total number of pages. */
1559
1603
  readonly pageCount: _angular_core.InputSignal<number>;
@@ -1850,7 +1894,9 @@ declare class AtlStepper implements AtlStepperContext {
1850
1894
  /** Layout orientation. */
1851
1895
  readonly orientation: _angular_core.InputSignal<"horizontal" | "vertical">;
1852
1896
  /**
1853
- * When true, users can only navigate to completed steps or the next pending step.
1897
+ * When true, a step can be reached only once every step before it is completed or
1898
+ * `optional`: the user can go to completed steps and the next pending one, and can
1899
+ * pass over optional steps. React and Vue behave the same.
1854
1900
  * Use `goTo()` / `next()` in your step content to advance programmatically.
1855
1901
  */
1856
1902
  readonly linear: _angular_core.InputSignal<boolean>;
@@ -2126,4 +2172,4 @@ interface AtlChatContext {
2126
2172
  declare const ATL_CHAT: InjectionToken<AtlChatContext>;
2127
2173
 
2128
2174
  export { ATL_ACCORDION_GROUP, ATL_BREADCRUMBS, ATL_CHAT, ATL_DIALOG, ATL_DRAWER, ATL_RADIO_GROUP, ATL_SELECT, ATL_STEPPER, ATL_TABLE, ATL_TAB_GROUP, AtlAccordionGroup, AtlAccordionHeader, AtlAccordionItem, AtlAlert, AtlAvatar, AtlAvatarGroup, AtlBadge, AtlBreadcrumbItem, AtlBreadcrumbs, AtlButton, AtlCard, AtlCardContent, AtlCardFooter, AtlCardHeader, AtlChat, AtlChatHeader, AtlChatInput, AtlChatMessage, AtlChatMessages, AtlChatSuggestion, AtlChatTyping, AtlCheckbox, AtlCodeBlock, AtlCombobox, AtlDialog, AtlDialogContent, AtlDialogFooter, AtlDialogHeader, AtlDrawer, AtlDrawerContent, AtlDrawerFooter, AtlDrawerHeader, AtlIcon, AtlInput, AtlMenu, AtlMenuItem, AtlMenuSeparator, AtlMenuTrigger, AtlOption, AtlPagination, AtlProgress, AtlRadio, AtlRadioGroup, AtlSelect, AtlSkeleton, AtlStep, AtlStepper, AtlTab, AtlTabGroup, AtlTable, AtlTbody, AtlTd, AtlTextarea, AtlTh, AtlThead, AtlToast, AtlToastContainer, AtlToastService, AtlToggle, AtlTooltip, AtlTr };
2129
- export type { AtlAccordionGroupContext, AtlBreadcrumbsContext, AtlChatContext, AtlDialogContext, AtlDrawerContext, AtlRadioGroupContext, AtlSelectContext, AtlSortDirection, AtlStepperContext, AtlTabGroupContext, AtlTableContext, PageItem, StepInfo, TabInfo, ToastData, ToastOptions };
2175
+ export type { AtlAccordionGroupContext, AtlBreadcrumbsContext, AtlChatContext, AtlDialogContext, AtlDrawerContext, AtlErrorItem, AtlRadioGroupContext, AtlSelectContext, AtlSortDirection, AtlStepperContext, AtlTabGroupContext, AtlTableContext, PageItem, StepInfo, TabInfo, ToastData, ToastOptions };