@masmarino/gabarit 2.0.0 → 2.1.1

package/types/masmarino-gabarit-disclosure.d.ts

@@ -0,0 +1,44 @@
+import * as i0 from "@angular/core";
+type DisclosureAppearance = 'bordered' | 'plain';
+type DisclosureHeadingLevel = 2 | 3 | 4 | 5 | 6;
+export declare class Disclosure {
+  label: import("@angular/core").InputSignal<string>;
+  open: import("@angular/core").ModelSignal<boolean>;
+  icon: import("@angular/core").InputSignal<string | null>;
+  appearance: import("@angular/core").InputSignal<DisclosureAppearance>;
+  headingLevel: import("@angular/core").InputSignal<DisclosureHeadingLevel | null>;
+  protected readonly buttonId: string;
+  protected readonly panelId: string;
+  protected toggle(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<Disclosure, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<Disclosure, "gbt-disclosure", never, {
+    "label": {
+      "alias": "label";
+      "required": true;
+      "isSignal": true;
+    };
+    "open": {
+      "alias": "open";
+      "required": false;
+      "isSignal": true;
+    };
+    "icon": {
+      "alias": "icon";
+      "required": false;
+      "isSignal": true;
+    };
+    "appearance": {
+      "alias": "appearance";
+      "required": false;
+      "isSignal": true;
+    };
+    "headingLevel": {
+      "alias": "headingLevel";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "open": "openChange";
+  }, never, ["*"], true, never>;
+}
+export type { DisclosureAppearance, DisclosureHeadingLevel };

package/types/masmarino-gabarit-divider.d.ts

@@ -0,0 +1,20 @@
+import * as i0 from "@angular/core";
+type DividerOrientation = 'horizontal' | 'vertical';
+export declare class Divider {
+  orientation: import("@angular/core").InputSignal<DividerOrientation>;
+  label: import("@angular/core").InputSignal<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<Divider, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<Divider, "gbt-divider", never, {
+    "orientation": {
+      "alias": "orientation";
+      "required": false;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+export type { DividerOrientation };

package/types/masmarino-gabarit-docs.d.ts

@@ -3,7 +3,8 @@ import { InjectionToken, Provider, Signal } from "@angular/core";
 import { Observable } from "rxjs";
 import { CanActivateFn, Routes } from "@angular/router";
 import { SafeHtml } from "@angular/platform-browser";
-import { AutocompleteSearchFn, PanelHeadingLevel } from "@masmarino/gabarit";
+import { AutocompleteSearchFn } from "@masmarino/gabarit/autocomplete";
+import { PanelHeadingLevel } from "@masmarino/gabarit/panel";
 interface DocsConfig {
   /** Where the files (`<root>/index.json`, `<root>/<section>/<page>.md`) and the routes live. `/docs` by default. */
   root: string;

package/types/masmarino-gabarit-drawer.d.ts

@@ -0,0 +1,51 @@
+import * as i0 from "@angular/core";
+import { OnDestroy } from "@angular/core";
+type DrawerEdge = 'right' | 'left' | 'top' | 'bottom';
+export declare class Drawer implements OnDestroy {
+  isOpen: import("@angular/core").InputSignal<boolean>;
+  edge: import("@angular/core").InputSignal<DrawerEdge>;
+  heading: import("@angular/core").InputSignal<string>;
+  headingLevel: import("@angular/core").InputSignal<1 | 2 | 3 | 4 | 5 | 6>;
+  closeLabel: import("@angular/core").InputSignal<string>;
+  closed: import("@angular/core").OutputEmitterRef<void>;
+  protected readonly rendered: import("@angular/core").WritableSignal<boolean>;
+  private readonly panel;
+  private previouslyFocused;
+  private closeTimer;
+  constructor();
+  ngOnDestroy(): void;
+  protected onEscape(): void;
+  protected onBackdropClick(event: MouseEvent): void;
+  protected onPanelKeydown(event: KeyboardEvent): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<Drawer, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<Drawer, "gbt-drawer", never, {
+    "isOpen": {
+      "alias": "isOpen";
+      "required": true;
+      "isSignal": true;
+    };
+    "edge": {
+      "alias": "edge";
+      "required": false;
+      "isSignal": true;
+    };
+    "heading": {
+      "alias": "heading";
+      "required": false;
+      "isSignal": true;
+    };
+    "headingLevel": {
+      "alias": "headingLevel";
+      "required": false;
+      "isSignal": true;
+    };
+    "closeLabel": {
+      "alias": "closeLabel";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "closed": "closed";
+  }, never, ["*"], true, never>;
+}
+export type { DrawerEdge };

package/types/masmarino-gabarit-empty-state.d.ts

@@ -0,0 +1,67 @@
+import * as i0 from "@angular/core";
+type EmptyStateIllustration = 'folder' | 'star' | 'checklist' | 'merge' | 'pipeline' | 'tag' | 'book' | 'server';
+type EmptyStateSize = 'default' | 'compact';
+type EmptyStateTone = 'default' | 'error';
+type EmptyStateHeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+export declare class EmptyState {
+  illustration: import("@angular/core").InputSignal<EmptyStateIllustration | null | undefined>;
+  heading: import("@angular/core").InputSignal<string>;
+  message: import("@angular/core").InputSignal<string>;
+  icon: import("@angular/core").InputSignal<string | null>;
+  size: import("@angular/core").InputSignal<EmptyStateSize>;
+  tone: import("@angular/core").InputSignal<EmptyStateTone>;
+  headingLevel: import("@angular/core").InputSignal<EmptyStateHeadingLevel | null>;
+  headingId: import("@angular/core").InputSignal<string | null>;
+  headingFocusable: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  private readonly headingEl;
+  focusHeading(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<EmptyState, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<EmptyState, "gbt-empty-state", never, {
+    "illustration": {
+      "alias": "illustration";
+      "required": false;
+      "isSignal": true;
+    };
+    "heading": {
+      "alias": "heading";
+      "required": true;
+      "isSignal": true;
+    };
+    "message": {
+      "alias": "message";
+      "required": false;
+      "isSignal": true;
+    };
+    "icon": {
+      "alias": "icon";
+      "required": false;
+      "isSignal": true;
+    };
+    "size": {
+      "alias": "size";
+      "required": false;
+      "isSignal": true;
+    };
+    "tone": {
+      "alias": "tone";
+      "required": false;
+      "isSignal": true;
+    };
+    "headingLevel": {
+      "alias": "headingLevel";
+      "required": false;
+      "isSignal": true;
+    };
+    "headingId": {
+      "alias": "headingId";
+      "required": false;
+      "isSignal": true;
+    };
+    "headingFocusable": {
+      "alias": "headingFocusable";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, ["*"], true, never>;
+}
+export type { EmptyStateHeadingLevel, EmptyStateIllustration, EmptyStateSize, EmptyStateTone };

package/types/masmarino-gabarit-file-upload.d.ts

@@ -0,0 +1,95 @@
+import { ControlValueAccessor } from "@angular/forms";
+import * as i0 from "@angular/core";
+declare function formatFileSize(bytes: number): string;
+export declare class FileUpload implements ControlValueAccessor {
+  private readonly fileInput;
+  id: import("@angular/core").InputSignal<string>;
+  label: import("@angular/core").InputSignal<string>;
+  multiple: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  accept: import("@angular/core").InputSignal<string>;
+  maxSizeMb: import("@angular/core").InputSignal<number | null>;
+  disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  errorMessage: import("@angular/core").InputSignal<string | null>;
+  dropLabel: import("@angular/core").InputSignal<string>;
+  removeLabel: import("@angular/core").InputSignal<(name: string) => string>;
+  oversizeMessage: import("@angular/core").InputSignal<(name: string, maxSizeMb: number) => string>;
+  extraFileMessage: import("@angular/core").InputSignal<(name: string) => string>;
+  protected readonly files: import("@angular/core").WritableSignal<File[]>;
+  protected readonly rejections: import("@angular/core").WritableSignal<string[]>;
+  protected readonly dragOver: import("@angular/core").WritableSignal<boolean>;
+  protected readonly formatFileSize: typeof formatFileSize;
+  private readonly formDisabled;
+  protected readonly isDisabled: import("@angular/core").Signal<boolean>;
+  private onChange;
+  private onTouched;
+  writeValue(value: File[] | null): void;
+  registerOnChange(fn: (value: File[]) => void): void;
+  registerOnTouched(fn: () => void): void;
+  setDisabledState(isDisabled: boolean): void;
+  protected openPicker(): void;
+  protected onFilesSelected(event: Event): void;
+  protected onDragEnter(event: DragEvent): void;
+  protected onDragOver(event: DragEvent): void;
+  protected onDragLeave(event: DragEvent): void;
+  protected onDrop(event: DragEvent): void;
+  protected removeFile(file: File): void;
+  private addFiles;
+  static ɵfac: i0.ɵɵFactoryDeclaration<FileUpload, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<FileUpload, "gbt-file-upload", never, {
+    "id": {
+      "alias": "id";
+      "required": false;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+    "multiple": {
+      "alias": "multiple";
+      "required": false;
+      "isSignal": true;
+    };
+    "accept": {
+      "alias": "accept";
+      "required": false;
+      "isSignal": true;
+    };
+    "maxSizeMb": {
+      "alias": "maxSizeMb";
+      "required": false;
+      "isSignal": true;
+    };
+    "disabled": {
+      "alias": "disabled";
+      "required": false;
+      "isSignal": true;
+    };
+    "errorMessage": {
+      "alias": "errorMessage";
+      "required": false;
+      "isSignal": true;
+    };
+    "dropLabel": {
+      "alias": "dropLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "removeLabel": {
+      "alias": "removeLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "oversizeMessage": {
+      "alias": "oversizeMessage";
+      "required": false;
+      "isSignal": true;
+    };
+    "extraFileMessage": {
+      "alias": "extraFileMessage";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}

package/types/masmarino-gabarit-floating-panel.d.ts

@@ -0,0 +1,14 @@
+interface FloatingPanelAnchor {
+  rect: DOMRect;
+  bottom: number;
+  left: number;
+}
+/** Returns `null` (panel closed, or trigger not in the DOM) when the caller should leave `panelStyle` untouched. */
+export declare function floatingPanelAnchor(open: boolean, trigger: HTMLElement | null, anchorBottom?: (rect: DOMRect) => number): FloatingPanelAnchor | null;
+/**
+ * Calls `follow` on every scroll in the page: the window's, and that of any scrolling container — the app shell's
+ * `main`, a modal's body — since a panel fixed to the viewport must follow its trigger through all of them. Scroll
+ * events don't bubble, so the listener sits on the window's capture phase. Call it in an injection context; it stops
+ * with the component.
+ */
+export declare function followPageScroll(follow: () => void): void;

package/types/masmarino-gabarit-format.d.ts

@@ -0,0 +1,54 @@
+import * as i0 from "@angular/core";
+import { PipeTransform } from "@angular/core";
+interface FormatBytesOptions {
+  base?: 1000 | 1024;
+  decimals?: number;
+  binaryUnits?: 'iec' | 'legacy';
+}
+export declare function formatBytes(bytes: number, locale: string, options?: FormatBytesOptions): string;
+type DateInput = Date | string | number;
+interface FormatRelativeTimeOptions {
+  style?: 'long' | 'short' | 'narrow';
+  numeric?: 'auto' | 'always';
+  maxUnit?: 'hour' | 'day' | 'week' | 'month';
+  absoluteAfterDays?: number;
+  timeZone?: string;
+}
+export declare function formatRelativeTime(date: DateInput | null | undefined, locale: string, now?: DateInput, options?: FormatRelativeTimeOptions): string;
+export declare function formatDateTime(date: DateInput | null | undefined, locale: string, options?: Intl.DateTimeFormatOptions): string;
+interface GbtPipeLocale {
+  locale?: string;
+}
+type GbtRelativeTimePipeOptions = FormatRelativeTimeOptions & GbtPipeLocale & {
+  now?: DateInput;
+};
+type GbtBytesPipeOptions = FormatBytesOptions & GbtPipeLocale;
+type GbtDateTimePipeOptions = Intl.DateTimeFormatOptions & GbtPipeLocale;
+export declare class GbtRelativeTimePipe implements PipeTransform {
+  private readonly localeId;
+  transform(value: DateInput | null | undefined, options?: GbtRelativeTimePipeOptions): string;
+  static ɵfac: i0.ɵɵFactoryDeclaration<GbtRelativeTimePipe, never>;
+  static ɵpipe: i0.ɵɵPipeDeclaration<GbtRelativeTimePipe, "gbtRelativeTime", true>;
+}
+export declare class GbtBytesPipe implements PipeTransform {
+  private readonly localeId;
+  transform(value: number | null | undefined, options?: GbtBytesPipeOptions): string;
+  static ɵfac: i0.ɵɵFactoryDeclaration<GbtBytesPipe, never>;
+  static ɵpipe: i0.ɵɵPipeDeclaration<GbtBytesPipe, "gbtBytes", true>;
+}
+export declare class GbtDateTimePipe implements PipeTransform {
+  private readonly localeId;
+  transform(value: DateInput | null | undefined, options?: GbtDateTimePipeOptions): string;
+  static ɵfac: i0.ɵɵFactoryDeclaration<GbtDateTimePipe, never>;
+  static ɵpipe: i0.ɵɵPipeDeclaration<GbtDateTimePipe, "gbtDateTime", true>;
+}
+export declare function formatNumber(value: number, locale: string, decimals?: number): string;
+export declare function formatCompact(value: number, locale: string): string;
+interface FormatDurationOptions {
+  days?: boolean;
+}
+export declare function formatDuration(ms: number, locale: string, options?: FormatDurationOptions): string;
+export declare function formatPercent(ratio: number, locale: string, decimals?: number): string;
+export declare function computeInitials(name: string): string;
+export declare function cachedIntl<T>(kind: string, locale: string, options: object | undefined, create: () => T): T;
+export type { DateInput, FormatBytesOptions, FormatDurationOptions, FormatRelativeTimeOptions, GbtBytesPipeOptions, GbtDateTimePipeOptions, GbtPipeLocale, GbtRelativeTimePipeOptions };

package/types/masmarino-gabarit-funnel-chart.d.ts

@@ -0,0 +1,78 @@
+import * as i0 from "@angular/core";
+interface FunnelStep {
+  label: string;
+  value: number;
+}
+interface RenderedStep {
+  label: string;
+  formattedValue: string;
+  part: number;
+  conversionFromPrevious: string;
+}
+export declare class FunnelChart {
+  steps: import("@angular/core").InputSignal<FunnelStep[]>;
+  label: import("@angular/core").InputSignal<string>;
+  locale: import("@angular/core").InputSignal<string>;
+  emptyMessage: import("@angular/core").InputSignal<string>;
+  tableCaption: import("@angular/core").InputSignal<string>;
+  stepColumn: import("@angular/core").InputSignal<string>;
+  valueColumn: import("@angular/core").InputSignal<string>;
+  conversionColumn: import("@angular/core").InputSignal<string>;
+  stepAnnouncement: import("@angular/core").InputSignal<(label: string, conversion: string) => string>;
+  private readonly reference;
+  protected readonly activeIndex: import("@angular/core").WritableSignal<number | null>;
+  protected onMouseLeave(event: MouseEvent): void;
+  protected readonly renderedSteps: import("@angular/core").Signal<RenderedStep[]>;
+  protected readonly activeStep: import("@angular/core").Signal<RenderedStep | null>;
+  protected readonly columns: import("@angular/core").Signal<string[]>;
+  protected readonly tableRows: import("@angular/core").Signal<(string | number)[][]>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<FunnelChart, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<FunnelChart, "gbt-funnel-chart", never, {
+    "steps": {
+      "alias": "steps";
+      "required": true;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": true;
+      "isSignal": true;
+    };
+    "locale": {
+      "alias": "locale";
+      "required": true;
+      "isSignal": true;
+    };
+    "emptyMessage": {
+      "alias": "emptyMessage";
+      "required": true;
+      "isSignal": true;
+    };
+    "tableCaption": {
+      "alias": "tableCaption";
+      "required": true;
+      "isSignal": true;
+    };
+    "stepColumn": {
+      "alias": "stepColumn";
+      "required": true;
+      "isSignal": true;
+    };
+    "valueColumn": {
+      "alias": "valueColumn";
+      "required": true;
+      "isSignal": true;
+    };
+    "conversionColumn": {
+      "alias": "conversionColumn";
+      "required": true;
+      "isSignal": true;
+    };
+    "stepAnnouncement": {
+      "alias": "stepAnnouncement";
+      "required": true;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+export type { FunnelStep };

package/types/masmarino-gabarit-gauge-bar.d.ts

@@ -0,0 +1,54 @@
+import * as i0 from "@angular/core";
+export declare class GaugeBar {
+  value: import("@angular/core").InputSignal<number>;
+  max: import("@angular/core").InputSignal<number>;
+  label: import("@angular/core").InputSignal<string>;
+  formattedValue: import("@angular/core").InputSignal<string>;
+  warningLabel: import("@angular/core").InputSignal<string>;
+  criticalLabel: import("@angular/core").InputSignal<string>;
+  thresholds: import("@angular/core").InputSignal<{
+    warning: number;
+    critical: number;
+  }>;
+  protected readonly percentage: import("@angular/core").Signal<number>;
+  protected readonly severity: import("@angular/core").Signal<"warning" | "critical" | null>;
+  protected readonly severityLabel: import("@angular/core").Signal<string | null>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<GaugeBar, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<GaugeBar, "gbt-gauge-bar", never, {
+    "value": {
+      "alias": "value";
+      "required": true;
+      "isSignal": true;
+    };
+    "max": {
+      "alias": "max";
+      "required": true;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": true;
+      "isSignal": true;
+    };
+    "formattedValue": {
+      "alias": "formattedValue";
+      "required": true;
+      "isSignal": true;
+    };
+    "warningLabel": {
+      "alias": "warningLabel";
+      "required": true;
+      "isSignal": true;
+    };
+    "criticalLabel": {
+      "alias": "criticalLabel";
+      "required": true;
+      "isSignal": true;
+    };
+    "thresholds": {
+      "alias": "thresholds";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}

package/types/masmarino-gabarit-git-field.d.ts

@@ -0,0 +1,39 @@
+import * as i0 from "@angular/core";
+declare const COLORS: readonly ["brand", "indigo", "patina", "brand-2", "indigo", "patina", "brand"];
+type Color = (typeof COLORS)[number];
+interface Line {
+  d: string;
+  color: Color;
+}
+interface Commit {
+  x: number;
+  y: number;
+  color: Color;
+  hollow: boolean;
+  /** Seconds of delay of its blink, so that the commits do not all light up together. */
+  delay: number;
+}
+interface Pulse {
+  d: string;
+  color: Color;
+  duration: number;
+  delay: number;
+}
+/**
+ * An animated commit graph on the graphite frame, behind a centred panel (the `[auth-backdrop]` slot of the sign-in
+ * pages) or a dark band: lanes that drift slowly sideways, their commits blinking in turn and pushes running along
+ * some of them, over two soft fields of colour. Decoration only: hidden from assistive technology, under the content,
+ * and still when reduced motion is asked for. It fills its nearest positioned ancestor.
+ */
+export declare class GitField {
+  protected readonly width = 1600;
+  protected readonly height = 560;
+  protected readonly tiles: number[];
+  protected readonly drawing: {
+    lines: Line[];
+    commits: Commit[];
+    pulses: Pulse[];
+  };
+  static ɵfac: i0.ɵɵFactoryDeclaration<GitField, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<GitField, "gbt-git-field", never, {}, {}, never, never, true, never>;
+}

package/types/masmarino-gabarit-icon-marker.d.ts

@@ -0,0 +1,47 @@
+import * as i0 from "@angular/core";
+type IconMarkerTone = 'neutral' | 'primary' | 'success' | 'warning' | 'error' | 'info';
+type IconMarkerSize = 'sm' | 'md' | 'lg' | 'xl';
+type IconMarkerShape = 'disc' | 'tile';
+type IconMarkerAppearance = 'soft' | 'outline';
+export declare class IconMarker {
+  icon: import("@angular/core").InputSignal<string>;
+  tone: import("@angular/core").InputSignal<IconMarkerTone>;
+  size: import("@angular/core").InputSignal<IconMarkerSize>;
+  shape: import("@angular/core").InputSignal<IconMarkerShape>;
+  appearance: import("@angular/core").InputSignal<IconMarkerAppearance>;
+  label: import("@angular/core").InputSignal<string | null>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<IconMarker, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<IconMarker, "gbt-icon-marker", never, {
+    "icon": {
+      "alias": "icon";
+      "required": true;
+      "isSignal": true;
+    };
+    "tone": {
+      "alias": "tone";
+      "required": false;
+      "isSignal": true;
+    };
+    "size": {
+      "alias": "size";
+      "required": false;
+      "isSignal": true;
+    };
+    "shape": {
+      "alias": "shape";
+      "required": false;
+      "isSignal": true;
+    };
+    "appearance": {
+      "alias": "appearance";
+      "required": false;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+export type { IconMarkerAppearance, IconMarkerShape, IconMarkerSize, IconMarkerTone };

package/types/masmarino-gabarit-icon.d.ts

@@ -0,0 +1,23 @@
+import * as i0 from "@angular/core";
+export declare class IconRegistry {
+  private readonly icons;
+  register(name: string, svgInnerMarkup: string): void;
+  registerAll(icons: Record<string, string>): void;
+  get(name: string): string | null;
+  static ɵfac: i0.ɵɵFactoryDeclaration<IconRegistry, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}
+export declare class Icon {
+  private readonly sanitizer;
+  private readonly registry;
+  name: import("@angular/core").InputSignal<string>;
+  protected readonly svgContent: import("@angular/core").Signal<import("@angular/platform-browser").SafeHtml | null>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<Icon, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<Icon, "gbt-icon", never, {
+    "name": {
+      "alias": "name";
+      "required": true;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}