@ankhorage/paradox 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.2.1
+
+### Patch Changes
+
+- f556df5: Update Ankhorage dependencies: `@ankhorage/policy`.
+
 ## 0.2.0
 
 ### Minor Changes

package/dist/analyze/exports.js

@@ -1,4 +1,5 @@
 import { isAbsolute, join, normalize, relative } from 'node:path';
+import { uniqueSortedStrings } from '@ankhorage/utility/array';
 import { Node } from 'ts-morph';
 import { getExportMetadata } from './utils/getExportMetadata.js';
 import { getParadoxComment } from './utils/getParadoxComment.js';
@@ -45,10 +46,10 @@ export function analyzeExports(project, options) {
                     title: existing.title ?? parsed.title,
                     description: existing.description ?? parsed.description,
                     isReadme: existing.isReadme || parsed.isReadme,
-                    see: uniqueSorted([...existing.see, ...parsed.see]),
-                    security: uniqueSorted([...existing.security, ...parsed.security]),
-                    exportPaths: uniqueSorted([...existing.exportPaths, ...metadata.exportPaths]),
-                    relatedSymbols: uniqueSorted([
+                    see: uniqueSortedStrings([...existing.see, ...parsed.see]),
+                    security: uniqueSortedStrings([...existing.security, ...parsed.security]),
+                    exportPaths: uniqueSortedStrings([...existing.exportPaths, ...metadata.exportPaths]),
+                    relatedSymbols: uniqueSortedStrings([
                         ...existing.relatedSymbols,
                         ...metadata.relatedSymbols,
                     ]),
@@ -106,12 +107,6 @@ function inferKind(node) {
         return 'value';
     return 'unknown';
 }
-/***
- * Returns unique string values sorted for deterministic generated output.
- */
-function uniqueSorted(values) {
-    return [...new Set(values)].sort((left, right) => left.localeCompare(right));
-}
 /***
  * Normalizes platform-specific path separators for generated documentation output.
  */

package/dist/analyze/modules.js

@@ -1,4 +1,5 @@
 import { isAbsolute, join, normalize, relative } from 'node:path';
+import { uniqueSortedStrings } from '@ankhorage/utility/array';
 /***
  * Builds a deterministic module relationship graph for documentation renderers.
  */
@@ -34,18 +35,12 @@ export function analyzeModules(project, options) {
         return {
             path,
             isEntrypoint: entrypointPaths.has(normalize(sourceFile.getFilePath())),
-            dependencies: uniqueSorted(dependencies),
-            exports: uniqueSorted(exports),
+            dependencies: uniqueSortedStrings(dependencies),
+            exports: uniqueSortedStrings(exports),
         };
     })
         .sort((left, right) => left.path.localeCompare(right.path));
 }
-/***
- * Returns unique string values sorted for deterministic generated output.
- */
-function uniqueSorted(values) {
-    return [...new Set(values)].sort((left, right) => left.localeCompare(right));
-}
 /***
  * Normalizes platform-specific path separators for generated documentation output.
  */

package/dist/analyze/semantic/exports.js

@@ -1,3 +1,4 @@
+import { uniqueSortedStrings } from '@ankhorage/utility/array';
 import { Node as MorphNode, TypeFormatFlags } from 'ts-morph';
 import { isReactComponent } from './isReactComponent.js';
 import { getParadoxComment, parseParadoxComment } from './paradoxComment.js';
@@ -21,7 +22,7 @@ export function collectExports(program) {
             const sourcePath = relativeToRoot(program.root, declaration.getSourceFile().getFilePath());
             const existing = exportsByName.get(name);
             const exportPaths = existing
-                ? uniqueSorted([...existing.exportPaths, entrypointPath])
+                ? uniqueSortedStrings([...existing.exportPaths, entrypointPath])
                 : [entrypointPath];
             const kind = existing?.kind ?? detectExportKind(declaration);
             exportsByName.set(name, {
@@ -378,9 +379,6 @@ function getCallableNode(node) {
     }
     return null;
 }
-function uniqueSorted(values) {
-    return [...new Set(values)].sort((left, right) => left.localeCompare(right));
-}
 const IGNORED_RELATED_SYMBOLS = new Set([
     'Array',
     'Boolean',

package/dist/analyze/sequenceScenarios.js

@@ -1,4 +1,5 @@
 import { isAbsolute, join, normalize } from 'node:path';
+import { uniqueSortedStrings } from '@ankhorage/utility/array';
 import { Node as MorphNode, } from 'ts-morph';
 import { relativeToRoot, toPosixPath } from './semantic/utils.js';
 import { getParadoxComment } from './utils/getParadoxComment.js';
@@ -85,7 +86,7 @@ function getBinSourceCandidates(targetPath) {
         candidates.push(normalized.replace(/\.jsx?$/, '.ts'));
         candidates.push(normalized.replace(/\.jsx?$/, '.tsx'));
     }
-    return uniqueSorted(candidates);
+    return uniqueSortedStrings(candidates);
 }
 function getSourceFileByRelativePath(project, root, relativePath) {
     const absolutePath = normalize(isAbsolute(relativePath) ? relativePath : join(root, relativePath));
@@ -169,6 +170,3 @@ function uniqueByFunctionName(declarations) {
         return true;
     });
 }
-function uniqueSorted(values) {
-    return [...new Set(values)].sort((left, right) => left.localeCompare(right));
-}

package/dist/render/renderers/diagrams.js

@@ -1,3 +1,4 @@
+import { uniqueSortedStrings } from '@ankhorage/utility/array';
 import { toFileStem } from '../toFileStem.js';
 const MAX_SEQUENCE_CALL_EDGES = 12;
 const MAX_SEQUENCE_PARTICIPANTS = 8;
@@ -174,7 +175,7 @@ function groupCallsBySource(callEdges) {
     return grouped;
 }
 function collectSequenceParticipants(callEdges) {
-    return uniqueSorted(callEdges.flatMap((edge) => [edge.fromSymbol, edge.toSymbol]));
+    return uniqueSortedStrings(callEdges.flatMap((edge) => [edge.fromSymbol, edge.toSymbol]));
 }
 function getCallEdgeKey(edge) {
     return `${edge.fromSymbol}->${edge.toSymbol}@${edge.sourcePath}:${edge.callExpression}`;
@@ -191,9 +192,6 @@ function renderFallbackEdge(modules, prefix) {
         return `  ${toMermaidId(`${prefix}-${previous.path}`)} -.-> ${toMermaidId(`${prefix}-${module.path}`)}`;
     });
 }
-function uniqueSorted(values) {
-    return [...new Set(values)].sort((left, right) => left.localeCompare(right));
-}
 function toMermaidId(value) {
     return value.replace(/[^A-Za-z0-9_]/g, '_');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/paradox",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Deterministic documentation generator for TypeScript packages.",
   "license": "MIT",
   "publishConfig": {
@@ -71,7 +71,7 @@
     "test:standalone": "bun test tests/cli.e2e.test.ts"
   },
   "dependencies": {
-    "@ankhorage/policy": "^0.1.0",
+    "@ankhorage/policy": "^0.2.0",
     "@ankhorage/utility": "^1.8.0",
     "ts-morph": "^28.0.0"
   },