@omerdlw/base-framework 1.0.0

package/dist/kernel/schema.d.ts

@@ -0,0 +1,13 @@
+import { DEFAULT_SOURCE, REGISTRY_LIFECYCLES, REGISTRY_SOURCES, REGISTRY_VALIDATION_MODES } from "./constants";
+import type { NormalizedRegistryMetadata, RegistryDefinitions, RegistryLifecycle, RegistryMetadata, ValidationResult } from "./types";
+export { DEFAULT_SOURCE, REGISTRY_LIFECYCLES, REGISTRY_SOURCES, REGISTRY_VALIDATION_MODES, };
+export declare function validateRegistryMetadata(metadata: unknown): ValidationResult;
+export declare function validateRegistryKey(type: string, key: unknown, definitions: RegistryDefinitions): ValidationResult;
+export declare function validateRegistryValue(type: string, key: unknown, value: unknown, definitions: RegistryDefinitions): ValidationResult;
+export declare function normalizeRegistryMetadata(metadata: unknown, { defaultCleanupDelayMs, defaultLifecycle, defaultSource, }?: {
+    defaultCleanupDelayMs?: number | null;
+    defaultLifecycle?: RegistryLifecycle | null;
+    defaultSource?: string;
+}): NormalizedRegistryMetadata;
+export declare function pickRegistryMetadata(options: unknown): RegistryMetadata;
+//# sourceMappingURL=schema.d.ts.map

package/dist/kernel/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/kernel/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAEd,mBAAmB,EAGnB,gBAAgB,EAChB,yBAAyB,EAC1B,MAAM,aAAa,CAAC;AAOrB,OAAO,KAAK,EACV,0BAA0B,EAC1B,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAEhB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,yBAAyB,GAC1B,CAAC;AAYF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,GAAG,gBAAgB,CAqD5E;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,OAAO,EACZ,WAAW,EAAE,mBAAmB,GAC/B,gBAAgB,CA8BlB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,mBAAmB,GAC/B,gBAAgB,CAyBlB;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,OAAO,EACjB,EACE,qBAA4B,EAC5B,gBAAuB,EACvB,aAA8B,GAC/B,GAAE;IACD,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,gBAAgB,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;CACnB,GACL,0BAA0B,CAqD5B;AAMD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAOvE"}

package/dist/kernel/store.d.ts

@@ -0,0 +1,4 @@
+import type { AppRegistryEntry, RegistryDefinitions, RegistryStore } from "./types";
+export type InitialRegistryEntries = readonly AppRegistryEntry[];
+export declare function createRegistryStore(initialEntries?: InitialRegistryEntries, definitions?: RegistryDefinitions): RegistryStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/kernel/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/kernel/store.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,gBAAgB,EAGhB,mBAAmB,EAMnB,aAAa,EAEd,MAAM,SAAS,CAAC;AAGjB,MAAM,MAAM,sBAAsB,GAAG,SAAS,gBAAgB,EAAE,CAAC;AAmSjE,wBAAgB,mBAAmB,CACjC,cAAc,GAAE,sBAA2B,EAC3C,WAAW,GAAE,mBAAoC,GAChD,aAAa,CA0Rf"}

package/dist/kernel/types.d.ts

@@ -0,0 +1,233 @@
+import type { ComponentType, Context, ReactNode } from "react";
+import type { ExternalStore } from "@/utils";
+export type AnyFunction = (...args: unknown[]) => unknown;
+export interface AppRegistryEntry<T = unknown> {
+    type: string;
+    items: Record<string, T>;
+    instanceId?: string;
+    options?: RegistryMetadata;
+    source?: string;
+}
+export type RegistrySource = "static" | "dynamic" | "user" | (string & {});
+export type RegistryLifecycle = "immediate" | "graceful" | "persistent" | "route";
+export type RegistryValidationMode = "warn" | "strict";
+export type RegistryScopeKind = "app" | "session" | "route" | "instance" | "workspace";
+export interface RegistryMetadata {
+    cleanup?: RegistryLifecycle;
+    cleanupDelayMs?: number | null;
+    instanceId?: string | null;
+    lifecycle?: RegistryLifecycle;
+    priority?: number;
+    source?: string;
+    scope?: string;
+    validation?: RegistryValidationMode;
+}
+type RegistryKeyPolicy = "singleton" | "named" | "path" | "route";
+export interface RegistryDefinition<TValue = unknown> {
+    keyPolicy: RegistryKeyPolicy;
+    lifecycle: RegistryLifecycle;
+    cleanupDelayMs?: number | null;
+    singletonKey?: string;
+    reservedKeys?: readonly string[];
+    valueKind?: "object" | "component";
+    merge?(valuesLowToHigh: TValue[]): TValue;
+    validate?(value: unknown): ValidationResult;
+}
+export interface RegistryDefinitions {
+    get(type: string): RegistryDefinition | undefined;
+    keys(): Iterable<string>;
+}
+export interface ValidationResult {
+    valid: boolean;
+    issues: string[];
+    reason?: string;
+}
+export interface SourceRecord<T = unknown> {
+    updatedAt: number;
+    sequence: number;
+    instanceId: string | null;
+    priority: number;
+    source: string;
+    scope: string;
+    value: T;
+}
+export interface RegisterOperation<T = unknown> {
+    kind: "register";
+    validation?: RegistryValidationMode;
+    source: string;
+    scope: string;
+    record: SourceRecord<T>;
+    instanceId: string | null;
+    type: string;
+    key: string;
+}
+export interface UnregisterOperation {
+    kind: "unregister";
+    instanceId: string | null;
+    scope: string | null;
+    source: string;
+    type: string;
+    key: string;
+}
+export type RegistryOperation = RegisterOperation | UnregisterOperation;
+export interface RegistrationHandle<T = unknown> {
+    (reason?: string): boolean;
+    active: boolean;
+    dispose: (reason?: string) => boolean;
+    instanceId: string | null;
+    key: string;
+    priority: number;
+    reason?: string;
+    source: string;
+    status: "active" | "disposed" | "superseded" | "rejected" | "ignored";
+    type: string;
+    update: (value: T, options?: RegistryMetadata) => RegistrationHandle<T>;
+    updatedAt: number;
+    validation: string;
+}
+export interface RegistrySchema {
+    [key: string]: unknown;
+}
+type RegistryTypeKey = keyof RegistrySchema & string;
+export interface NormalizedRegistryMetadata {
+    cleanupDelayMs: number | null;
+    lifecycle: RegistryLifecycle | null;
+    priority: number | null;
+    registerOptions: RegistryMetadata;
+    scope?: string;
+    source: string;
+    validation?: RegistryValidationMode;
+}
+export type RegistryEntryRecords = Record<string, unknown>;
+export type RegistryState = Record<string, Record<string, RegistryEntryRecords>>;
+export type RegistrySourceOrOptions = string | RegistryMetadata;
+type RegistryRegisterFn = <K extends RegistryTypeKey = RegistryTypeKey, T = RegistrySchema[K]>(type: K, key: string, item: T, sourceOrOptions?: RegistrySourceOrOptions, optionsArg?: RegistryMetadata) => RegistrationHandle<T>;
+type RegistryUnregisterFn = <K extends RegistryTypeKey = RegistryTypeKey>(type: K, key: string, sourceOrOptions?: RegistrySourceOrOptions) => void;
+export interface RegistryQueue {
+    register: RegistryRegisterFn;
+    unregister: RegistryUnregisterFn;
+}
+export interface RegistryCleanupTimer {
+    cancelled: boolean;
+    timerId: ReturnType<typeof setTimeout> | null;
+}
+export interface RegistryApplyContext extends RegistryQueue {
+    batch: (executor: (queue: RegistryQueue) => void) => number;
+    cleanupScope: Map<string, RegistryCleanupTimer>;
+    instanceId: string;
+    modules?: readonly AnyCoreModule[];
+    pathname: string;
+}
+export interface RegistryTransactionResult {
+    applied?: number;
+    queued?: number;
+    status: "open" | "committed" | "rolled-back";
+    traceId: string;
+}
+export interface RegistryTransactionRef {
+    index: number;
+    status: "open" | "committed" | "rolled-back" | "queued";
+    traceId: string;
+}
+export interface RegistryTransactionQueue {
+    register: (type: string, key: string, value: unknown, sourceOrOptions?: RegistrySourceOrOptions, optionsArg?: RegistryMetadata) => RegistryTransactionRef;
+    unregister: (type: string, key: string, sourceOrOptions?: RegistrySourceOrOptions) => RegistryTransactionRef;
+}
+export interface RegistryStore {
+    batch: (executor: (queue: RegistryQueue) => void) => number;
+    dispose: (operation: RegisterOperation, reason?: string) => boolean;
+    getEntriesSnapshot: <K extends RegistryTypeKey = RegistryTypeKey, T = RegistrySchema[K]>(type: K, scope?: string | null) => Record<string, T>;
+    getSnapshot: <K extends RegistryTypeKey = RegistryTypeKey, T = RegistrySchema[K]>(type: K, key: string, scope?: string | null) => T | undefined;
+    isCurrent: (operation: RegisterOperation) => boolean;
+    register: RegistryRegisterFn;
+    subscribe: <K extends RegistryTypeKey = RegistryTypeKey>(type: K, key: string | null | undefined, listener: () => void) => () => void;
+    transaction: (executor: (tx: RegistryTransactionQueue) => void, metadata?: RegistryMetadata) => RegistryTransactionResult;
+    unregister: RegistryUnregisterFn;
+}
+export interface PageOptions {
+    instanceId?: string;
+    lifecycle?: RegistryLifecycle;
+    priority?: number;
+    scope?: string;
+    source?: string;
+    [key: string]: unknown;
+}
+export interface PageConfig {
+    registry?: RegistryMetadata;
+    title?: string;
+}
+export interface PageController {
+    Provider: ({ children }: {
+        children?: ReactNode;
+    }) => ReactNode;
+    config: PageConfig;
+    modules: PageModules;
+    reset: () => void;
+    set: (partial: Partial<PageConfig>) => void;
+}
+export interface RegistrationEntry {
+    cleanupDelayMs: number | null;
+    key: string;
+    lifecycle: RegistryLifecycle | null;
+    registerOptions: RegistryMetadata;
+    scope: string | undefined;
+    source: string;
+    value: unknown;
+}
+export interface StableFunctionEntry {
+    current: AnyFunction;
+    stable: AnyFunction;
+}
+export interface PageControllerStore {
+    getSnapshot: () => PageController | null;
+    notify: () => void;
+    register: (id: string, controllerRef: {
+        current: PageController | null;
+    }) => void;
+    subscribe: (listener: () => void) => () => void;
+    unregister: (id: string) => void;
+}
+export interface CoreModules {
+}
+export type ModuleId = keyof CoreModules & string;
+export interface ModuleRuntime<TState = unknown, TActions = unknown> {
+    readonly actions: TActions;
+    readonly store: ExternalStore<TState>;
+}
+export interface PageRegistration {
+    key: string;
+    value: unknown;
+}
+export interface ModulePageContext {
+    pathname: string;
+}
+export interface PageModuleApi {
+    set: (partial: Partial<PageConfig>) => void;
+}
+type ModuleSliceItem<TSlice> = TSlice extends readonly (infer TItem)[] ? TItem : TSlice;
+interface ModulePageSpec<TSlice, TController> {
+    select?(config: PageConfig): TSlice | null | undefined;
+    entries?(item: ModuleSliceItem<TSlice>, context: ModulePageContext): readonly PageRegistration[] | null | undefined;
+    use?(slice: TSlice | null, page: PageModuleApi): TController;
+}
+export interface CoreModule<TId extends string = string, TRuntime = unknown, TSlice = unknown, TController = unknown> {
+    readonly id: TId;
+    readonly context?: Context<TRuntime | null>;
+    readonly Provider?: ComponentType<{
+        children?: ReactNode;
+    }>;
+    readonly Backdrop?: ComponentType;
+    readonly Overlay?: ComponentType;
+    readonly uses?: readonly string[];
+    readonly registry?: RegistryDefinition;
+    readonly page?: ModulePageSpec<TSlice, TController>;
+}
+export type AnyCoreModule = CoreModule<string, any, any, any>;
+export type ModuleRuntimeOf<M> = M extends CoreModule<string, infer TRuntime, any, any> ? TRuntime : never;
+export type ModuleStateOf<K extends ModuleId> = ModuleRuntimeOf<CoreModules[K]> extends ModuleRuntime<infer TState, unknown> ? TState : never;
+type ModuleControllerOf<M> = M extends CoreModule<string, any, any, infer TController> ? TController : never;
+export type PageModules = {
+    [K in ModuleId as [ModuleControllerOf<CoreModules[K]>] extends [never] ? never : K]?: ModuleControllerOf<CoreModules[K]>;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/kernel/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/kernel/types.ts"],"names":[],"mappings":"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"}

package/dist/kernel/utils.d.ts

@@ -0,0 +1,20 @@
+import type { RegistryMetadata } from "./types";
+import { isObject, isPlainObject, shallowEqual } from "@/utils";
+export { isObject, isPlainObject, shallowEqual };
+export declare function hasOwnProperty(target: object, key: string): boolean;
+export declare function parseFiniteNumber(value: unknown): number | null;
+export declare function getValidString(value: unknown, fallback?: string | null): string | null;
+export declare function resolveInstanceId(value: unknown): string | null;
+export declare function getSourceRank(source: string): number;
+export declare function resolveRegisterInput(sourceOrOptions: unknown, optionsArg?: unknown): {
+    source: string;
+    options: RegistryMetadata;
+};
+export declare function resolveScope(options: RegistryMetadata | null | undefined): string;
+export declare function resolveUnregisterInput(sourceOrOptions: unknown): {
+    instanceId: string | null;
+    scope: string | null;
+    source: string;
+};
+export declare function mergeModuleConfigs<T extends object>(base: T, patch: Partial<T>): T;
+//# sourceMappingURL=utils.d.ts.map

package/dist/kernel/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/kernel/utils.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EACL,QAAQ,EACR,aAAa,EACb,YAAY,EAEb,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC;AAEjD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAG/D;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,MAAM,GAAG,IAAW,GAC7B,MAAM,GAAG,IAAI,CAEf;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAI/D;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,OAAO,EACxB,UAAU,CAAC,EAAE,OAAO,GACnB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,CAoB/C;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,GAC3C,MAAM,CAIR;AAED,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,OAAO,GAAG;IAChE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB,CAmBA;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EACjD,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAChB,CAAC,CAqBH"}

package/dist/modules/ambient/constants.d.ts

@@ -0,0 +1,23 @@
+export declare const AMBIENT_CSS_VARS: Readonly<{
+    readonly ambientGlow: "--color-ambient-glow";
+    readonly colorPrimary: "--color-primary";
+    readonly primary: "--primary";
+    readonly black: "--black";
+    readonly white: "--white";
+}>;
+export declare const AMBIENT_DEFAULTS: Readonly<{
+    readonly primary: "#101010";
+    readonly black: "#0b0b0b";
+}>;
+export declare const COLOR_EXTRACT_CONFIG: Readonly<{
+    readonly blackChromaFactor: 0.35;
+    readonly primaryLightness: 0.74;
+    readonly maxBlackChroma: 0.055;
+    readonly blackLightness: 0.15;
+    readonly cacheLimit: 100;
+    readonly maxChroma: 0.28;
+    readonly minChroma: 0.03;
+    readonly sampleSize: 32;
+}>;
+export declare const ambientTheme: import("../theme").ThemeSpec<"transition">;
+//# sourceMappingURL=constants.d.ts.map

package/dist/modules/ambient/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/modules/ambient/constants.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gBAAgB;;;;;;EAMlB,CAAC;AAEZ,eAAO,MAAM,gBAAgB;;;EAGlB,CAAC;AAEZ,eAAO,MAAM,oBAAoB;;;;;;;;;EAStB,CAAC;AAEZ,eAAO,MAAM,YAAY,4CAA+C,CAAC"}

package/dist/modules/ambient/context.d.ts

@@ -0,0 +1,10 @@
+import type { AmbientConfig, AmbientContextValue, AmbientExtractOptions, AmbientImageSource, AmbientPalette, AmbientProviderProps, AmbientProviderValue, AmbientState } from "./types";
+export declare const AmbientContext: import("react").Context<AmbientProviderValue | null>;
+export declare function AmbientProvider({ children, initialPalette, }: AmbientProviderProps): import("react").JSX.Element;
+export declare function useAmbientColor(imageSource: AmbientImageSource, options?: AmbientExtractOptions | null): {
+    isExtracting: boolean;
+    palette: AmbientPalette;
+};
+export declare function useAmbientTheme(config?: AmbientConfig | string | null): AmbientState;
+export declare function useAmbient(configOrImage?: AmbientConfig | string | null): AmbientContextValue;
+//# sourceMappingURL=context.d.ts.map

package/dist/modules/ambient/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/modules/ambient/context.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,YAAY,EACb,MAAM,SAAS,CAAC;AASjB,eAAO,MAAM,cAAc,sDACoD,CAAC;AAUhF,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,cAAqB,GACtB,EAAE,oBAAoB,+BAgCtB;AAED,wBAAgB,eAAe,CAC7B,WAAW,EAAE,kBAAkB,EAC/B,OAAO,GAAE,qBAAqB,GAAG,IAAW,GAC3C;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,CAoDpD;AAED,wBAAgB,eAAe,CAC7B,MAAM,GAAE,aAAa,GAAG,MAAM,GAAG,IAAW,GAC3C,YAAY,CAmFd;AAED,wBAAgB,UAAU,CACxB,aAAa,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,GAC5C,mBAAmB,CAqBrB"}

package/dist/modules/ambient/index.d.ts

@@ -0,0 +1,6 @@
+export { AMBIENT_CSS_VARS, AMBIENT_DEFAULTS, COLOR_EXTRACT_CONFIG, ambientTheme, } from "./constants";
+export { extractPaletteFromImage, oklchToString, resolvePageAmbientTheme, rgbToOklch, } from "./utils";
+export { ambientModule, defineAmbient } from "./module";
+export { AmbientContext, AmbientProvider, useAmbient, useAmbientColor, useAmbientTheme, } from "./context";
+export type * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/ambient/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/ambient/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,uBAAuB,EACvB,UAAU,GACX,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAExD,OAAO,EACL,cAAc,EACd,eAAe,EACf,UAAU,EACV,eAAe,EACf,eAAe,GAChB,MAAM,WAAW,CAAC;AAEnB,mBAAmB,SAAS,CAAC"}