@ojiepermana/angular 22.1.13 → 22.2.0

package/types/ojiepermana-angular-theme-shell-services.d.ts

@@ -1,11 +1,10 @@
-import * as _angular_core from '@angular/core';
-import { InjectionToken, EnvironmentProviders } from '@angular/core';
-import { ShellPlatform, ShellDevice, ShellWindowState, ShellMode, ShellColor, ShellFrame } from '@ojiepermana/angular/theme/shell/types';
-
+import * as i0 from "@angular/core";
+import { EnvironmentProviders, InjectionToken } from "@angular/core";
+import { ShellColor, ShellDevice, ShellFrame, ShellMode, ShellPlatform, ShellWindowState } from "@ojiepermana/angular/theme/shell/types";
 /** What the shell needs to know about the host window right now. */
-interface ShellWindowSnapshot {
-    readonly state: ShellWindowState;
-    readonly focused: boolean;
+export interface ShellWindowSnapshot {
+  readonly state: ShellWindowState;
+  readonly focused: boolean;
 }
 /**
  * The seam between the shell and a desktop runtime.
@@ -15,76 +14,75 @@ interface ShellWindowSnapshot {
  * pays nothing and an app that ships to a native window provides one adapter.
  * Commands may be sync or async — the shell always awaits them.
  */
-interface ShellWindowBridge {
-    readonly platform: ShellPlatform;
-    /**
-     * Host OS, when the runtime can report it. `null` means "cannot tell" — the
-     * shell then falls back to its `device` input, storage, or the mode's default,
-     * rather than guessing.
-     */
-    device(): ShellDevice | null | Promise<ShellDevice | null>;
-    snapshot(): ShellWindowSnapshot | Promise<ShellWindowSnapshot>;
-    minimize(): void | Promise<void>;
-    toggleMaximize(): void | Promise<void>;
-    close(): void | Promise<void>;
-    /**
-     * Move the window with the pointer. Tauri and Electron both mark their drag
-     * surface declaratively (`data-tauri-drag-region` / `-webkit-app-region`, both
-     * stamped on the titlebar), so this is only needed by runtimes that require an
-     * explicit call.
-     */
-    startDragging?(): void | Promise<void>;
-    /** Observe window resize/move/focus changes; resolves to the unsubscribe. */
-    watch?(onChange: () => void): (() => void) | Promise<() => void>;
+export interface ShellWindowBridge {
+  readonly platform: ShellPlatform;
+  /**
+   * Host OS, when the runtime can report it. `null` means "cannot tell" — the
+   * shell then falls back to its `device` input, storage, or the mode's default,
+   * rather than guessing.
+   */
+  device(): ShellDevice | null | Promise<ShellDevice | null>;
+  snapshot(): ShellWindowSnapshot | Promise<ShellWindowSnapshot>;
+  minimize(): void | Promise<void>;
+  toggleMaximize(): void | Promise<void>;
+  close(): void | Promise<void>;
+  /**
+   * Move the window with the pointer. Tauri and Electron both mark their drag
+   * surface declaratively (`data-tauri-drag-region` / `-webkit-app-region`, both
+   * stamped on the titlebar), so this is only needed by runtimes that require an
+   * explicit call.
+   */
+  startDragging?(): void | Promise<void>;
+  /** Observe window resize/move/focus changes; resolves to the unsubscribe. */
+  watch?(onChange: () => void): (() => void) | Promise<() => void>;
 }
-declare const SHELL_WINDOW_BRIDGE: InjectionToken<ShellWindowBridge>;
+export declare const SHELL_WINDOW_BRIDGE: InjectionToken<ShellWindowBridge>;
 /**
  * Browser fallback used when no bridge is provided: a page has no window to
  * drive, so it reports the web platform, no device opinion, and every command is
  * a no-op. This is what keeps `<Shell>` renderable (and testable) outside a
  * desktop runtime.
  */
-declare const WEB_SHELL_WINDOW_BRIDGE: ShellWindowBridge;
+export declare const WEB_SHELL_WINDOW_BRIDGE: ShellWindowBridge;
 /**
  * Register the bridge `ShellService` drives. Pass a factory to defer any runtime
  * probing until the injector is created.
  */
-declare function provideShellWindowBridge(bridge: ShellWindowBridge | (() => ShellWindowBridge)): EnvironmentProviders;
-
+export declare function provideShellWindowBridge(bridge: ShellWindowBridge | (() => ShellWindowBridge)): EnvironmentProviders;
 /**
  * The slice of a Tauri `Window` the shell drives, declared structurally so the
  * theme package never has to depend on `@tauri-apps/api`. Any object with these
  * methods works, which is also what makes the bridge testable with a fake.
  */
-interface TauriWindowHandle {
-    minimize(): Promise<void>;
-    toggleMaximize(): Promise<void>;
-    close(): Promise<void>;
-    isMaximized(): Promise<boolean>;
-    isFullscreen(): Promise<boolean>;
-    startDragging(): Promise<void>;
-    isFocused?(): Promise<boolean>;
-    onResized?(handler: () => void): Promise<() => void>;
-    onFocusChanged?(handler: () => void): Promise<() => void>;
+export interface TauriWindowHandle {
+  minimize(): Promise<void>;
+  toggleMaximize(): Promise<void>;
+  close(): Promise<void>;
+  isMaximized(): Promise<boolean>;
+  isFullscreen(): Promise<boolean>;
+  startDragging(): Promise<void>;
+  isFocused?(): Promise<boolean>;
+  onResized?(handler: () => void): Promise<() => void>;
+  onFocusChanged?(handler: () => void): Promise<() => void>;
 }
-interface TauriShellBridgeOptions {
-    /**
-     * Resolve the window to drive. Defaults to the `withGlobalTauri` global
-     * (`window.__TAURI__.window.getCurrentWindow()`). Apps that keep the global
-     * off pass the module instead:
-     * `{ currentWindow: () => import('@tauri-apps/api/window').then((m) => m.getCurrentWindow()) }`.
-     */
-    readonly currentWindow?: () => TauriWindowHandle | null | Promise<TauriWindowHandle | null>;
-    /**
-     * Resolve the host OS, mapped onto the shell's `device` axis. Defaults to the
-     * `withGlobalTauri` os plugin, then the browser platform string. Apps without
-     * the global pass
-     * `{ platform: () => import('@tauri-apps/plugin-os').then((m) => m.platform()) }`.
-     */
-    readonly platform?: () => string | Promise<string>;
+export interface TauriShellBridgeOptions {
+  /**
+   * Resolve the window to drive. Defaults to the `withGlobalTauri` global
+   * (`window.__TAURI__.window.getCurrentWindow()`). Apps that keep the global
+   * off pass the module instead:
+   * `{ currentWindow: () => import('@tauri-apps/api/window').then((m) => m.getCurrentWindow()) }`.
+   */
+  readonly currentWindow?: () => TauriWindowHandle | null | Promise<TauriWindowHandle | null>;
+  /**
+   * Resolve the host OS, mapped onto the shell's `device` axis. Defaults to the
+   * `withGlobalTauri` os plugin, then the browser platform string. Apps without
+   * the global pass
+   * `{ platform: () => import('@tauri-apps/plugin-os').then((m) => m.platform()) }`.
+   */
+  readonly platform?: () => string | Promise<string>;
 }
 /** `true` when the page is running inside a Tauri webview. */
-declare function isTauriRuntime(): boolean;
+export declare function isTauriRuntime(): boolean;
 /**
  * Adapter from a Tauri window onto {@link ShellWindowBridge}.
  *
@@ -92,17 +90,16 @@ declare function isTauriRuntime(): boolean;
  * bridge can be registered unconditionally: run the app in a browser and the
  * commands become no-ops rather than errors.
  */
-declare function createTauriShellWindowBridge(options?: TauriShellBridgeOptions): ShellWindowBridge;
+export declare function createTauriShellWindowBridge(options?: TauriShellBridgeOptions): ShellWindowBridge;
 /**
  * Register the Tauri window bridge for `ShellService`. Safe to call in a build
  * that also ships to the browser — outside a Tauri webview the bridge resolves
  * no window and the shell falls back to inert commands.
  */
-declare function provideTauriShellWindowBridge(options?: TauriShellBridgeOptions): EnvironmentProviders;
-
+export declare function provideTauriShellWindowBridge(options?: TauriShellBridgeOptions): EnvironmentProviders;
 interface ShellMutationOptions {
-    /** `false` keeps the change out of localStorage (a host-driven override, not a user choice). */
-    persist?: boolean;
+  /** `false` keeps the change out of localStorage (a host-driven override, not a user choice). */
+  persist?: boolean;
 }
 /**
  * State behind `<Shell>`: the persisted `mode` / `device` / `color` / `frame`
@@ -129,65 +126,62 @@ interface ShellMutationOptions {
  * With no bridge registered this resolves to the inert web bridge, so the same
  * component tree renders in a browser tab, in a unit test, and under SSR.
  */
-declare class ShellService {
-    private readonly platformId;
-    private readonly storage;
-    private readonly destroyRef;
-    private readonly bridge;
-    /** Runtime hosting the shell; `web` whenever no bridge is registered. */
-    readonly platform: ShellPlatform;
-    /** `true` for any non-browser runtime — i.e. there is a real OS window to drive. */
-    readonly isDesktopRuntime: boolean;
-    private readonly modeState;
-    private readonly deviceState;
-    private readonly colorState;
-    private readonly frameState;
-    private readonly reportedDeviceState;
-    private readonly windowStateState;
-    private readonly focusedState;
-    readonly mode: _angular_core.Signal<"web" | "desktop" | "tablet" | "mobile">;
-    /**
-     * Preferred device: the stored choice, else what the runtime reports, else the
-     * current mode's default. Not forced to match `mode()` — see the class note.
-     */
-    readonly device: _angular_core.Signal<"browser" | "macos" | "windows" | "linux" | "ipad" | "android" | "ios">;
-    /** Where the shell's chrome takes its colors from: the design system, or the device's native look. */
-    readonly color: _angular_core.Signal<"sync" | "default">;
-    /** How the app sits in its window: flush (`classic`) or inset as a panel (`modern`). */
-    readonly frame: _angular_core.Signal<"classic" | "modern">;
-    readonly windowState: _angular_core.Signal<"normal" | "maximized" | "fullscreen">;
-    readonly focused: _angular_core.Signal<boolean>;
-    readonly isMaximized: _angular_core.Signal<boolean>;
-    readonly isFullscreen: _angular_core.Signal<boolean>;
-    constructor();
-    setMode(mode: ShellMode, options?: ShellMutationOptions): void;
-    setDevice(device: ShellDevice, options?: ShellMutationOptions): void;
-    setColor(color: ShellColor, options?: ShellMutationOptions): void;
-    setFrame(frame: ShellFrame, options?: ShellMutationOptions): void;
-    /** Adopt `mode` as the default, unless a choice is already stored. */
-    registerMode(mode: ShellMode): void;
-    /** Adopt `device` as the default, unless a choice is already stored. */
-    registerDevice(device: ShellDevice): void;
-    /** Adopt `color` as the default, unless a choice is already stored. */
-    registerColor(color: ShellColor): void;
-    /** Adopt `frame` as the default, unless a choice is already stored. */
-    registerFrame(frame: ShellFrame): void;
-    /** Re-read the device and window state from the bridge. */
-    sync(): Promise<void>;
-    minimize(): Promise<void>;
-    toggleMaximize(): Promise<void>;
-    close(): Promise<void>;
-    /** Start a pointer-driven window move, for runtimes that need an explicit call. */
-    startDragging(): Promise<void>;
-    private command;
-    private watchWindow;
-    private storedMode;
-    private storedDevice;
-    private storedColor;
-    private storedFrame;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ShellService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ShellService>;
-}
-
-export { SHELL_WINDOW_BRIDGE, ShellService, WEB_SHELL_WINDOW_BRIDGE, createTauriShellWindowBridge, isTauriRuntime, provideShellWindowBridge, provideTauriShellWindowBridge };
-export type { ShellWindowBridge, ShellWindowSnapshot, TauriShellBridgeOptions, TauriWindowHandle };
+export declare class ShellService {
+  private readonly platformId;
+  private readonly storage;
+  private readonly destroyRef;
+  private readonly bridge;
+  /** Runtime hosting the shell; `web` whenever no bridge is registered. */
+  readonly platform: ShellPlatform;
+  /** `true` for any non-browser runtime — i.e. there is a real OS window to drive. */
+  readonly isDesktopRuntime: boolean;
+  private readonly modeState;
+  private readonly deviceState;
+  private readonly colorState;
+  private readonly frameState;
+  private readonly reportedDeviceState;
+  private readonly windowStateState;
+  private readonly focusedState;
+  readonly mode: import("@angular/core").Signal<"web" | "desktop" | "tablet" | "mobile">;
+  /**
+   * Preferred device: the stored choice, else what the runtime reports, else the
+   * current mode's default. Not forced to match `mode()` — see the class note.
+   */
+  readonly device: import("@angular/core").Signal<"browser" | "macos" | "windows" | "linux" | "ipad" | "android" | "ios">;
+  /** Where the shell's chrome takes its colors from: the design system, or the device's native look. */
+  readonly color: import("@angular/core").Signal<"sync" | "default">;
+  /** How the app sits in its window: flush (`classic`) or inset as a panel (`modern`). */
+  readonly frame: import("@angular/core").Signal<"classic" | "modern">;
+  readonly windowState: import("@angular/core").Signal<"normal" | "maximized" | "fullscreen">;
+  readonly focused: import("@angular/core").Signal<boolean>;
+  readonly isMaximized: import("@angular/core").Signal<boolean>;
+  readonly isFullscreen: import("@angular/core").Signal<boolean>;
+  constructor();
+  setMode(mode: ShellMode, options?: ShellMutationOptions): void;
+  setDevice(device: ShellDevice, options?: ShellMutationOptions): void;
+  setColor(color: ShellColor, options?: ShellMutationOptions): void;
+  setFrame(frame: ShellFrame, options?: ShellMutationOptions): void;
+  /** Adopt `mode` as the default, unless a choice is already stored. */
+  registerMode(mode: ShellMode): void;
+  /** Adopt `device` as the default, unless a choice is already stored. */
+  registerDevice(device: ShellDevice): void;
+  /** Adopt `color` as the default, unless a choice is already stored. */
+  registerColor(color: ShellColor): void;
+  /** Adopt `frame` as the default, unless a choice is already stored. */
+  registerFrame(frame: ShellFrame): void;
+  /** Re-read the device and window state from the bridge. */
+  sync(): Promise<void>;
+  minimize(): Promise<void>;
+  toggleMaximize(): Promise<void>;
+  close(): Promise<void>;
+  /** Start a pointer-driven window move, for runtimes that need an explicit call. */
+  startDragging(): Promise<void>;
+  private command;
+  private watchWindow;
+  private storedMode;
+  private storedDevice;
+  private storedColor;
+  private storedFrame;
+  static ɵfac: i0.ɵɵFactoryDeclaration<ShellService, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}

package/types/ojiepermana-angular-theme-shell-types.d.ts

@@ -5,7 +5,7 @@
  *
  * Persisted under {@link SHELL_MODE_STORAGE_KEY}.
  */
-declare const SHELL_MODES: readonly ["web", "desktop", "tablet", "mobile"];
+export declare const SHELL_MODES: readonly ["web", "desktop", "tablet", "mobile"];
 /**
  * Concrete host the shell is running on. Each mode owns a set of these (see
  * {@link SHELL_MODE_DEVICES}) — `android` deliberately belongs to both `tablet`
@@ -13,7 +13,7 @@ declare const SHELL_MODES: readonly ["web", "desktop", "tablet", "mobile"];
  *
  * Persisted under {@link SHELL_DEVICE_STORAGE_KEY}.
  */
-declare const SHELL_DEVICES: readonly ["browser", "macos", "windows", "linux", "ipad", "android", "ios"];
+export declare const SHELL_DEVICES: readonly ["browser", "macos", "windows", "linux", "ipad", "android", "ios"];
 /**
  * Where the shell's own chrome takes its colors from. `sync` keeps the titlebar
  * inside the design system, so it recolors with `theme-color` / `theme-neutral`
@@ -22,7 +22,7 @@ declare const SHELL_DEVICES: readonly ["browser", "macos", "windows", "linux", "
  *
  * Persisted under {@link SHELL_COLOR_STORAGE_KEY}.
  */
-declare const SHELL_COLORS: readonly ["sync", "default"];
+export declare const SHELL_COLORS: readonly ["sync", "default"];
 /**
  * How the app sits inside its window.
  *
@@ -39,67 +39,64 @@ declare const SHELL_COLORS: readonly ["sync", "default"];
  *
  * Persisted under {@link SHELL_FRAME_STORAGE_KEY}.
  */
-declare const SHELL_FRAMES: readonly ["classic", "modern"];
+export declare const SHELL_FRAMES: readonly ["classic", "modern"];
 /**
  * Runtime hosting the shell — distinct from `device`, which is the OS. `web`
  * means no bridge is registered, so there is no window to drive.
  */
-declare const SHELL_PLATFORMS: readonly ["web", "tauri", "electron", "custom"];
-declare const SHELL_WINDOW_STATES: readonly ["normal", "maximized", "fullscreen"];
-type ShellMode = (typeof SHELL_MODES)[number];
-type ShellDevice = (typeof SHELL_DEVICES)[number];
-type ShellColor = (typeof SHELL_COLORS)[number];
-type ShellFrame = (typeof SHELL_FRAMES)[number];
-type ShellPlatform = (typeof SHELL_PLATFORMS)[number];
-type ShellWindowState = (typeof SHELL_WINDOW_STATES)[number];
-declare const SHELL_DEFAULT_MODE: ShellMode;
-declare const SHELL_DEFAULT_DEVICE: ShellDevice;
-declare const SHELL_DEFAULT_COLOR: ShellColor;
-declare const SHELL_DEFAULT_FRAME: ShellFrame;
-declare const SHELL_DEFAULT_PLATFORM: ShellPlatform;
-declare const SHELL_DEFAULT_WINDOW_STATE: ShellWindowState;
-declare const SHELL_MODE_STORAGE_KEY = "shell-mode";
-declare const SHELL_DEVICE_STORAGE_KEY = "shell-device";
-declare const SHELL_COLOR_STORAGE_KEY = "shell-color";
-declare const SHELL_FRAME_STORAGE_KEY = "shell-frame";
+export declare const SHELL_PLATFORMS: readonly ["web", "tauri", "electron", "custom"];
+export declare const SHELL_WINDOW_STATES: readonly ["normal", "maximized", "fullscreen"];
+export type ShellMode = (typeof SHELL_MODES)[number];
+export type ShellDevice = (typeof SHELL_DEVICES)[number];
+export type ShellColor = (typeof SHELL_COLORS)[number];
+export type ShellFrame = (typeof SHELL_FRAMES)[number];
+export type ShellPlatform = (typeof SHELL_PLATFORMS)[number];
+export type ShellWindowState = (typeof SHELL_WINDOW_STATES)[number];
+export declare const SHELL_DEFAULT_MODE: ShellMode;
+export declare const SHELL_DEFAULT_DEVICE: ShellDevice;
+export declare const SHELL_DEFAULT_COLOR: ShellColor;
+export declare const SHELL_DEFAULT_FRAME: ShellFrame;
+export declare const SHELL_DEFAULT_PLATFORM: ShellPlatform;
+export declare const SHELL_DEFAULT_WINDOW_STATE: ShellWindowState;
+export declare const SHELL_MODE_STORAGE_KEY = "shell-mode";
+export declare const SHELL_DEVICE_STORAGE_KEY = "shell-device";
+export declare const SHELL_COLOR_STORAGE_KEY = "shell-color";
+export declare const SHELL_FRAME_STORAGE_KEY = "shell-frame";
 /**
  * Which devices each mode can run on. The first entry is the mode's default, used
  * when nothing else resolves — and to correct a device that cannot belong to the
  * active mode (`mode='desktop' device='ipad'` has no meaning).
  */
-declare const SHELL_MODE_DEVICES: Readonly<Record<ShellMode, readonly ShellDevice[]>>;
-declare function isShellMode(value: string | null | undefined): value is ShellMode;
-declare function isShellDevice(value: string | null | undefined): value is ShellDevice;
-declare function isShellColor(value: string | null | undefined): value is ShellColor;
-declare function isShellFrame(value: string | null | undefined): value is ShellFrame;
-declare function isShellPlatform(value: string | null | undefined): value is ShellPlatform;
-declare function isShellWindowState(value: string | null | undefined): value is ShellWindowState;
-declare function normalizeShellMode(value: string | null | undefined): ShellMode;
-declare function normalizeShellColor(value: string | null | undefined): ShellColor;
-declare function normalizeShellFrame(value: string | null | undefined): ShellFrame;
+export declare const SHELL_MODE_DEVICES: Readonly<Record<ShellMode, readonly ShellDevice[]>>;
+export declare function isShellMode(value: string | null | undefined): value is ShellMode;
+export declare function isShellDevice(value: string | null | undefined): value is ShellDevice;
+export declare function isShellColor(value: string | null | undefined): value is ShellColor;
+export declare function isShellFrame(value: string | null | undefined): value is ShellFrame;
+export declare function isShellPlatform(value: string | null | undefined): value is ShellPlatform;
+export declare function isShellWindowState(value: string | null | undefined): value is ShellWindowState;
+export declare function normalizeShellMode(value: string | null | undefined): ShellMode;
+export declare function normalizeShellColor(value: string | null | undefined): ShellColor;
+export declare function normalizeShellFrame(value: string | null | undefined): ShellFrame;
 /**
  * Resolve a frame that is coherent with `mode`. Only a desktop window has a frame
  * to shape — the other modes have no titlebar to fuse with a surround — so
  * `modern` collapses to `classic` there rather than insetting an app for no reason.
  */
-declare function resolveShellFrameForMode(mode: ShellMode, frame: string | null | undefined): ShellFrame;
+export declare function resolveShellFrameForMode(mode: ShellMode, frame: string | null | undefined): ShellFrame;
 /** Devices the mode can run on; the first is its default. */
-declare function shellDevicesForMode(mode: ShellMode): readonly ShellDevice[];
-declare function defaultShellDeviceForMode(mode: ShellMode): ShellDevice;
-declare function isShellDeviceForMode(mode: ShellMode, device: ShellDevice): boolean;
+export declare function shellDevicesForMode(mode: ShellMode): readonly ShellDevice[];
+export declare function defaultShellDeviceForMode(mode: ShellMode): ShellDevice;
+export declare function isShellDeviceForMode(mode: ShellMode, device: ShellDevice): boolean;
 /**
  * Resolve a device that is coherent with `mode`. An unknown device, or one that
  * belongs to a different form factor, falls back to the mode's default rather
  * than leaving the pair in a state no styling can describe.
  */
-declare function resolveShellDeviceForMode(mode: ShellMode, device: string | null | undefined): ShellDevice;
+export declare function resolveShellDeviceForMode(mode: ShellMode, device: string | null | undefined): ShellDevice;
 /**
  * Map a raw platform identifier onto the device axis — a Tauri `platform()`
  * result, an Electron `process.platform`, or a `navigator.platform`/user-agent
  * string. Order matters: iPadOS reports itself as a Mac, and Android tablets and
  * phones share a token, so the narrower match has to win first.
  */
-declare function normalizeShellDevice(value: string | null | undefined): ShellDevice | null;
-
-export { SHELL_COLORS, SHELL_COLOR_STORAGE_KEY, SHELL_DEFAULT_COLOR, SHELL_DEFAULT_DEVICE, SHELL_DEFAULT_FRAME, SHELL_DEFAULT_MODE, SHELL_DEFAULT_PLATFORM, SHELL_DEFAULT_WINDOW_STATE, SHELL_DEVICES, SHELL_DEVICE_STORAGE_KEY, SHELL_FRAMES, SHELL_FRAME_STORAGE_KEY, SHELL_MODES, SHELL_MODE_DEVICES, SHELL_MODE_STORAGE_KEY, SHELL_PLATFORMS, SHELL_WINDOW_STATES, defaultShellDeviceForMode, isShellColor, isShellDevice, isShellDeviceForMode, isShellFrame, isShellMode, isShellPlatform, isShellWindowState, normalizeShellColor, normalizeShellDevice, normalizeShellFrame, normalizeShellMode, resolveShellDeviceForMode, resolveShellFrameForMode, shellDevicesForMode };
-export type { ShellColor, ShellDevice, ShellFrame, ShellMode, ShellPlatform, ShellWindowState };
+export declare function normalizeShellDevice(value: string | null | undefined): ShellDevice | null;