@ojiepermana/angular-component 22.0.44 → 22.0.46

package/types/ojiepermana-angular-component-icon.d.ts

@@ -1,4 +1,5 @@
 import * as _angular_core from '@angular/core';
+import { InjectionToken, EnvironmentProviders } from '@angular/core';
 
 declare class IconComponent {
     private readonly materialSymbols;
@@ -20,12 +21,58 @@ declare class IconComponent {
 declare const MATERIAL_SYMBOLS_FONT_ATTR = "data-icon-font";
 declare const MATERIAL_SYMBOLS_FONT_ID = "material-symbols-outlined";
 declare const MATERIAL_SYMBOLS_FONT_HREF = "https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@24,400,0,0";
+/** Configuration for {@link provideMaterialSymbols}. */
+interface MaterialSymbolsConfig {
+    /**
+     * Stylesheet URL to load the Material Symbols font from. Defaults to the
+     * Google Fonts URL ({@link MATERIAL_SYMBOLS_FONT_HREF}). Point this at a
+     * self-hosted stylesheet for offline / CSP / privacy-safe setups.
+     */
+    readonly href?: string;
+}
+/**
+ * Presence of this token is what enables {@link IconComponent} to auto-load the
+ * font. It is only provided when the app opts in via `provideMaterialSymbols()`;
+ * without it, `<Icon>` makes no network request.
+ */
+declare const MATERIAL_SYMBOLS_CONFIG: InjectionToken<MaterialSymbolsConfig>;
 declare class MaterialSymbolsService {
     private readonly documentRef;
     private readonly platformId;
+    private readonly config;
+    /**
+     * Token-gated load. No-op unless the app opted in via `provideMaterialSymbols()`
+     * (which provides {@link MATERIAL_SYMBOLS_CONFIG}). Called by `IconComponent`
+     * so rendering an icon never triggers an implicit network request on its own.
+     */
     ensureLoaded(): void;
+    /**
+     * Explicitly inject the font stylesheet, regardless of whether the config
+     * token is present. Used by integrations that decide to load the font from
+     * their own option surface (e.g. `provideUiTheme({ icons: { materialSymbols: true } })`).
+     */
+    load(config?: MaterialSymbolsConfig): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MaterialSymbolsService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<MaterialSymbolsService>;
 }
 
-export { IconComponent, MATERIAL_SYMBOLS_FONT_ATTR, MATERIAL_SYMBOLS_FONT_HREF, MATERIAL_SYMBOLS_FONT_ID, MaterialSymbolsService };
+/**
+ * Opt in to loading the Material Symbols icon font that `<Icon>` renders with.
+ *
+ * By default `IconComponent` makes **no** network request — better for privacy,
+ * offline, and strict CSP. Add this provider to your bootstrap to fetch the font
+ * stylesheet once at startup. Pass `{ href }` to load from a self-hosted source
+ * instead of Google Fonts.
+ *
+ * @example
+ * // Google Fonts (default source):
+ * bootstrapApplication(App, { providers: [provideMaterialSymbols()] });
+ *
+ * @example
+ * // Self-hosted / offline:
+ * provideMaterialSymbols({ href: '/assets/material-symbols.css' });
+ */
+declare function provideMaterialSymbols(config?: MaterialSymbolsConfig): EnvironmentProviders;
+
+export { IconComponent, MATERIAL_SYMBOLS_CONFIG, MATERIAL_SYMBOLS_FONT_ATTR, MATERIAL_SYMBOLS_FONT_HREF, MATERIAL_SYMBOLS_FONT_ID, MaterialSymbolsService, provideMaterialSymbols };
+export type { MaterialSymbolsConfig };

package/types/ojiepermana-angular-component-radio.d.ts

@@ -41,6 +41,9 @@ declare class RadioComponent {
     readonly value: _angular_core.InputSignal<string>;
     readonly disabled: _angular_core.InputSignal<boolean>;
     readonly class: _angular_core.InputSignal<string>;
+    /** Accessible name for the radio input when no text is projected into `<Radio>`. */
+    readonly ariaLabel: _angular_core.InputSignal<string | null>;
+    readonly ariaLabelledby: _angular_core.InputSignal<string | null>;
     protected readonly selected: _angular_core.Signal<boolean>;
     protected readonly isDisabled: _angular_core.Signal<boolean>;
     protected readonly hostClasses: _angular_core.Signal<string>;
@@ -51,7 +54,7 @@ declare class RadioComponent {
     protected handleBlur(): void;
     focus(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RadioComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioComponent, "Radio", never, { "value": { "alias": "value"; "required": true; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioComponent, "Radio", never, { "value": { "alias": "value"; "required": true; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "ariaLabelledby": { "alias": "aria-labelledby"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
 export { RadioComponent, RadioGroupComponent };

package/types/ojiepermana-angular-component-sheet.d.ts

@@ -25,10 +25,18 @@ declare class SheetComponent {
     readonly closeButtonLabel: _angular_core.InputSignal<string>;
     readonly labelledBy: _angular_core.InputSignal<string | null>;
     readonly describedBy: _angular_core.InputSignal<string | null>;
+    /** ARIA role for the surface. Defaults to `'dialog'`. */
+    readonly role: _angular_core.InputSignal<string>;
     readonly class: _angular_core.InputSignal<string>;
     readonly radius: _angular_core.InputSignal<"inherit" | "none" | "sm" | "md" | "lg" | "xl" | "full">;
     readonly density: _angular_core.InputSignal<"inherit" | "compact" | "normal" | "relaxed" | "spacious">;
     readonly openedChange: _angular_core.OutputEmitterRef<boolean>;
+    private readonly registeredTitleId;
+    private readonly registeredDescriptionId;
+    /** Explicit `aria-labelledby` wins; otherwise a projected `SheetTitle` supplies the id. */
+    protected readonly resolvedLabelledBy: _angular_core.Signal<string | null>;
+    /** Explicit `aria-describedby` wins; otherwise a projected `SheetDescription` supplies the id. */
+    protected readonly resolvedDescribedBy: _angular_core.Signal<string | null>;
     private readonly tpl;
     private overlayRef;
     private focusTrap;
@@ -42,9 +50,17 @@ declare class SheetComponent {
     private attach;
     private detach;
     close(): void;
+    /** Called by a projected `SheetTitle` so default usage has an accessible name (AXE-safe). */
+    registerTitleId(id: string | null): void;
+    /** Cleared by a `SheetTitle` on destroy so a closed/reopened sheet never points at a stale id. */
+    unregisterTitleId(id: string): void;
+    /** Called by a projected `SheetDescription`. */
+    registerDescriptionId(id: string | null): void;
+    /** Cleared by a `SheetDescription` on destroy. */
+    unregisterDescriptionId(id: string): void;
     private isDrawerHost;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SheetComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SheetComponent, "Sheet, Drawer", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "side": { "alias": "side"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; "isSignal": true; }; "closeOnBackdropClick": { "alias": "closeOnBackdropClick"; "required": false; "isSignal": true; }; "showCloseButton": { "alias": "showCloseButton"; "required": false; "isSignal": true; }; "closeButtonLabel": { "alias": "closeButtonLabel"; "required": false; "isSignal": true; }; "labelledBy": { "alias": "aria-labelledby"; "required": false; "isSignal": true; }; "describedBy": { "alias": "aria-describedby"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; "radius": { "alias": "radius"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "openedChange": "openedChange"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SheetComponent, "Sheet, Drawer", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "side": { "alias": "side"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; "isSignal": true; }; "closeOnBackdropClick": { "alias": "closeOnBackdropClick"; "required": false; "isSignal": true; }; "showCloseButton": { "alias": "showCloseButton"; "required": false; "isSignal": true; }; "closeButtonLabel": { "alias": "closeButtonLabel"; "required": false; "isSignal": true; }; "labelledBy": { "alias": "aria-labelledby"; "required": false; "isSignal": true; }; "describedBy": { "alias": "aria-describedby"; "required": false; "isSignal": true; }; "role": { "alias": "role"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; "radius": { "alias": "radius"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "openedChange": "openedChange"; }, never, ["*"], true, never>;
 }
 
 declare class SheetHeaderComponent {
@@ -54,16 +70,30 @@ declare class SheetHeaderComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SheetHeaderComponent, "SheetHeader, DrawerHeader", never, { "class": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 declare class SheetTitleComponent {
+    /** Explicit id override; when omitted a document-unique id is generated. */
+    readonly id: _angular_core.InputSignal<string | null>;
     readonly class: _angular_core.InputSignal<string>;
+    private readonly autoId;
+    private readonly sheet;
+    /** The id rendered on the element, used by the parent sheet for aria-labelledby. */
+    readonly resolvedId: _angular_core.Signal<string>;
     protected readonly classes: _angular_core.Signal<string>;
+    constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SheetTitleComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SheetTitleComponent, "SheetTitle, DrawerTitle, h2[SheetTitle], h2[DrawerTitle]", never, { "class": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SheetTitleComponent, "SheetTitle, DrawerTitle, h2[SheetTitle], h2[DrawerTitle]", never, { "id": { "alias": "id"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 declare class SheetDescriptionComponent {
+    /** Explicit id override; when omitted a document-unique id is generated. */
+    readonly id: _angular_core.InputSignal<string | null>;
     readonly class: _angular_core.InputSignal<string>;
+    private readonly autoId;
+    private readonly sheet;
+    /** The id rendered on the element, used by the parent sheet for aria-describedby. */
+    readonly resolvedId: _angular_core.Signal<string>;
     protected readonly classes: _angular_core.Signal<string>;
+    constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SheetDescriptionComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SheetDescriptionComponent, "SheetDescription, DrawerDescription, p[SheetDescription], p[DrawerDescription]", never, { "class": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SheetDescriptionComponent, "SheetDescription, DrawerDescription, p[SheetDescription], p[DrawerDescription]", never, { "id": { "alias": "id"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 declare class SheetContentComponent {
     readonly class: _angular_core.InputSignal<string>;

package/types/ojiepermana-angular-component-timeline.d.ts

@@ -32,11 +32,12 @@ declare class TimelineIndicatorComponent {
     readonly variant: _angular_core.InputSignal<TimelineIndicatorVariant>;
     readonly status: _angular_core.InputSignal<TimelineStatus | null>;
     readonly color: _angular_core.InputSignal<TimelineIndicatorColor | null>;
+    readonly ariaLabel: _angular_core.InputSignal<string | null>;
     readonly class: _angular_core.InputSignal<string>;
     protected readonly resolvedStatus: _angular_core.Signal<TimelineStatus>;
     protected readonly classes: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TimelineIndicatorComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimelineIndicatorComponent, "TimelineIndicator", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimelineIndicatorComponent, "TimelineIndicator", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 declare class TimelineContentComponent {
     private readonly item;