@ankhorage/paradox 0.1.5 → 0.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,17 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.1.7
4
+
5
+ ### Patch Changes
6
+
7
+ - 8a9c0ab: Update DEVTOOLS
8
+
9
+ ## 0.1.6
10
+
11
+ ### Patch Changes
12
+
13
+ - 8ba8f5c: Remove the hardcoded Path resolution section from generated README output so consumer documentation only contains analyzed package content.
14
+
3
15
  ## 0.1.5
4
16
 
5
17
  ### Patch Changes
package/README.md CHANGED
@@ -3,7 +3,7 @@
3
3
 
4
4
  # @ankhorage/paradox
5
5
 
6
- ![license: MIT](./paradox/badges/license.svg) ![npm: v0.1.4](./paradox/badges/npm.svg) ![runtime: bun](./paradox/badges/runtime.svg) ![typescript: strict](./paradox/badges/typescript.svg) ![eslint: checked](./paradox/badges/eslint.svg) ![prettier: checked](./paradox/badges/prettier.svg) ![build: checked](./paradox/badges/build.svg) ![tests: checked](./paradox/badges/tests.svg) ![docs: paradox](./paradox/badges/docs.svg)
6
+ ![license: MIT](./paradox/badges/license.svg) ![npm: v0.1.6](./paradox/badges/npm.svg) ![runtime: bun](./paradox/badges/runtime.svg) ![typescript: strict](./paradox/badges/typescript.svg) ![eslint: checked](./paradox/badges/eslint.svg) ![prettier: checked](./paradox/badges/prettier.svg) ![build: checked](./paradox/badges/build.svg) ![tests: checked](./paradox/badges/tests.svg) ![docs: paradox](./paradox/badges/docs.svg)
7
7
 
8
8
  Deterministic documentation generator for TypeScript packages.
9
9
 
@@ -291,15 +291,6 @@ graph TD
291
291
 
292
292
  </details>
293
293
 
294
- ## Path resolution
295
-
296
- - Config discovery: searches upward from `process.cwd()` for `paradox.config.ts/js/mjs/cjs` (required; no fallback).
297
- - Package root: defaults to the directory containing `paradox.config.*`; `package.root` (when relative) resolves relative to that directory.
298
- - Output directory: defaults to `paradox/`; `output.dir` (when relative) resolves relative to the resolved package root and must stay inside it.
299
- - Modes:
300
- - `safe`: writes generated artifacts only under the output directory
301
- - `write`: additionally updates `<packageRoot>/README.md`
302
-
303
294
  ## Public API
304
295
 
305
296
  ### Config
@@ -38,7 +38,6 @@ function renderReadme(model, outputDir, badges, diagrams) {
38
38
  }
39
39
  renderGeneratedDocumentation(lines, outputDir, diagrams);
40
40
  renderArchitecturePreview(lines, diagrams);
41
- renderPathResolution(lines);
42
41
  renderReadmeApi(lines, model);
43
42
  return `${lines.join('\n').trimEnd()}\n`;
44
43
  }
@@ -128,15 +127,6 @@ function renderArchitecturePreview(lines, diagrams) {
128
127
  lines.push('</details>', '');
129
128
  }
130
129
  }
131
- function renderPathResolution(lines) {
132
- lines.push('## Path resolution', '');
133
- lines.push('- Config discovery: searches upward from `process.cwd()` for `paradox.config.ts/js/mjs/cjs` (required; no fallback).');
134
- lines.push('- Package root: defaults to the directory containing `paradox.config.*`; `package.root` (when relative) resolves relative to that directory.');
135
- lines.push('- Output directory: defaults to `paradox/`; `output.dir` (when relative) resolves relative to the resolved package root and must stay inside it.');
136
- lines.push('- Modes:');
137
- lines.push(' - `safe`: writes generated artifacts only under the output directory');
138
- lines.push(' - `write`: additionally updates `<packageRoot>/README.md`', '');
139
- }
140
130
  function renderReadmeApi(lines, model) {
141
131
  const groups = getReadmeGroups(model);
142
132
  if (groups.length === 0)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ankhorage/paradox",
3
- "version": "0.1.5",
3
+ "version": "0.1.7",
4
4
  "description": "Deterministic documentation generator for TypeScript packages.",
5
5
  "license": "MIT",
6
6
  "publishConfig": {
@@ -61,7 +61,7 @@
61
61
  "ts-morph": "^24.0.0"
62
62
  },
63
63
  "devDependencies": {
64
- "@ankhorage/devtools": "^1.0.5",
64
+ "@ankhorage/devtools": "^1.0.6",
65
65
  "@changesets/cli": "^2.31.0",
66
66
  "@types/bun": "^1.3.13",
67
67
  "typescript": "^5.6.3"