@sentropic/design-system-angular 0.36.58 → 0.36.60

package/dist/AppShell.d.ts

@@ -2,29 +2,130 @@ import * as i0 from "@angular/core";
 export type AppShellVariant = "site" | "workspace";
 export type AppShellUtilityMode = "reserve" | "overlay" | "floating";
 export type AppShellUtilitySide = "left" | "right" | "bottom";
+export type AppShellPanelCollapse = "stack" | "accordion";
+export type AppShellPanelKey = "navigationPanel" | "contextPanel" | "utilityPanel";
 export type AppShellProps = {
     variant?: AppShellVariant;
+    /** Presence flags for named panels — pair with a projected `[slot=x]` element. */
+    topChrome?: unknown;
+    primaryRail?: unknown;
+    navigationPanel?: unknown;
+    contextPanel?: unknown;
+    utilityPanel?: unknown;
+    bottomPanel?: unknown;
     mainId?: string;
     navigationLabel?: string;
     contextLabel?: string;
     utilityLabel?: string;
     utilityMode?: AppShellUtilityMode;
     utilitySide?: AppShellUtilitySide;
+    /**
+     * Below the 48rem breakpoint, `"stack"` (default) keeps today's behaviour —
+     * panels stack full-width in document order, always expanded. `"accordion"`
+     * degrades each present panel to a keyboard-accessible disclosure (collapsed
+     * by default) instead of squeezing the main content. Desktop (>48rem)
+     * rendering is IDENTICAL in both modes. Panel content is mounted once
+     * regardless of mode/breakpoint; collapsing hides/sizes the region via CSS
+     * rather than destroying it, so a stateful widget projected into a panel
+     * never remounts.
+     */
+    panelCollapse?: AppShellPanelCollapse;
+    /** Disclosure label for `primaryRail` when `panelCollapse="accordion"`. */
+    primaryRailLabel?: string;
+    /** Disclosure label for `navigationPanel` when `panelCollapse="accordion"`. Defaults to `navigationLabel`. */
+    navigationPanelLabel?: string;
+    /** Disclosure label for `contextPanel` when `panelCollapse="accordion"`. Defaults to `contextLabel`. */
+    contextPanelLabel?: string;
+    /** Disclosure label for `utilityPanel` when `panelCollapse="accordion"`. Defaults to `utilityLabel`. */
+    utilityPanelLabel?: string;
+    /** Enables drag-to-resize handles on side panels above 48rem. Default false — zero regression. */
+    panelResize?: boolean;
+    /** Controlled panel widths in px. When provided the component never mutates width itself. */
+    panelWidths?: Partial<Record<AppShellPanelKey, number>>;
+    /** Seeds uncontrolled widths in px. */
+    defaultPanelWidths?: Partial<Record<AppShellPanelKey, number>>;
+    /** Fired on every committed resize. Persistence is the CONSUMER's job — the DS stays presentational. */
+    onPanelResize?: (key: AppShellPanelKey, width: number) => void;
+    /** Lower clamp in px. Default 180. */
+    panelMinWidth?: number;
+    /** Upper clamp in px. Default 640. */
+    panelMaxWidth?: number;
     class?: string;
 };
 export declare class AppShell {
     static readonly stComponentName = "AppShell";
     readonly componentName = "AppShell";
     variant: AppShellVariant;
+    topChrome?: unknown;
+    primaryRail?: unknown;
+    navigationPanel?: unknown;
+    contextPanel?: unknown;
+    utilityPanel?: unknown;
+    bottomPanel?: unknown;
     mainId: string;
     navigationLabel: string;
     contextLabel: string;
     utilityLabel: string;
     utilityMode: AppShellUtilityMode;
     utilitySide: AppShellUtilitySide;
+    panelCollapse: AppShellPanelCollapse;
+    primaryRailLabel: string;
+    navigationPanelLabel?: string;
+    contextPanelLabel?: string;
+    utilityPanelLabel?: string;
     classInput?: string;
+    panelResize: boolean;
+    panelWidths?: Partial<Record<AppShellPanelKey, number>>;
+    defaultPanelWidths?: Partial<Record<AppShellPanelKey, number>>;
+    onPanelResize?: (key: AppShellPanelKey, width: number) => void;
+    panelMinWidth: number;
+    panelMaxWidth: number;
+    private navigationPanelRef?;
+    private contextPanelRef?;
+    private utilityPanelRef?;
+    private internalWidths?;
+    private dragKey;
+    private dragPositive;
+    private dragStartX;
+    private dragStartWidth;
+    primaryRailPanelOpen: boolean;
+    navigationPanelOpen: boolean;
+    contextPanelOpen: boolean;
+    utilityPanelOpen: boolean;
+    readonly primaryRailTriggerId = "st-appShell-primaryRail-trigger";
+    readonly primaryRailRegionId = "st-appShell-primaryRail-region";
+    readonly navigationPanelTriggerId = "st-appShell-navigationPanel-trigger";
+    readonly navigationPanelRegionId = "st-appShell-navigationPanel-region";
+    readonly contextPanelTriggerId = "st-appShell-contextPanel-trigger";
+    readonly contextPanelRegionId = "st-appShell-contextPanel-region";
+    readonly utilityPanelTriggerId = "st-appShell-utilityPanel-trigger";
+    readonly utilityPanelRegionId = "st-appShell-utilityPanel-region";
     get hostClass(): string;
+    get navigationPanelLabelResolved(): string;
+    get contextPanelLabelResolved(): string;
+    get utilityPanelLabelResolved(): string;
+    get primaryRailRegionCollapsed(): boolean;
+    get navigationPanelRegionCollapsed(): boolean;
+    get contextPanelRegionCollapsed(): boolean;
+    get utilityPanelRegionCollapsed(): boolean;
+    togglePrimaryRailPanel(): void;
+    toggleNavigationPanel(): void;
+    toggleContextPanel(): void;
+    toggleUtilityPanel(): void;
+    private get isWidthControlled();
+    private ensureInternalWidths;
+    widthFor(key: AppShellPanelKey): number | undefined;
+    clampWidth(n: number): number;
+    displayWidth(key: AppShellPanelKey): number;
+    private panelElFor;
+    get utilityPositive(): boolean;
+    get panelStyle(): string | null;
+    private commitWidth;
+    onHandlePointerDown(event: PointerEvent, key: AppShellPanelKey, positive: boolean): void;
+    onHandlePointerMove(event: PointerEvent): void;
+    onHandlePointerUp(event: PointerEvent): void;
+    onHandleKeydown(event: KeyboardEvent, key: AppShellPanelKey, positive: boolean): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AppShell, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AppShell, "st-app-shell", never, { "variant": { "alias": "variant"; "required": false; }; "mainId": { "alias": "mainId"; "required": false; }; "navigationLabel": { "alias": "navigationLabel"; "required": false; }; "contextLabel": { "alias": "contextLabel"; "required": false; }; "utilityLabel": { "alias": "utilityLabel"; "required": false; }; "utilityMode": { "alias": "utilityMode"; "required": false; }; "utilitySide": { "alias": "utilitySide"; "required": false; }; "classInput": { "alias": "class"; "required": false; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AppShell, "st-app-shell", never, { "variant": { "alias": "variant"; "required": false; }; "topChrome": { "alias": "topChrome"; "required": false; }; "primaryRail": { "alias": "primaryRail"; "required": false; }; "navigationPanel": { "alias": "navigationPanel"; "required": false; }; "contextPanel": { "alias": "contextPanel"; "required": false; }; "utilityPanel": { "alias": "utilityPanel"; "required": false; }; "bottomPanel": { "alias": "bottomPanel"; "required": false; }; "mainId": { "alias": "mainId"; "required": false; }; "navigationLabel": { "alias": "navigationLabel"; "required": false; }; "contextLabel": { "alias": "contextLabel"; "required": false; }; "utilityLabel": { "alias": "utilityLabel"; "required": false; }; "utilityMode": { "alias": "utilityMode"; "required": false; }; "utilitySide": { "alias": "utilitySide"; "required": false; }; "panelCollapse": { "alias": "panelCollapse"; "required": false; }; "primaryRailLabel": { "alias": "primaryRailLabel"; "required": false; }; "navigationPanelLabel": { "alias": "navigationPanelLabel"; "required": false; }; "contextPanelLabel": { "alias": "contextPanelLabel"; "required": false; }; "utilityPanelLabel": { "alias": "utilityPanelLabel"; "required": false; }; "classInput": { "alias": "class"; "required": false; }; "panelResize": { "alias": "panelResize"; "required": false; }; "panelWidths": { "alias": "panelWidths"; "required": false; }; "defaultPanelWidths": { "alias": "defaultPanelWidths"; "required": false; }; "onPanelResize": { "alias": "onPanelResize"; "required": false; }; "panelMinWidth": { "alias": "panelMinWidth"; "required": false; }; "panelMaxWidth": { "alias": "panelMaxWidth"; "required": false; }; }, {}, never, ["*", "[slot=topChrome]", "[slot=primaryRail]", "[slot=navigationPanel]", "[slot=main]", "[slot=contextPanel]", "[slot=utilityPanel]", "[slot=bottomPanel]"], true, never>;
 }
 //# sourceMappingURL=AppShell.d.ts.map

package/dist/AppShell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../src/AppShell.ts"],"names":[],"mappings":";AAEA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,WAAW,CAAC;AACnD,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AACrE,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE9D,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,qBASa,QAAQ;IACnB,MAAM,CAAC,QAAQ,CAAC,eAAe,cAAc;IAC7C,QAAQ,CAAC,aAAa,cAAc;IACzB,OAAO,EAAE,eAAe,CAAe;IACvC,MAAM,SAAU;IAChB,eAAe,SAA0B;IACzC,YAAY,SAAmB;IAC/B,YAAY,SAAmB;IAC/B,WAAW,EAAE,mBAAmB,CAAa;IAC7C,WAAW,EAAE,mBAAmB,CAAW;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEtC,IAAI,SAAS,IAAI,MAAM,CAEtB;yCAdU,QAAQ;2CAAR,QAAQ;CAepB"}
+{"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../src/AppShell.ts"],"names":[],"mappings":"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"}