@codeyam/codeyam-cli 0.1.0-staging.e38f7bd → 0.1.0-staging.fef152f

package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.js

@@ -0,0 +1,189 @@
+import { safeFileName } from '~codeyam/utils';
+import getImageReplacementCode from './getImageReplacementCode';
+import getNextJsErrorClosingCode from './getNextJsErrorClosingCode';
+/**
+ * Generates the ScenarioClientWrapper component code.
+ * This is a Client Component that handles all the interactive features
+ * (iframe messaging, console interception, error closing, etc.)
+ * while allowing the actual page to be a Server Component.
+ */
+export default function generateScenarioClientWrapper(scenario) {
+    const safeScenarioName = safeFileName(scenario.name);
+    return `"use client";
+/* eslint-disable */
+// ScenarioClientWrapper - Client Component for interactive features
+// This wraps Server Components to add client-side interactivity
+
+import {
+  useCallback,
+  useEffect,
+  useState,
+  type ReactNode,
+} from 'react';
+import { scenarios } from "./MockData_${safeScenarioName}";
+
+// Inject image interception code at module level
+${getImageReplacementCode()}
+
+interface ScenarioClientWrapperProps {
+  scenarioName: string;
+  fileName: string;
+  version: string;
+  children: ReactNode;
+}
+
+export function ScenarioClientWrapper({
+  scenarioName,
+  fileName,
+  version,
+  children,
+}: ScenarioClientWrapperProps) {
+  const [internalVersion, setInternalVersion] = useState(1);
+  const [searchParams] = useState(() =>
+    typeof window !== 'undefined'
+      ? new URLSearchParams(window.location.search)
+      : new URLSearchParams()
+  );
+  const widthOverride = searchParams.get('width');
+  const heightOverride = searchParams.get('height') || 'auto';
+
+  // Set page metadata
+  useEffect(() => {
+    document.title = \`\${fileName}: \${scenarioName} CodeYam Demo v\${version}\`;
+    let metaDesc = document.querySelector('meta[name="description"]');
+    if (!metaDesc) {
+      metaDesc = document.createElement('meta');
+      metaDesc.setAttribute('name', 'description');
+      document.head.appendChild(metaDesc);
+    }
+    metaDesc.setAttribute('content', \`This is a demo of the \${fileName} component\`);
+  }, [fileName, scenarioName, version]);
+
+  // Message posting helper
+  const respond = useCallback((message: any) => {
+    try {
+      window.parent.postMessage({
+        type: 'codeyam-update',
+        name: scenarioName,
+        message,
+      }, '*');
+    } catch (e) {
+      console.warn('Error posting message to parent', message, e);
+    }
+  }, [scenarioName]);
+
+  // Handle data override messages from parent
+  useEffect(() => {
+    const eventListener = (event: MessageEvent) => {
+      if (event.data.type === 'codeyam-override-data') {
+        const parsedData = JSON.parse(event.data.data);
+        console.log("Override data received");
+        respond("Set override data to " + JSON.stringify(parsedData, null, 2));
+        scenarios().updateData(scenarioName, parsedData);
+        setInternalVersion(prev => prev + 1);
+      }
+    };
+    window.addEventListener('message', eventListener);
+    return () => window.removeEventListener('message', eventListener);
+  }, [respond, scenarioName]);
+
+  // Console interception
+  useEffect(() => {
+    const oldConsoleLog = console.log;
+    console.log = function(...args: any[]) {
+      oldConsoleLog(...args);
+      try {
+        window.parent.postMessage({
+          type: 'codeyam-log',
+          name: scenarioName,
+          data: {
+            log: {
+              name: "console.log",
+              args
+            }
+          }
+        }, '*');
+      } catch (e) {
+        oldConsoleLog('Error posting message to parent', e);
+      }
+    };
+
+    const oldConsoleError = console.error;
+    console.error = function(...args: any[]) {
+      oldConsoleError(...args);
+      window.parent.postMessage({
+        type: 'codeyam-log',
+        name: scenarioName,
+        data: {
+          log: {
+            name: "console.error",
+            args
+          }
+        }
+      }, '*');
+    };
+
+    return () => {
+      console.log = oldConsoleLog;
+      console.error = oldConsoleError;
+    };
+  }, [scenarioName]);
+
+  // Next.js error closing
+  ${getNextJsErrorClosingCode()}
+
+  // Height calculation and resize messaging
+  useEffect(() => {
+    if (typeof window === 'undefined') return;
+
+    const calculateHeight = () => {
+      const bodyHeight = document.body.offsetHeight;
+      const htmlHeight = document.documentElement.offsetHeight;
+      const scrollHeight = Math.max(
+        document.body.scrollHeight,
+        document.documentElement.scrollHeight,
+        document.body.offsetHeight,
+        document.documentElement.offsetHeight,
+        document.body.clientHeight,
+        document.documentElement.clientHeight
+      );
+      return Math.max(100, bodyHeight, htmlHeight, scrollHeight);
+    };
+
+    const calculatedHeight = calculateHeight();
+    parent.postMessage({ type: 'codeyam-resize', name: scenarioName, height: calculatedHeight }, '*');
+
+    const eventListener = (event: MessageEvent) => {
+      if (event.data.name === scenarioName) {
+        if (event.data.type === 'codeyam-respond') {
+          const calculatedHeight = calculateHeight();
+          parent.postMessage({ type: 'codeyam-resize', name: scenarioName, height: calculatedHeight }, '*');
+        }
+      }
+    };
+
+    window.addEventListener('message', eventListener);
+    return () => window.removeEventListener('message', eventListener);
+  }, [scenarioName]);
+
+  const width = widthOverride || 'auto';
+
+  return (
+    <div className='flex flex-col justify-center items-center h-screen' data-version={internalVersion}>
+      <div className='w-full flex items-center justify-center'>
+        <div id='component' style={{
+          minWidth: width !== 'auto' ? \`min(\${width}, 100vw)\` : undefined,
+          height: heightOverride !== 'auto' ? heightOverride : undefined,
+          minHeight: heightOverride !== 'auto' ? heightOverride : undefined,
+          display: 'block',
+          padding: '6px'
+        }}>
+          {children}
+        </div>
+      </div>
+    </div>
+  );
+}
+`;
+}
+//# sourceMappingURL=generateScenarioClientWrapper.js.map

package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateScenarioClientWrapper.js","sourceRoot":"","sources":["../../../../../../generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,uBAAuB,MAAM,2BAA2B,CAAC;AAChE,OAAO,yBAAyB,MAAM,6BAA6B,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,6BAA6B,CACnD,QAAkB;IAElB,MAAM,gBAAgB,GAAG,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAErD,OAAO;;;;;;;;;;;wCAW+B,gBAAgB;;;EAGtD,uBAAuB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA2GvB,yBAAyB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsD9B,CAAC;AACF,CAAC"}

package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.d.ts

@@ -0,0 +1,20 @@
+import { Entity, Analysis, type File, type Scenario } from '~codeyam/types';
+/**
+ * Generates a Server Component page for async components (Server Components in Next.js).
+ *
+ * This is needed because:
+ * 1. Async components use await, which only works in Server Components
+ * 2. Client Components ("use client") don't support async/await in the component body
+ * 3. We use Next.js composition pattern: Server Component page renders the async component,
+ *    then wraps it in a Client Component (ScenarioClientWrapper) for interactive features
+ */
+export default function generateScenarioServerComponent({ file, entity, analysis, currentPath, appPath, scenario, relativeMocksDir, }: {
+    file: File;
+    entity: Entity;
+    analysis: Analysis;
+    currentPath: string;
+    appPath: string;
+    scenario: Scenario;
+    relativeMocksDir: string;
+}): string;
+//# sourceMappingURL=generateScenarioServerComponent.d.ts.map

package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateScenarioServerComponent.d.ts","sourceRoot":"","sources":["../../../../../../generate/src/lib/componentScenarioPage/generateScenarioServerComponent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAO5E;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,+BAA+B,CAAC,EACtD,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,WAAW,EACX,OAAO,EACP,QAAQ,EACR,gBAAgB,GACjB,EAAE;IACD,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,UAwCA"}

package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.js

@@ -0,0 +1,53 @@
+import { safeFileName } from '~codeyam/utils';
+import getComponentImportStatement from '../getComponentImportStatement';
+import scenarioComponentForServer from '../scenarioComponentForServer';
+const VERSION = '0.5.1';
+/**
+ * Generates a Server Component page for async components (Server Components in Next.js).
+ *
+ * This is needed because:
+ * 1. Async components use await, which only works in Server Components
+ * 2. Client Components ("use client") don't support async/await in the component body
+ * 3. We use Next.js composition pattern: Server Component page renders the async component,
+ *    then wraps it in a Client Component (ScenarioClientWrapper) for interactive features
+ */
+export default function generateScenarioServerComponent({ file, entity, analysis, currentPath, appPath, scenario, relativeMocksDir, }) {
+    const fileName = file.name.split('.')[0];
+    const safeScenarioName = safeFileName(scenario.name);
+    return `/* eslint-disable */
+// Server Component page for async component: ${entity.name}
+// This page does NOT have "use client" - it runs on the server
+import { ScenarioClientWrapper } from "${relativeMocksDir}/ScenarioClientWrapper";
+${analysis.scenarios?.length > 0 ? `import { scenarios } from "${relativeMocksDir}/MockData_${safeScenarioName}";` : ''}
+${getComponentImportStatement({
+        file,
+        entity,
+        analysis,
+        currentPath,
+        appPath,
+        scenario,
+        primary: true,
+        namedExport: entity.name !== 'default' &&
+            (entity.metadata?.notExported || entity.metadata?.namedExport) &&
+            entity.entityType !== 'library',
+    })}
+
+function getScenarioProps({ argumentIndex, propName }: { argumentIndex: number, propName?: string }) {
+  const data = scenarios().data();
+  const argument = data['arguments'][argumentIndex];
+  return propName ? argument[propName] : argument;
+}
+
+export default async function Index() {
+  return (
+    <ScenarioClientWrapper
+      scenarioName="${scenario.name}"
+      fileName="${fileName}"
+      version="${VERSION}"
+    >
+      ${scenarioComponentForServer(entity, analysis, scenario)}
+    </ScenarioClientWrapper>
+  );
+}`;
+}
+//# sourceMappingURL=generateScenarioServerComponent.js.map

package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateScenarioServerComponent.js","sourceRoot":"","sources":["../../../../../../generate/src/lib/componentScenarioPage/generateScenarioServerComponent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,2BAA2B,MAAM,gCAAgC,CAAC;AACzE,OAAO,0BAA0B,MAAM,+BAA+B,CAAC;AAEvE,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,+BAA+B,CAAC,EACtD,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,WAAW,EACX,OAAO,EACP,QAAQ,EACR,gBAAgB,GASjB;IACC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,MAAM,gBAAgB,GAAG,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAErD,OAAO;gDACuC,MAAM,CAAC,IAAI;;yCAElB,gBAAgB;EACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,8BAA8B,gBAAgB,aAAa,gBAAgB,IAAI,CAAC,CAAC,CAAC,EAAE;EACrH,2BAA2B,CAAC;QAC5B,IAAI;QACJ,MAAM;QACN,QAAQ;QACR,WAAW;QACX,OAAO;QACP,QAAQ;QACR,OAAO,EAAE,IAAI;QACb,WAAW,EACT,MAAM,CAAC,IAAI,KAAK,SAAS;YACzB,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,IAAI,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC;YAC9D,MAAM,CAAC,UAAU,KAAK,SAAS;KAClC,CAAC;;;;;;;;;;;sBAWoB,QAAQ,CAAC,IAAI;kBACjB,QAAQ;iBACT,OAAO;;QAEhB,0BAA0B,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC;;;EAG5D,CAAC;AACH,CAAC"}

package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/getIFrameMessageListenerCode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getIFrameMessageListenerCode.d.ts","sourceRoot":"","sources":["../../../../../../generate/src/lib/componentScenarioPage/getIFrameMessageListenerCode.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,4BAA4B,CAAC,EACnD,YAAY,GACb,EAAE;IACD,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,CA4ET"}
+{"version":3,"file":"getIFrameMessageListenerCode.d.ts","sourceRoot":"","sources":["../../../../../../generate/src/lib/componentScenarioPage/getIFrameMessageListenerCode.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,4BAA4B,CAAC,EACnD,YAAY,GACb,EAAE;IACD,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,CAiFT"}

package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/getIFrameMessageListenerCode.js

@@ -1,4 +1,8 @@
 export default function getIFrameMessageListenerCode({ scenarioName, }) {
+    // Escape backslashes first, then single quotes to produce valid JS string literals
+    const escapedScenarioName = scenarioName
+        .replace(/\\/g, '\\\\')
+        .replace(/'/g, "\\'");
     return `const [version, setVersion] = useState(1);
 
   function _getScenarioProps({ argumentIndex, propName }: { argumentIndex: number, propName?: string }) {
@@ -10,7 +14,7 @@ export default function getIFrameMessageListenerCode({ scenarioName, }) {
     try {
       window.parent.postMessage({ 
         type: 'codeyam-update', 
-        name: '${scenarioName}',
+        name: '${escapedScenarioName}',
         message,
       }, '*');
     } catch (e) {
@@ -24,7 +28,7 @@ export default function getIFrameMessageListenerCode({ scenarioName, }) {
         const parsedData = JSON.parse(event.data.data);
         console.log("Override data received");
         respond("Set override data to " + JSON.stringify(parsedData, null, 2));
-        scenarios().updateData('${scenarioName}', parsedData);
+        scenarios().updateData('${escapedScenarioName}', parsedData);
         setVersion(prev => prev + 1);
       }
     }
@@ -40,7 +44,7 @@ export default function getIFrameMessageListenerCode({ scenarioName, }) {
       try {
         window.parent.postMessage({
           type: 'codeyam-log',
-          name: '${scenarioName}',
+          name: '${escapedScenarioName}',
           data: {
             log: {
               name: "console.log",
@@ -58,7 +62,7 @@ export default function getIFrameMessageListenerCode({ scenarioName, }) {
       oldConsoleError(...args);
       window.parent.postMessage({
         type: 'codeyam-log',
-        name: '${scenarioName}',
+        name: '${escapedScenarioName}',
         data: {
           log: {
             name: "console.log",

package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/getIFrameMessageListenerCode.js.map

@@ -1 +1 @@
-{"version":3,"file":"getIFrameMessageListenerCode.js","sourceRoot":"","sources":["../../../../../../generate/src/lib/componentScenarioPage/getIFrameMessageListenerCode.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,4BAA4B,CAAC,EACnD,YAAY,GAGb;IACC,OAAO;;;;;;;;;;;iBAWQ,YAAY;;;;;;;;;;;;;;kCAcK,YAAY;;;;;;;;;;;;;;;;mBAgB3B,YAAY;;;;;;;;;;;;;;;;;;iBAkBd,YAAY;;;;;;;;;;;;;;;CAe5B,CAAC;AACF,CAAC"}
+{"version":3,"file":"getIFrameMessageListenerCode.js","sourceRoot":"","sources":["../../../../../../generate/src/lib/componentScenarioPage/getIFrameMessageListenerCode.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,4BAA4B,CAAC,EACnD,YAAY,GAGb;IACC,mFAAmF;IACnF,MAAM,mBAAmB,GAAG,YAAY;SACrC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAExB,OAAO;;;;;;;;;;;iBAWQ,mBAAmB;;;;;;;;;;;;;;kCAcF,mBAAmB;;;;;;;;;;;;;;;;mBAgBlC,mBAAmB;;;;;;;;;;;;;;;;;;iBAkBrB,mBAAmB;;;;;;;;;;;;;;;CAenC,CAAC;AACF,CAAC"}

package/analyzer-template/packages/github/dist/generate/src/lib/deepMerge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deepMerge.d.ts","sourceRoot":"","sources":["../../../../../generate/src/lib/deepMerge.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,WAAW,EAAE,GAAG,EAChB,OAAO,EAAE,GAAG,EACZ,IAAI,kBAAgB,GACnB,GAAG,CAuCL"}
+{"version":3,"file":"deepMerge.d.ts","sourceRoot":"","sources":["../../../../../generate/src/lib/deepMerge.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,WAAW,EAAE,GAAG,EAChB,OAAO,EAAE,GAAG,EACZ,IAAI,kBAAgB,GACnB,GAAG,CAgEL"}

package/analyzer-template/packages/github/dist/generate/src/lib/deepMerge.js

@@ -10,6 +10,27 @@ export default function deepMerge(defaultData, changes, seen = new WeakSet()) {
             }
             seen.add(changes);
         }
+        // Handle arrays at the top level - this is critical for nested arrays (tuples)
+        // like [["path", { data }]] which should NOT be converted to objects
+        if (Array.isArray(changes)) {
+            const defaultArray = Array.isArray(defaultData) ? defaultData : [];
+            const result = [];
+            for (let i = 0; i < changes.length; i++) {
+                const item = changes[i];
+                if (item && typeof item === 'object' && !Array.isArray(item)) {
+                    // Merge object items with corresponding default array item
+                    result[i] = deepMerge(defaultArray[i], item, seen);
+                }
+                else if (Array.isArray(item)) {
+                    // Recursively handle nested arrays (tuples)
+                    result[i] = deepMerge(defaultArray[i], item, seen);
+                }
+                else {
+                    result[i] = item;
+                }
+            }
+            return result;
+        }
         const merge = { ...defaultData };
         for (const key in changes) {
             if (changes[key] === null) {
@@ -18,11 +39,16 @@ export default function deepMerge(defaultData, changes, seen = new WeakSet()) {
                 merge[key] = null;
             }
             else if (Array.isArray(changes[key])) {
+                // Get the original default array BEFORE we replace it
+                const defaultArray = Array.isArray(defaultData[key])
+                    ? defaultData[key]
+                    : [];
                 merge[key] = [];
                 for (let i = 0; i < changes[key].length; i++) {
                     const item = changes[key][i];
                     if (typeof item === 'object' && item !== null) {
-                        merge[key][i] = deepMerge(merge?.[key]?.[i], item, seen);
+                        // Merge with corresponding item from default array by index position
+                        merge[key][i] = deepMerge(defaultArray[i], item, seen);
                     }
                     else {
                         merge[key][i] = item;

package/analyzer-template/packages/github/dist/generate/src/lib/deepMerge.js.map

@@ -1 +1 @@
-{"version":3,"file":"deepMerge.js","sourceRoot":"","sources":["../../../../../generate/src/lib/deepMerge.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,WAAgB,EAChB,OAAY,EACZ,IAAI,GAAG,IAAI,OAAO,EAAE;IAEpB,IAAI,CAAC,OAAO;QAAE,OAAO,WAAW,CAAC;IACjC,IAAI,CAAC,WAAW;QAAE,OAAO,OAAO,CAAC;IAEjC,IAAI,CAAC;QACH,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACpD,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;YACnE,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACpB,CAAC;QAED,MAAM,KAAK,GAAG,EAAE,GAAG,WAAW,EAAE,CAAC;QACjC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC1B,4EAA4E;gBAC5E,+EAA+E;gBAC/E,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YACpB,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBACvC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;gBAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC7B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;wBAC9C,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;oBAC3D,CAAC;yBAAM,CAAC;wBACN,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;oBACvB,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;gBACrE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;YAC/D,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,6BAA6B,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QACjE,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC"}
+{"version":3,"file":"deepMerge.js","sourceRoot":"","sources":["../../../../../generate/src/lib/deepMerge.ts"],"names":[],"mappings":"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"}

package/analyzer-template/packages/github/dist/generate/src/lib/directExecutionScript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"directExecutionScript.d.ts","sourceRoot":"","sources":["../../../../../generate/src/lib/directExecutionScript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAElE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAC3C,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,GACjB,MAAM,CAuJR"}
+{"version":3,"file":"directExecutionScript.d.ts","sourceRoot":"","sources":["../../../../../generate/src/lib/directExecutionScript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAElE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAC3C,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,GACjB,MAAM,CAsKR"}

package/analyzer-template/packages/github/dist/generate/src/lib/directExecutionScript.js

@@ -11,6 +11,15 @@
  */
 export default function directExecutionScript(file, entity, analysis, scenario) {
     const { name: entityName } = entity;
+    // notExported entities cannot be imported, so we can't generate an execution script
+    if (entity.metadata?.notExported) {
+        console.log('CodeYam Error: directExecutionScript called with notExported entity', {
+            entityName,
+            filePath: file.path,
+            metadata: entity.metadata,
+        });
+        throw new Error(`Cannot generate execution script for entity '${entityName}' - it is not exported from '${file.path}'`);
+    }
     const safeEntityName = entityName === 'default' ? 'defaultExport' : entityName;
     // Check if this is a class method
     const isMethod = entity.entityType === 'method';
@@ -33,7 +42,7 @@ export default function directExecutionScript(file, entity, analysis, scenario)
     const importPath = file.path.replace(/\.(ts|tsx|js|jsx)$/, '');
     // Determine if it's a named or default export
     const isDefaultExport = entity.name === 'default';
-    const isNamedExport = entity.metadata?.namedExport || entity.metadata?.notExported;
+    const isNamedExport = entity.metadata?.namedExport;
     let importStatement;
     if (isMethod) {
         // For methods, we always import the parent class

package/analyzer-template/packages/github/dist/generate/src/lib/directExecutionScript.js.map

@@ -1 +1 @@
-{"version":3,"file":"directExecutionScript.js","sourceRoot":"","sources":["../../../../../generate/src/lib/directExecutionScript.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"directExecutionScript.js","sourceRoot":"","sources":["../../../../../generate/src/lib/directExecutionScript.ts"],"names":[],"mappings":"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"}

package/analyzer-template/packages/github/dist/generate/src/lib/getComponentScenarioPath.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getComponentScenarioPath.d.ts","sourceRoot":"","sources":["../../../../../generate/src/lib/getComponentScenarioPath.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAKxD,eAAO,MAAM,0BAA0B,yBAAyB,CAAC;AAEjE,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAC9C,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,UAqBjB"}
+{"version":3,"file":"getComponentScenarioPath.d.ts","sourceRoot":"","sources":["../../../../../generate/src/lib/getComponentScenarioPath.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAKxD,eAAO,MAAM,0BAA0B,yBAAyB,CAAC;AAEjE,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAC9C,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,UA0BjB"}

package/analyzer-template/packages/github/dist/generate/src/lib/getComponentScenarioPath.js

@@ -9,13 +9,17 @@ export default function getComponentScenarioPath(file, entity, currentPath, appP
         ? `${appPath}/${CODEYAM_DEMO_PAGES_DIRNAME}/${file.name}`
         : file.path;
     const relativePath = safeFolder(getRelativePath(currentPath, filePath).split('/').slice(0, -1).join('/'));
+    // Check if the file is an index file (e.g., index.tsx, index.ts)
+    // This must match the logic in writeScenarioComponents.ts
+    const isIndexFile = file.name.startsWith('index.');
+    const indexPrefix = isIndexFile ? 'index_' : '';
     if (scenario) {
         // Include scenario name in path to allow multiple scenarios to coexist
         const importPath = isLibraryDemoPage
-            ? `${relativePath}/${entity.sha}_${safeFileName(entityName)}_${safeFileName(scenario.name)}`
-            : `${relativePath}/${entity.sha}_${safeFileName(entityName)}_${safeFileName(scenario.name)}`;
+            ? `${relativePath}/${entity.sha}_${indexPrefix}${safeFileName(entityName)}_${safeFileName(scenario.name)}`
+            : `${relativePath}/${entity.sha}_${indexPrefix}${safeFileName(entityName)}_${safeFileName(scenario.name)}`;
         return `${importPath}`;
     }
-    return `${relativePath}_${entity.sha}_${safeFileName(entityName)}`;
+    return `${relativePath}_${entity.sha}_${indexPrefix}${safeFileName(entityName)}`;
 }
 //# sourceMappingURL=getComponentScenarioPath.js.map

package/analyzer-template/packages/github/dist/generate/src/lib/getComponentScenarioPath.js.map

@@ -1 +1 @@
-{"version":3,"file":"getComponentScenarioPath.js","sourceRoot":"","sources":["../../../../../generate/src/lib/getComponentScenarioPath.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,eAAe,MAAM,mBAAmB,CAAC;AAChD,OAAO,UAAU,MAAM,cAAc,CAAC;AAEtC,MAAM,CAAC,MAAM,0BAA0B,GAAG,sBAAsB,CAAC;AAEjE,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAC9C,IAAU,EACV,MAAc,EACd,WAAmB,EACnB,OAAe,EACf,QAAkB,EAClB,OAAgB;IAEhB,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IACpC,MAAM,iBAAiB,GAAG,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC;IACrE,MAAM,QAAQ,GAAG,iBAAiB;QAChC,CAAC,CAAC,GAAG,OAAO,IAAI,0BAA0B,IAAI,IAAI,CAAC,IAAI,EAAE;QACzD,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAEd,MAAM,YAAY,GAAG,UAAU,CAC7B,eAAe,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CACzE,CAAC;IAEF,IAAI,QAAQ,EAAE,CAAC;QACb,uEAAuE;QACvE,MAAM,UAAU,GAAG,iBAAiB;YAClC,CAAC,CAAC,GAAG,YAAY,IAAI,MAAM,CAAC,GAAG,IAAI,YAAY,CAAC,UAAU,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;YAC5F,CAAC,CAAC,GAAG,YAAY,IAAI,MAAM,CAAC,GAAG,IAAI,YAAY,CAAC,UAAU,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/F,OAAO,GAAG,UAAU,EAAE,CAAC;IACzB,CAAC;IAED,OAAO,GAAG,YAAY,IAAI,MAAM,CAAC,GAAG,IAAI,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;AACrE,CAAC"}
+{"version":3,"file":"getComponentScenarioPath.js","sourceRoot":"","sources":["../../../../../generate/src/lib/getComponentScenarioPath.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,eAAe,MAAM,mBAAmB,CAAC;AAChD,OAAO,UAAU,MAAM,cAAc,CAAC;AAEtC,MAAM,CAAC,MAAM,0BAA0B,GAAG,sBAAsB,CAAC;AAEjE,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAC9C,IAAU,EACV,MAAc,EACd,WAAmB,EACnB,OAAe,EACf,QAAkB,EAClB,OAAgB;IAEhB,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IACpC,MAAM,iBAAiB,GAAG,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC;IACrE,MAAM,QAAQ,GAAG,iBAAiB;QAChC,CAAC,CAAC,GAAG,OAAO,IAAI,0BAA0B,IAAI,IAAI,CAAC,IAAI,EAAE;QACzD,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAEd,MAAM,YAAY,GAAG,UAAU,CAC7B,eAAe,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CACzE,CAAC;IAEF,iEAAiE;IACjE,0DAA0D;IAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAEhD,IAAI,QAAQ,EAAE,CAAC;QACb,uEAAuE;QACvE,MAAM,UAAU,GAAG,iBAAiB;YAClC,CAAC,CAAC,GAAG,YAAY,IAAI,MAAM,CAAC,GAAG,IAAI,WAAW,GAAG,YAAY,CAAC,UAAU,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;YAC1G,CAAC,CAAC,GAAG,YAAY,IAAI,MAAM,CAAC,GAAG,IAAI,WAAW,GAAG,YAAY,CAAC,UAAU,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7G,OAAO,GAAG,UAAU,EAAE,CAAC;IACzB,CAAC;IAED,OAAO,GAAG,YAAY,IAAI,MAAM,CAAC,GAAG,IAAI,WAAW,GAAG,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;AACnF,CAAC"}

package/analyzer-template/packages/github/dist/generate/src/lib/scenarioComponentForServer.d.ts

@@ -0,0 +1,8 @@
+import type { Analysis, Entity, Scenario } from '~codeyam/types';
+/**
+ * Generates the component JSX for Server Component pages.
+ * Unlike scenarioComponent, this doesn't wrap in a Scenario component
+ * (the ScenarioClientWrapper handles that on the client).
+ */
+export default function scenarioComponentForServer(entity: Entity, analysis: Analysis, scenario: Scenario): string;
+//# sourceMappingURL=scenarioComponentForServer.d.ts.map

package/analyzer-template/packages/github/dist/generate/src/lib/scenarioComponentForServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenarioComponentForServer.d.ts","sourceRoot":"","sources":["../../../../../generate/src/lib/scenarioComponentForServer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAiBjE;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,0BAA0B,CAChD,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,UAwFnB"}

package/analyzer-template/packages/github/dist/generate/src/lib/scenarioComponentForServer.js

@@ -0,0 +1,89 @@
+import { safeFileName } from '~codeyam/utils';
+import handleWrappers from './handleWrappers';
+// Escape double quotes for use in JavaScript string literals
+const escapeForJsString = (s) => s.replace(/"/g, '\\"');
+const dimensionString = (dimension) => {
+    if (!dimension)
+        return 'auto';
+    if (typeof dimension === 'string') {
+        if (dimension === 'full')
+            return '100%';
+        if (dimension.indexOf('%') > -1)
+            return dimension;
+        if (dimension.indexOf('px') > -1)
+            return dimension;
+    }
+    return `${dimension}px`;
+};
+/**
+ * Generates the component JSX for Server Component pages.
+ * Unlike scenarioComponent, this doesn't wrap in a Scenario component
+ * (the ScenarioClientWrapper handles that on the client).
+ */
+export default function scenarioComponentForServer(entity, analysis, scenario) {
+    let entityComponentName = entity.entityType === 'library' ? safeFileName(entity.name) : entity.name;
+    if (entityComponentName === 'default') {
+        entityComponentName =
+            entity.entityType === 'library' ? 'defaultExport' : 'DefaultExport';
+    }
+    const positionalArguments = analysis.metadata?.scenariosDataStructure?.arguments ?? [];
+    const namedArguments = typeof positionalArguments?.[0] === 'object'
+        ? Object.keys(positionalArguments?.[0])
+        : [];
+    // Use analysis.metadata.defaultWidth as override, otherwise fall back to entity.metadata.defaultWidth
+    const width = dimensionString(entity?.entityType === 'library'
+        ? '100%'
+        : (analysis.metadata?.defaultWidth ?? entity.metadata?.defaultWidth));
+    console.log('CodeYam: Server Scenario', {
+        analysisId: scenario.analysisId,
+        scenarioId: scenario.id,
+        scenarioName: scenario.name,
+        scenarioDescription: scenario.description,
+        width,
+    });
+    const childrenArg = namedArguments.find((name) => name === 'children');
+    const nonChildrenAndRefProps = namedArguments.filter((name) => name !== 'children' && name !== 'ref');
+    // Deduplicate props by their base name (before parentheses for function overloads)
+    const seenBaseNames = new Set();
+    const uniqueProps = nonChildrenAndRefProps.filter((name) => {
+        const baseName = name.endsWith(')') ? name.split('(')[0] : name;
+        if (seenBaseNames.has(baseName)) {
+            return false;
+        }
+        seenBaseNames.add(baseName);
+        return true;
+    });
+    const argsSpacing = '\n         ';
+    let args = `${argsSpacing}`;
+    if (positionalArguments.length === 0) {
+        args += '>';
+    }
+    else if (positionalArguments.length === 1) {
+        if (typeof positionalArguments[0] === 'object') {
+            args +=
+                uniqueProps?.length > 0
+                    ? `${uniqueProps
+                        .map((name) => isNaN(parseInt(name))
+                        ? name.endsWith(')')
+                            ? `${name.split('(')[0]}={() => getScenarioProps({ argumentIndex: 0, propName: "${escapeForJsString(name)}" }) as any}`
+                            : `${name}={getScenarioProps({ argumentIndex: 0, propName: "${escapeForJsString(name)}" }) as any}`
+                        : `positionalArgument_${name}={getScenarioProps({ argumentIndex: 0, propName: "positionalArgument_${escapeForJsString(name)}" }) as any}`)
+                        .join(argsSpacing)}\n      >`
+                    : `>`;
+        }
+        else {
+            args += `positionalArgument_0={getScenarioProps({ argumentIndex: 0 }) as any}${argsSpacing}\n      >`;
+        }
+    }
+    else if (positionalArguments.length > 1) {
+        args += `${positionalArguments
+            .map((_, index) => `positionalArgument_${index}={getScenarioProps({ argumentIndex: ${index} }) as any}`)
+            .join(argsSpacing)}\n      >`;
+    }
+    const children = childrenArg
+        ? `\n             {getScenarioProps({ argumentIndex: 0, propName: 'children'})}`
+        : '';
+    // For server components, we don't wrap in Scenario - that's handled by ScenarioClientWrapper
+    return handleWrappers(`<${entityComponentName}${args}${children}\n          </${entityComponentName}>`, analysis);
+}
+//# sourceMappingURL=scenarioComponentForServer.js.map

package/analyzer-template/packages/github/dist/generate/src/lib/scenarioComponentForServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenarioComponentForServer.js","sourceRoot":"","sources":["../../../../../generate/src/lib/scenarioComponentForServer.ts"],"names":[],"mappings":"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"}

package/analyzer-template/packages/github/dist/github/src/lib/loadOrCreateCommit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadOrCreateCommit.d.ts","sourceRoot":"","sources":["../../../../src/lib/loadOrCreateCommit.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAWzC,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,WAAW,EAAE,CAAC,CAmDxB;AAED,wBAA8B,kBAAkB,CAC9C,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,OAAO;;;GAmHnB"}
+{"version":3,"file":"loadOrCreateCommit.d.ts","sourceRoot":"","sources":["../../../../src/lib/loadOrCreateCommit.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAWzC,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,WAAW,EAAE,CAAC,CAmDxB;AAED,wBAA8B,kBAAkB,CAC9C,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,OAAO;;;GAiInB"}

package/analyzer-template/packages/github/dist/github/src/lib/loadOrCreateCommit.js

@@ -81,6 +81,16 @@ export default async function loadOrCreateCommit(project, commitSha, baseline) {
         ]);
         branchFromDb = newBranches[0];
     }
+    // If no branch was found or created (e.g., non-HEAD commit where
+    // listBranchesForHeadCommit returns empty), fall back to the primary branch.
+    // Only do this for baseline commits where the assumption is justified.
+    if (!branchFromDb && baseline && project.branches) {
+        branchFromDb = project.branches.find((b) => b.primary) ?? null;
+    }
+    if (!branchFromDb) {
+        throw new Error(`Could not determine branch for commit ${commitSha}. ` +
+            `The commit may not be at the HEAD of any branch, and no primary branch was found.`);
+    }
     commit.branch = branchFromDb;
     branchName = branchFromDb.name;
     if (!commit.author?.username) {