@zudojs/docs 1.0.0 → 1.0.1

package/dist/generator/generatorMarkdownNodes.js

@@ -5,12 +5,12 @@
  * untrusted node content cannot break out of a table, code fence,
  * heading or link.
  */
-const CALLOUT_LABELS = {
-    note: "NOTE",
-    warning: "WARNING",
-    tip: "TIP",
-    danger: "DANGER",
-};
+const CALLOUT_LABELS = new Map([
+    ["note", "NOTE"],
+    ["warning", "WARNING"],
+    ["tip", "TIP"],
+    ["danger", "DANGER"],
+]);
 /**
  * Converts a list of documentation nodes to markdown.
  *
@@ -65,7 +65,11 @@ export function nodesToMarkdown(nodes) {
                 lines.push("");
                 break;
             case "callout": {
-                const label = CALLOUT_LABELS[node.kind] ?? singleLine(String(node.kind)).toUpperCase();
+                // A Map, not a plain-object lookup: a kind of "constructor" coming
+                // from untrusted JSON must not resolve to Object.prototype.constructor
+                // and print a function's source as the label.
+                const label = CALLOUT_LABELS.get(node.kind) ??
+                    singleLine(String(node.kind)).toUpperCase();
                 const [first = "", ...rest] = node.value.split(/\r?\n/);
                 lines.push(`> **${label}:** ${first}`);
                 for (const line of rest) {

package/dist/utils/utils.freeze.d.ts

@@ -9,8 +9,9 @@
 export declare function deepFreeze<T>(value: T, seen?: WeakSet<object>): T;
 /**
  * Returns a deep-frozen copy of `value`, leaving the caller's object
- * untouched. Falls back to freezing a shallow copy when the value
- * cannot be structurally cloned (e.g. contains functions).
+ * untouched. Falls back to a recursive copy of plain objects, arrays and
+ * Dates when the value cannot be structurally cloned (e.g. contains
+ * functions); those are kept by reference.
  */
 export declare function deepFreezeClone<T>(value: T): T;
 //# sourceMappingURL=utils.freeze.d.ts.map

package/dist/utils/utils.freeze.js

@@ -24,8 +24,9 @@ export function deepFreeze(value, seen = new WeakSet()) {
 }
 /**
  * Returns a deep-frozen copy of `value`, leaving the caller's object
- * untouched. Falls back to freezing a shallow copy when the value
- * cannot be structurally cloned (e.g. contains functions).
+ * untouched. Falls back to a recursive copy of plain objects, arrays and
+ * Dates when the value cannot be structurally cloned (e.g. contains
+ * functions); those are kept by reference.
  */
 export function deepFreezeClone(value) {
     let copy;
@@ -33,15 +34,38 @@ export function deepFreezeClone(value) {
         copy = structuredClone(value);
     }
     catch {
-        copy = shallowCopy(value);
+        copy = deepCopy(value, new WeakMap());
     }
     return deepFreeze(copy);
 }
-function shallowCopy(value) {
-    if (Array.isArray(value))
-        return [...value];
-    if (isPlainObject(value))
-        return { ...value };
+/**
+ * Recursive fallback for values `structuredClone` rejects. A shallow copy
+ * was not enough: `deepFreeze` then walked into the caller's nested
+ * objects and froze them in place.
+ */
+function deepCopy(value, seen) {
+    if (typeof value !== "object" || value === null)
+        return value;
+    if (seen.has(value))
+        return seen.get(value);
+    if (value instanceof Date) {
+        return new Date(value.getTime());
+    }
+    if (Array.isArray(value)) {
+        const copy = [];
+        seen.set(value, copy);
+        for (const item of value)
+            copy.push(deepCopy(item, seen));
+        return copy;
+    }
+    if (isPlainObject(value)) {
+        const copy = {};
+        seen.set(value, copy);
+        for (const [key, item] of Object.entries(value)) {
+            copy[key] = deepCopy(item, seen);
+        }
+        return copy;
+    }
     return value;
 }
 function isPlainObject(value) {

package/dist/validator/validatorAll/validatorNavigation.core.js

@@ -43,11 +43,14 @@ export function validateNavigation(items, registeredIds) {
                 });
                 continue;
             }
-            if (visited.has(node))
-                continue;
+            // The same node object mounted in two places is still the document
+            // appearing twice in the navigation, so the duplicate check runs on
+            // every visit; only the per-node checks and the descent are skipped
+            // for a node already seen.
+            const firstVisit = !visited.has(node);
             visited.add(node);
             if (node.documentId) {
-                if (!registeredIds.has(node.documentId)) {
+                if (firstVisit && !registeredIds.has(node.documentId)) {
                     issues.push({
                         severity: "error",
                         code: "NAVIGATION_UNKNOWN_DOCUMENT",
@@ -65,14 +68,14 @@ export function validateNavigation(items, registeredIds) {
                 }
                 seenIds.add(node.documentId);
             }
-            else if (!node.children || node.children.length === 0) {
+            else if (firstVisit && (!node.children || node.children.length === 0)) {
                 issues.push({
                     severity: "warning",
                     code: "NAVIGATION_EMPTY_ITEM",
                     message: `Navigation item "${node.title}" has neither a documentId nor children.`,
                 });
             }
-            if (node.children) {
+            if (firstVisit && node.children) {
                 walk(node.children, [...ancestors, node]);
             }
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zudojs/docs",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Documentation infrastructure with structured document model, registry, validation, navigation, and generation.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -11,13 +11,17 @@
     }
   },
   "dependencies": {
-    "@zudojs/errors": "1.0.0"
+    "@zudojs/errors": "1.0.1"
   },
   "devDependencies": {
     "typescript": "7.0.2",
     "vitest": "^4.1.11"
   },
   "license": "MIT",
+  "author": {
+    "name": "Oluwayemi Oyinlola",
+    "url": "https://github.com/oyinlola-tech"
+  },
   "type": "module",
   "files": [
     "dist",