@ojiepermana/angular 0.1.1 → 21.0.2

package/types/ojiepermana-angular-navigation.d.ts

@@ -1,8 +1,8 @@
 import * as _angular_core from '@angular/core';
-import { EnvironmentProviders, InjectionToken } from '@angular/core';
 import { Params, QueryParamsHandling, IsActiveMatchOptions } from '@angular/router';
+import { ClassValue } from 'clsx';
 
-type NavigationItemType = 'aside' | 'basic' | 'collapsable' | 'divider' | 'group' | 'spacer';
+type NavigationItemType = 'aside' | 'basic' | 'collapsable' | 'divider' | 'group' | 'mega' | 'spacer';
 interface NavigationItemClasses {
     title?: string;
     subtitle?: string;
@@ -30,7 +30,7 @@ interface NavigationItemBase {
     tooltip?: string;
     /** Custom CSS classes */
     classes?: NavigationItemClasses;
-    /** Material icon name */
+    /** Material Symbols icon name (ligature, e.g. `dashboard`, `menu_book`) */
     icon?: string;
     /** Badge configuration */
     badge?: NavigationItemBadge;
@@ -77,6 +77,16 @@ interface NavigationGroupItem extends NavigationItemBase {
     type: 'group';
     children: NavigationItem[];
 }
+/**
+ * Mega menu branch — dirender sebagai panel full-width multi-kolom pada topbar.
+ * Children biasanya berupa `NavigationGroupItem` (per kolom) berisi `basic` items.
+ */
+interface NavigationMegaItem extends NavigationItemBase {
+    type: 'mega';
+    /** Jumlah kolom saat viewport >= md (default: 4) */
+    columns?: number;
+    children: NavigationItem[];
+}
 interface NavigationDividerItem extends NavigationItemBase {
     type: 'divider';
     children?: never;
@@ -85,7 +95,7 @@ interface NavigationSpacerItem extends NavigationItemBase {
     type: 'spacer';
     children?: never;
 }
-type NavigationBranchItem = NavigationAsideItem | NavigationCollapsableItem | NavigationGroupItem;
+type NavigationBranchItem = NavigationAsideItem | NavigationCollapsableItem | NavigationGroupItem | NavigationMegaItem;
 type NavigationLeafItem = NavigationBasicItem | NavigationDividerItem | NavigationSpacerItem;
 type NavigationItem = NavigationBranchItem | NavigationLeafItem;
 /**
@@ -96,133 +106,263 @@ type NavigationItem = NavigationBranchItem | NavigationLeafItem;
  */
 type NavigationStructuredItem = NavigationItem;
 /**
- * Horizontal Navigation Variants
- * - default: standard top navigation treatment
- * - mega: roomier top navigation with larger dropdown treatment
- */
-type HorizontalNavigationVariant = 'default' | 'mega';
-/**
- * Vertical Navigation Appearances
- * - default: 280px width, full labels & icons
- * - collapsible: alias variant that currently reuses the default layout
+ * Sidebar Appearance
+ * - default: full width (lebar penuh) dengan label + icon
+ * - thin: icon-only, expand overlay saat hover
  */
-type VerticalNavigationAppearance = 'default' | 'collapsible';
+type SidebarAppearance = 'default' | 'thin';
 /**
- * Vertical Navigation Modes
- * - over: Overlay mode (fixed position, z-index tinggi)
- * - side: Side mode (relative position, push content)
+ * Topbar Appearance
+ * - default: horizontal dengan dropdown untuk collapsable
+ * - megamenu: full-width panel multi-kolom untuk item `mega`
  */
-type VerticalNavigationMode = 'over' | 'side';
-/**
- * Vertical Navigation Position
- */
-type VerticalNavigationPosition = 'left' | 'right';
-
-interface NgNavigationConfig {
-    defaultHorizontalVariant: HorizontalNavigationVariant;
-    defaultVerticalVariant: VerticalNavigationAppearance;
-}
-
-declare function provideNgNavigation(config?: Partial<NgNavigationConfig>): EnvironmentProviders;
-
-declare class NavigationPreferencesService {
-    private readonly config;
-    private readonly document;
-    private readonly isBrowser;
-    private readonly storage;
-    private readonly _horizontalVariant;
-    private readonly _verticalAppearance;
-    private readonly _activeItemId;
-    private readonly _expandedItemIds;
-    readonly horizontalVariant: _angular_core.Signal<HorizontalNavigationVariant>;
-    readonly verticalAppearance: _angular_core.Signal<VerticalNavigationAppearance>;
-    readonly activeItemId: _angular_core.Signal<string | null>;
-    readonly expandedItemIds: _angular_core.Signal<string[]>;
-    setHorizontalVariant(value: HorizontalNavigationVariant): void;
-    setVerticalAppearance(value: VerticalNavigationAppearance): void;
-    setActiveItem(id: string | null): void;
-    clearActiveItem(): void;
-    setExpandedItemIds(ids: readonly string[]): void;
-    expandItem(id: string): void;
-    collapseItem(id: string): void;
-    toggleExpandedItem(id: string): void;
-    clearExpandedItems(): void;
-    reset(): void;
-    syncWithNavigation(navigation: readonly NavigationItem[]): void;
-    private readActiveItemId;
-    private readExpandedItemIds;
-    private readHorizontalVariant;
-    private readVerticalAppearance;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationPreferencesService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<NavigationPreferencesService>;
-}
-
-declare const DEFAULT_NG_NAVIGATION_CONFIG: NgNavigationConfig;
-declare const NG_NAVIGATION_CONFIG: InjectionToken<NgNavigationConfig>;
-
-declare function getNavigationItemAction(item: NavigationItem): NavigationActionHandler | undefined;
-declare function getNavigationItemVisibilityHandler(item: NavigationItem): NavigationVisibilityHandler | undefined;
-declare function isNavigationItemHidden(item: NavigationItem): boolean;
-declare function shouldRenderNavigationItem(item: NavigationItem): boolean;
-declare function hasNavigationChildren(item: NavigationItem): item is NavigationBranchItem;
-declare function getNavigationChildren(item: NavigationItem): NavigationItem[];
-declare function isNavigationRoutableItem(item: NavigationItem): item is NavigationItem & NavigationRoutableItemBase;
+type TopbarAppearance = 'default' | 'megamenu';
+/** Sidebar position */
+type SidebarPosition = 'left' | 'right';
+/** Sidebar display mode */
+type SidebarMode = 'over' | 'side';
+type VerticalNavigationAppearance = SidebarAppearance;
+type VerticalNavigationMode = SidebarMode;
+type VerticalNavigationPosition = SidebarPosition;
 
+/** Default registry key used when no id is specified. */
+declare const DEFAULT_NAVIGATION_ID = "main";
 /**
- * Navigation Service
+ * Signal-based global state untuk navigation (sidebar/topbar).
  *
- * Service ini bertanggung jawab untuk:
- * 1. Store dan retrieve navigation data
- * 2. Menyediakan state aktif dan expanded item
- * 3. Utility functions untuk navigation operations
+ * Items disimpan dalam registry ber-key. Key default adalah `'main'`.
+ * Komponen `ui-sidebar` / `ui-topbar` memilih registry via input `navigationId`.
  */
 declare class NavigationService {
-    private readonly preferences;
-    private _navigation;
-    readonly navigationItems: _angular_core.Signal<NavigationItem[]>;
-    readonly activeItemId: _angular_core.Signal<string | null>;
-    readonly flatNavigation: _angular_core.Signal<NavigationItem[]>;
-    readonly expandedItemIds: _angular_core.Signal<string[]>;
-    /**
-     * Store navigation data
-     * Biasanya dipanggil saat app initialization
-     */
-    storeNavigation(navigation: NavigationItem[]): void;
+    private readonly router;
+    private readonly destroyRef;
+    /** Internal version counter — incremented on every registry mutation. */
+    private readonly _version;
+    /** Internal map of registered navigation trees. */
+    private readonly _registry;
     /**
-     * Get navigation data dari storage
+     * Backward-compatible accessor — returns items for the default (`'main'`) key.
+     * Prefer `getItems(id)` when working with named registries.
      */
-    getNavigation(): NavigationItem[];
+    readonly items: _angular_core.Signal<readonly NavigationItem[]>;
+    /** Sidebar collapsed (default ↔ thin) toggle untuk desktop. */
+    readonly collapsed: _angular_core.WritableSignal<boolean>;
+    /** Sheet drawer terbuka di mobile. */
+    readonly mobileOpen: _angular_core.WritableSignal<boolean>;
+    /** Set id grup / collapsable yang sedang terbuka. */
+    readonly openGroups: _angular_core.WritableSignal<ReadonlySet<string>>;
+    /** URL aktif terakhir. Update otomatis dari Router `NavigationEnd`. */
+    readonly activeUrl: _angular_core.WritableSignal<string>;
+    /** Trail id item yang sedang match dengan URL aktif (across ALL registries). */
+    readonly activeTrail: _angular_core.Signal<ReadonlySet<string>>;
+    constructor();
     /**
-     * Delete navigation data dari storage
+     * Register items di registry.
+     *
+     * Overload:
+     * - `registerItems(items)` → key `'main'`
+     * - `registerItems(id, items)` → key spesifik
      */
-    deleteNavigation(): void;
-    setActiveItem(id: string | null): void;
-    clearActiveItem(): void;
-    getActiveItem(navigation?: NavigationItem[]): NavigationItem | null;
-    expandItem(id: string): void;
-    collapseItem(id: string): void;
-    toggleItemExpanded(id: string): void;
-    isItemExpanded(id: string): boolean;
-    clearExpandedItems(): void;
+    registerItems(items: NavigationItem[]): void;
+    registerItems(id: string, items: NavigationItem[]): void;
+    /** Remove a named registry entry. */
+    removeItems(id: string): void;
     /**
-     * Flatten navigation array
-     * Convert nested structure menjadi flat array (hanya basic items)
-     * Berguna untuk search, analytics, atau operations lainnya
+     * Computed yang mengembalikan items untuk key tertentu.
+     * Reactive terhadap perubahan registry.
      */
-    getFlatNavigation(navigation: NavigationItem[], flatNavigation?: NavigationItem[]): NavigationItem[];
-    /**
-     * Get item by ID dari navigation tree
-     * Recursive search untuk find item dengan id tertentu
-     */
-    getItem(id: string, navigation: NavigationItem[]): NavigationItem | null;
-    /**
-     * Get parent dari item dengan id tertentu
-     * Berguna untuk breadcrumb atau navigation path
-     */
-    getItemParent(id: string, navigation: NavigationItem[], parent: NavigationItem[] | NavigationItem): NavigationItem[] | NavigationItem | null;
+    getItems(id: string): () => readonly NavigationItem[];
+    /** Toggle sidebar collapsed (default ↔ thin). */
+    toggleCollapsed(): void;
+    setCollapsed(value: boolean): void;
+    openMobile(): void;
+    closeMobile(): void;
+    toggleMobile(): void;
+    isGroupOpen(id: string): boolean;
+    toggleGroup(id: string): void;
+    setGroupOpen(id: string, open: boolean): void;
+    /** Apakah id termasuk dalam active trail saat ini. */
+    isActive(id: string | undefined): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<NavigationService>;
 }
 
-export { DEFAULT_NG_NAVIGATION_CONFIG, NG_NAVIGATION_CONFIG, NavigationPreferencesService, NavigationService, getNavigationChildren, getNavigationItemAction, getNavigationItemVisibilityHandler, hasNavigationChildren, isNavigationItemHidden, isNavigationRoutableItem, provideNgNavigation, shouldRenderNavigationItem };
-export type { HorizontalNavigationVariant, NavigationActionHandler, NavigationAsideItem, NavigationBasicItem, NavigationBranchItem, NavigationCollapsableItem, NavigationDividerItem, NavigationGroupItem, NavigationItem, NavigationItemBadge, NavigationItemBase, NavigationItemClasses, NavigationItemType, NavigationLeafItem, NavigationRoutableItemBase, NavigationSpacerItem, NavigationStructuredItem, NavigationVisibilityHandler, NgNavigationConfig, VerticalNavigationAppearance, VerticalNavigationMode, VerticalNavigationPosition };
+/**
+ * Material Symbols icon renderer.
+ * Menyuntikkan stylesheet font sekali saat dipakai agar consumer tidak perlu
+ * menambahkan `<link>` manual di `index.html`.
+ */
+declare class UiNavIconComponent {
+    private readonly doc;
+    private readonly platformId;
+    readonly name: _angular_core.InputSignal<string>;
+    readonly class: _angular_core.InputSignal<string>;
+    readonly size: _angular_core.InputSignal<number | null>;
+    protected readonly fontVariationSettings = "\"FILL\" 0, \"wght\" 400, \"GRAD\" 0, \"opsz\" 24";
+    constructor();
+    protected readonly classes: _angular_core.Signal<string>;
+    private ensureFontStylesheet;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<UiNavIconComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<UiNavIconComponent, "ui-nav-icon", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/** Concatenate and dedupe Tailwind class names. */
+declare function cn(...inputs: ClassValue[]): string;
+
+/**
+ * Recursive navigation item renderer (vertical context).
+ *
+ * Menerima item polymorphic dan delegasi ke template sesuai `type`.
+ * Mega dirender sebagai group biasa saat muncul di konteks vertical.
+ */
+declare class UiNavItemComponent {
+    private readonly nav;
+    protected readonly cn: typeof cn;
+    readonly item: _angular_core.InputSignal<NavigationItem>;
+    readonly level: _angular_core.InputSignal<number>;
+    /** Compact / icon-only rendering (sidebar `thin`). */
+    readonly compact: _angular_core.InputSignal<boolean>;
+    protected readonly exactMatch: {
+        readonly exact: true;
+        readonly paths: "exact";
+        readonly queryParams: "exact";
+        readonly fragment: "exact";
+        readonly matrixParams: "exact";
+    };
+    protected readonly inexactMatch: {
+        readonly paths: "subset";
+        readonly queryParams: "subset";
+        readonly fragment: "ignored";
+        readonly matrixParams: "ignored";
+    };
+    protected readonly type: _angular_core.Signal<"aside" | "basic" | "collapsable" | "divider" | "group" | "mega" | "spacer">;
+    protected readonly groupItem: _angular_core.Signal<NavigationGroupItem>;
+    protected readonly collapsableItem: _angular_core.Signal<NavigationCollapsableItem>;
+    protected readonly megaItem: _angular_core.Signal<NavigationMegaItem>;
+    protected readonly asideItem: _angular_core.Signal<NavigationAsideItem>;
+    protected readonly basicItem: _angular_core.Signal<NavigationBasicItem>;
+    protected readonly headingId: _angular_core.Signal<string>;
+    protected isGroupOpen(): boolean;
+    protected isTrailActive(): boolean;
+    protected toggleGroup(): void;
+    protected runAction(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<UiNavItemComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<UiNavItemComponent, "ui-nav-item", never, { "item": { "alias": "item"; "required": true; "isSignal": true; }; "level": { "alias": "level"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Vertical navigation (sidebar) — shadcn-styled.
+ *
+ * Variants:
+ * - `default`: 17.5rem, label + icon
+ * - `thin`: 4rem icon-only; hover memunculkan overlay expand (tidak push konten)
+ *
+ * Mobile (`< md`): saat `autoMobile=true` (default), host desktop disembunyikan
+ * dan konten dirender lewat CDK Overlay drawer dengan focus trap. State buka
+ * dikontrol lewat `NavigationService.mobileOpen`.
+ */
+declare class SidebarComponent {
+    private readonly nav;
+    private readonly bp;
+    private readonly overlay;
+    private readonly vcr;
+    private readonly focusTrapFactory;
+    private readonly doc;
+    private readonly destroyRef;
+    readonly items: _angular_core.InputSignal<NavigationItem[]>;
+    /** Registry key di `NavigationService`. Default `'main'`. */
+    readonly navigationId: _angular_core.InputSignal<string>;
+    readonly appearance: _angular_core.InputSignal<SidebarAppearance>;
+    readonly position: _angular_core.InputSignal<SidebarPosition>;
+    readonly ariaLabel: _angular_core.InputSignal<string>;
+    readonly header: _angular_core.InputSignal<boolean>;
+    readonly class: _angular_core.InputSignal<string>;
+    /** Auto switch ke CDK overlay drawer saat viewport `< md`. */
+    readonly autoMobile: _angular_core.InputSignal<boolean>;
+    /** Auto-register `items` ke `NavigationService` agar `activeTrail` bekerja. */
+    readonly autoRegister: _angular_core.InputSignal<boolean>;
+    /** Resolved items: input jika disediakan, fallback ke registry NavigationService. */
+    protected readonly resolvedItems: _angular_core.Signal<readonly NavigationItem[]>;
+    private readonly hovered;
+    private readonly drawerTpl;
+    private drawerRef;
+    private focusTrap;
+    private previouslyFocused;
+    /** True saat viewport `< md` (767.98px). */
+    protected readonly isMobileMedia: _angular_core.Signal<boolean>;
+    protected readonly isMobile: _angular_core.Signal<boolean>;
+    protected readonly isExpanded: _angular_core.Signal<boolean>;
+    protected readonly isCompact: _angular_core.Signal<boolean>;
+    constructor();
+    protected readonly hostClasses: _angular_core.Signal<string>;
+    protected readonly innerClasses: _angular_core.Signal<string>;
+    protected onHoverEnter(): void;
+    protected onHoverLeave(): void;
+    /** Touch fallback: tap pada strip thin (ketika belum expanded) untuk expand. */
+    protected onHostClick(event: MouseEvent): void;
+    private openDrawer;
+    private closeDrawer;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidebarComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidebarComponent, "ui-sidebar", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "navigationId": { "alias": "navigationId"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "header": { "alias": "header"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; "autoMobile": { "alias": "autoMobile"; "required": false; "isSignal": true; }; "autoRegister": { "alias": "autoRegister"; "required": false; "isSignal": true; }; }, {}, never, ["[ui-sidebar-header]", "[ui-sidebar-footer]"], true, never>;
+}
+
+/**
+ * Horizontal navigation (topbar) — shadcn-styled.
+ *
+ * Variants:
+ * - `default`: horizontal list; item `collapsable` buka dropdown
+ * - `megamenu`: item `mega` buka panel full-width multi-kolom
+ */
+declare class TopbarComponent {
+    protected readonly nav: NavigationService;
+    private readonly overlay;
+    private readonly vcr;
+    private readonly host;
+    private readonly destroyRef;
+    readonly items: _angular_core.InputSignal<NavigationItem[]>;
+    /** Registry key di `NavigationService`. Default `'main'`. */
+    readonly navigationId: _angular_core.InputSignal<string>;
+    readonly appearance: _angular_core.InputSignal<TopbarAppearance>;
+    readonly ariaLabel: _angular_core.InputSignal<string>;
+    readonly class: _angular_core.InputSignal<string>;
+    /** Auto-register `items` ke `NavigationService` agar `activeTrail` bekerja. */
+    readonly autoRegister: _angular_core.InputSignal<boolean>;
+    /** Tampilkan hamburger di `< md` yang men-toggle mobile drawer sidebar. */
+    readonly showHamburger: _angular_core.InputSignal<boolean>;
+    readonly hamburgerLabel: _angular_core.InputSignal<string>;
+    /** Resolved items: input jika disediakan, fallback ke registry NavigationService. */
+    protected readonly resolvedItems: _angular_core.Signal<readonly NavigationItem[]>;
+    protected readonly openId: _angular_core.WritableSignal<string | null>;
+    private active;
+    private readonly dropdownTpl;
+    private readonly megaTpl;
+    constructor();
+    protected readonly hostClasses: _angular_core.Signal<string>;
+    protected asBasic(i: NavigationItem): NavigationBasicItem;
+    protected asCollapsable(i: NavigationItem): NavigationCollapsableItem;
+    protected asGroup(i: NavigationItem): NavigationGroupItem;
+    protected asMega(i: NavigationItem): NavigationMegaItem;
+    protected isItemActive(id: string | undefined): boolean;
+    protected megaColsClass(columns?: number): string;
+    protected toggleDropdown(trigger: HTMLElement, item: NavigationItem): void;
+    protected openDropdown(trigger: HTMLElement, item: NavigationItem): void;
+    protected toggleMega(trigger: HTMLElement, item: NavigationItem): void;
+    protected openMega(trigger: HTMLElement, item: NavigationItem): void;
+    private attach;
+    protected closeAll(): void;
+    /** Menubar keyboard navigation: ArrowLeft/Right antar trigger, Home/End, ArrowDown fokus panel. */
+    protected onMenubarKeydown(event: KeyboardEvent): void;
+    /** Arrow-key navigation dalam dropdown/mega panel. */
+    protected onPanelKeydown(event: KeyboardEvent): void;
+    private collectPanelFocusables;
+    private focusFirstInPanel;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TopbarComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TopbarComponent, "ui-topbar", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "navigationId": { "alias": "navigationId"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; "autoRegister": { "alias": "autoRegister"; "required": false; "isSignal": true; }; "showHamburger": { "alias": "showHamburger"; "required": false; "isSignal": true; }; "hamburgerLabel": { "alias": "hamburgerLabel"; "required": false; "isSignal": true; }; }, {}, never, ["[ui-topbar-start]", "[ui-topbar-end]"], true, never>;
+}
+
+declare const DemoNavigationData: NavigationItem[];
+
+declare const NAVIGATION_VERSION = "0.0.1";
+
+export { DEFAULT_NAVIGATION_ID, DemoNavigationData, NAVIGATION_VERSION, NavigationService, SidebarComponent, TopbarComponent, UiNavIconComponent, UiNavItemComponent };
+export type { NavigationActionHandler, NavigationAsideItem, NavigationBasicItem, NavigationBranchItem, NavigationCollapsableItem, NavigationDividerItem, NavigationGroupItem, NavigationItem, NavigationItemBadge, NavigationItemBase, NavigationItemClasses, NavigationItemType, NavigationLeafItem, NavigationMegaItem, NavigationRoutableItemBase, NavigationSpacerItem, NavigationStructuredItem, NavigationVisibilityHandler, SidebarAppearance, SidebarMode, SidebarPosition, TopbarAppearance, VerticalNavigationAppearance, VerticalNavigationMode, VerticalNavigationPosition };

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

@@ -1,2 +1,171 @@
+import * as _angular_core from '@angular/core';
+import { InjectionToken, Provider, EnvironmentProviders } from '@angular/core';
 
-export { };
+declare const MODES: readonly ["light", "dark"];
+type ThemeMode = (typeof MODES)[number];
+declare const COLOR_SCHEMES: readonly ["light", "dark", "system"];
+type ColorScheme = (typeof COLOR_SCHEMES)[number];
+declare const COLORS: readonly ["blue", "red", "green", "purple", "amber"];
+type ThemeColor = (typeof COLORS)[number];
+declare const STYLES: readonly ["default", "sharp", "brutal", "soft"];
+type ThemeStyle = (typeof STYLES)[number];
+declare const BRANDS: readonly ["etos"];
+type ThemeBrand = (typeof BRANDS)[number];
+interface ThemeConfig {
+    readonly mode: ThemeMode;
+    readonly brand: ThemeBrand | null;
+    readonly color: ThemeColor;
+    readonly style: ThemeStyle;
+}
+interface MaterialThemeConfig {
+    /** Initial mode preference. Supports `system` for first-visit OS detection. */
+    readonly mode?: ColorScheme;
+    /** Initial brand bundle. When set, it replaces the explicit color and style layers. */
+    readonly brand?: ThemeBrand | null;
+    /** Alias for `brand` to match the persisted `theme-brand` setting. */
+    readonly 'theme-brand'?: ThemeBrand | null;
+    /** Initial brand color layer. */
+    readonly color?: ThemeColor;
+    /** Initial style personality layer. */
+    readonly style?: ThemeStyle;
+    /** @deprecated Use `mode` instead. */
+    readonly defaultMode?: ColorScheme;
+    /** Default brand bundle. When set, it replaces the explicit color and style layers. */
+    readonly defaultBrand?: ThemeBrand | null;
+    /** @deprecated Use `color` instead. */
+    readonly defaultColor?: ThemeColor;
+    /** @deprecated Use `style` instead. */
+    readonly defaultStyle?: ThemeStyle;
+    /** @deprecated Use `defaultMode` instead. */
+    readonly defaultScheme?: ColorScheme;
+    /** @deprecated Use `defaultColor` instead. */
+    readonly defaultTheme?: ThemeColor | string;
+    /** @deprecated Use `modeStorageKey` instead. */
+    readonly storageKey?: string | null;
+    /** @deprecated Use `modeStorageKey` instead. */
+    readonly schemeStorageKey?: string | null;
+    /** @deprecated Use `colorStorageKey` instead. */
+    readonly themeStorageKey?: string | null;
+    /** localStorage key used to persist the mode preference. Set to `null` to disable persistence. */
+    readonly modeStorageKey?: string | null;
+    /** localStorage key used to persist the brand bundle. Set to `null` to disable persistence. */
+    readonly brandStorageKey?: string | null;
+    /** localStorage key used to persist the color layer. Set to `null` to disable persistence. */
+    readonly colorStorageKey?: string | null;
+    /** localStorage key used to persist the style layer. Set to `null` to disable persistence. */
+    readonly styleStorageKey?: string | null;
+}
+interface ResolvedMaterialThemeConfig {
+    readonly defaultMode: ColorScheme;
+    readonly defaultBrand: ThemeBrand | null;
+    readonly defaultColor: ThemeColor;
+    readonly defaultStyle: ThemeStyle;
+    readonly modeStorageKey: string | null;
+    readonly brandStorageKey: string | null;
+    readonly colorStorageKey: string | null;
+    readonly styleStorageKey: string | null;
+}
+declare const MATERIAL_THEME_CONFIG: InjectionToken<MaterialThemeConfig>;
+declare const DEFAULT_MATERIAL_THEME_CONFIG: ResolvedMaterialThemeConfig;
+declare function isColorScheme(value: string | null | undefined): value is ColorScheme;
+declare function isThemeColor(value: string | null | undefined): value is ThemeColor;
+declare function isThemeStyle(value: string | null | undefined): value is ThemeStyle;
+declare function isThemeBrand(value: string | null | undefined): value is ThemeBrand;
+
+declare class ThemeService {
+    private readonly document;
+    private readonly destroyRef;
+    private readonly config;
+    private readonly initialBrand;
+    private readonly _modePreference;
+    private readonly _brand;
+    private readonly _color;
+    private readonly _style;
+    private readonly _systemPrefersDark;
+    readonly scheme: _angular_core.Signal<"light" | "dark" | "system">;
+    readonly brand: _angular_core.Signal<"etos" | null>;
+    readonly color: _angular_core.Signal<"blue" | "red" | "green" | "purple" | "amber">;
+    readonly theme: _angular_core.Signal<"blue" | "red" | "green" | "purple" | "amber">;
+    readonly style: _angular_core.Signal<"default" | "sharp" | "brutal" | "soft">;
+    readonly mode: _angular_core.Signal<"light" | "dark">;
+    readonly snapshot: _angular_core.Signal<ThemeConfig>;
+    readonly isDark: _angular_core.Signal<boolean>;
+    constructor();
+    setMode(mode: ThemeMode): void;
+    setScheme(scheme: ColorScheme): void;
+    setBrand(brand: ThemeBrand | null): void;
+    setColor(color: ThemeColor): void;
+    setTheme(theme: ThemeColor | string): void;
+    setStyle(style: ThemeStyle): void;
+    setAll(config: Partial<ThemeConfig> & {
+        readonly scheme?: ColorScheme;
+    }): void;
+    toggleScheme(): void;
+    toggleMode(): void;
+    reset(): void;
+    private resolveConfig;
+    private resolveMode;
+    private prefersDark;
+    private watchSystemScheme;
+    private readPersistedMode;
+    private readPersistedBrand;
+    private readPersistedColor;
+    private readPersistedStyle;
+    private persistMode;
+    private persistBrand;
+    private persistColor;
+    private persistStyle;
+    private clearPersistedBrand;
+    private clearPersistedColor;
+    private clearPersistedStyle;
+    private clearPersistedItem;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ThemeService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ThemeService>;
+}
+
+/**
+ * Opaque feature unit consumed by {@link provideMaterialTheme}. Mirrors
+ * Angular's router/http feature pattern so add-ons can be composed without
+ * widening the primary provider signature.
+ */
+interface MaterialThemeFeature {
+    readonly providers: Provider[];
+}
+/**
+ * Bootstrap the shared theme for any `@ojiepermana/angular/*` entry point.
+ *
+ * By default wires up the theme config token and eagerly initializes `ThemeService`
+ * so root theme attributes are applied during bootstrap. Opt in
+ * to Angular Material defaults (ripple / form-field) via
+ * {@link withMaterialDefaults}.
+ * Supports shorthand `mode`, `color`, and `style` config keys.
+ *
+ * @example
+ * export const appConfig: ApplicationConfig = {
+ *   providers: [
+ *     provideAnimations(),
+ *     provideMaterialTheme(
+ *       {
+ *         mode: 'system',
+ *         color: 'blue',
+ *         style: 'soft',
+ *       },
+ *       withMaterialDefaults(),
+ *     ),
+ *   ],
+ * };
+ */
+declare function provideMaterialTheme(config?: MaterialThemeConfig, ...features: MaterialThemeFeature[]): EnvironmentProviders;
+/**
+ * Opt-in Angular Material defaults tuned for the shared theme layer:
+ *
+ * - Disables the global Material ripple.
+ * - Forces `appearance: 'outline'` + `subscriptSizing: 'dynamic'` on every
+ *   `mat-form-field`.
+ *
+ * Only apply when your app actually renders Angular Material components.
+ */
+declare function withMaterialDefaults(): MaterialThemeFeature;
+
+export { BRANDS, COLORS, COLOR_SCHEMES, DEFAULT_MATERIAL_THEME_CONFIG, MATERIAL_THEME_CONFIG, MODES, STYLES, ThemeService, isColorScheme, isThemeBrand, isThemeColor, isThemeStyle, provideMaterialTheme, withMaterialDefaults };
+export type { ColorScheme, MaterialThemeConfig, MaterialThemeFeature, ResolvedMaterialThemeConfig, ThemeBrand, ThemeColor, ThemeConfig, ThemeMode, ThemeStyle };

package/types/ojiepermana-angular.d.ts

@@ -1,2 +1,3 @@
+declare const MATERIAL_VERSION = "0.0.1";
 
-export { };
+export { MATERIAL_VERSION };