@mapomodule/utils 1.0.0 → 2.0.0-beta.1

package/dist/menuHelpers.js

@@ -0,0 +1,56 @@
+/** Return the maximum nesting depth of a MenuNode tree (root = depth 1). */
+export function calcMaxMenuNestDepth(nodes, depth = 1) {
+    if (!nodes.length)
+        return depth - 1;
+    let max = depth;
+    for (const node of nodes) {
+        if (node.children.length) {
+            const child = calcMaxMenuNestDepth(node.children, depth + 1);
+            if (child > max)
+                max = child;
+        }
+    }
+    return max;
+}
+/**
+ * Builds a hierarchical menu tree from flat route records.
+ *
+ * Routes are included only when they define a `meta.label` and are not marked
+ * as hidden. Parent-child relationships are resolved through `meta.parent`.
+ *
+ * @param routes Flat list of normalized router records.
+ * @returns Root menu nodes with nested children.
+ */
+export function buildRouteTree(routes) {
+    const nodeMap = new Map();
+    for (const route of routes) {
+        const { label, icon, hidden, sidebarFooter } = route.meta ?? {};
+        if (!label || hidden)
+            continue;
+        nodeMap.set(route.path, {
+            link: route.path,
+            label,
+            icon: icon ?? "i-lucide-circle-dot",
+            children: [],
+            meta: route.meta ?? {},
+            sidebarFooter: Boolean(sidebarFooter),
+        });
+    }
+    const roots = [];
+    for (const route of routes) {
+        const { label, hidden, parent } = route.meta ?? {};
+        if (!label || hidden)
+            continue;
+        const node = nodeMap.get(route.path);
+        if (parent) {
+            const parentKey = String(parent).startsWith("/") ? parent : `/${parent}`;
+            if (nodeMap.has(parentKey)) {
+                nodeMap.get(parentKey).children.push(node);
+                continue;
+            }
+        }
+        roots.push(node);
+    }
+    return roots;
+}
+//# sourceMappingURL=menuHelpers.js.map

package/dist/menuHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menuHelpers.js","sourceRoot":"","sources":["../src/menuHelpers.ts"],"names":[],"mappings":"AAWA,4EAA4E;AAC5E,MAAM,UAAU,oBAAoB,CAAC,KAAiB,EAAE,KAAK,GAAG,CAAC;IAC/D,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,KAAK,GAAG,CAAC,CAAC;IACpC,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YAC7D,IAAI,KAAK,GAAG,GAAG;gBAAE,GAAG,GAAG,KAAK,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,MAA+B;IAC5D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE5C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;QAChE,IAAI,CAAC,KAAK,IAAI,MAAM;YAAE,SAAS;QAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK;YACL,IAAI,EAAE,IAAI,IAAI,qBAAqB;YACnC,QAAQ,EAAE,EAAE;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;YACtB,aAAa,EAAE,OAAO,CAAC,aAAa,CAAC;SACtC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;QACnD,IAAI,CAAC,KAAK,IAAI,MAAM;YAAE,SAAS;QAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAE,CAAC;QACtC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC;YACzE,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3B,OAAO,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC5C,SAAS;YACX,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/nestedValue.js

@@ -0,0 +1,53 @@
+/**
+ * Reads a value from an object using a dot-notation path.
+ *
+ * @param obj Source object to traverse.
+ * @param path Dot-notation path (for example, `"user.profile.name"`).
+ * @returns The nested value, or `undefined` when the path cannot be fully resolved.
+ */
+export function getNestedValue(obj, path) {
+    return path.split(".").reduce((current, key) => {
+        if (current == null || typeof current !== "object")
+            return undefined;
+        return current[key];
+    }, obj);
+}
+/**
+ * In-place version for Vue reactive proxies. Mutates obj directly so Vue's
+ * reactivity system tracks the change. Creates missing intermediate objects.
+ */
+export function setNestedValueMutating(obj, path, value) {
+    const keys = path.split(".");
+    let current = obj;
+    for (let i = 0; i < keys.length - 1; i++) {
+        const key = keys[i];
+        if (current[key] == null || typeof current[key] !== "object") {
+            current[key] = {};
+        }
+        current = current[key];
+    }
+    current[keys[keys.length - 1]] = value;
+}
+/**
+ * Returns a new object with `value` assigned at the given dot-notation path.
+ *
+ * Existing nested objects along the path are shallow-cloned to preserve immutability.
+ *
+ * @param obj Source object.
+ * @param path Dot-notation path where the value should be set.
+ * @param value Value to assign at the target path.
+ * @returns A new object with the updated nested value.
+ */
+export function setNestedValue(obj, path, value) {
+    const keys = path.split(".");
+    const result = { ...obj };
+    let current = result;
+    for (let i = 0; i < keys.length - 1; i++) {
+        const key = keys[i];
+        current[key] = { ...current[key] };
+        current = current[key];
+    }
+    current[keys[keys.length - 1]] = value;
+    return result;
+}
+//# sourceMappingURL=nestedValue.js.map

package/dist/nestedValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nestedValue.js","sourceRoot":"","sources":["../src/nestedValue.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY,EAAE,IAAY;IACvD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;QAC7C,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACrE,OAAQ,OAAmC,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC,EAAE,GAAG,CAAC,CAAC;AACV,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,GAA4B,EAC5B,IAAY,EACZ,KAAc;IAEd,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,OAAO,GAA4B,GAAG,CAAC;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC7D,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACpB,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,GAAG,CAA4B,CAAC;IACpD,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AACzC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAM,EACN,IAAY,EACZ,KAAc;IAEd,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,EAAE,GAAG,GAAG,EAA6B,CAAC;IACrD,IAAI,OAAO,GAAG,MAAM,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAI,OAAO,CAAC,GAAG,CAA6B,EAAE,CAAC;QAChE,OAAO,GAAG,OAAO,CAAC,GAAG,CAA4B,CAAC;IACpD,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;IACvC,OAAO,MAAW,CAAC;AACrB,CAAC"}

package/dist/normalizeEndpoint.js

@@ -0,0 +1,39 @@
+/**
+ * Ensures an API endpoint path has exactly one leading and one trailing slash.
+ * Query strings are preserved unchanged — the slash is inserted before the `?`.
+ * Used by `useCrud` to normalize user-provided endpoint paths before making requests.
+ *
+ * @example
+ * normalizeEndpoint('api/articles')          // '/api/articles/'
+ * normalizeEndpoint('/api/articles')         // '/api/articles/'
+ * normalizeEndpoint('/api/articles/')        // '/api/articles/'
+ * normalizeEndpoint('/api/articles/?q=1')    // '/api/articles/?q=1'
+ */
+export function normalizeEndpoint(endpoint) {
+    const qIdx = endpoint.indexOf("?");
+    const path = qIdx >= 0 ? endpoint.slice(0, qIdx) : endpoint;
+    const query = qIdx >= 0 ? endpoint.slice(qIdx) : "";
+    const stripped = path.replace(/^\/+|\/+$/g, "");
+    return `/${stripped}/${query}`;
+}
+/**
+ * Splits an endpoint string into its clean path and parsed query params.
+ * Useful when an endpoint carries baked-in params (e.g. `?fields=id,title`) that
+ * must be merged into request params while CRUD mutations target the bare path.
+ *
+ * @example
+ * splitEndpointParams('/api/articles/?fields=id,title')
+ *  { path: '/api/articles/', params: { fields: 'id,title' } }
+ * splitEndpointParams('/api/articles/')
+ *  { path: '/api/articles/', params: {} }
+ */
+export function splitEndpointParams(endpoint) {
+    const qIdx = endpoint.indexOf("?");
+    if (qIdx < 0)
+        return { path: endpoint, params: {} };
+    return {
+        path: endpoint.slice(0, qIdx),
+        params: Object.fromEntries(new URLSearchParams(endpoint.slice(qIdx + 1))),
+    };
+}
+//# sourceMappingURL=normalizeEndpoint.js.map

package/dist/normalizeEndpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeEndpoint.js","sourceRoot":"","sources":["../src/normalizeEndpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC5D,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAChD,OAAO,IAAI,QAAQ,IAAI,KAAK,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAIlD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACpD,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;QAC7B,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;KAC1E,CAAC;AACJ,CAAC"}

package/dist/objectDiff.js

@@ -0,0 +1,58 @@
+/**
+ * Returns true when `val` is a non-null plain object (excluding arrays).
+ */
+function isPlainObject(val) {
+    return typeof val === "object" && val !== null && !Array.isArray(val);
+}
+/**
+ * Deeply compares two arrays, including nested arrays and plain objects.
+ */
+function arraysDeepEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    return a.every((item, i) => {
+        const bItem = b[i];
+        if (Array.isArray(item) && Array.isArray(bItem))
+            return arraysDeepEqual(item, bItem);
+        if (isPlainObject(item) && isPlainObject(bItem))
+            return Object.keys(objectDiff(item, bItem)).length === 0;
+        return Object.is(item, bItem);
+    });
+}
+/**
+ * Computes a deep diff between two objects and returns only changed fields.
+ *
+ * Nested objects are diffed recursively. Arrays are compared deeply and, when changed,
+ * are returned as the full current array value.
+ *
+ * @param base Base object used as the comparison reference.
+ * @param current Current object to compare against `base`.
+ * @returns A partial object containing only keys whose values differ from `base`.
+ */
+export function objectDiff(base, current) {
+    const diff = {};
+    const allKeys = new Set([
+        ...Object.keys(base),
+        ...Object.keys(current),
+    ]);
+    for (const key of allKeys) {
+        const baseVal = base[key];
+        const currentVal = current[key];
+        if (isPlainObject(baseVal) && isPlainObject(currentVal)) {
+            const nested = objectDiff(baseVal, currentVal);
+            if (Object.keys(nested).length > 0) {
+                diff[key] = nested;
+            }
+        }
+        else if (Array.isArray(baseVal) && Array.isArray(currentVal)) {
+            if (!arraysDeepEqual(baseVal, currentVal)) {
+                diff[key] = currentVal;
+            }
+        }
+        else if (!Object.is(baseVal, currentVal)) {
+            diff[key] = currentVal;
+        }
+    }
+    return diff;
+}
+//# sourceMappingURL=objectDiff.js.map

package/dist/objectDiff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectDiff.js","sourceRoot":"","sources":["../src/objectDiff.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,SAAS,aAAa,CAAC,GAAY;IACjC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,CAAY,EAAE,CAAY;IACjD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QACzB,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAC7C,OAAO,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACtC,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC;YAC7C,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;QAC3D,OAAO,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAmB,IAAO,EAAE,OAAU;IAC9D,MAAM,IAAI,GAAe,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC;QACtB,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QACpB,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;KACxB,CAAiB,CAAC;IAEnB,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAI,IAAgC,CAAC,GAAa,CAAC,CAAC;QACjE,MAAM,UAAU,GAAI,OAAmC,CAAC,GAAa,CAAC,CAAC;QACvE,IAAI,aAAa,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;YACxD,MAAM,MAAM,GAAG,UAAU,CACvB,OAAkC,EAClC,UAAqC,CACtC,CAAC;YACF,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAoB,CAAC;YACnC,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/D,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;gBAC1C,IAAI,CAAC,GAAG,CAAC,GAAG,UAAwB,CAAC;YACvC,CAAC;QACH,CAAC;aAAM,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,GAAG,CAAC,GAAG,UAAwB,CAAC;QACvC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/objectHelpers.js

@@ -0,0 +1,93 @@
+const VUE_RAW_FLAG = "__v_raw";
+function unwrapVueRaw(value) {
+    if (value === null || typeof value !== "object")
+        return value;
+    const maybeRaw = value[VUE_RAW_FLAG];
+    if (maybeRaw && maybeRaw !== value) {
+        return unwrapVueRaw(maybeRaw);
+    }
+    return value;
+}
+/**
+ * Deep-clones a value and returns a detached copy.
+ *
+ * The function first unwraps Vue reactive proxies (when present), then:
+ * - uses `structuredClone` when available
+ * - falls back to recursive cloning for plain objects/arrays
+ *
+ * The recursive fallback does not support circular references.
+ */
+export function deepClone(value) {
+    const raw = unwrapVueRaw(value);
+    if (raw === null || typeof raw !== "object")
+        return raw;
+    if (typeof globalThis !== "undefined" && "structuredClone" in globalThis) {
+        try {
+            return structuredClone(raw);
+        }
+        catch {
+            // Fall through to recursive clone.
+        }
+    }
+    if (Array.isArray(raw))
+        return raw.map(deepClone);
+    const result = {};
+    for (const key of Object.keys(raw)) {
+        result[key] = deepClone(raw[key]);
+    }
+    return result;
+}
+/**
+ * Type guard that returns true when `value` is a browser `File`.
+ */
+export function isFile(value) {
+    return typeof File !== "undefined" && value instanceof File;
+}
+/**
+ * Type guard that returns true when `value` is a browser `Blob`.
+ */
+export function isBlob(value) {
+    return typeof Blob !== "undefined" && value instanceof Blob;
+}
+/**
+ * Type guard that returns true when `value` is either a `File` or a `Blob`.
+ */
+export function isFileOrBlob(value) {
+    return isFile(value) || isBlob(value);
+}
+/**
+ * Return all dot-notation paths in `obj` where the predicate is truthy.
+ */
+export function findPropPaths(obj, predicate, _prefix = "") {
+    if (obj === null || typeof obj !== "object")
+        return [];
+    const paths = [];
+    for (const key of Object.keys(obj)) {
+        const path = _prefix ? `${_prefix}.${key}` : key;
+        const val = obj[key];
+        if (predicate(val)) {
+            paths.push(path);
+        }
+        else if (val !== null && typeof val === "object") {
+            paths.push(...findPropPaths(val, predicate, path));
+        }
+    }
+    return paths;
+}
+/** Return all paths in `obj` that hold a File or Blob. */
+export function filesInObject(obj) {
+    return findPropPaths(obj, isFileOrBlob);
+}
+/**
+ * Return a shallow copy of `obj` containing only the listed top-level keys.
+ */
+export function filterObj(obj, keys) {
+    const result = {};
+    for (const key of keys) {
+        if (Object.prototype.hasOwnProperty.call(obj, key)) {
+            result[key] = obj[key];
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=objectHelpers.js.map

package/dist/objectHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectHelpers.js","sourceRoot":"","sources":["../src/objectHelpers.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,SAAS,CAAC;AAE/B,SAAS,YAAY,CAAI,KAAQ;IAC/B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,QAAQ,GAAI,KAAiC,CAAC,YAAY,CAAC,CAAC;IAClE,IAAI,QAAQ,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QACnC,OAAO,YAAY,CAAC,QAAa,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAI,KAAQ;IACnC,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IAExD,IAAI,OAAO,UAAU,KAAK,WAAW,IAAI,iBAAiB,IAAI,UAAU,EAAE,CAAC;QACzE,IAAI,CAAC;YACH,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,mCAAmC;QACrC,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC,SAAS,CAAiB,CAAC;IAClE,MAAM,MAAM,GAAG,EAA6B,CAAC;IAC7C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAa,CAAC,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAE,GAA+B,CAAC,GAAG,CAAC,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,MAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,OAAO,IAAI,KAAK,WAAW,IAAI,KAAK,YAAY,IAAI,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,OAAO,IAAI,KAAK,WAAW,IAAI,KAAK,YAAY,IAAI,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAY,EACZ,SAAoC,EACpC,OAAO,GAAG,EAAE;IAEZ,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACvD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAa,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QACjD,MAAM,GAAG,GAAI,GAA+B,CAAC,GAAG,CAAC,CAAC;QAClD,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;aAAM,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACnD,KAAK,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO,aAAa,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,GAAM,EACN,IAAiB;IAEjB,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;YACnD,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/slotNamespace.js

@@ -0,0 +1,15 @@
+/**
+ * Creates a namespaced view of slots, including only those that start with the given prefix.
+ *
+ * Filtered slot names are normalized by removing the prefix from the slot key.
+ *
+ * @param slots Source Vue slots object.
+ * @param prefix Prefix used to select which slots to include.
+ * @returns A new `Slots` object containing only prefixed slots, renamed without the prefix.
+ */
+export function slotNamespace(slots, prefix) {
+    return Object.fromEntries(Object.entries(slots)
+        .filter(([name]) => name.startsWith(prefix))
+        .map(([name, fn]) => [name.slice(prefix.length), fn]));
+}
+//# sourceMappingURL=slotNamespace.js.map

package/dist/slotNamespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slotNamespace.js","sourceRoot":"","sources":["../src/slotNamespace.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,KAAY,EAAE,MAAc;IACxD,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;SAClB,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;SAC3C,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAC/C,CAAC;AACb,CAAC"}

package/dist/types/debounce.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Creates a debounced wrapper that delays invocation until calls stop for `ms` milliseconds.
+ *
+ * Each new call clears the pending timer, so only the last call in a burst is executed.
+ *
+ * @param fn Function to debounce.
+ * @param ms Debounce delay in milliseconds.
+ * @returns A debounced function with the same argument signature as `fn`.
+ */
+export declare function debounce<A extends unknown[]>(fn: (...args: A) => unknown, ms: number): (...args: A) => void;
+//# sourceMappingURL=debounce.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../src/debounce.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,EAC1C,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,EAC3B,EAAE,EAAE,MAAM,GACT,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,CAQtB"}

package/dist/types/deepMerge.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Deeply merges `override` into `base` and returns a new object.
+ *
+ * Nested plain objects are merged recursively, while other values replace
+ * the corresponding base value when the override value is not `undefined`.
+ *
+ * @param base Base object.
+ * @param override Partial object with values that should override `base`.
+ * @returns A new object containing the merged result.
+ */
+export declare function deepMerge<T extends Record<string, unknown>>(base: T, override: Partial<T>): T;
+//# sourceMappingURL=deepMerge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deepMerge.d.ts","sourceRoot":"","sources":["../../src/deepMerge.ts"],"names":[],"mappings":"AAOA;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,GACnB,CAAC,CAeH"}

package/dist/types/formatDate.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Formats a date using a token-based pattern.
+ *
+ * Supported tokens: `YYYY`, `MM`, `DD`, `HH`, `mm`, `ss`.
+ *
+ * @param date Date value as a `Date` instance or parseable date string.
+ * @param format Output format pattern. Defaults to `"YYYY-MM-DD"`.
+ * @returns Formatted date string, or an empty string if the input date is invalid.
+ */
+export declare function formatDate(date: string | Date, format?: string): string;
+//# sourceMappingURL=formatDate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatDate.d.ts","sourceRoot":"","sources":["../../src/formatDate.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,SAAe,GAAG,MAAM,CAW7E"}

package/dist/types/index.d.ts

@@ -0,0 +1,13 @@
+export { deepMerge } from "./deepMerge.js";
+export { deepClone, isFile, isBlob, isFileOrBlob, findPropPaths, filesInObject, filterObj, } from "./objectHelpers.js";
+export { getNestedValue, setNestedValue, setNestedValueMutating, } from "./nestedValue.js";
+export { objectDiff } from "./objectDiff.js";
+export { formatDate } from "./formatDate.js";
+export { debounce } from "./debounce.js";
+export { slotNamespace } from "./slotNamespace.js";
+export { buildRouteTree, calcMaxMenuNestDepth } from "./menuHelpers.js";
+export type { MenuNode } from "./menuHelpers.js";
+export { normalizeEndpoint, splitEndpointParams } from "./normalizeEndpoint.js";
+export type { JSONSchema } from "./jsonSchema/index.js";
+export { matchesSchema, applyConditionals, hasConditionals, resolveSchema, extractDefs, getDefaultForSchema, } from "./jsonSchema/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EACL,SAAS,EACT,MAAM,EACN,MAAM,EACN,YAAY,EACZ,aAAa,EACb,aAAa,EACb,SAAS,GACV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,cAAc,EACd,cAAc,EACd,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxE,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAChF,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,WAAW,EACX,mBAAmB,GACpB,MAAM,uBAAuB,CAAC"}

package/dist/types/jsonSchema/conditionals.d.ts

@@ -0,0 +1,40 @@
+import type { JSONSchema } from "./types.js";
+/**
+ * Evaluates whether `value` satisfies all constraints in `schema`.
+ * Handles `required`, `properties`, `not`, `allOf`, `anyOf`, `oneOf`,
+ * `dependentRequired`, and nested `if/then/else` rules.
+ *
+ * @param value  - The data value to validate.
+ * @param schema - The JSON Schema node to validate against.
+ * @returns `true` if the value conforms to the schema.
+ */
+export declare function matchesSchema(value: unknown, schema: JSONSchema): boolean;
+/**
+ * Evaluates all conditional keywords in `schema` against `value` and returns
+ * an effective schema with the appropriate branches merged in.
+ *
+ * Supported conditional keywords:
+ * - `if / then / else` (top-level and inside `allOf`)
+ * - `dependentSchemas` / `dependentRequired`
+ *
+ * Iteration is repeated up to {@link MAX_CONDITIONAL_PASSES} times to handle cascading
+ * conditionals where a merged branch introduces new `if` rules. Stops early when the
+ * schema stabilises between iterations.
+ *
+ * @param schema   - The base schema to evaluate.
+ * @param value    - The current form data used to resolve conditionals.
+ * @param resolver - Optional function to resolve `$ref` pointers inside branches.
+ * @returns A new schema with all applicable branches merged.
+ */
+export declare function applyConditionals(schema: JSONSchema, value: unknown, resolver?: (s: JSONSchema) => JSONSchema): JSONSchema;
+/**
+ * Returns `true` if the schema contains any conditional keywords that could
+ * affect the visible set of properties at runtime.
+ *
+ * Checked keywords: `if`, `dependentSchemas`, `dependentRequired`, and
+ * any `if` entries nested inside `allOf`.
+ *
+ * @param schema - The schema to inspect.
+ */
+export declare function hasConditionals(schema: JSONSchema): boolean;
+//# sourceMappingURL=conditionals.d.ts.map

package/dist/types/jsonSchema/conditionals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditionals.d.ts","sourceRoot":"","sources":["../../../src/jsonSchema/conditionals.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA+F7C;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAuCzE;AAoFD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,UAAU,GACvC,UAAU,CAiGZ;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAU3D"}

package/dist/types/jsonSchema/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * JSON Schema utilities for the Mapo form engine.
+ *
+ * - {@link JSONSchema}         — shared type definition
+ * - {@link matchesSchema}      — validate a value against a schema node
+ * - {@link applyConditionals}  — resolve `if/then/else` and dependent keywords
+ * - {@link hasConditionals}    — check whether a schema has runtime conditionals
+ * - {@link resolveSchema}      — dereference `$ref`, `anyOf`, `oneOf`
+ * - {@link extractDefs}        — extract the `$defs` / `definitions` map
+ * - {@link getDefaultForSchema} — derive a zero/empty default value from a schema
+ */
+export type { JSONSchema } from "./types.js";
+export { matchesSchema, applyConditionals, hasConditionals, } from "./conditionals.js";
+export { resolveSchema, extractDefs, getDefaultForSchema } from "./resolve.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/jsonSchema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/jsonSchema/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/types/jsonSchema/resolve.d.ts

@@ -0,0 +1,41 @@
+import type { JSONSchema } from "./types.js";
+/**
+ * Recursively resolves a JSON Schema by following `$ref`, `anyOf`, and `oneOf` pointers.
+ *
+ * - `$ref` is dereferenced against the provided `defs` map.
+ * - `anyOf` / `oneOf` with a single non-null branch is unwrapped; nullable schemas
+ *   are marked with `_nullable: true`.
+ * - A `oneOf` paired with a `discriminator` is returned as-is (handled by union editors).
+ *
+ * @param schema - The schema node to resolve.
+ * @param defs   - Flat map of reusable definitions (`$defs` / `definitions`).
+ * @param seen   - WeakSet used to detect circular references across recursive calls.
+ * @param depth  - Current recursion depth; capped at {@link MAX_RESOLVE_DEPTH}.
+ * @returns The fully resolved schema node.
+ */
+export declare function resolveSchema(schema: JSONSchema, defs: Record<string, JSONSchema>, seen?: WeakSet<JSONSchema>, depth?: number): JSONSchema;
+/**
+ * Extracts the reusable definitions map from a root JSON Schema.
+ * Supports both the modern `$defs` keyword and the legacy `definitions` keyword.
+ *
+ * @param schema - The root schema object.
+ * @returns A flat record of named sub-schemas.
+ */
+export declare function extractDefs(schema: JSONSchema): Record<string, JSONSchema>;
+/**
+ * Derives a sensible empty/zero default value for a given JSON Schema node.
+ *
+ * If the schema declares an explicit `default`, that value is deep-cloned and returned.
+ * Otherwise, a type-appropriate zero value is produced:
+ * - `object` → object with per-property defaults
+ * - `array`  → `[]`
+ * - `string` → `""`
+ * - `integer` / `number` → `0`
+ * - `boolean` → `false`
+ * - `relation` → `null` (or `[]` when `multiple: true`)
+ *
+ * @param schema - The resolved schema node.
+ * @returns The default value inferred from the schema type.
+ */
+export declare function getDefaultForSchema(schema: JSONSchema): unknown;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/types/jsonSchema/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/jsonSchema/resolve.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK7C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EAChC,IAAI,GAAE,OAAO,CAAC,UAAU,CAAiB,EACzC,KAAK,SAAI,GACR,UAAU,CA2DZ;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAE1E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAoB/D"}

package/dist/types/jsonSchema/types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Subset of the JSON Schema specification used throughout the Mapo form engine.
+ * Covers validation keywords, combination keywords, and custom extensions.
+ *
+ * This is the single source of truth for the schema shape — `conditionals.ts`,
+ * `resolve.ts`, and the public barrel all import `JSONSchema` from here.
+ */
+export interface JSONSchema {
+    type?: string | string[];
+    properties?: Record<string, JSONSchema>;
+    required?: string[];
+    items?: JSONSchema;
+    const?: unknown;
+    enum?: unknown[];
+    not?: JSONSchema;
+    allOf?: JSONSchema[];
+    anyOf?: JSONSchema[];
+    oneOf?: JSONSchema[];
+    if?: JSONSchema;
+    then?: JSONSchema;
+    else?: JSONSchema;
+    dependentSchemas?: Record<string, JSONSchema>;
+    dependentRequired?: Record<string, string[]>;
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
+    multipleOf?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    $ref?: string;
+    $defs?: Record<string, JSONSchema>;
+    definitions?: Record<string, JSONSchema>;
+    discriminator?: {
+        propertyName: string;
+    };
+    title?: string;
+    default?: unknown;
+    _nullable?: boolean;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/jsonSchema/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,EAAE,CAAC,EAAE,UAAU,CAAC;IAChB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC9C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzC,aAAa,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/types/menuHelpers.d.ts

@@ -0,0 +1,22 @@
+import type { RouteRecordNormalized, RouteMeta } from "vue-router";
+export interface MenuNode {
+    link: string;
+    label: string;
+    icon: string;
+    children: MenuNode[];
+    meta: RouteMeta;
+    sidebarFooter: boolean;
+}
+/** Return the maximum nesting depth of a MenuNode tree (root = depth 1). */
+export declare function calcMaxMenuNestDepth(nodes: MenuNode[], depth?: number): number;
+/**
+ * Builds a hierarchical menu tree from flat route records.
+ *
+ * Routes are included only when they define a `meta.label` and are not marked
+ * as hidden. Parent-child relationships are resolved through `meta.parent`.
+ *
+ * @param routes Flat list of normalized router records.
+ * @returns Root menu nodes with nested children.
+ */
+export declare function buildRouteTree(routes: RouteRecordNormalized[]): MenuNode[];
+//# sourceMappingURL=menuHelpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"menuHelpers.d.ts","sourceRoot":"","sources":["../../src/menuHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,IAAI,EAAE,SAAS,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,KAAK,SAAI,GAAG,MAAM,CAUzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,QAAQ,EAAE,CAgC1E"}

package/dist/types/nestedValue.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Reads a value from an object using a dot-notation path.
+ *
+ * @param obj Source object to traverse.
+ * @param path Dot-notation path (for example, `"user.profile.name"`).
+ * @returns The nested value, or `undefined` when the path cannot be fully resolved.
+ */
+export declare function getNestedValue(obj: unknown, path: string): unknown;
+/**
+ * In-place version for Vue reactive proxies. Mutates obj directly so Vue's
+ * reactivity system tracks the change. Creates missing intermediate objects.
+ */
+export declare function setNestedValueMutating(obj: Record<string, unknown>, path: string, value: unknown): void;
+/**
+ * Returns a new object with `value` assigned at the given dot-notation path.
+ *
+ * Existing nested objects along the path are shallow-cloned to preserve immutability.
+ *
+ * @param obj Source object.
+ * @param path Dot-notation path where the value should be set.
+ * @param value Value to assign at the target path.
+ * @returns A new object with the updated nested value.
+ */
+export declare function setNestedValue<T extends Record<string, unknown>>(obj: T, path: string, value: unknown): T;
+//# sourceMappingURL=nestedValue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nestedValue.d.ts","sourceRoot":"","sources":["../../src/nestedValue.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAKlE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,IAAI,CAWN;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,GAAG,EAAE,CAAC,EACN,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,CAAC,CAWH"}