@magmonium/one 0.4.68 → 0.4.69

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magmonium/one",
-  "version": "0.4.68",
+  "version": "0.4.69",
   "description": "Magmonium One — Angular design-system primitives for mm Apps",
   "author": "magmonium",
   "license": "MIT",

package/types/magmonium-one.d.ts

@@ -1321,6 +1321,19 @@ export declare function activeElementWithin(node: Node): Element | null;
 export declare function getScrollParent(node: Node | null): HTMLElement | Window;
 export declare function isJson(data: unknown): boolean;
 export declare function getValue<T, K extends keyof T>(obj: T, key: K): T[K];
+/**
+ * The row a map holds under `id`, or `undefined` when it holds none — the
+ * OneFunction a ScreenComputed calls to turn an id into its row (ADR 0201).
+ * A `map` Cardinality emits as `Record<string, T>`, so the key is a string.
+ */
+export declare function getFromMap<T>(id: string | undefined, map: Record<string, T> | undefined): T | undefined;
+/**
+ * Whether a map holds anything under `id` — the boolean OneFunction a
+ * StoreMethod's CallCondition gates a call on and a ScreenComputed may derive
+ * (ADR 0202). `false`, never `undefined`, while the id or the map is: a gate
+ * reading an unloaded store answers "not there yet" rather than nothing.
+ */
+export declare function existsInMap(id: string | undefined, map: Record<string, unknown> | undefined): boolean;
 export declare function createMap<T extends object>(elems: T[], key?: keyof T | 'id', elemMap?: Record<string, T>): Record<string, T>;
 /**
  * Total over the three Sizes. Deliberately accepts nothing else — the old
@@ -1554,7 +1567,7 @@ export declare class DraggableDirective {
   readonly max: import("@angular/core").InputSignal<Position | undefined>;
   readonly dragStart: import("@angular/core").OutputEmitterRef<void>;
   readonly dragEnd: import("@angular/core").OutputEmitterRef<void>;
-  protected readonly cursor: import("@angular/core").Signal<"move" | "ew-resize" | "ns-resize">;
+  protected readonly cursor: import("@angular/core").Signal<"ew-resize" | "ns-resize" | "move">;
   protected state: DraggableState;
   set pos(position: Position);
   /**
@@ -2856,7 +2869,7 @@ export declare class ButtonComponent extends ReactiveElementComponent<Button> {
   navParams: import("@angular/core").InputSignal<Record<string, string | number> | undefined>;
   href: import("@angular/core").InputSignal<string | undefined>;
   disabled: import("@angular/core").InputSignal<boolean | undefined>;
-  variant: import("@angular/core").InputSignal<"ghost" | "primary" | "secondary" | "tab" | undefined>;
+  variant: import("@angular/core").InputSignal<"primary" | "ghost" | "secondary" | "tab" | undefined>;
   name: import("@angular/core").InputSignal<string | undefined>;
   baseUrl: import("@angular/core").InputSignal<string | undefined>;
   one: import("@angular/core").InputSignal<boolean | undefined>;
@@ -3476,7 +3489,7 @@ export declare class ButtonGroupComponent extends ConfigComponent<ButtonGroup> {
     color?: string | keyof import("dist/libs/cli/src").ThemeColor;
     align?: ConfigAlign;
     isLoading?: boolean;
-    variant?: "ghost" | "primary" | "secondary" | "tab" | undefined;
+    variant?: "primary" | "ghost" | "secondary" | "tab" | undefined;
     label?: string;
     noTranslate?: boolean;
     params?: Record<string, string>;
@@ -4243,7 +4256,7 @@ declare class BaseTextInputComponent<T extends Input = TextInput> extends BaseIn
   private autofocused;
   constructor();
   readonly isFocused: import("@angular/core").WritableSignal<boolean>;
-  readonly iconColor: import("@angular/core").Signal<"border" | "error" | "focus">;
+  readonly iconColor: import("@angular/core").Signal<"error" | "border" | "focus">;
   protected readonly setValue: (value: string) => void;
   static ɵfac: i0.ɵɵFactoryDeclaration<BaseTextInputComponent<any>, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<BaseTextInputComponent<any>, never, never, {
@@ -4863,7 +4876,7 @@ export declare class SectionFilterGroupComponent {
   readonly paddingX: import("@angular/core").InputSignal<boolean | undefined>;
   readonly paddingY: import("@angular/core").InputSignal<boolean | undefined>;
   readonly maxWidth: import("@angular/core").InputSignal<string | undefined>;
-  readonly align: import("@angular/core").InputSignal<"left" | "center" | "right" | undefined>;
+  readonly align: import("@angular/core").InputSignal<"center" | "left" | "right" | undefined>;
   readonly config: import("@angular/core").InputSignal<SectionFilterGroupConfig | undefined>;
   /**
    * The whole group's selection, keyed by each Filter's `name` — one key per
@@ -4881,7 +4894,7 @@ export declare class SectionFilterGroupComponent {
   protected readonly resolvedPadding: import("@angular/core").Signal<boolean>;
   protected readonly resolvedPaddingX: import("@angular/core").Signal<boolean>;
   protected readonly resolvedPaddingY: import("@angular/core").Signal<boolean>;
-  protected readonly resolvedAlign: import("@angular/core").Signal<"left" | "center" | "right">;
+  protected readonly resolvedAlign: import("@angular/core").Signal<"center" | "left" | "right">;
   protected readonly resolvedMaxWidth: import("@angular/core").Signal<string | undefined>;
   protected readonly noBorder: import("@angular/core").Signal<boolean>;
   /**
@@ -4986,7 +4999,7 @@ export declare class SectionStepperComponent implements OnDestroy {
   readonly lg: import("@angular/core").InputSignal<number | undefined>;
   readonly xl: import("@angular/core").InputSignal<number | undefined>;
   readonly xxl: import("@angular/core").InputSignal<number | undefined>;
-  readonly orientation: import("@angular/core").InputSignal<"horizontal" | "vertical" | undefined>;
+  readonly orientation: import("@angular/core").InputSignal<"vertical" | "horizontal" | undefined>;
   readonly stepChange: import("@angular/core").OutputEmitterRef<number>;
   private readonly isCompact;
   private readonly mediaMatched;
@@ -5060,7 +5073,7 @@ export declare class SectionStepperComponent implements OnDestroy {
 export declare class SectionBadgesComponent {
   readonly wrap: import("@angular/core").InputSignal<boolean>;
   readonly border: import("@angular/core").InputSignal<boolean>;
-  readonly align: import("@angular/core").InputSignal<"left" | "center" | "right">;
+  readonly align: import("@angular/core").InputSignal<"center" | "left" | "right">;
   private readonly sectionContext;
   protected readonly hasBorder: import("@angular/core").Signal<boolean>;
   static ɵfac: i0.ɵɵFactoryDeclaration<SectionBadgesComponent, never>;
@@ -5208,7 +5221,7 @@ export declare class SectionPaginationComponent {
    * Entries that are not positive numbers drop rather than throw.
    */
   readonly perPageOptions: import("@angular/core").InputSignal<string | undefined>;
-  readonly align: import("@angular/core").InputSignal<"left" | "center" | "right">;
+  readonly align: import("@angular/core").InputSignal<"center" | "left" | "right">;
   readonly showPerPage: import("@angular/core").InputSignal<boolean>;
   /** Hides the band outright once everything fits one page. */
   readonly hideOnSinglePage: import("@angular/core").InputSignal<boolean>;
@@ -5545,7 +5558,7 @@ export declare class SectionComponent extends ConfigComponent<SectionConfig> {
   readonly align: import("@angular/core").InputSignal<SectionAlign | undefined>;
   readonly alignX: import("@angular/core").InputSignal<GridAlignX | undefined>;
   readonly alignY: import("@angular/core").InputSignal<GridAlignY | undefined>;
-  readonly size: import("@angular/core").InputSignal<Size | "sm" | "md" | "lg" | undefined>;
+  readonly size: import("@angular/core").InputSignal<"sm" | "md" | "lg" | Size | undefined>;
   private readonly parentSize;
   readonly resolvedSize: import("@angular/core").Signal<Size>;
   protected readonly sizeLength: import("@angular/core").Signal<string>;
@@ -5716,8 +5729,8 @@ export declare class SectionHeaderComponent {
   readonly visibilityRule: import("@angular/core").InputSignal<((key: string, data?: unknown) => boolean) | undefined>;
   readonly disableRule: import("@angular/core").InputSignal<((key: string, data?: unknown) => boolean) | undefined>;
   readonly extraData: import("@angular/core").InputSignal<unknown>;
-  readonly align: import("@angular/core").InputSignal<"left" | "center" | "right" | undefined>;
-  readonly alignment: import("@angular/core").Signal<"left" | "center" | "right">;
+  readonly align: import("@angular/core").InputSignal<"center" | "left" | "right" | undefined>;
+  readonly alignment: import("@angular/core").Signal<"center" | "left" | "right">;
   readonly badge: import("@angular/core").InputSignal<BadgeCount | undefined>;
   readonly showBack: import("@angular/core").InputSignal<boolean>;
   readonly actionButton: import("@angular/core").InputSignal<string | undefined>;
@@ -5735,7 +5748,7 @@ export declare class SectionHeaderComponent {
   protected readonly sidepanel: import("@angular/core").Signal<boolean>;
   protected readonly noBorder: import("@angular/core").Signal<boolean>;
   protected readonly resolvedMaxWidth: import("@angular/core").Signal<string | undefined>;
-  protected readonly boxAlign: import("@angular/core").Signal<"left" | "center" | "right">;
+  protected readonly boxAlign: import("@angular/core").Signal<"center" | "left" | "right">;
   protected readonly iconBox: import("@angular/core").Signal<string>;
   protected readonly isSticky: import("@angular/core").Signal<boolean>;
   protected readonly hasMenu: import("@angular/core").Signal<boolean>;
@@ -5882,7 +5895,7 @@ export declare class SectionButtonGroupComponent extends ConfigComponent<Section
   readonly vertical: import("@angular/core").InputSignal<boolean | undefined>;
   readonly align: import("@angular/core").InputSignal<ConfigAlign>;
   readonly variant: import("@angular/core").InputSignal<"spaced" | "joined" | undefined>;
-  readonly size: import("@angular/core").InputSignal<Size | "sm" | "md" | "lg" | undefined>;
+  readonly size: import("@angular/core").InputSignal<"sm" | "md" | "lg" | Size | undefined>;
   readonly fullWidth: import("@angular/core").InputSignal<boolean | undefined>;
   private readonly parentSize;
   readonly resolvedSize: import("@angular/core").Signal<Size>;
@@ -5890,7 +5903,7 @@ export declare class SectionButtonGroupComponent extends ConfigComponent<Section
   protected readonly resolvedFullWidth: import("@angular/core").Signal<boolean>;
   protected readonly resolvedVertical: import("@angular/core").Signal<boolean>;
   protected readonly resolvedVariant: import("@angular/core").Signal<"spaced" | "joined">;
-  protected readonly resolvedAlign: import("@angular/core").Signal<"left" | "center" | "right" | "top" | "bottom">;
+  protected readonly resolvedAlign: import("@angular/core").Signal<"center" | "left" | "right" | "bottom" | "top">;
   static ɵfac: i0.ɵɵFactoryDeclaration<SectionButtonGroupComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<SectionButtonGroupComponent, "m-section-button-group", never, {
     "vertical": {
@@ -5922,7 +5935,7 @@ export declare class SectionButtonGroupComponent extends ConfigComponent<Section
 }
 export declare class SectionFooterComponent {
   readonly sticky: import("@angular/core").InputSignal<boolean>;
-  readonly align: import("@angular/core").InputSignal<"left" | "center" | "right">;
+  readonly align: import("@angular/core").InputSignal<"center" | "left" | "right">;
   readonly maxWidth: import("@angular/core").InputSignal<string | undefined>;
   private readonly scrollSticky;
   protected readonly isSticky: import("@angular/core").Signal<boolean>;
@@ -5930,7 +5943,7 @@ export declare class SectionFooterComponent {
   protected readonly sidepanel: import("@angular/core").Signal<boolean>;
   protected readonly noBorder: import("@angular/core").Signal<boolean>;
   protected readonly resolvedMaxWidth: import("@angular/core").Signal<string | undefined>;
-  protected readonly boxAlign: import("@angular/core").Signal<"left" | "center" | "right">;
+  protected readonly boxAlign: import("@angular/core").Signal<"center" | "left" | "right">;
   static ɵfac: i0.ɵɵFactoryDeclaration<SectionFooterComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<SectionFooterComponent, "m-section-footer", never, {
     "sticky": {
@@ -8077,7 +8090,7 @@ declare class DropdownBoxComponent {
 }
 /** The trigger both option Fields draw: a searchable text input and a chevron. */
 declare const DROPDOWN_TEMPLATE = "\n  @if (config(); as dropdown) {\n    @if (dropdown.label) {\n      <m-label\n        [for]=\"dropdown.name ?? ''\"\n        [placeholder]=\"dropdown.label\"\n        [params]=\"dropdown.params\"\n        [required]=\"required()\"\n        [disabled]=\"disabled()\"\n      />\n    }\n    <div\n      class=\"trigger-wrap\"\n      #wrapper\n      [mSelector]=\"selectorConfig()\"\n      [disabled]=\"disabled() || readonly() || !!config()?.readonly\"\n      (opened)=\"onOpened()\"\n      (closed)=\"onClosed()\"\n      (focusin)=\"isFocused.set(true)\"\n      (focusout)=\"isFocused.set(false)\"\n    >\n      <m-text-input\n        [config]=\"triggerInputConfig()\"\n        [value]=\"displayValue()\"\n        [disabled]=\"disabled()\"\n        [invalid]=\"invalid()\"\n        [hideErrors]=\"true\"\n        [(touched)]=\"touched\"\n        [focused]=\"focused()\"\n        (valueChange)=\"onInput($event)\"\n        (click)=\"preventToggleWhenOpen($event)\"\n        (keydown.space)=\"$event.stopPropagation()\"\n        (keydown.enter)=\"onEnter($event)\"\n        (keydown.arrowdown)=\"onArrow($event, 1)\"\n        (keydown.arrowup)=\"onArrow($event, -1)\"\n        (keydown.tab)=\"$event.stopPropagation()\"\n      />\n      <m-button [disabled]=\"disabled()\" [config]=\"chevron()\" />\n    </div>\n    @if (showErrors()) {\n      @for (error of errors(); track $index) {\n        <m-text-output\n          variant=\"footer\"\n          color=\"error\"\n          [label]=\"error.message\"\n        />\n      }\n    }\n  }\n";
-declare const DROPDOWN_IMPORTS: (typeof TextInputComponent | typeof SelectorDirective | typeof LabelComponent | typeof TextOutputComponent | typeof ButtonComponent)[];
+declare const DROPDOWN_IMPORTS: (typeof ButtonComponent | typeof LabelComponent | typeof SelectorDirective | typeof TextOutputComponent | typeof TextInputComponent)[];
 /**
  * Everything a Dropdown and a Multiselect share: the options, the search, the
  * keyboard walk and the panel. What differs is only what the Field holds — one
@@ -8261,7 +8274,7 @@ declare class ColorPickerBoxComponent implements AfterViewInit, OnDestroy {
   protected readonly _eyedropperConfig: import("@magmonium/one").Button;
   protected readonly _headerContextMenu: ContextMenu;
   protected readonly themeSwatches: import("@angular/core").Signal<{
-    key: "mm" | "mmLite" | "mmDark" | "background" | "border" | "text" | "textSecondary" | "focus" | "error" | "errorLight" | "warning" | "successLite" | "success" | "highlight" | "wealth";
+    key: "text" | "error" | "focus" | "mm" | "mmLite" | "mmDark" | "background" | "border" | "textSecondary" | "errorLight" | "warning" | "successLite" | "success" | "highlight" | "wealth";
     color: string;
   }[]>;
   hue: import("@angular/core").WritableSignal<number>;
@@ -9006,7 +9019,7 @@ export declare class FileUploadInputComponent extends BaseInputComponent<FileUpl
   private readonly editorSize;
   private readonly maxSize;
   protected readonly isLocked: import("@angular/core").Signal<boolean>;
-  protected readonly dropZoneIconColor: import("@angular/core").Signal<"border" | "error" | "focus">;
+  protected readonly dropZoneIconColor: import("@angular/core").Signal<"error" | "border" | "focus">;
   /** Object URLs of the previews on show, keyed by what the value holds. */
   private readonly previews;
   protected readonly heldFiles: import("@angular/core").Signal<HeldFile[]>;
@@ -9460,17 +9473,17 @@ export declare class SectionFormComponent<T extends object = Record<string, unkn
   protected readonly resolvesConfigAsset = false;
   readonly variant: import("@angular/core").InputSignal<string | undefined>;
   readonly maxWidth: import("@angular/core").InputSignal<string | undefined>;
-  readonly heightMode: import("@angular/core").InputSignal<"full" | "fixed" | undefined>;
+  readonly heightMode: import("@angular/core").InputSignal<"fixed" | "full" | undefined>;
   readonly maxHeight: import("@angular/core").InputSignal<string | number | undefined>;
   readonly height: import("@angular/core").InputSignal<string | number | undefined>;
-  readonly align: import("@angular/core").InputSignal<"left" | "center" | "right" | undefined>;
+  readonly align: import("@angular/core").InputSignal<"center" | "left" | "right" | undefined>;
   readonly padding: import("@angular/core").InputSignal<string | number | undefined>;
   readonly paddingX: import("@angular/core").InputSignal<string | number | undefined>;
   readonly paddingY: import("@angular/core").InputSignal<string | number | undefined>;
   readonly margin: import("@angular/core").InputSignal<string | number | undefined>;
   readonly marginX: import("@angular/core").InputSignal<string | number | undefined>;
   readonly marginY: import("@angular/core").InputSignal<string | number | undefined>;
-  readonly size: import("@angular/core").InputSignal<Size | "sm" | "md" | "lg" | undefined>;
+  readonly size: import("@angular/core").InputSignal<"sm" | "md" | "lg" | Size | undefined>;
   readonly autofocus: import("@angular/core").InputSignal<boolean>;
   data: import("@angular/core").InputSignal<T | undefined>;
   readonly dataChange: import("@angular/core").OutputEmitterRef<T>;
@@ -9515,7 +9528,7 @@ export declare class SectionFormComponent<T extends object = Record<string, unkn
   protected readonly handleSubmit: (event: Event) => void;
   readonly resolvedSize: import("@angular/core").Signal<Size>;
   protected readonly sizeLength: import("@angular/core").Signal<string | null>;
-  readonly resolvedAlign: import("@angular/core").Signal<"left" | "center" | "right">;
+  readonly resolvedAlign: import("@angular/core").Signal<"center" | "left" | "right">;
   readonly resolvedVariant: import("@angular/core").Signal<string | undefined>;
   readonly resolvedMaxWidth: import("@angular/core").Signal<string | number | undefined>;
   private readonly resolvedPadding;
@@ -9527,7 +9540,7 @@ export declare class SectionFormComponent<T extends object = Record<string, unkn
   readonly resolvedMinHeight: import("@angular/core").Signal<string | undefined>;
   readonly resolvedMinWidth: import("@angular/core").Signal<string | undefined>;
   readonly resolvedMaxHeight: import("@angular/core").Signal<string | number | undefined>;
-  readonly resolvedHeightMode: import("@angular/core").Signal<"full" | "fixed" | undefined>;
+  readonly resolvedHeightMode: import("@angular/core").Signal<"fixed" | "full" | undefined>;
   readonly isFullHeight: import("@angular/core").Signal<boolean>;
   readonly cssMaxHeight: import("@angular/core").Signal<string | undefined>;
   constructor();
@@ -10375,7 +10388,7 @@ export declare class ComponentStepperComponent {
   components: import("@angular/core").InputSignal<Type<unknown>[]>;
   labels: import("@angular/core").InputSignal<string[] | undefined>;
   currentIndex: import("@angular/core").InputSignal<number>;
-  variant: import("@angular/core").InputSignal<"horizontal" | "vertical">;
+  variant: import("@angular/core").InputSignal<"vertical" | "horizontal">;
   context: import("@angular/core").InputSignal<Record<string, unknown> | undefined>;
   readonly stepChange: import("@angular/core").OutputEmitterRef<number>;
   static ɵfac: i0.ɵɵFactoryDeclaration<ComponentStepperComponent, never>;
@@ -12077,7 +12090,7 @@ export type DocAiPhase = 'idle' | 'asking' | 'question' | 'outline' | 'writing'
  */
 export declare class DocEditorComponent implements ControlValueAccessor {
   protected readonly groups: readonly import("@magmonium/one").DocToolbarGroup[];
-  protected readonly icons: Record<"table" | "list" | "bold" | "italic" | "strike" | "heading" | "quote" | "link" | "code", string>;
+  protected readonly icons: Record<"code" | "link" | "table" | "strike" | "list" | "bold" | "heading" | "italic" | "quote", string>;
   protected readonly docActionKey: typeof docActionKey;
   private readonly translate;
   protected readonly value: import("@angular/core").WritableSignal<string>;
@@ -14091,7 +14104,7 @@ export declare class ConfirmComponent {
   cancelLabel: import("@angular/core").InputSignal<string>;
   protected readonly confirmText: import("@angular/core").Signal<string>;
   protected readonly cancelText: import("@angular/core").Signal<string>;
-  protected readonly accent: import("@angular/core").Signal<"error" | "warning" | "success" | "mm">;
+  protected readonly accent: import("@angular/core").Signal<"error" | "mm" | "success" | "warning">;
   protected readonly iconName: import("@angular/core").Signal<"exclamation-triangle" | "info" | "trash" | "check-circle">;
   protected accept(): void;
   protected decline(): void;