@ojiepermana/angular 0.1.1 → 21.0.2

package/types/ojiepermana-angular-generator-api.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Public config shape for the SDK generator.
+ *
+ * Users place an `sdk.config.json` at the workspace root describing one or more
+ * generation targets. All paths are resolved relative to the workspace root
+ * (i.e. the directory containing the config file).
+ */
+type SdkOutputMode = 'standalone' | 'library' | 'secondary-entrypoint';
+interface SdkFeatureFlags {
+    /** Emit `models/*.ts` (type-only DTO interfaces). Default `true`. */
+    models?: boolean;
+    /** Emit tree-shakeable operation functions in `fn/<tag>/*.ts`. Default `true`. */
+    operations?: boolean;
+    /** Emit grouped Injectable service classes per tag. Default `true`. */
+    services?: boolean;
+    /** Emit the runtime client primitives (ApiConfiguration, BaseService, etc). Default `true`. */
+    client?: boolean;
+    /** Emit operation rules + field validators + permission helpers. Default `true`. */
+    metadata?: boolean;
+    /** Emit navigation tree derived from tags (parent, x-icon). Default `false`. */
+    navigation?: boolean;
+}
+interface SdkTargetConfig {
+    /** Path to OpenAPI 3.x spec (YAML or JSON). Required. */
+    input: string;
+    /** Output directory (relative to workspace root). Required. */
+    output: string;
+    /** Output mode. Defaults to `"standalone"`. */
+    mode?: SdkOutputMode;
+    /** Optional human-readable name used for logs & the generated `Api` class. */
+    clientName?: string;
+    /** Package name used when `mode === "library"`. */
+    packageName?: string;
+    /** Package version used when `mode === "library"`. Defaults to `0.0.1`. */
+    packageVersion?: string;
+    /** Default rootUrl baked into ApiConfiguration. Defaults to the first server in the spec. */
+    rootUrl?: string;
+    /** Feature toggles. Every feature defaults to `true` except `navigation` (default `true` too). */
+    features?: SdkFeatureFlags;
+    /**
+     * When `true`, reorganize emitted files into one folder per domain (derived
+     * from OpenAPI tags). Models shared by multiple domains live in `shared/`,
+     * domain-owned models live inside each domain. Default `false` (flat layout).
+     */
+    splitByDomain?: boolean;
+    /**
+     * Granularity of `splitByDomain`. Only meaningful when `splitByDomain` is
+     * `true`. `'service'` (default) groups every tag under its root parent — one
+     * folder per backend service (e.g. all Role/Permission/... tags collapse into
+     * `access/`). `'tag'` emits one folder per leaf tag, nested under the parent
+     * chain (e.g. `storage/gcs/`, `storage/s3/`, `access/role/`).
+     */
+    splitDepth?: 'service' | 'tag';
+    /** Custom file banner. Defaults to a short auto-generated notice. */
+    banner?: string;
+}
+interface SdkConfig {
+    targets: SdkTargetConfig[];
+}
+interface ResolvedFeatureFlags {
+    models: boolean;
+    operations: boolean;
+    services: boolean;
+    client: boolean;
+    metadata: boolean;
+    navigation: boolean;
+}
+interface ResolvedSdkTarget {
+    input: string;
+    output: string;
+    mode: SdkOutputMode;
+    clientName: string;
+    packageName: string;
+    packageVersion: string;
+    rootUrl: string | undefined;
+    features: ResolvedFeatureFlags;
+    splitByDomain: boolean;
+    splitDepth: 'service' | 'tag';
+    banner: string;
+}
+declare function resolveTarget(raw: SdkTargetConfig): ResolvedSdkTarget;
+declare function resolveConfig(raw: unknown): ResolvedSdkTarget[];
+
+export { resolveConfig, resolveTarget };
+export type { ResolvedFeatureFlags, ResolvedSdkTarget, SdkConfig, SdkFeatureFlags, SdkOutputMode, SdkTargetConfig };

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

@@ -1,90 +1,139 @@
-import * as i0 from '@angular/core';
-import { EnvironmentProviders, InjectionToken } from '@angular/core';
+import * as _angular_core from '@angular/core';
+import { InjectionToken, EnvironmentProviders } from '@angular/core';
+import { SidebarAppearance, SidebarPosition, SidebarMode, TopbarAppearance } from '@ojiepermana/angular/navigation';
 
-declare const LAYOUT_MODES: readonly ["vertical", "horizontal", "empty"];
-type LayoutMode = (typeof LAYOUT_MODES)[number];
-declare const LAYOUT_CONTAINERS: readonly ["full", "boxed"];
-type LayoutContainer = (typeof LAYOUT_CONTAINERS)[number];
-interface NgLayoutConfig {
-    defaultMode: LayoutMode;
-    defaultContainer: LayoutContainer;
-}
-
-declare class LayoutService {
-    private readonly config;
-    private readonly document;
-    private readonly isBrowser;
-    private readonly storage;
-    readonly mode: i0.WritableSignal<"vertical" | "horizontal" | "empty">;
-    readonly container: i0.WritableSignal<"full" | "boxed">;
-    constructor();
-    /**
-     * Updates the active shell mode and persists the value for future sessions.
-     */
-    setMode(value: LayoutMode): void;
-    /**
-     * Updates the active container width mode and persists the value for future sessions.
-     */
-    setContainer(value: LayoutContainer): void;
-    /**
-     * Clears persisted layout state and restores the configured defaults for mode and container.
-     */
-    reset(): void;
-    private applyToDOM;
-    static ɵfac: i0.ɵɵFactoryDeclaration<LayoutService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<LayoutService>;
+/**
+ * Vertical layout — sidebar + main (scrollable).
+ *
+ * Data navigasi diambil dari `NavigationService` (register via
+ * `NavigationService.registerItems()` di bootstrap). Main memegang
+ * `<router-outlet>` dan scroll jika konten panjang.
+ *
+ * Markup:
+ * ```html
+ * <vertical>
+ *   <!-- sidebar + router-outlet dirender oleh komponen -->
+ * </vertical>
+ * ```
+ */
+declare class VerticalLayoutComponent {
+    private readonly layout;
+    private readonly theme;
+    readonly sidebarAppearance: _angular_core.InputSignal<SidebarAppearance>;
+    readonly sidebarPosition: _angular_core.InputSignal<SidebarPosition>;
+    readonly sidebarMode: _angular_core.InputSignal<SidebarMode>;
+    readonly ariaLabel: _angular_core.InputSignal<string>;
+    protected readonly layoutWidth: _angular_core.Signal<"full" | "fixed">;
+    protected readonly themeStyle: _angular_core.Signal<"default" | "sharp" | "brutal" | "soft">;
+    protected readonly shellBorderWidth: _angular_core.Signal<"var(--border-width)" | null>;
+    protected readonly dividerBorderWidth: _angular_core.Signal<string>;
+    protected readonly hostClasses: _angular_core.Signal<string>;
+    protected readonly frameClasses: _angular_core.Signal<string>;
+    protected readonly mainClasses: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<VerticalLayoutComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<VerticalLayoutComponent, "vertical", never, { "sidebarAppearance": { "alias": "sidebarAppearance"; "required": false; "isSignal": true; }; "sidebarPosition": { "alias": "sidebarPosition"; "required": false; "isSignal": true; }; "sidebarMode": { "alias": "sidebarMode"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-declare class LayoutHostDirective {
-    protected readonly layout: LayoutService;
-    static ɵfac: i0.ɵɵFactoryDeclaration<LayoutHostDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<LayoutHostDirective, "[ngtLayoutHost]", never, {}, {}, never, never, true, never>;
+/**
+ * Horizontal layout — topbar (h-12) + main (scrollable).
+ *
+ * Data navigasi diambil dari `NavigationService`.
+ * Consumer app dapat memproyeksikan brand kiri dan profile kanan.
+ *
+ * Markup:
+ * ```html
+ * <horizontal>
+ *   <a ui-layout-brand>Brand</a>
+ *   <button ui-layout-profile type="button">Profile</button>
+ * </horizontal>
+ * ```
+ */
+declare class HorizontalLayoutComponent {
+    private readonly layout;
+    private readonly theme;
+    readonly topbarAppearance: _angular_core.InputSignal<TopbarAppearance>;
+    readonly ariaLabel: _angular_core.InputSignal<string>;
+    protected readonly layoutWidth: _angular_core.Signal<"full" | "fixed">;
+    protected readonly themeStyle: _angular_core.Signal<"default" | "sharp" | "brutal" | "soft">;
+    protected readonly shellBorderWidth: _angular_core.Signal<"var(--border-width)" | null>;
+    protected readonly dividerBorderWidth: _angular_core.Signal<string>;
+    protected readonly hostClasses: _angular_core.Signal<string>;
+    protected readonly frameClasses: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<HorizontalLayoutComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<HorizontalLayoutComponent, "horizontal", never, { "topbarAppearance": { "alias": "topbarAppearance"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, ["[ui-layout-brand],[ui-topbar-start]", "[ui-layout-profile],[ui-topbar-end]"], true, never>;
 }
 
-declare class LayoutHorizontalComponent {
-    static ɵfac: i0.ɵɵFactoryDeclaration<LayoutHorizontalComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<LayoutHorizontalComponent, "horizontal", never, {}, {}, never, ["[brand]", "[navigation]", "[action]"], true, never>;
+/**
+ * Empty layout — full-viewport, flex-centered main.
+ *
+ * Cocok untuk halaman login / error / onboarding (pola shadcn `login-05`).
+ * Konten dirender lewat `<router-outlet>`; consumer men-style card / form
+ * milik halaman route sendiri.
+ *
+ * Markup:
+ * ```html
+ * <empty>
+ *   <!-- router-outlet dirender oleh komponen -->
+ * </empty>
+ * ```
+ */
+declare class EmptyLayoutComponent {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<EmptyLayoutComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EmptyLayoutComponent, "empty", never, {}, {}, never, never, true, never>;
 }
 
-declare class LayoutVerticalComponent {
-    static ɵfac: i0.ɵɵFactoryDeclaration<LayoutVerticalComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<LayoutVerticalComponent, "vertical", never, {}, {}, never, ["[navigation]"], true, never>;
+declare const LAYOUT_MODES: readonly ["vertical", "horizontal"];
+type LayoutMode = (typeof LAYOUT_MODES)[number];
+declare const LAYOUT_WIDTHS: readonly ["full", "fixed"];
+type LayoutWidth = (typeof LAYOUT_WIDTHS)[number];
+interface MaterialLayoutConfig {
+    /** Initial layout mode. */
+    readonly mode?: LayoutMode;
+    /** Initial layout width. */
+    readonly width?: LayoutWidth;
+    /** @deprecated Use `mode` instead. */
+    /** Initial layout mode. Defaults to `vertical`. */
+    readonly defaultMode?: LayoutMode;
+    /** localStorage key used to persist the layout mode. Set to `null` to disable persistence. */
+    readonly storageKey?: string | null;
+    /** localStorage key used to persist the layout width. Set to `null` to disable persistence. */
+    readonly widthStorageKey?: string | null;
 }
-
-declare class LayoutContainerSwitcherComponent {
-    protected readonly layout: LayoutService;
-    protected readonly label: i0.Signal<"Boxed layout container enabled" | "Boxed layout container disabled">;
-    protected toggle(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<LayoutContainerSwitcherComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<LayoutContainerSwitcherComponent, "layout-container-switcher", never, {}, {}, never, never, true, never>;
+interface ResolvedMaterialLayoutConfig {
+    readonly defaultMode: LayoutMode;
+    readonly defaultWidth: LayoutWidth;
+    readonly storageKey: string | null;
+    readonly widthStorageKey: string | null;
 }
+declare const MATERIAL_LAYOUT_CONFIG: InjectionToken<MaterialLayoutConfig>;
+declare const DEFAULT_MATERIAL_LAYOUT_CONFIG: ResolvedMaterialLayoutConfig;
+declare function isLayoutMode(value: string | null | undefined): value is LayoutMode;
+declare function isLayoutWidth(value: string | null | undefined): value is LayoutWidth;
 
-declare class LayoutModeSwitcherComponent {
-    protected readonly layout: LayoutService;
-    protected readonly options: ({
-        value: "vertical";
-        label: string;
-    } | {
-        value: "horizontal";
-        label: string;
-    })[];
-    protected readonly currentOption: i0.Signal<{
-        value: "vertical";
-        label: string;
-    } | {
-        value: "horizontal";
-        label: string;
-    } | {
-        value: "empty";
-        label: string;
-    }>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<LayoutModeSwitcherComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<LayoutModeSwitcherComponent, "layout-mode-switcher", never, {}, {}, never, never, true, never>;
+declare class LayoutService {
+    private readonly document;
+    private readonly config;
+    private readonly _mode;
+    private readonly _width;
+    readonly mode: _angular_core.Signal<"vertical" | "horizontal">;
+    readonly width: _angular_core.Signal<"full" | "fixed">;
+    constructor();
+    setMode(mode: LayoutMode): void;
+    toggleMode(): void;
+    setWidth(width: LayoutWidth): void;
+    toggleWidth(): void;
+    private resolveConfig;
+    private readPersistedMode;
+    private readPersistedWidth;
+    private persistMode;
+    private persistWidth;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<LayoutService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<LayoutService>;
 }
 
-declare function provideNgLayout(config?: Partial<NgLayoutConfig>): EnvironmentProviders;
+declare function provideMaterialLayout(config?: MaterialLayoutConfig): EnvironmentProviders;
 
-declare const NG_LAYOUT_CONFIG: InjectionToken<NgLayoutConfig>;
+declare const LAYOUT_VERSION = "0.0.1";
 
-export { LayoutContainerSwitcherComponent, LayoutHorizontalComponent, LayoutHostDirective, LayoutModeSwitcherComponent, LayoutService, LayoutVerticalComponent, NG_LAYOUT_CONFIG, provideNgLayout };
-export type { LayoutContainer, LayoutMode, NgLayoutConfig };
+export { DEFAULT_MATERIAL_LAYOUT_CONFIG, EmptyLayoutComponent, HorizontalLayoutComponent, LAYOUT_MODES, LAYOUT_VERSION, LAYOUT_WIDTHS, LayoutService, MATERIAL_LAYOUT_CONFIG, VerticalLayoutComponent, isLayoutMode, isLayoutWidth, provideMaterialLayout };
+export type { LayoutMode, LayoutWidth, MaterialLayoutConfig, ResolvedMaterialLayoutConfig };