@ikonai/sdk-react-ui-standard 1.0.7

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@ikonai/sdk-react-ui-standard",
+  "version": "1.0.7",
+  "type": "module",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": "./index.js",
+      "types": "./index.d.ts"
+    }
+  },
+  "peerDependencies": {
+    "@ikonai/sdk-react-ui": "*",
+    "lucide-react": "*",
+    "@dnd-kit/core": "*",
+    "@dnd-kit/sortable": "*",
+    "@dnd-kit/utilities": "*",
+    "@radix-ui/react-accessible-icon": "*",
+    "@radix-ui/react-accordion": "*",
+    "@radix-ui/react-alert-dialog": "*",
+    "@radix-ui/react-aspect-ratio": "*",
+    "@radix-ui/react-avatar": "*",
+    "@radix-ui/react-checkbox": "*",
+    "@radix-ui/react-collapsible": "*",
+    "@radix-ui/react-dialog": "*",
+    "@radix-ui/react-direction": "*",
+    "@radix-ui/react-form": "*",
+    "@radix-ui/react-hover-card": "*",
+    "@radix-ui/react-menubar": "*",
+    "@radix-ui/react-navigation-menu": "*",
+    "@radix-ui/react-popover": "*",
+    "@radix-ui/react-portal": "*",
+    "@radix-ui/react-progress": "*",
+    "@radix-ui/react-radio-group": "*",
+    "@radix-ui/react-scroll-area": "*",
+    "@radix-ui/react-select": "*",
+    "@radix-ui/react-separator": "*",
+    "@radix-ui/react-slider": "*",
+    "@radix-ui/react-switch": "*",
+    "@radix-ui/react-tabs": "*",
+    "@radix-ui/react-toast": "*",
+    "@radix-ui/react-toggle": "*",
+    "@radix-ui/react-toggle-group": "*",
+    "@radix-ui/react-toolbar": "*",
+    "@radix-ui/react-tooltip": "*",
+    "@radix-ui/react-primitive": "*",
+    "@radix-ui/react-visually-hidden": "*",
+    "react": "*",
+    "react-dom": "*",
+    "react-markdown": "*",
+    "rehype-external-links": "*",
+    "remark-gfm": "*"
+  }
+}

package/radix-core.d.ts

@@ -0,0 +1,67 @@
+import { UiComponentRendererProps, UiNode, UiNodeProps, UiRenderContext } from '../../sdk-react-ui/src/index.ts';
+export declare const RESET_BUTTON_CLASS = "ikon-reset-button";
+export declare const RESET_INPUT_CLASS = "ikon-reset-input";
+export declare const RESET_FOCUS_CLASS = "ikon-reset-focus";
+export declare function hasAnyKeys(obj: Record<string, unknown>): boolean;
+export declare const TEXT_FIELD_EXCLUDE_KEYS: Set<string>;
+export declare const TEXT_AREA_EXCLUDE_KEYS: Set<string>;
+export declare const CHECKBOX_EXCLUDE_KEYS: Set<string>;
+export declare const SWITCH_EXCLUDE_KEYS: Set<string>;
+export declare const RADIO_GROUP_EXCLUDE_KEYS: Set<string>;
+export declare const TOGGLE_EXCLUDE_KEYS: Set<string>;
+export declare const SLIDER_EXCLUDE_KEYS: Set<string>;
+export declare const SELECT_EXCLUDE_KEYS: Set<string>;
+export declare const BUTTON_EXCLUDE_KEYS: Set<string>;
+export declare const ICON_BUTTON_EXCLUDE_KEYS: Set<string>;
+export declare const EMPTY_EXCLUDE_SET: Set<string>;
+export declare function toStringValue(value: unknown): string | undefined;
+export declare function toBooleanValue(value: unknown): boolean | undefined;
+export declare function toNumberValue(value: unknown): number | undefined;
+export declare function toActionId(value: unknown): string | undefined;
+export declare function combineClassNames(...candidates: (string | readonly string[] | undefined)[]): string | undefined;
+export declare function pickPrimitiveProps(props: UiNodeProps | undefined, exclude?: Set<string>): Record<string, unknown>;
+export declare function createVoidDispatcher(actionId: string | undefined, dispatch: UiComponentRendererProps['context']['dispatchAction']): (() => void) | undefined;
+export declare function createCachedVoidDispatcher(nodeId: string, actionId: string | undefined, context: UiRenderContext): (() => void) | undefined;
+export declare function createStringDispatcher(actionId: string | undefined, dispatch: UiComponentRendererProps['context']['dispatchAction']): ((value: string) => void) | undefined;
+export declare function createCachedStringDispatcher(nodeId: string, actionId: string | undefined, context: UiRenderContext): ((value: string) => void) | undefined;
+export declare function createNullableBooleanDispatcher(actionId: string | undefined, dispatch: UiComponentRendererProps['context']['dispatchAction']): ((value: boolean | null | undefined) => void) | undefined;
+export declare function createCachedNullableBooleanDispatcher(nodeId: string, actionId: string | undefined, context: UiRenderContext): ((value: boolean | null | undefined) => void) | undefined;
+export declare function toStringListValue(value: unknown): string[] | undefined;
+export declare function toStyleIdList(value: unknown): readonly string[] | undefined;
+export interface SlotChildCollection {
+    readonly defaultChildren: readonly UiNode[];
+    readonly slotChildren: ReadonlyMap<string, readonly UiNode[]>;
+}
+export declare function collectSlotChildren(node: UiNode): SlotChildCollection;
+/**
+ * Hook for managing controlled/uncontrolled component state.
+ * Reduces boilerplate in form components that support both controlled and uncontrolled modes.
+ *
+ * @param controlledValue - The controlled value (undefined means uncontrolled)
+ * @param defaultValue - The default value for uncontrolled mode
+ * @param onChange - Optional callback when value changes
+ * @returns Tuple of [currentValue, setValue] for use in the component
+ */
+export declare function useControlledState<T>(controlledValue: T | undefined, defaultValue: T, onChange?: (value: T) => void): [T, (value: T) => void];
+/**
+ * Hook for optimistic UI state updates.
+ * Provides immediate visual feedback when users interact with controlled components,
+ * while the server state remains the source of truth.
+ *
+ * @param serverValue - The controlled value from the server (undefined means uncontrolled)
+ * @param defaultValue - The default value for uncontrolled mode
+ * @param onChange - Optional callback when value changes (dispatches to server)
+ * @returns Tuple of [currentValue, setValue, isPending] - isPending is true while waiting for server response
+ */
+export declare function useOptimisticState<T>(serverValue: T | undefined, defaultValue: T, onChange?: (value: T) => void): [T, (value: T) => void, boolean];
+/**
+ * Hook for optimistic UI state updates with array values.
+ * Provides immediate visual feedback when users interact with controlled components,
+ * while the server state remains the source of truth.
+ *
+ * @param serverValue - The controlled array value from the server (undefined means uncontrolled)
+ * @param defaultValue - The default array value for uncontrolled mode
+ * @param onChange - Optional callback when value changes (dispatches to server)
+ * @returns Tuple of [currentValue, setValue, isPending] - isPending is true while waiting for server response
+ */
+export declare function useOptimisticArrayState<T>(serverValue: T[] | undefined, defaultValue: T[], onChange?: (value: T[]) => void): [T[], (value: T[]) => void, boolean];

package/radix-module.d.ts

@@ -0,0 +1,5 @@
+import { IkonUiComponentResolver, IkonUiModuleLoader, IkonUiRegistry } from '../../sdk-react-ui/src/index.ts';
+export declare const IKON_UI_RADIX_MODULE = "radix";
+export declare const loadRadixModule: IkonUiModuleLoader;
+export declare function registerRadixModule(registry: IkonUiRegistry): void;
+export declare function createRadixResolvers(): IkonUiComponentResolver[];

package/utils/file-upload.d.ts

@@ -0,0 +1,61 @@
+import { UiRenderContext } from '../../../sdk-react-ui/src/index.ts';
+export interface FileInfo {
+    file: File;
+    uploadId: string;
+}
+export interface FileSelectedPayload {
+    Files: Array<{
+        FileName: string;
+        Size: number;
+        Mime: string;
+    }>;
+}
+export interface FileUploadStartedPayload {
+    UploadId: string;
+    FileName: string;
+    Size: number;
+    Mime: string;
+}
+export interface FileUploadProgressPayload {
+    UploadId: string;
+    FileName: string;
+    ProgressPercentage: number;
+}
+export interface FileUploadCompletePayload {
+    UploadId: string;
+    FileName: string;
+    Size: number;
+    Mime: string;
+    FilePath: string;
+}
+export interface FileUploadErrorPayload {
+    UploadId: string;
+    FileName: string;
+    ErrorMessage: string;
+}
+export interface UploadCallbacks {
+    onFileSelectedId?: string;
+    onUploadStartedId?: string;
+    onUploadProgressId?: string;
+    onUploadCompleteId?: string;
+    onUploadErrorId?: string;
+}
+export interface UploadOptions {
+    callbacks: UploadCallbacks;
+    context: UiRenderContext;
+    uploadPath?: string;
+}
+export declare function generateUploadId(): string;
+export declare function validateFile(file: File, accept?: string[], maxSize?: number): {
+    valid: boolean;
+    error?: string;
+};
+export declare function uploadFileViaProtocol(fileInfo: FileInfo, options: UploadOptions): Promise<void>;
+export declare function processAndUploadFiles(files: File[], options: {
+    multiple: boolean;
+    accept?: string[];
+    maxFileSize?: number;
+    callbacks: UploadCallbacks;
+    context: UiRenderContext;
+    uploadPath?: string;
+}): Promise<void>;