jamdesk 1.1.19 → 1.1.21

package/vendored/lib/paths.ts

@@ -1,20 +1,32 @@
 /**
- * ESM Path Helpers
- * 
- * Since ESM doesn't have __dirname, we create helpers for common paths.
- * Import these instead of using __dirname directly.
+ * Path Helpers
+ *
+ * Centralized build-service paths derived from the CJS `__dirname` of this file.
  */
 
-import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
+import { existsSync } from 'fs';
 
-// Get the directory of the current module
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
+/**
+ * Resolve the build-service root directory.
+ *
+ * In source (tsx / vitest): __dirname = build-service/lib  → parent is root.
+ * In compiled CJS:          __dirname = build-service/dist/lib → grandparent is root.
+ *
+ * We walk up from __dirname until we find the directory containing package.json.
+ */
+function findProjectRoot(): string {
+  let dir = dirname(__dirname); // one level up from lib/
+  if (existsSync(join(dir, 'package.json'))) return dir;
+  dir = dirname(dir); // two levels up (from dist/lib/)
+  if (existsSync(join(dir, 'package.json'))) return dir;
+  // Fallback — should never happen
+  return dirname(__dirname);
+}
 
 // Export common paths
 export const LIB_DIR = __dirname;
-export const BUILD_SERVICE_DIR = dirname(__dirname);
+export const BUILD_SERVICE_DIR = findProjectRoot();
 export const PROJECTS_DIR = join(BUILD_SERVICE_DIR, 'projects');
 export const SCRIPTS_DIR = join(BUILD_SERVICE_DIR, 'scripts');
 export const PUBLIC_DIR = join(BUILD_SERVICE_DIR, 'public');

package/vendored/lib/project-slug-context.tsx

@@ -0,0 +1,27 @@
+'use client';
+
+import { createContext, useContext, type ReactNode } from 'react';
+
+// `NEXT_PUBLIC_PROJECT_SLUG` is inlined at build time and unset in the
+// multi-tenant ISR deployment, so the slug has to flow through context.
+// `layout.tsx` seeds the value from the `x-project-slug` header set by
+// middleware. Empty string means "unknown" — consumers should no-op.
+const ProjectSlugContext = createContext<string>('');
+
+export function ProjectSlugProvider({
+  children,
+  slug,
+}: {
+  children: ReactNode;
+  slug: string;
+}): React.ReactElement {
+  return (
+    <ProjectSlugContext.Provider value={slug}>
+      {children}
+    </ProjectSlugContext.Provider>
+  );
+}
+
+export function useProjectSlug(): string {
+  return useContext(ProjectSlugContext);
+}

package/vendored/lib/r2-manifest.ts

@@ -52,6 +52,7 @@ export interface Manifest {
   projectSlug?: string;
   files: Record<string, { hash: string; size?: number }>;
   snippets?: Record<string, { hash: string }>;
+  assets?: Record<string, { hash: string }>;
   configHash?: string;
 }
 

package/vendored/next.config.js

@@ -12,6 +12,7 @@
 
 /** @type {import('next').NextConfig} */
 const nextConfig = {
+  poweredByHeader: false,
   // Hide dev indicator (floating icon in bottom-left)
   devIndicators: false,
   // Rewrite /_jd/ asset paths to public/ in dev (ISR middleware handles this in production)
@@ -20,6 +21,7 @@ const nextConfig = {
       { source: '/_jd/images/:path*', destination: '/images/:path*' },
       { source: '/_jd/videos/:path*', destination: '/videos/:path*' },
       { source: '/_jd/playground/:path*', destination: '/api/playground/:path*' },
+      { source: '/_jd/:path*', destination: '/:path*' },
     ];
   },
   // Allow /_jd/ image paths with ?v= cache-busting query strings in <Image>

package/vendored/schema/docs-schema.json

@@ -1544,6 +1544,17 @@
                     },
                     "additionalProperties": false,
                     "description": "Configuration for the jamdesk spellcheck command"
+                },
+                "images": {
+                    "type": "object",
+                    "description": "Image optimization settings for documentation builds",
+                    "properties": {
+                        "convertToWebp": {
+                            "type": "boolean",
+                            "description": "Automatically convert PNG and JPG images to WebP format during builds. Reduces image sizes by 60-80% for faster page loads. SVG and GIF files are not converted. Default: false"
+                        }
+                    },
+                    "additionalProperties": false
                 }
             },
             "required": [
@@ -1660,6 +1671,9 @@
                 },
                 "spellcheck": {
                     "$ref": "#/anyOf/0/properties/spellcheck"
+                },
+                "images": {
+                    "$ref": "#/anyOf/0/properties/images"
                 }
             },
             "required": [
@@ -1776,6 +1790,9 @@
                 },
                 "spellcheck": {
                     "$ref": "#/anyOf/0/properties/spellcheck"
+                },
+                "images": {
+                    "$ref": "#/anyOf/0/properties/images"
                 }
             },
             "required": [

package/vendored/components/snippets/generated/ar__SnippetIntro.tsx

@@ -1,43 +0,0 @@
-// Auto-generated file - do not edit manually
-// @ts-nocheck
-
-import React from 'react';
-
-// Import built-in MDX components that snippets can use
-import { Note, Info, Warning, Tip, Check, Danger, Callout } from '@/components/mdx/Callouts';
-import { Card } from '@/components/mdx/Card';
-import { CardGroup } from '@/components/mdx/CardGroup';
-import { ParamField } from '@/components/mdx/ParamField';
-import { ResponseField } from '@/components/mdx/ResponseField';
-import { Accordion, AccordionGroup } from '@/components/mdx/Accordion';
-import { CodeGroup } from '@/components/mdx/CodeGroup';
-import { Steps, Step } from '@/components/mdx/Steps';
-
-
-// Helper component for rendering plain MDX snippets
-// Content is from project snippets (controlled source), not user input
-const PlainMdxSnippet = ({ content }: { content: string }) => {
-  const formattedContent = content
-    .split('\n\n')
-    .map((paragraph) => {
-      let html = paragraph.replace(/\*\*([^*]+)\*\*/g, '<strong>$1</strong>');
-      html = html.replace(/\*([^*]+)\*/g, '<em>$1</em>');
-      html = html.replace(/\`([^\`]+)\`/g, '<code>$1</code>');
-      return html;
-    })
-    .filter(p => p.trim());
-
-  return (
-    <div className="snippet-content">
-      {formattedContent.map((p, i) => (
-        <p key={i} dangerouslySetInnerHTML={{ __html: p }} />
-      ))}
-    </div>
-  );
-};
-
-const SnippetIntro = () => {
-  return <PlainMdxSnippet content={"أحد المبادئ الأساسية في تطوير البرمجيات هو مبدأ DRY (Don't Repeat\nYourself). وهذا مبدأ ينطبق على التوثيق أيضًا.\nإذا وجدت نفسك تكرر المحتوى نفسه في عدة أماكن، ففكّر في إنشاء مقتطف\nمخصص (snippet) للحفاظ على content الخاص بك متزامنًا."} />;
-};
-
-export default SnippetIntro;

package/vendored/components/snippets/generated/es__SnippetIntro.tsx

@@ -1,43 +0,0 @@
-// Auto-generated file - do not edit manually
-// @ts-nocheck
-
-import React from 'react';
-
-// Import built-in MDX components that snippets can use
-import { Note, Info, Warning, Tip, Check, Danger, Callout } from '@/components/mdx/Callouts';
-import { Card } from '@/components/mdx/Card';
-import { CardGroup } from '@/components/mdx/CardGroup';
-import { ParamField } from '@/components/mdx/ParamField';
-import { ResponseField } from '@/components/mdx/ResponseField';
-import { Accordion, AccordionGroup } from '@/components/mdx/Accordion';
-import { CodeGroup } from '@/components/mdx/CodeGroup';
-import { Steps, Step } from '@/components/mdx/Steps';
-
-
-// Helper component for rendering plain MDX snippets
-// Content is from project snippets (controlled source), not user input
-const PlainMdxSnippet = ({ content }: { content: string }) => {
-  const formattedContent = content
-    .split('\n\n')
-    .map((paragraph) => {
-      let html = paragraph.replace(/\*\*([^*]+)\*\*/g, '<strong>$1</strong>');
-      html = html.replace(/\*([^*]+)\*/g, '<em>$1</em>');
-      html = html.replace(/\`([^\`]+)\`/g, '<code>$1</code>');
-      return html;
-    })
-    .filter(p => p.trim());
-
-  return (
-    <div className="snippet-content">
-      {formattedContent.map((p, i) => (
-        <p key={i} dangerouslySetInnerHTML={{ __html: p }} />
-      ))}
-    </div>
-  );
-};
-
-const SnippetIntro = () => {
-  return <PlainMdxSnippet content={"Uno de los principios fundamentales del desarrollo de software es DRY (Don't Repeat Yourself). Este es un principio que también se aplica a la documentación. Si te encuentras repitiendo el mismo contenido en varios lugares, deberías considerar crear un snippet personalizado para mantener tu contenido sincronizado."} />;
-};
-
-export default SnippetIntro;

package/vendored/components/snippets/generated/ja__SnippetIntro.tsx

@@ -1,43 +0,0 @@
-// Auto-generated file - do not edit manually
-// @ts-nocheck
-
-import React from 'react';
-
-// Import built-in MDX components that snippets can use
-import { Note, Info, Warning, Tip, Check, Danger, Callout } from '@/components/mdx/Callouts';
-import { Card } from '@/components/mdx/Card';
-import { CardGroup } from '@/components/mdx/CardGroup';
-import { ParamField } from '@/components/mdx/ParamField';
-import { ResponseField } from '@/components/mdx/ResponseField';
-import { Accordion, AccordionGroup } from '@/components/mdx/Accordion';
-import { CodeGroup } from '@/components/mdx/CodeGroup';
-import { Steps, Step } from '@/components/mdx/Steps';
-
-
-// Helper component for rendering plain MDX snippets
-// Content is from project snippets (controlled source), not user input
-const PlainMdxSnippet = ({ content }: { content: string }) => {
-  const formattedContent = content
-    .split('\n\n')
-    .map((paragraph) => {
-      let html = paragraph.replace(/\*\*([^*]+)\*\*/g, '<strong>$1</strong>');
-      html = html.replace(/\*([^*]+)\*/g, '<em>$1</em>');
-      html = html.replace(/\`([^\`]+)\`/g, '<code>$1</code>');
-      return html;
-    })
-    .filter(p => p.trim());
-
-  return (
-    <div className="snippet-content">
-      {formattedContent.map((p, i) => (
-        <p key={i} dangerouslySetInnerHTML={{ __html: p }} />
-      ))}
-    </div>
-  );
-};
-
-const SnippetIntro = () => {
-  return <PlainMdxSnippet content={"ソフトウェア開発の中核となる原則の一つに、DRY（Don't Repeat Yourself）があります。この原則はドキュメントにも当てはまります。同じ内容を複数の場所で繰り返している場合は、内容を常に同期させておけるように、カスタムスニペットの作成を検討してください。"} />;
-};
-
-export default SnippetIntro;

package/vendored/components/snippets/generated/ko__SnippetIntro.tsx

@@ -1,43 +0,0 @@
-// Auto-generated file - do not edit manually
-// @ts-nocheck
-
-import React from 'react';
-
-// Import built-in MDX components that snippets can use
-import { Note, Info, Warning, Tip, Check, Danger, Callout } from '@/components/mdx/Callouts';
-import { Card } from '@/components/mdx/Card';
-import { CardGroup } from '@/components/mdx/CardGroup';
-import { ParamField } from '@/components/mdx/ParamField';
-import { ResponseField } from '@/components/mdx/ResponseField';
-import { Accordion, AccordionGroup } from '@/components/mdx/Accordion';
-import { CodeGroup } from '@/components/mdx/CodeGroup';
-import { Steps, Step } from '@/components/mdx/Steps';
-
-
-// Helper component for rendering plain MDX snippets
-// Content is from project snippets (controlled source), not user input
-const PlainMdxSnippet = ({ content }: { content: string }) => {
-  const formattedContent = content
-    .split('\n\n')
-    .map((paragraph) => {
-      let html = paragraph.replace(/\*\*([^*]+)\*\*/g, '<strong>$1</strong>');
-      html = html.replace(/\*([^*]+)\*/g, '<em>$1</em>');
-      html = html.replace(/\`([^\`]+)\`/g, '<code>$1</code>');
-      return html;
-    })
-    .filter(p => p.trim());
-
-  return (
-    <div className="snippet-content">
-      {formattedContent.map((p, i) => (
-        <p key={i} dangerouslySetInnerHTML={{ __html: p }} />
-      ))}
-    </div>
-  );
-};
-
-const SnippetIntro = () => {
-  return <PlainMdxSnippet content={"소프트웨어 개발의 핵심 원칙 중 하나는 DRY(Don't Repeat Yourself)입니다. 이 원칙은 문서 작성에도 그대로 적용됩니다. 동일한 content를 여러 곳에서 반복해서 작성하고 있다면, content를 일관되게 유지할 수 있도록 커스텀 스니펫을 만드는 것을 고려해야 합니다."} />;
-};
-
-export default SnippetIntro;

package/vendored/postcss.config.js

@@ -1,6 +0,0 @@
-export default {
-  plugins: {
-    '@tailwindcss/postcss': {},
-  },
-}
-