jamdesk 1.0.22 → 1.1.0

package/vendored/schema/docs-schema.json

@@ -879,6 +879,24 @@
               "typography": {
                 "type": "boolean",
                 "description": "Enable typography enhancements: smart quotes (\u201ccurly\u201d), en-dashes (\u2013), em-dashes (\u2014), and ellipses (\u2026). Defaults to `false`"
+              },
+              "js": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "pattern": "^/",
+                    "description": "Path to a custom JavaScript file relative to your docs directory (e.g., \"/script.js\")"
+                  },
+                  {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "pattern": "^/"
+                    },
+                    "description": "Array of custom JavaScript file paths to include on every page"
+                  }
+                ],
+                "description": "Custom JavaScript to include on every page. Specify a file path or array of paths relative to your docs directory"
               }
             },
             "additionalProperties": false,
@@ -1040,6 +1058,19 @@
                 ],
                 "additionalProperties": false
               },
+              "crisp": {
+                "type": "object",
+                "properties": {
+                  "websiteId": {
+                    "type": "string",
+                    "minLength": 8
+                  }
+                },
+                "required": [
+                  "websiteId"
+                ],
+                "additionalProperties": false
+              },
               "intercom": {
                 "type": "object",
                 "properties": {
@@ -1248,6 +1279,10 @@
           "contextual": {
             "type": "object",
             "properties": {
+              "enabled": {
+                "type": "boolean",
+                "description": "Enable or disable the AI Actions menu. Default: true"
+              },
               "options": {
                 "type": "array",
                 "items": {
@@ -1259,6 +1294,7 @@
                         "view",
                         "chatgpt",
                         "claude",
+                        "gemini",
                         "perplexity",
                         "mcp",
                         "cursor",
@@ -1330,9 +1366,6 @@
                 "description": "Contextual menu options available on documentation pages"
               }
             },
-            "required": [
-              "options"
-            ],
             "additionalProperties": false,
             "description": "Configure contextual menu options for page actions (copy, view source, AI chat, etc.)"
           },

package/vendored/scripts/copy-files.cjs

@@ -3,7 +3,7 @@
  * Copy Static Assets Script
  * 
  * Copies static assets from project's images directory to public/images.
- * Also copies custom style.css and script.js if they exist in project root.
+ * Also copies custom style.css and JS files if they exist in project root.
  * Supports project-specific builds via PROJECT_NAME environment variable.
  * 
  * File type and size restrictions:
@@ -17,7 +17,8 @@
  * 
  * Custom Files (optional):
  *   projects/<name>/style.css  -> public/custom.css (overrides theme styles)
- *   projects/<name>/script.js  -> public/custom.js (custom JavaScript)
+ *   projects/<name>/*.js       -> public/custom.js (custom JavaScript, concatenated)
+ *     - Configured via styling.js in docs.json, or auto-detected from project root
  * 
  */
 
@@ -94,7 +95,6 @@ async function copyCustomFiles() {
 
   const customFiles = [
     { src: 'style.css', dest: 'custom.css', configKey: '_hasCustomCss' },
-    { src: 'script.js', dest: 'custom.js', configKey: '_hasCustomJs' },
     { src: 'sitemap.xml', dest: 'sitemap.xml', configKey: '_hasCustomSitemap' },
     { src: 'robots.txt', dest: 'robots.txt', configKey: '_hasCustomRobots' },
   ];
@@ -125,7 +125,50 @@ async function copyCustomFiles() {
       docsConfig[configKey] = false;
     }
   }
-  
+
+  // Handle custom JavaScript (supports styling.js config + auto-detection)
+  const customJsDest = path.join(publicDir, 'custom.js');
+  let jsFiles = [];
+
+  if (docsConfig.styling?.js) {
+    // Use configured paths from styling.js
+    const configured = Array.isArray(docsConfig.styling.js)
+      ? docsConfig.styling.js
+      : [docsConfig.styling.js];
+    jsFiles = configured.map(p => p.replace(/^\//, ''));
+  } else {
+    // Auto-detect .js files in project root
+    try {
+      jsFiles = fs.readdirSync(projectDir)
+        .filter(f => f.endsWith('.js') && fs.statSync(path.join(projectDir, f)).isFile())
+        .sort();
+    } catch { /* ignore */ }
+  }
+
+  if (jsFiles.length > 0) {
+    const jsContents = [];
+    for (const file of jsFiles) {
+      const srcPath = path.join(projectDir, file);
+      if (fs.existsSync(srcPath)) {
+        jsContents.push(fs.readFileSync(srcPath, 'utf8'));
+      }
+    }
+    if (jsContents.length > 0) {
+      fs.writeFileSync(customJsDest, jsContents.join('\n'));
+      docsConfig._hasCustomJs = true;
+      console.log(`   ✓ Custom JS (${jsFiles.join(', ')}) -> custom.js`);
+    } else {
+      // All configured files missing — clean up stale custom.js
+      if (fs.existsSync(customJsDest)) fs.removeSync(customJsDest);
+      docsConfig._hasCustomJs = false;
+    }
+  } else {
+    if (fs.existsSync(customJsDest)) {
+      fs.removeSync(customJsDest);
+    }
+    docsConfig._hasCustomJs = false;
+  }
+
   // Write updated docs.json with custom file flags
   await fs.writeJson(docsJsonPath, docsConfig, { spaces: 2 });
 }

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

@@ -1,25 +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';
-
-
-const CodeLink = ({ title, href }: any) => {
-  return (
-    <Card title={`${title}`} href={`${href}`} horizontal icon="code">
-      {" "}
-    </Card>
-  );
-};
-
-export default CodeLink;

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

@@ -1,44 +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';
-
-
-const HeaderAPI = ({ noProfileKey, profileKeyRequired }: any) => (
-  <>
-    <ParamField header="Authorization" type="string" required>
-      <a href="/apis/overview#authorization">API Key</a> of the Primary Profile.
-      <br />
-      <br />
-      Format: <code>Authorization: Bearer API_KEY</code>
-    </ParamField>
-    {!noProfileKey &&
-      (profileKeyRequired ? (
-        <ParamField header="Profile-Key" type="string" required>
-          <a href="/apis/overview#profile-key-format">Profile Key</a> of a User Profile.
-          <br />
-          <br />
-          Format: <code>Profile-Key: PROFILE_KEY</code>
-        </ParamField>
-      ) : (
-        <ParamField header="Profile-Key" type="string">
-          <a href="/apis/overview#profile-key-format">Profile Key</a> of a User Profile.
-          <br />
-          <br />
-          Format: <code>Profile-Key: PROFILE_KEY</code>
-        </ParamField>
-      ))}
-  </>
-);
-
-export default HeaderAPI;

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

@@ -1,53 +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';
-
-
-const PlansAvailable = ({ plans, maxPackRequired }: any) => {
-  let displayPlans = plans;
-
-if (plans.length === 1) {
-const lowerCasePlan = plans[0].toLowerCase();
-if (lowerCasePlan === "basic") {
-displayPlans = ["Basic", "Premium", "Business", "Enterprise"];
-} else if (lowerCasePlan === "business") {
-displayPlans = ["Business", "Enterprise"];
-} else if (lowerCasePlan === "premium") {
-displayPlans = ["Premium", "Business", "Enterprise"];
-}
-}
-
-return (
-
-<Note>
-Available on {displayPlans.length === 1 ? "the " : ""}
-{displayPlans.join(", ").replace(/\b\w/g, (l) => l.toUpperCase())}{" "}
-{displayPlans.length > 1 ? "plans" : "plan"}.
-
-{maxPackRequired && (
-
-  <a href="https://www.acme.com/docs/additional/maxpack"
- className="flex items-center mt-2 cursor-pointer"
->
- <span className="px-1.5 py-0.5 rounded text-sm" style={{backgroundColor: '#C264B6', color: 'white', fontSize: '12px'}}>
-   Max Pack required
- </span>
-</a>
-)}
-</Note>
-
-);
-};
-
-export default PlansAvailable;

package/vendored/components/snippets/generated/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={"One of the core principles of software development is DRY (Don't Repeat\nYourself). This is a principle that apply to documentation as\nwell. If you find yourself repeating the same content in multiple places, you\nshould consider creating a custom snippet to keep your content in sync."} />;
-};
-
-export default SnippetIntro;