@issonujha/sdui-core 0.0.0-stage → 0.1.1

package/dist/buildNavTree.d.ts

@@ -0,0 +1,8 @@
+import type { NavigationItem } from './contracts.js';
+/**
+ * Builds a nested navigation tree from a flat list. Mirrors the backend
+ * TreeHierarchyEngine: duplicate ids throw, orphans are promoted to roots,
+ * true cycles throw.
+ */
+export declare function buildNavTree(flatItems: NavigationItem[]): NavigationItem[];
+//# sourceMappingURL=buildNavTree.d.ts.map

package/dist/buildNavTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildNavTree.d.ts","sourceRoot":"","sources":["../src/buildNavTree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CA4D1E"}

package/dist/buildNavTree.js

@@ -0,0 +1,65 @@
+/**
+ * Builds a nested navigation tree from a flat list. Mirrors the backend
+ * TreeHierarchyEngine: duplicate ids throw, orphans are promoted to roots,
+ * true cycles throw.
+ */
+export function buildNavTree(flatItems) {
+    if (!flatItems || flatItems.length === 0)
+        return [];
+    const byId = new Map();
+    for (const item of flatItems) {
+        if (byId.has(item.id))
+            throw new Error(`Duplicate node id: ${item.id}`);
+        byId.set(item.id, { ...item, children: [] });
+    }
+    const roots = [];
+    const childrenByParent = new Map();
+    for (const item of flatItems) {
+        const node = byId.get(item.id);
+        const parentId = item.parentId ?? null;
+        if (parentId === null || !byId.has(parentId)) {
+            roots.push(node);
+        }
+        else {
+            const siblings = childrenByParent.get(parentId) ?? [];
+            siblings.push(node);
+            childrenByParent.set(parentId, siblings);
+        }
+    }
+    const sortAndLink = (nodes) => {
+        nodes.sort((a, b) => a.order - b.order);
+        for (const node of nodes) {
+            const children = childrenByParent.get(node.id) ?? [];
+            node.children = children;
+            sortAndLink(children);
+        }
+    };
+    sortAndLink(roots);
+    const reachable = new Set();
+    const visit = (nodes) => {
+        for (const node of nodes) {
+            if (reachable.has(node.id))
+                continue;
+            reachable.add(node.id);
+            visit(node.children ?? []);
+        }
+    };
+    visit(roots);
+    if (reachable.size < byId.size) {
+        for (const id of byId.keys()) {
+            if (reachable.has(id))
+                continue;
+            const path = new Set();
+            let cursor = id;
+            while (cursor !== null && !path.has(cursor)) {
+                path.add(cursor);
+                cursor = byId.get(cursor)?.parentId ?? null;
+            }
+            if (cursor !== null) {
+                throw new Error(`Circular hierarchy cycle detected involving node: ${id}`);
+            }
+        }
+    }
+    return roots;
+}
+//# sourceMappingURL=buildNavTree.js.map

package/dist/buildNavTree.js.map

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

package/dist/contracts.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Universal SDUI contracts. These are field-compatible supersets of rn-backend's
+ * current JSON wire format. The canonical pagination flag is `last` (not `isLast`).
+ */
+export type ColumnType = 'text' | 'money' | 'badge' | 'number' | 'date' | 'link' | 'custom';
+export interface ColumnDef<T = Record<string, unknown>> {
+    key: string;
+    label: string;
+    type?: ColumnType;
+    sortable?: boolean;
+    filterable?: boolean;
+    align?: 'left' | 'center' | 'right';
+    width?: number | string;
+    currency?: string;
+    badgeColorMap?: Record<string, string>;
+    actions?: TableAction<T>[];
+    /** Roles permitted to view this column. Empty/undefined = visible to all. */
+    rolesAllowed?: string[];
+}
+export interface TableAction<T = Record<string, unknown>> {
+    key: string;
+    label: string;
+    icon?: string;
+    method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    endpoint?: string | ((row: T) => string);
+    confirmText?: string;
+}
+export type FilterType = 'SELECT' | 'MULTI_SELECT' | 'FACET' | 'LOOKUP' | 'DATE_RANGE' | 'SEARCH' | 'BOOLEAN';
+export interface FilterOption {
+    label: string;
+    value: string | number | boolean | null;
+    count?: number | null;
+}
+export interface FilterDef {
+    key: string;
+    label: string;
+    type: FilterType;
+    placeholder?: string;
+    options?: FilterOption[];
+    defaultValue?: unknown;
+    /** LOOKUP: registry key resolved by the host lookup service. */
+    entityKey?: string;
+    minChars?: number;
+    /** LOOKUP / MULTI_SELECT. */
+    multiple?: boolean;
+    /** FACET: facet key resolved when options are empty. */
+    facetKey?: string;
+    /** Column this filter binds to. */
+    columnKey?: string;
+    /** Roles permitted to see/interact with this dimension. */
+    rolesAllowed?: string[];
+    /** Cascading parent filter key. */
+    dependsOn?: string;
+    /** Remote endpoint for dynamic options (executed by the host fetcher). */
+    optionsEndpoint?: string;
+}
+export interface DataTableResponse<T> {
+    content: T[];
+    totalElements: number;
+    totalPages: number;
+    pageNumber: number;
+    pageSize: number;
+    /** Wire field is `last` (matches rn-backend), never `isLast`. */
+    last: boolean;
+    columns: ColumnDef<T>[];
+    filters: FilterDef[];
+    sortBy?: string;
+    sortDir?: 'asc' | 'desc' | 'ASC' | 'DESC';
+    summary?: Record<string, unknown>;
+    stages?: KanbanStageDef[];
+    enableLiveReload?: boolean;
+    defaultLiveReload?: number;
+    enableExport?: boolean;
+    enableColumnVisibility?: boolean;
+}
+export interface DataTableRequest {
+    page?: number;
+    size?: number;
+    sortBy?: string;
+    sortDir?: 'ASC' | 'DESC';
+    search?: string;
+    filters?: Record<string, unknown>;
+}
+export interface NavigationItem {
+    id: string;
+    code: string;
+    label: string;
+    route: string;
+    icon?: string;
+    order: number;
+    parentId?: string | null;
+    type?: 'LINK' | 'GROUP' | 'DIVIDER';
+    visible?: boolean;
+    requiredRoles?: string[];
+    exactMatch?: boolean;
+    group?: string;
+    children?: NavigationItem[];
+}
+export interface PlatformFilter {
+    key: string;
+    label: string;
+    type: FilterType;
+    options?: FilterOption[];
+    defaultValue?: unknown;
+    entityKey?: string;
+    multiple?: boolean;
+}
+export type TableViewMode = 'table' | 'kanban' | 'cards' | 'list';
+export interface KanbanStageDef {
+    key: string;
+    label: string;
+    color?: string;
+    textColor?: string;
+    borderColor?: string;
+    statuses?: string[];
+}
+export interface StageTransitionOption {
+    id: string;
+    name: string;
+    code: string;
+    requiresOtp?: boolean;
+    primary?: boolean;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/contracts.d.ts.map

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

package/dist/contracts.js

@@ -0,0 +1,6 @@
+/**
+ * Universal SDUI contracts. These are field-compatible supersets of rn-backend's
+ * current JSON wire format. The canonical pagination flag is `last` (not `isLast`).
+ */
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './contracts.js';
+export * from './moveNode.js';
+export * from './buildNavTree.js';
+export * from './roles.js';
+export * from './useTreeDragDrop.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from './contracts.js';
+export * from './moveNode.js';
+export * from './buildNavTree.js';
+export * from './roles.js';
+export * from './useTreeDragDrop.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC"}

package/dist/moveNode.d.ts

@@ -0,0 +1,15 @@
+import type { NavigationItem } from './contracts.js';
+export interface NodeDelta {
+    id: string;
+    parentId: string | null;
+    order: number;
+}
+/**
+ * Pure, framework-free reorder: moves `draggedId` relative to `targetId` and returns
+ * both the new tree and the deltas the host should persist. Contains no network I/O.
+ */
+export declare function moveNode(roots: NavigationItem[], draggedId: string, targetId: string, placement: 'before' | 'after' | 'inside'): {
+    tree: NavigationItem[];
+    deltas: NodeDelta[];
+};
+//# sourceMappingURL=moveNode.d.ts.map

package/dist/moveNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moveNode.d.ts","sourceRoot":"","sources":["../src/moveNode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,cAAc,EAAE,EACvB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GACvC;IAAE,IAAI,EAAE,cAAc,EAAE,CAAC;IAAC,MAAM,EAAE,SAAS,EAAE,CAAA;CAAE,CA+CjD"}

package/dist/moveNode.js

@@ -0,0 +1,52 @@
+/**
+ * Pure, framework-free reorder: moves `draggedId` relative to `targetId` and returns
+ * both the new tree and the deltas the host should persist. Contains no network I/O.
+ */
+export function moveNode(roots, draggedId, targetId, placement) {
+    const deltas = [];
+    const clone = (nodes) => nodes.map((n) => ({ ...n, children: n.children ? clone(n.children) : undefined }));
+    const detach = (nodes, id) => {
+        for (let i = 0; i < nodes.length; i++) {
+            if (nodes[i].id === id)
+                return nodes.splice(i, 1)[0];
+            const found = nodes[i].children ? detach(nodes[i].children, id) : null;
+            if (found)
+                return found;
+        }
+        return null;
+    };
+    const next = clone(roots);
+    const dragged = detach(next, draggedId);
+    if (!dragged || draggedId === targetId)
+        return { tree: roots, deltas: [] };
+    const insertInto = (nodes) => {
+        for (const node of nodes) {
+            if (node.id === targetId) {
+                node.children = node.children ?? [];
+                if (placement === 'inside') {
+                    node.children.push(dragged);
+                }
+                else {
+                    const idx = placement === 'before' ? 0 : node.children.length;
+                    node.children.splice(idx, 0, dragged);
+                }
+                return true;
+            }
+            if (node.children && insertInto(node.children))
+                return true;
+        }
+        return false;
+    };
+    if (!insertInto(next))
+        return { tree: roots, deltas: [] };
+    const walk = (nodes, parentId) => {
+        nodes.forEach((n, i) => {
+            deltas.push({ id: n.id, parentId, order: i });
+            if (n.children?.length)
+                walk(n.children, n.id);
+        });
+    };
+    walk(next, null);
+    return { tree: next, deltas };
+}
+//# sourceMappingURL=moveNode.js.map

package/dist/moveNode.js.map

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

package/dist/roles.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Role-aware visibility helpers. These are the glue between the auth-service token
+ * roles/permissions and what a project's UI shows.
+ */
+/** True when `rolesAllowed` is empty/undefined, or the user holds one of them. */
+export declare function isVisibleForRoles(rolesAllowed: string[] | undefined, userRoles: string[]): boolean;
+/**
+ * Recursively filters a navigation tree to items the user may see. A group with no
+ * visible children is itself dropped.
+ */
+export declare function filterNavByRoles<T extends {
+    requiredRoles?: string[];
+    children?: T[];
+}>(items: T[], userRoles: string[]): T[];
+//# sourceMappingURL=roles.d.ts.map

package/dist/roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../src/roles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAGlG;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS;IAAE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAA;CAAE,EACrF,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,MAAM,EAAE,GAClB,CAAC,EAAE,CASL"}

package/dist/roles.js

@@ -0,0 +1,27 @@
+/**
+ * Role-aware visibility helpers. These are the glue between the auth-service token
+ * roles/permissions and what a project's UI shows.
+ */
+/** True when `rolesAllowed` is empty/undefined, or the user holds one of them. */
+export function isVisibleForRoles(rolesAllowed, userRoles) {
+    if (!rolesAllowed || rolesAllowed.length === 0)
+        return true;
+    return rolesAllowed.some((role) => userRoles.includes(role));
+}
+/**
+ * Recursively filters a navigation tree to items the user may see. A group with no
+ * visible children is itself dropped.
+ */
+export function filterNavByRoles(items, userRoles) {
+    const result = [];
+    for (const item of items) {
+        if (!isVisibleForRoles(item.requiredRoles, userRoles))
+            continue;
+        const children = item.children ? filterNavByRoles(item.children, userRoles) : undefined;
+        if (item.children && item.children.length > 0 && (!children || children.length === 0))
+            continue;
+        result.push(children ? { ...item, children } : { ...item });
+    }
+    return result;
+}
+//# sourceMappingURL=roles.js.map

package/dist/roles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.js","sourceRoot":"","sources":["../src/roles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kFAAkF;AAClF,MAAM,UAAU,iBAAiB,CAAC,YAAkC,EAAE,SAAmB;IACvF,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5D,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAU,EACV,SAAmB;IAEnB,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC;YAAE,SAAS;QAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACxF,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC;YAAE,SAAS;QAChG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/useTreeDragDrop.d.ts

@@ -0,0 +1,20 @@
+import type { NavigationItem } from './contracts.js';
+import { type NodeDelta } from './moveNode.js';
+export type DropPlacement = 'before' | 'after' | 'inside';
+/**
+ * Headless drag-and-drop state for a navigation tree. Performs no network I/O: the
+ * host receives deltas via the callback passed to `onDrop`.
+ */
+export declare function useTreeDragDrop(initialItems: NavigationItem[]): {
+    items: NavigationItem[];
+    draggedId: string | null;
+    dropTarget: {
+        id: string;
+        placement: "before" | "after" | "inside";
+    } | null;
+    onDragStart: (id: string) => void;
+    onDragOver: (targetId: string, ratio: number, isGroup: boolean) => void;
+    onDrop: (onCommitDeltas: (deltas: NodeDelta[]) => void) => void;
+    setItems: import("react").Dispatch<import("react").SetStateAction<NavigationItem[]>>;
+};
+//# sourceMappingURL=useTreeDragDrop.d.ts.map

package/dist/useTreeDragDrop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTreeDragDrop.d.ts","sourceRoot":"","sources":["../src/useTreeDragDrop.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAEzD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,cAAc,EAAE;;;;YAGT,MAAM;mBAAa,QAAQ,GAAG,OAAO,GAAG,QAAQ;;sBAI9D,MAAM;2BAG9B,MAAM,SAAS,MAAM,WAAW,OAAO;6BASjC,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,IAAI;;EAYjD"}

package/dist/useTreeDragDrop.js

@@ -0,0 +1,31 @@
+import { useState, useCallback } from 'react';
+import { moveNode } from './moveNode.js';
+/**
+ * Headless drag-and-drop state for a navigation tree. Performs no network I/O: the
+ * host receives deltas via the callback passed to `onDrop`.
+ */
+export function useTreeDragDrop(initialItems) {
+    const [items, setItems] = useState(initialItems);
+    const [draggedId, setDraggedId] = useState(null);
+    const [dropTarget, setDropTarget] = useState(null);
+    const onDragStart = useCallback((id) => setDraggedId(id), []);
+    const onDragOver = useCallback((targetId, ratio, isGroup) => {
+        if (isGroup && ratio >= 0.3 && ratio <= 0.7)
+            setDropTarget({ id: targetId, placement: 'inside' });
+        else if (ratio < 0.5)
+            setDropTarget({ id: targetId, placement: 'before' });
+        else
+            setDropTarget({ id: targetId, placement: 'after' });
+    }, []);
+    const onDrop = useCallback((onCommitDeltas) => {
+        if (!draggedId || !dropTarget)
+            return;
+        const { tree, deltas } = moveNode(items, draggedId, dropTarget.id, dropTarget.placement);
+        setItems(tree);
+        setDraggedId(null);
+        setDropTarget(null);
+        onCommitDeltas(deltas); // host persists deltas; package performs no network I/O
+    }, [items, draggedId, dropTarget]);
+    return { items, draggedId, dropTarget, onDragStart, onDragOver, onDrop, setItems };
+}
+//# sourceMappingURL=useTreeDragDrop.js.map

package/dist/useTreeDragDrop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTreeDragDrop.js","sourceRoot":"","sources":["../src/useTreeDragDrop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAE9C,OAAO,EAAE,QAAQ,EAAkB,MAAM,eAAe,CAAC;AAIzD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,YAA8B;IAC5D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAmB,YAAY,CAAC,CAAC;IACnE,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAChE,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAC1C,IAAI,CACL,CAAC;IAEF,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAEtE,MAAM,UAAU,GAAG,WAAW,CAC5B,CAAC,QAAgB,EAAE,KAAa,EAAE,OAAgB,EAAE,EAAE;QACpD,IAAI,OAAO,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG;YAAE,aAAa,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;aAC7F,IAAI,KAAK,GAAG,GAAG;YAAE,aAAa,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;;YACtE,aAAa,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC,EACD,EAAE,CACH,CAAC;IAEF,MAAM,MAAM,GAAG,WAAW,CACxB,CAAC,cAA6C,EAAE,EAAE;QAChD,IAAI,CAAC,SAAS,IAAI,CAAC,UAAU;YAAE,OAAO;QACtC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;QACzF,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,wDAAwD;IAClF,CAAC,EACD,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,CAC/B,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACrF,CAAC"}

package/package.json

@@ -1,6 +1,33 @@
 {
   "name": "@issonujha/sdui-core",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Universal SDUI contracts, tree/reorder algorithms and headless hooks (zero UI, zero network).",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "peerDependencies": {
+    "react": ">=17"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.3",
+    "typescript": "^5.5.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "echo \"no tests yet\" && exit 0"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.