@omerdlw/base-framework 1.0.0

package/dist/modules/context-menu/types.d.ts

@@ -0,0 +1,171 @@
+import { type ReactNode } from "react";
+import { type ExternalStore } from "@/utils";
+import { type RegistryMetadata } from "@/kernel";
+export interface ContextMenuTrigger {
+    clientX?: number;
+    clientY?: number;
+    currentTarget?: EventTarget | null;
+    preventDefault?: () => void;
+    stopPropagation?: () => void;
+    target?: EventTarget | null;
+}
+export type ContextMenuIcon = ReactNode;
+export interface ContextMenuPosition {
+    x: number;
+    y: number;
+}
+export type ContextMenuThemeSlot = "backdrop" | "menu" | "header" | "headerIcon" | "headerText" | "headerEyebrow" | "headerTitle" | "headerDescription" | "separator" | "item" | "itemIcon" | "itemLabel" | "itemShortcut";
+export type ContextMenuClasses = Readonly<Record<ContextMenuThemeSlot, string>>;
+export interface ContextMenuClassNames {
+    backdrop?: string;
+    menu?: string;
+    header?: string;
+    headerIcon?: string;
+    headerText?: string;
+    headerEyebrow?: string;
+    headerTitle?: string;
+    headerDescription?: string;
+    separator?: string;
+    item?: string;
+    itemDanger?: string;
+    itemIcon?: string;
+    itemLabel?: string;
+    itemShortcut?: string;
+}
+export interface ContextMenuPageMeta {
+    description: ReactNode;
+    descriptionText: string;
+    eyebrow: ReactNode;
+    icon: ContextMenuIcon;
+    path: string;
+    title: ReactNode;
+    titleText: string;
+}
+export interface ContextMenuContextValue {
+    currentTarget?: EventTarget | null;
+    event?: ContextMenuTrigger | null;
+    pathname: string;
+    point: ContextMenuPosition;
+    target?: Element | null;
+    payload?: unknown;
+    page?: ContextMenuPageMeta | null;
+}
+export type ContextMenuItemType = "action" | "separator";
+export interface ContextMenuItem {
+    key?: string;
+    type?: ContextMenuItemType | string;
+    label?: ReactNode | ((context: ContextMenuContextValue) => ReactNode);
+    icon?: ContextMenuIcon;
+    itemIconClassName?: string;
+    shortcut?: string | ((context: ContextMenuContextValue) => string | null) | null;
+    danger?: boolean | ((context: ContextMenuContextValue) => boolean);
+    disabled?: boolean | ((context: ContextMenuContextValue) => boolean);
+    hidden?: boolean | ((context: ContextMenuContextValue) => boolean);
+    visible?: boolean | ((context: ContextMenuContextValue) => boolean);
+    closeOnSelect?: boolean;
+    className?: string;
+    onClick?: (event: ContextMenuTrigger | undefined, context: ContextMenuContextValue) => void | Promise<void>;
+    onSelect?: (event: ContextMenuTrigger | undefined, context: ContextMenuContextValue) => void | Promise<void>;
+}
+export interface ContextMenuResolvedItem {
+    key: string;
+    type: ContextMenuItemType;
+    label?: string;
+    icon?: ContextMenuIcon;
+    itemIconClassName?: string;
+    shortcut?: string | null;
+    danger?: boolean;
+    disabled?: boolean;
+    closeOnSelect?: boolean;
+    className?: string;
+    onClick?: ((event: ContextMenuTrigger | undefined, context: ContextMenuContextValue) => void | Promise<void>) | null;
+    onSelect?: ((event: ContextMenuTrigger | undefined, context: ContextMenuContextValue) => void | Promise<void>) | null;
+}
+export type ContextMenuHeaderConfig = {
+    title?: ReactNode;
+    description?: ReactNode;
+    eyebrow?: ReactNode;
+    icon?: ContextMenuIcon;
+} | false;
+export interface ContextMenuResolvedHeader {
+    description: ReactNode;
+    descriptionText: string;
+    eyebrow: ReactNode;
+    icon: ContextMenuIcon;
+    title: ReactNode;
+    titleText: string;
+}
+export interface ContextMenuConfig {
+    id?: string;
+    path?: string | null;
+    paths?: string[] | null;
+    pathMatcher?: (path: string) => boolean;
+    target?: string | string[] | null;
+    items?: (ContextMenuItem | "separator")[] | ((context: ContextMenuContextValue) => (ContextMenuItem | "separator")[]);
+    onOpen?: (event: MouseEvent, context: ContextMenuContextValue) => boolean | object | void;
+    onClose?: (context: ContextMenuContextValue) => void;
+    classNames?: ContextMenuClassNames;
+    priority?: number;
+    enabled?: boolean | ((context: ContextMenuContextValue) => boolean);
+    when?: boolean | ((event: MouseEvent, info: {
+        pathname: string;
+        target: Element | null;
+        context: ContextMenuContextValue;
+    }) => boolean);
+    payload?: unknown;
+    resolvePayload?: (event: MouseEvent, context: ContextMenuContextValue) => unknown;
+    resolveContext?: (event: MouseEvent, context: ContextMenuContextValue) => Record<string, unknown>;
+    header?: ContextMenuHeaderConfig | ((context: ContextMenuContextValue) => ContextMenuHeaderConfig);
+    showPageHeader?: boolean;
+    menus?: ContextMenuConfig[];
+}
+export interface ContextMenuCandidate {
+    registryKey: string;
+    config: ContextMenuConfig;
+    order: number;
+}
+export interface ContextMenuResolvedMatch {
+    config: ContextMenuConfig;
+    context: ContextMenuContextValue;
+    items: ContextMenuResolvedItem[];
+    score: number;
+    order: number;
+}
+export interface ContextMenuState {
+    config: ContextMenuConfig | null;
+    context: ContextMenuContextValue | null;
+    isOpen: boolean;
+    items: ContextMenuResolvedItem[];
+    position: ContextMenuPosition;
+}
+export interface ContextMenuTriggerBindings {
+    onContextMenu: (event: ContextMenuTrigger) => void;
+}
+export interface ContextMenuOpenInput {
+    config?: ContextMenuConfig | null;
+    context?: ContextMenuContextValue | null;
+    items?: ContextMenuResolvedItem[];
+    position?: Partial<ContextMenuPosition> | null;
+}
+export interface ContextMenuActions {
+    openMenu: (input: ContextMenuOpenInput) => void;
+    closeMenu: () => void;
+    bind: (payload?: unknown, configOverride?: Partial<ContextMenuConfig>) => ContextMenuTriggerBindings;
+}
+export interface ContextMenuProviderValue {
+    actions: ContextMenuActions;
+    store: ExternalStore<ContextMenuState>;
+}
+export type ContextMenuContextApi = ContextMenuState & ContextMenuActions;
+export interface ContextMenuDefinition {
+    config: Partial<ContextMenuConfig>;
+    id: string;
+    use: (options?: Partial<ContextMenuConfig>) => ContextMenuContextApi;
+}
+export type ContextMenuPageConfig = Partial<ContextMenuConfig> & {
+    registry?: RegistryMetadata;
+};
+export interface ContextMenuPageApi extends ContextMenuActions {
+    set: (contextMenu: ContextMenuPageConfig | null) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/modules/context-menu/types.d.ts.map

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

package/dist/modules/context-menu/utils.d.ts

@@ -0,0 +1,16 @@
+import { type ContextMenuConfig, type ContextMenuContextValue, type ContextMenuPageMeta, type ContextMenuPosition, type ContextMenuResolvedHeader, type ContextMenuResolvedItem } from "./types";
+export declare function joinClassNames(...classes: (string | boolean | null | undefined)[]): string;
+export declare function isScrollLockKey(event: {
+    key: string;
+}): boolean;
+export declare function extractNodeText(value: unknown): string;
+export declare function resolveAsBoolean(value: unknown, context?: unknown, defaultValue?: boolean): boolean;
+export declare function resolveAsValue<T = unknown>(value: unknown, context?: unknown, fallback?: T): T;
+export declare function emitContextMenuVisibility(isOpen: boolean): void;
+export declare function safeInvoke<T = unknown>(handler: unknown, ...args: unknown[]): T | undefined;
+export declare function resolveContextMenuPageMeta(dockItem: unknown, pathname?: string): ContextMenuPageMeta | null;
+export declare function positionMenu(menuElement: HTMLElement | null, position?: ContextMenuPosition | null): void;
+export declare function resolveMenuItems(config: ContextMenuConfig | null | undefined, context: ContextMenuContextValue): ContextMenuResolvedItem[];
+export declare function resolveMenuHeader(config: ContextMenuConfig | null | undefined, context: ContextMenuContextValue): ContextMenuResolvedHeader | null;
+export declare function getNextActiveIndex(items: ContextMenuResolvedItem[], current: number, direction: 1 | -1): number;
+//# sourceMappingURL=utils.d.ts.map

package/dist/modules/context-menu/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/modules/context-menu/utils.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAG5B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAE7B,MAAM,SAAS,CAAC;AAGjB,wBAAgB,cAAc,CAC5B,GAAG,OAAO,EAAE,CAAC,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAClD,MAAM,CAER;AAaD,wBAAgB,eAAe,CAAC,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAE/D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAgBtD;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,OAAO,EACjB,YAAY,UAAO,GAClB,OAAO,CAYT;AAED,wBAAgB,cAAc,CAAC,CAAC,GAAG,OAAO,EACxC,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,OAAO,EACjB,QAAQ,CAAC,EAAE,CAAC,GACX,CAAC,CAUH;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAO/D;AAED,wBAAgB,UAAU,CAAC,CAAC,GAAG,OAAO,EACpC,OAAO,EAAE,OAAO,EAChB,GAAG,IAAI,EAAE,OAAO,EAAE,GACjB,CAAC,GAAG,SAAS,CAcf;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,OAAO,EACjB,QAAQ,SAAK,GACZ,mBAAmB,GAAG,IAAI,CA8B5B;AAED,wBAAgB,YAAY,CAC1B,WAAW,EAAE,WAAW,GAAG,IAAI,EAC/B,QAAQ,CAAC,EAAE,mBAAmB,GAAG,IAAI,GACpC,IAAI,CAWN;AAmDD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,EAC5C,OAAO,EAAE,uBAAuB,GAC/B,uBAAuB,EAAE,CAmB3B;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,EAC5C,OAAO,EAAE,uBAAuB,GAC/B,yBAAyB,GAAG,IAAI,CAyBlC;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,uBAAuB,EAAE,EAChC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,GAChB,MAAM,CAUR"}

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

@@ -0,0 +1,7 @@
+import { type ControlsThemeSlot } from "./types";
+export declare const CONTROLS_EDGE_INSET = 4;
+export declare const CONTROLS_DOCK_GAP = 8;
+export declare const CONTROLS_DOCK_ELEMENT_ID = "dock-card-stack";
+export declare const CONTROL_SIDE_NAMES: readonly ["left", "right"];
+export declare const controlsTheme: import("../theme").ThemeSpec<ControlsThemeSlot>;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/modules/controls/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,wBAAwB,oBAAoB,CAAC;AAC1D,eAAO,MAAM,kBAAkB,4BAA4C,CAAC;AAE5E,eAAO,MAAM,aAAa,iDAAiD,CAAC"}

package/dist/modules/controls/hooks.d.ts

@@ -0,0 +1,15 @@
+import { type RegistryMetadata } from "@/kernel";
+import { type ControlEntry, type ControlsLayout, type ControlsPageConfig, type ControlsUseOptions, type DefineControlsOptions } from "./types";
+export declare function useControlsLayout(): ControlsLayout | null;
+export declare function useControlsRegistration(config: ControlsPageConfig | null | undefined, options?: RegistryMetadata & {
+    enabled?: boolean;
+}): void;
+export declare function useControls(config?: DefineControlsOptions | ControlEntry | ControlEntry[] | null, options?: ControlsUseOptions): ControlsLayout | null;
+export declare function useControlsModel(): {
+    portalTarget: HTMLElement | null;
+    layout: ControlsLayout | null;
+    left: import("./types").ControlsPairItem[];
+    right: import("./types").ControlsPairItem[];
+    theme: import("../theme").ResolvedTheme<import("./types").ControlsThemeSlot>;
+};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/modules/controls/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/modules/controls/hooks.ts"],"names":[],"mappings":"AAaA,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC3B,MAAM,SAAS,CAAC;AAkCjB,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,IAAI,CAsDzD;AAYD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,EAC7C,OAAO,CAAC,EAAE,gBAAgB,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACjD,IAAI,CAEN;AAED,wBAAgB,WAAW,CACzB,MAAM,CAAC,EAAE,qBAAqB,GAAG,YAAY,GAAG,YAAY,EAAE,GAAG,IAAI,EACrE,OAAO,CAAC,EAAE,kBAAkB,GAC3B,cAAc,GAAG,IAAI,CAoBvB;AAID,wBAAgB,gBAAgB;;;;;;EAiB/B"}

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

@@ -0,0 +1,6 @@
+export { Controls } from "./overlay";
+export { CONTROLS_EDGE_INSET, CONTROLS_DOCK_GAP, CONTROLS_DOCK_ELEMENT_ID, controlsTheme, CONTROL_SIDE_NAMES, } from "./constants";
+export { useControls, useControlsLayout, useControlsRegistration, } from "./hooks";
+export { controlsModule, defineControls } from "./module";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/controls/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,aAAa,EACb,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1D,cAAc,SAAS,CAAC"}