jamdesk 1.1.96 → 1.1.98

package/scripts/patch-openapi-schemas.js

@@ -1,24 +1,31 @@
 #!/usr/bin/env node
 /**
- * Patch a typo in @apidevtools/openapi-schemas@2.1.0.
+ * Patch two defects in @apidevtools/openapi-schemas@2.1.0's bundled
+ * OpenAPI 3.1 meta-schema. Both are idempotent and self-cleaning once
+ * upstream ships fixes (https://github.com/APIDevTools/openapi-schemas):
  *
- * The bundled OpenAPI 3.1 meta-schema defines `server-variable.properties`
- * as `{ enum, default, descriptions }` — but the OpenAPI 3.1 spec says the
- * third property is `description` (singular). Combined with
- * `unevaluatedProperties: false` on the same definition, any spec-valid
- * `description` field on a server variable is rejected with:
+ * 1. server-variable typo: `properties` declares `descriptions` (plural)
+ *    instead of `description`. With `unevaluatedProperties: false` on the
+ *    same def, a spec-valid `description` is rejected with:
+ *      #/servers/0/variables/<name> must NOT have unevaluated properties
  *
- *   #/servers/0/variables/<name> must NOT have unevaluated properties
- *
- * We swap the typo at install time so swagger-parser accepts the spec.
- * Idempotent — safe to run multiple times. Deletes itself cleanly once
- * upstream ships a fix:
- *
- *   https://github.com/APIDevTools/openapi-schemas
+ * 2. license over-constraint: the `license` def carries
+ *      "oneOf": [ {"required":["identifier"]}, {"required":["url"]} ]
+ *    which forces every license to have an `identifier` or a `url`. The
+ *    OpenAPI 3.1 spec (§4.8.4) only requires `name`; `identifier` and
+ *    `url` are optional and merely mutually exclusive. A `{ name }`-only
+ *    license is valid (Mintlify accepts it; `jamdesk migrate`'s
+ *    auto-discovered Mintlify starter spec uses `{ "name": "MIT" }`).
+ *    The correct constraint is `not: { required: [identifier, url] }`.
  *
  * This file runs as an npm `postinstall` script in the package root, so
  * `__dirname` is always `<package>/scripts/` and `node_modules` resolves
  * one level up.
+ *
+ * The CLI's *workspace* install (~/.jamdesk) is patched separately and
+ * identically by patchWorkspaceOpenApiSchemas() in src/lib/deps.ts — if
+ * you change the patch logic here, mirror it there (and in
+ * build-service/scripts/patch-openapi-schemas.js).
  */
 
 import fs from 'fs';
@@ -55,30 +62,45 @@ try {
   process.exit(0);
 }
 
-const defs = schema && schema.$defs;
-const serverVariable = defs && defs['server-variable'];
-const props = serverVariable && serverVariable.properties;
-
-if (!props) {
-  // Schema shape changed upstream — bail out quietly.
-  process.exit(0);
+/**
+ * Fix 1: server-variable `descriptions` -> `description`.
+ * Returns true if it changed the schema.
+ */
+function patchServerVariable(s) {
+  const props = s?.$defs?.['server-variable']?.properties;
+  if (!props) return false; // Shape changed upstream — leave alone.
+  if (props.description) return false; // Already patched / upstream fixed.
+  if (!props.descriptions) return false; // No typo to fix.
+  props.description = props.descriptions;
+  delete props.descriptions;
+  return true;
 }
 
-if (props.description) {
-  // Already patched (or upstream fixed it). Either way, no work to do.
-  process.exit(0);
+/**
+ * Fix 2: license over-constraint. Replace the bad `oneOf` with the
+ * spec-correct mutual-exclusivity guard. Returns true if it changed.
+ */
+function patchLicense(s) {
+  const license = s?.$defs?.license;
+  if (!license || typeof license !== 'object') return false;
+  if (!Array.isArray(license.oneOf)) return false; // Already patched / fixed.
+  delete license.oneOf;
+  license.not = { required: ['identifier', 'url'] };
+  return true;
 }
 
-if (!props.descriptions) {
-  // No typo to fix. Quietly no-op.
+const patched = [];
+if (patchServerVariable(schema)) patched.push('server-variable typo (descriptions → description)');
+if (patchLicense(schema)) patched.push('license oneOf → not(identifier+url)');
+
+if (patched.length === 0) {
   process.exit(0);
 }
 
-props.description = props.descriptions;
-delete props.descriptions;
-
 try {
-  fs.writeFileSync(schemaPath, JSON.stringify(schema, null, 2));
+  // Trailing newline keeps this byte-identical to fs-extra's writeJson
+  // (jsonfile finalEOL) used by the runtime patch in src/lib/deps.ts.
+  fs.writeFileSync(schemaPath, JSON.stringify(schema, null, 2) + '\n');
 } catch (err) {
   console.warn(
     '[jamdesk] patch-openapi-schemas: failed to write patch, skipping:',
@@ -86,6 +108,4 @@ try {
   );
   process.exit(0);
 }
-console.log(
-  '[jamdesk] patched openapi-schemas 3.1 server-variable typo (descriptions → description)'
-);
+console.log(`[jamdesk] patched openapi-schemas 3.1: ${patched.join('; ')}`);

package/vendored/components/mdx/Mermaid.tsx

@@ -1,17 +1,26 @@
 'use client';
 
 import dynamic from 'next/dynamic';
-import { useMemo, useState } from 'react';
+import { useMemo, useRef, useState } from 'react';
 import { readCachedHeight } from './mermaidCache';
 import { useIsomorphicLayoutEffect } from '../../hooks/useIsomorphicLayoutEffect';
 
 // Neutral floor reserved in the SSR markup itself (present on the browser's
 // first paint, before any JS) so a cache miss / pre-hydration window shows
 // correctly-sized empty space instead of a collapse or a grey pulse. Roughly
-// the prior skeleton footprint; refined to the exact diagram height on a
-// cache hit by the layout effect below.
+// the prior skeleton footprint; a cache hit refines it to the exact diagram
+// height pre-paint, and once the diagram renders the floor is released
+// entirely (see the layout effect below).
 const DEFAULT_MERMAID_RESERVE_PX = 192;
 
+// Sentinel: floor released, MermaidInner's own min-height governs the box.
+const FLOOR_RELEASED_PX = 0;
+
+// A rendered diagram (or the error box) is always taller than this; the empty
+// pre-render container is 0px. Distinguishes "content has painted" from "still
+// reserving the gap" so the floor is released only once it is dead weight.
+const RENDERED_FLOOR_RELEASE_PX = 8;
+
 const MermaidInner = dynamic(
   () => import('./MermaidInner').then(mod => ({ default: mod.MermaidInner })),
   { ssr: false, loading: () => null }
@@ -25,21 +34,49 @@ interface MermaidProps {
 }
 
 export function Mermaid({ children, className, minWidth }: MermaidProps) {
+  const wrapperRef = useRef<HTMLDivElement>(null);
+
   // Server + first (hydration) render emit the constant default — identical
   // markup, so no hydration mismatch. The sessionStorage read happens only
   // in the post-hydration layout effect, never in this initializer.
   const [reservedPx, setReservedPx] = useState(DEFAULT_MERMAID_RESERVE_PX);
 
-  // Fires once, after the hydration commit, synchronously before that
-  // commit's paint — and BEFORE the MermaidInner chunk has resolved or
-  // injected anything. On a cache hit, refine the reserved space to the
-  // exact diagram height so the SVG paints into already-exact space.
-  // Distinct from the reverted spike: one pre-paint settle before injection,
-  // never a re-render around an already-injected node. minWidth still flows
-  // to MermaidInner unchanged; the wrapper owns height only.
+  // The reserved min-height only bridges the pre-render gap; it must never
+  // outlive the diagram or it leaves dead space under any diagram shorter
+  // than the floor (the cache-miss path never refines it down).
   useIsomorphicLayoutEffect(() => {
-    const h = readCachedHeight(children);
-    if (h > 0) setReservedPx(h);
+    const wrapper = wrapperRef.current;
+
+    // Relies on MermaidInner rendering exactly one HTMLElement root (the
+    // diagram container or the error box); if that contract changes, this
+    // height probe silently targets the wrong node.
+    const releaseIfRendered = (): boolean => {
+      const content = wrapper?.firstElementChild as HTMLElement | null;
+      if (content && content.clientHeight > RENDERED_FLOOR_RELEASE_PX) {
+        setReservedPx(FLOOR_RELEASED_PX);
+        return true;
+      }
+      return false;
+    };
+
+    // Already painted (warm soft-nav: SVG hydrated synchronously from cache) —
+    // the floor is already dead weight, skip the cache refine entirely.
+    if (releaseIfRendered()) return;
+
+    // Not yet painted: cache hit → reserve the exact height pre-paint (zero
+    // shift); cache miss / new diagram → hold the default floor for its gap.
+    const cached = readCachedHeight(children);
+    setReservedPx(cached > 0 ? cached : DEFAULT_MERMAID_RESERVE_PX);
+
+    if (!wrapper || typeof MutationObserver === 'undefined') return;
+    // childList only — no `attributes`: MermaidInner's post-commit style pass
+    // mutates SVG child styles heavily; observing attributes would fire a
+    // callback storm. The SVG-insert is a childList mutation, all we need.
+    const mo = new MutationObserver(() => {
+      if (releaseIfRendered()) mo.disconnect();
+    });
+    mo.observe(wrapper, { childList: true, subtree: true });
+    return () => mo.disconnect();
   }, [children]);
 
   // Stable element identity across reservedPx changes. The pre-paint
@@ -63,7 +100,7 @@ export function Mermaid({ children, className, minWidth }: MermaidProps) {
   );
 
   return (
-    <div data-testid="mermaid-wrapper" style={{ minHeight: reservedPx }}>
+    <div ref={wrapperRef} data-testid="mermaid-wrapper" style={{ minHeight: reservedPx }}>
       {inner}
     </div>
   );

package/vendored/components/navigation/Sidebar.tsx

@@ -539,7 +539,7 @@ export function Sidebar({ config, layout = 'header-logo', tabsPosition: tabsPosi
       <div className="flex flex-col gap-1 px-4 pt-4">
         {resolvedNav.externalAnchors.map((anchor) => (
           <a
-            key={anchor.name}
+            key={`${anchor.href}|${anchor.name}`}
             href={anchor.href}
             target="_blank"
             rel="noopener noreferrer"

package/vendored/lib/navigation-resolver.ts

@@ -460,6 +460,21 @@ export function resolveNavigation(
     }
   }
 
+  // Dedupe exact (name+href) repeats. `jamdesk migrate` historically emitted
+  // external anchors in BOTH config.anchors and navigation.global.anchors, so
+  // the resolver would otherwise return the same link twice. Keyed on
+  // name+href (not name alone) so two genuinely distinct anchors that share a
+  // label are preserved — Sidebar.tsx keys them by href|name, so distinct
+  // hrefs no longer collide as React keys. First occurrence wins, so
+  // top-level config.anchors takes precedence over global.anchors.
+  const seenAnchors = new Set<string>();
+  result.externalAnchors = result.externalAnchors.filter((anchor) => {
+    const dedupeKey = `${anchor.name}\0${anchor.href}`;
+    if (seenAnchors.has(dedupeKey)) return false;
+    seenAnchors.add(dedupeKey);
+    return true;
+  });
+
   // Resolve top-level tabs
   if (navigation.tabs) {
     result.tabs = navigation.tabs.map(resolveTab);

package/vendored/workspace-package-lock.json

@@ -1921,9 +1921,9 @@
       }
     },
     "node_modules/@types/node": {
-      "version": "25.8.0",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-25.8.0.tgz",
-      "integrity": "sha512-TCFSk8IZh+iLX1xtksoBVtdmgL+1IX0fC9BeU4QqFSuNdN/K+HUlhqOzEmSYYpZUVsLYcPqc9KX+60iDuninSQ==",
+      "version": "25.9.0",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-25.9.0.tgz",
+      "integrity": "sha512-AOQwYUNolgy3VosiRqXrACUXTN8nJUtPl7FJXMqZVyxiiCLhQuG3jXKvCS1ALr+Y2OmZhzzLVlYPEqJaiqkaJQ==",
       "license": "MIT",
       "dependencies": {
         "undici-types": ">=7.24.0 <7.24.7"
@@ -2134,9 +2134,9 @@
       }
     },
     "node_modules/baseline-browser-mapping": {
-      "version": "2.10.30",
-      "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.10.30.tgz",
-      "integrity": "sha512-xjOFN16Ha1+Rz4nFYKqHU/LSB+gx/Vi3yQLX7r7sAW+Wa+8hhF2h4pvqTrTMc8+WcDBEunnUurr46Jvv0jk3Vg==",
+      "version": "2.10.31",
+      "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.10.31.tgz",
+      "integrity": "sha512-MujYO3eP72uvmSE0i4wltsodRfIpZATP3jvzRNRGGxgzId7aVocVJJV3nf01qnzzKFGxQVC9bpWxl5cjxTr/7Q==",
       "license": "Apache-2.0",
       "bin": {
         "baseline-browser-mapping": "dist/cli.cjs"
@@ -2913,9 +2913,9 @@
       }
     },
     "node_modules/dompurify": {
-      "version": "3.4.4",
-      "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.4.4.tgz",
-      "integrity": "sha512-r8K7KGKEcztXfA/nfabSYB2hg9tDphORJTdf8xprN/luSLGmNhOBN8dm1/SYjqLLet6YUFEXOcrdTuwryp/Bew==",
+      "version": "3.4.5",
+      "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.4.5.tgz",
+      "integrity": "sha512-OrwIBKsdNSVEeubdJ1HBv/wNENRM9ytAVCv7YXt//A3vPdVMNuACRqK9mXCGCBW2ln7BT/A4X0jXHo2Gu89miA==",
       "license": "(MPL-2.0 OR Apache-2.0)",
       "optionalDependencies": {
         "@types/trusted-types": "^2.0.7"
@@ -2934,9 +2934,9 @@
       "license": "ISC"
     },
     "node_modules/enhanced-resolve": {
-      "version": "5.21.3",
-      "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.21.3.tgz",
-      "integrity": "sha512-QyL119InA+XXEkNLNTPCXPugSvOfhwv0JOlGNzvxs0hZaiHLNvXSpudUWsOlsXGWJh8G6ckCScEkVHfX3kw/2Q==",
+      "version": "5.21.4",
+      "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.21.4.tgz",
+      "integrity": "sha512-wE4fDO8OjJhrPFH69HUQStq5oKvGRTNXEyW+k5C/pUQLASSsTu7obd2V3GvCDgPcY9AWjhJ4jz9Kh7iRvrxhJg==",
       "license": "MIT",
       "dependencies": {
         "graceful-fs": "^4.2.4",
@@ -4067,9 +4067,9 @@
       }
     },
     "node_modules/lru-cache": {
-      "version": "11.3.6",
-      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.3.6.tgz",
-      "integrity": "sha512-Gf/KoL3C/MlI7Bt0PGI9I+TeTC/I6r/csU58N4BSNc4lppLBeKsOdFYkK+dX0ABDUMJNfCHTyPpzwwO21Awd3A==",
+      "version": "11.4.0",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.4.0.tgz",
+      "integrity": "sha512-W+R+kFL4HgVxONq2bhXPi3bGpzGe/yEhVOp233qw9wCRtgncJ15P3bC+e4zZMu4Cq7d+WAJjXGW0uUkifhcatA==",
       "license": "BlueOak-1.0.0",
       "engines": {
         "node": "20 || >=22"

package/dist/__tests__/unit/dev-workspace-symlinks.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=dev-workspace-symlinks.test.d.ts.map

package/dist/__tests__/unit/dev-workspace-symlinks.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dev-workspace-symlinks.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/dev-workspace-symlinks.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/unit/dev-workspace-symlinks.test.js

@@ -1,112 +0,0 @@
-/**
- * @vitest-environment node
- *
- * Tests prepareProjectWorkspaceLinks — replaces the single
- * <workspace>/projects/<name> -> <projectDir> symlink with per-entry
- * symlinks that skip non-active language directories. This is what
- * actually reduces Turbopack's filesystem scan from 403 MDX files to
- * 135 on jamdesk-docs.
- */
-import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
-import fs from 'fs-extra';
-import path from 'path';
-import { tmpdir } from 'os';
-import { prepareProjectWorkspaceLinks } from '../../commands/dev.js';
-import { output } from '../../lib/output.js';
-describe('prepareProjectWorkspaceLinks', () => {
-    let tmpRoot;
-    let projectDir;
-    let workspaceProjectDir;
-    beforeEach(() => {
-        tmpRoot = fs.mkdtempSync(path.join(tmpdir(), 'jam-ws-'));
-        projectDir = path.join(tmpRoot, 'project');
-        workspaceProjectDir = path.join(tmpRoot, 'ws', 'projects', 'project');
-        // Set up a project layout that mirrors a multi-language docs project:
-        //   project/
-        //     ai/intro.mdx       (en at root)
-        //     development/foo.mdx (en at root)
-        //     es/ai/intro.mdx    (spanish)
-        //     fr/ai/intro.mdx    (french)
-        //     docs.json
-        //     images/logo.png
-        fs.mkdirpSync(path.join(projectDir, 'ai'));
-        fs.writeFileSync(path.join(projectDir, 'ai', 'intro.mdx'), '# en');
-        fs.mkdirpSync(path.join(projectDir, 'development'));
-        fs.writeFileSync(path.join(projectDir, 'development', 'foo.mdx'), '# en');
-        fs.mkdirpSync(path.join(projectDir, 'es', 'ai'));
-        fs.writeFileSync(path.join(projectDir, 'es', 'ai', 'intro.mdx'), '# es');
-        fs.mkdirpSync(path.join(projectDir, 'fr', 'ai'));
-        fs.writeFileSync(path.join(projectDir, 'fr', 'ai', 'intro.mdx'), '# fr');
-        fs.writeFileSync(path.join(projectDir, 'docs.json'), '{}');
-        fs.mkdirpSync(path.join(projectDir, 'images'));
-        fs.writeFileSync(path.join(projectDir, 'images', 'logo.png'), '');
-    });
-    afterEach(() => {
-        fs.removeSync(tmpRoot);
-    });
-    it('symlinks every top-level entry when skip set is empty', async () => {
-        await prepareProjectWorkspaceLinks(projectDir, workspaceProjectDir, new Set());
-        expect(fs.existsSync(path.join(workspaceProjectDir, 'ai', 'intro.mdx'))).toBe(true);
-        expect(fs.existsSync(path.join(workspaceProjectDir, 'es', 'ai', 'intro.mdx'))).toBe(true);
-        expect(fs.existsSync(path.join(workspaceProjectDir, 'fr', 'ai', 'intro.mdx'))).toBe(true);
-    });
-    it('does not symlink docs.json (caller writes a filtered copy)', async () => {
-        // docs.json must not be symlinked — the caller writes a per-language
-        // filtered copy, and fs.writeFile through a symlink would clobber the
-        // user's source docs.json.
-        await prepareProjectWorkspaceLinks(projectDir, workspaceProjectDir, new Set());
-        expect(fs.existsSync(path.join(workspaceProjectDir, 'docs.json'))).toBe(false);
-    });
-    it('skips entries whose names are in the skip set', async () => {
-        await prepareProjectWorkspaceLinks(projectDir, workspaceProjectDir, new Set(['es', 'fr']));
-        expect(fs.existsSync(path.join(workspaceProjectDir, 'ai', 'intro.mdx'))).toBe(true);
-        expect(fs.existsSync(path.join(workspaceProjectDir, 'development', 'foo.mdx'))).toBe(true);
-        expect(fs.existsSync(path.join(workspaceProjectDir, 'images', 'logo.png'))).toBe(true);
-        // Skipped:
-        expect(fs.existsSync(path.join(workspaceProjectDir, 'es'))).toBe(false);
-        expect(fs.existsSync(path.join(workspaceProjectDir, 'fr'))).toBe(false);
-        // docs.json not symlinked — caller writes a filtered copy.
-        expect(fs.existsSync(path.join(workspaceProjectDir, 'docs.json'))).toBe(false);
-    });
-    it('rebuilds the workspace links from scratch on subsequent calls', async () => {
-        // First call: no skip
-        await prepareProjectWorkspaceLinks(projectDir, workspaceProjectDir, new Set());
-        expect(fs.existsSync(path.join(workspaceProjectDir, 'es'))).toBe(true);
-        // Second call: skip es
-        await prepareProjectWorkspaceLinks(projectDir, workspaceProjectDir, new Set(['es']));
-        expect(fs.existsSync(path.join(workspaceProjectDir, 'es'))).toBe(false);
-        expect(fs.existsSync(path.join(workspaceProjectDir, 'fr'))).toBe(true);
-        expect(fs.existsSync(path.join(workspaceProjectDir, 'ai', 'intro.mdx'))).toBe(true);
-    });
-    it('handles a pre-existing single symlink at workspaceProjectDir (legacy layout)', async () => {
-        // Pre-create the legacy single-symlink layout
-        fs.mkdirpSync(path.dirname(workspaceProjectDir));
-        fs.symlinkSync(projectDir, workspaceProjectDir, 'junction');
-        await prepareProjectWorkspaceLinks(projectDir, workspaceProjectDir, new Set(['es', 'fr']));
-        const lstat = fs.lstatSync(workspaceProjectDir);
-        expect(lstat.isDirectory()).toBe(true);
-        expect(fs.existsSync(path.join(workspaceProjectDir, 'ai', 'intro.mdx'))).toBe(true);
-        expect(fs.existsSync(path.join(workspaceProjectDir, 'es'))).toBe(false);
-    });
-    it('surfaces friendly error (not raw stack trace) when fs.rm throws ENOTEMPTY', async () => {
-        // Regression: before safeRemoveCache, fs.remove raised an unfriendly stack
-        // trace when Turbopack still held open files. Now safeRemoveCache detects
-        // the race and calls process.exit(1) with a human-readable message.
-        const rmSpy = vi.spyOn(fs, 'rm');
-        const exitSpy = vi.spyOn(process, 'exit').mockImplementation(((code) => {
-            throw new Error(`process.exit:${code}`);
-        }));
-        const errorSpy = vi.spyOn(output, 'error').mockImplementation(() => undefined);
-        const enotempty = Object.assign(new Error('ENOTEMPTY'), { code: 'ENOTEMPTY' });
-        // fs.rm will be called by safeRemoveCache; make it fail with ENOTEMPTY
-        // even after the internal maxRetries — simulate persistent race condition.
-        rmSpy.mockRejectedValue(enotempty);
-        await expect(prepareProjectWorkspaceLinks(projectDir, workspaceProjectDir, new Set())).rejects.toThrow('process.exit:1');
-        const msg = errorSpy.mock.calls[0]?.[0] ?? '';
-        expect(msg).toContain('Another `jamdesk dev` instance');
-        expect(msg).toContain('pkill -f');
-        expect(exitSpy).toHaveBeenCalledWith(1);
-        vi.restoreAllMocks();
-    });
-});
-//# sourceMappingURL=dev-workspace-symlinks.test.js.map

package/dist/__tests__/unit/dev-workspace-symlinks.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dev-workspace-symlinks.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/dev-workspace-symlinks.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/unit/language-filter.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=language-filter.test.d.ts.map

package/dist/__tests__/unit/language-filter.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"language-filter.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/language-filter.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/unit/language-filter.test.js

@@ -1,166 +0,0 @@
-/**
- * @vitest-environment node
- *
- * Tests for getActiveLanguageFilter — pure helper that decides which
- * top-level language directories to skip when symlinking project content
- * into the dev workspace. Multi-language sites' non-default languages
- * inflate Turbopack's filesystem scan and balloon cold compile time
- * (jamdesk-docs: 67s with 3 langs vs. 12.5s with 1 lang).
- */
-import { describe, it, expect } from 'vitest';
-import { getActiveLanguageFilter, isPageInSkippedLanguage, filterConfigByActiveLanguage, } from '../../lib/language-filter.js';
-const config = (langs) => ({
-    navigation: { languages: langs.map(l => ({ language: l.language, default: l.default })) },
-});
-describe('getActiveLanguageFilter', () => {
-    it('returns null filter when project has no languages array', () => {
-        const result = getActiveLanguageFilter({ navigation: {} }, undefined, false);
-        expect(result).toEqual({ active: null, skip: new Set() });
-    });
-    it('returns null filter when project has only one language', () => {
-        const result = getActiveLanguageFilter(config([{ language: 'en', default: true }]), undefined, false);
-        expect(result).toEqual({ active: 'en', skip: new Set() });
-    });
-    it('skips non-default languages when active is the default', () => {
-        const result = getActiveLanguageFilter(config([
-            { language: 'en', default: true },
-            { language: 'es' },
-            { language: 'fr' },
-        ]), undefined, false);
-        expect(result.active).toBe('en');
-        expect(result.skip).toEqual(new Set(['es', 'fr']));
-    });
-    it('falls back to first language when none is marked default', () => {
-        const result = getActiveLanguageFilter(config([{ language: 'en' }, { language: 'es' }, { language: 'fr' }]), undefined, false);
-        expect(result.active).toBe('en');
-        expect(result.skip).toEqual(new Set(['es', 'fr']));
-    });
-    it('accepts --lang matching the default language (no-op equivalence)', () => {
-        const result = getActiveLanguageFilter(config([
-            { language: 'en', default: true },
-            { language: 'es' },
-        ]), 'en', false);
-        expect(result.active).toBe('en');
-        expect(result.skip).toEqual(new Set(['es']));
-    });
-    it('throws on --lang for a non-default language (initial release scope)', () => {
-        // Non-default-language layouts mix root-level default-lang content with
-        // <lang>/ subdirs for translations; correctly stripping the default
-        // content while keeping <lang>/ takes more work and is deferred to a
-        // follow-up. For now, surface the workaround clearly.
-        expect(() => getActiveLanguageFilter(config([
-            { language: 'en', default: true },
-            { language: 'es' },
-            { language: 'fr' },
-        ]), 'es', false)).toThrow(/--lang es: previewing non-default languages.*--all-langs/i);
-    });
-    it('returns empty skip set when --all-langs is set', () => {
-        const result = getActiveLanguageFilter(config([
-            { language: 'en', default: true },
-            { language: 'es' },
-        ]), undefined, true);
-        expect(result.active).toBe('en');
-        expect(result.skip).toEqual(new Set());
-    });
-    it('throws on --lang code that does not exist in docs.json', () => {
-        expect(() => getActiveLanguageFilter(config([{ language: 'en', default: true }, { language: 'es' }]), 'de', false)).toThrow(/--lang de.*not.*docs\.json.*Available: en, es/);
-    });
-    it('handles malformed languages array (entries missing language field) by ignoring them', () => {
-        const malformed = {
-            navigation: {
-                languages: [
-                    { language: 'en', default: true },
-                    { default: false }, // missing language: ignored
-                    { language: 'es' },
-                    { language: 42 }, // wrong type: ignored
-                ],
-            },
-        };
-        const result = getActiveLanguageFilter(malformed, undefined, false);
-        expect(result.active).toBe('en');
-        expect(result.skip).toEqual(new Set(['es']));
-    });
-    it('returns null active when no valid language entries exist', () => {
-        const result = getActiveLanguageFilter({ navigation: { languages: [{ default: true }] } }, undefined, false);
-        expect(result).toEqual({ active: null, skip: new Set() });
-    });
-    it('rejects empty-string --lang as an invalid code (commander passes "" through)', () => {
-        // commander.js treats `--lang ""` as a value, not as missing — so
-        // langOption is "" (defined, but empty). Empty string is never a valid
-        // language code; surface it as a clear error rather than silently
-        // falling back to the default.
-        expect(() => getActiveLanguageFilter(config([{ language: 'en', default: true }, { language: 'es' }]), '', false)).toThrow(/--lang.*not.*docs\.json/);
-    });
-});
-describe('isPageInSkippedLanguage', () => {
-    it('returns false when skip set is empty', () => {
-        expect(isPageInSkippedLanguage('fr/introduction', new Set())).toBe(false);
-    });
-    it('returns true when first path segment is a skipped language', () => {
-        expect(isPageInSkippedLanguage('fr/introduction', new Set(['fr']))).toBe(true);
-    });
-    it('returns true for nested paths inside a skipped language', () => {
-        expect(isPageInSkippedLanguage('fr/setup/connecting-github', new Set(['fr', 'de']))).toBe(true);
-    });
-    it('returns false when first segment is the active language', () => {
-        expect(isPageInSkippedLanguage('en/introduction', new Set(['fr']))).toBe(false);
-    });
-    it('returns false for unprefixed root pages', () => {
-        expect(isPageInSkippedLanguage('introduction', new Set(['fr']))).toBe(false);
-    });
-    it('does not match when the skip code is a prefix-substring of a different segment', () => {
-        // Guard against startsWith('fr/') matching e.g. 'fr-something/foo'
-        expect(isPageInSkippedLanguage('fr-something/foo', new Set(['fr']))).toBe(false);
-    });
-    it('returns true for a path with a fragment anchor in a skipped language', () => {
-        // Broken-anchor warnings from validate-links.cjs surface as link values
-        // like `fr/introduction#missing-section` — the fragment lives past the
-        // first segment so the language check still works.
-        expect(isPageInSkippedLanguage('fr/introduction#setup', new Set(['fr']))).toBe(true);
-    });
-});
-describe('filterConfigByActiveLanguage', () => {
-    it('returns the input unchanged (same reference) when skip is empty', () => {
-        const config = { name: 'foo', navigation: { languages: [{ language: 'en' }] } };
-        const result = filterConfigByActiveLanguage(config, { active: 'en', skip: new Set() });
-        expect(result).toBe(config);
-    });
-    it('drops skipped languages from navigation.languages', () => {
-        const config = {
-            name: 'jamdesk-docs',
-            navigation: {
-                languages: [
-                    { language: 'en', default: true, tabs: [{ tab: 'Guide' }] },
-                    { language: 'fr', tabs: [{ tab: 'Guide' }] },
-                    { language: 'de', tabs: [{ tab: 'Guide' }] },
-                ],
-            },
-        };
-        const result = filterConfigByActiveLanguage(config, {
-            active: 'en',
-            skip: new Set(['fr', 'de']),
-        });
-        expect(result.navigation.languages).toEqual([
-            { language: 'en', default: true, tabs: [{ tab: 'Guide' }] },
-        ]);
-        // Top-level fields preserved.
-        expect(result.name).toBe('jamdesk-docs');
-        // Original config untouched.
-        expect(config.navigation.languages).toHaveLength(3);
-    });
-    it('preserves other navigation fields (tabs, global, anchors, etc.)', () => {
-        const config = {
-            navigation: {
-                languages: [{ language: 'en' }, { language: 'fr' }],
-                global: { anchors: [{ anchor: 'Support' }] },
-            },
-        };
-        const result = filterConfigByActiveLanguage(config, {
-            active: 'en',
-            skip: new Set(['fr']),
-        });
-        expect(result.navigation.global).toEqual({ anchors: [{ anchor: 'Support' }] });
-        expect(result.navigation.languages).toHaveLength(1);
-    });
-});
-//# sourceMappingURL=language-filter.test.js.map