@mapomodule/utils 1.0.0 → 2.0.0-beta.2

package/dist/jsonSchema/resolve.js

@@ -0,0 +1,133 @@
+// Cherry-picked from structured-widget-editor (MIT License, Copyright (c) 2026 bnznamco)
+// Source: https://github.com/bnznamco/structured-widget-editor/blob/main/src/SchemaForm.vue (resolveSchema method)
+// Modifications: extracted as standalone function, converted to TypeScript.
+/** Maximum recursion depth allowed when resolving nested schema references. */
+const MAX_RESOLVE_DEPTH = 32;
+/**
+ * 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 function resolveSchema(schema, defs, seen = new WeakSet(), depth = 0) {
+    if (!schema)
+        return { type: "string" };
+    // Cycle guard: self-referential schemas (e.g. nested comments, tree categories)
+    // would recurse infinitely. Return a stripped-down object node instead.
+    if (seen.has(schema) || depth > MAX_RESOLVE_DEPTH) {
+        const { $ref: _ref, anyOf: _ao, oneOf: _oo, ...rest } = schema;
+        return { type: "object", ...rest };
+    }
+    seen.add(schema);
+    if (schema.$ref) {
+        const refPath = schema.$ref
+            .replace(/^#\/\$defs\//, "")
+            .replace(/^#\/definitions\//, "");
+        const resolved = defs[refPath];
+        if (!resolved)
+            return { type: "string", title: refPath };
+        const { $ref: _ref, ...rest } = schema;
+        return { ...resolveSchema(resolved, defs, seen, depth + 1), ...rest };
+    }
+    if (schema.anyOf) {
+        const nonNull = schema.anyOf.filter((s) => s.type !== "null");
+        const hasNull = schema.anyOf.some((s) => s.type === "null");
+        if (hasNull && nonNull.length === 1) {
+            // Optional field pattern: `anyOf: [T, null]` → unwrap T, mark nullable
+            const resolved = resolveSchema(nonNull[0], defs, seen, depth + 1);
+            return {
+                ...resolved,
+                _nullable: true,
+                title: schema.title ?? resolved.title,
+                default: "default" in schema ? schema.default : null,
+            };
+        }
+        if (nonNull.length >= 1)
+            return resolveSchema(nonNull[0], defs, seen, depth + 1);
+    }
+    // oneOf + discriminator → pass through as-is (handled by UnionEditor / MapoRepeater templates)
+    if (schema.oneOf && schema.discriminator)
+        return schema;
+    if (schema.oneOf) {
+        const nonNull = schema.oneOf.filter((s) => s.type !== "null");
+        const hasNull = schema.oneOf.some((s) => s.type === "null");
+        if (hasNull && nonNull.length === 1) {
+            // Optional field pattern: `oneOf: [T, null]` → unwrap T, mark nullable
+            const resolved = resolveSchema(nonNull[0], defs, seen, depth + 1);
+            return {
+                ...resolved,
+                _nullable: true,
+                title: schema.title ?? resolved.title,
+                default: "default" in schema ? schema.default : null,
+            };
+        }
+        if (nonNull.length >= 1)
+            return resolveSchema(nonNull[0], defs, seen, depth + 1);
+    }
+    return schema;
+}
+/**
+ * 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 function extractDefs(schema) {
+    return schema.$defs ?? schema.definitions ?? {};
+}
+/**
+ * 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 function getDefaultForSchema(schema) {
+    if ("default" in schema)
+        return structuredClone(schema.default);
+    if (schema.type === "object") {
+        const obj = {};
+        for (const [key, prop] of Object.entries(schema.properties || {})) {
+            if ("default" in prop)
+                obj[key] = structuredClone(prop.default);
+            else if (prop.type === "string")
+                obj[key] = "";
+            else if (prop.type === "integer" || prop.type === "number")
+                obj[key] = 0;
+            else if (prop.type === "boolean")
+                obj[key] = false;
+            else if (prop.type === "array")
+                obj[key] = [];
+        }
+        return obj;
+    }
+    if (schema.type === "array")
+        return [];
+    if (schema.type === "string")
+        return "";
+    if (schema.type === "integer" || schema.type === "number")
+        return 0;
+    if (schema.type === "boolean")
+        return false;
+    if (schema.type === "relation")
+        return schema.multiple ? [] : null;
+    return null;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/jsonSchema/resolve.js.map

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

package/dist/jsonSchema/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/jsonSchema/types.js.map

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

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":"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"}

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/formatters.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Format a byte count as a human-readable string (ported from Mapo v1).
+ *
+ * @param bytes Number of bytes.
+ * @param si Use metric (powers of 1000, "kB/MB") instead of binary (powers of 1024, "KiB/MiB"). Default `false`.
+ * @param dp Decimal places. Default `1`.
+ */
+export declare function humanFileSize(bytes: number, si?: boolean, dp?: number): string;
+/**
+ * Convert a string into a URL-safe slug: lowercase, accents stripped,
+ * non-alphanumerics collapsed into single dashes (ported from Mapo v1).
+ * Camomilla folder payloads require a `slug` derived from the title.
+ */
+export declare function slugify(str: string | null | undefined): string;
+//# sourceMappingURL=formatters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/formatters.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,UAAQ,EAAE,EAAE,SAAI,GAAG,MAAM,CAuBvE;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAa9D"}

package/dist/types/index.d.ts

@@ -0,0 +1,14 @@
+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 { humanFileSize, slugify } from "./formatters.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,aAAa,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACzD,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"}