feat(lynxtron-go): hide internal gallery entries by default (#87)

Author: icecreamx10

.changeset/hide-internal-gallery-entries.md

@@ -0,0 +1,5 @@
+---
+"lynxtron-go": patch
+---
+
+Keep the Electron Fiddles collection, its collection cases, and the built-in Hello Lynxtron starter hidden from the Lynxtron Go Gallery by default behind the `LYNXTRON_GALLERY_INTERNAL_SHOWCASES=1` build switch.

lynxtron-go/lynx.config.ts

@@ -51,6 +51,9 @@ const isPreviewMode = showcaseSourceMode === 'local-registry' || showcaseSourceM
 const isLocalRegistry = showcaseSourceMode === 'local-registry';
 const isLocalWorkspace = showcaseSourceMode === 'local-workspace';
 const isReleaseArtifacts = showcaseSourceMode === 'release-artifacts';
+// Internal Gallery entries stay compiled and can be enabled for development
+// builds without changing the renderer source. Product builds leave them off.
+const galleryInternalShowcases = process.env.LYNXTRON_GALLERY_INTERNAL_SHOWCASES === '1';
 const registryPath = path.resolve(monorepoRoot, 'showcase-registry.json');
 
 // Thumbnails are staged into the app's own bundle rather than linked at their
@@ -239,6 +242,7 @@ export default defineConfig({
       __FIDDLE_CATALOG__: JSON.stringify(bakedFiddles),
       __SHOWCASE_PREVIEW__: JSON.stringify(isPreviewMode),
       __SHOWCASE_LOCAL_WORKSPACE__: JSON.stringify(isLocalWorkspace),
+      __GALLERY_INTERNAL_SHOWCASES__: JSON.stringify(galleryInternalShowcases),
       __BRAND_MARK_URL__: JSON.stringify(BRAND_MARK_URL),
       __BRAND_MARK_ON_DARK_URL__: JSON.stringify(BRAND_MARK_ON_DARK_URL),
     },

lynxtron-go/src/app/components/Gallery/GalleryHome.tsx

@@ -3,13 +3,14 @@ import { Button } from '../../fiddle/bp';
 import { Tooltip } from '../../fiddle/bp/Tooltip';
 import {
   FIDDLE_CATALOG,
-  FIDDLE_SHOWCASE_NAME,
+  GALLERY_INTERNAL_SHOWCASES,
   SHOWCASE_LOCAL_WORKSPACE,
   SHOWCASE_PREVIEW,
   SHOWCASE_REGISTRY,
   type FiddleEntry,
   type ShowcaseEntry,
 } from '../../store';
+import { resolveGalleryShowcases } from './gallery-visibility';
 
 interface GalleryHomeProps {
   onBack: () => void;
@@ -185,10 +186,10 @@ export function GalleryHome({
 }: GalleryHomeProps) {
   // The Electron-fiddles showcase gets its own section below, so it does not
   // also take a slot in the featured grid.
-  const fiddleShowcase = SHOWCASE_REGISTRY.find(e => e.name === FIDDLE_SHOWCASE_NAME);
-  const featured = fiddleShowcase
-    ? SHOWCASE_REGISTRY.filter(e => e.name !== FIDDLE_SHOWCASE_NAME)
-    : SHOWCASE_REGISTRY;
+  const { featured, fiddleShowcase } = resolveGalleryShowcases(
+    SHOWCASE_REGISTRY,
+    GALLERY_INTERNAL_SHOWCASES,
+  );
   // The collection card is one of the cards under this rule, so the count has
   // to include it — a header that disagrees with what is under it is worse
   // than no header.

lynxtron-go/src/app/components/Gallery/gallery-visibility.test.ts

@@ -0,0 +1,31 @@
+import { describe, expect, it } from 'vitest';
+import {
+  FIDDLE_SHOWCASE_NAME,
+  HELLO_SHOWCASE_NAME,
+  type ShowcaseEntry,
+} from '../../store';
+import { resolveGalleryShowcases } from './gallery-visibility';
+
+function entry(name: string): ShowcaseEntry {
+  return { name, description: '', tags: [], url: '' };
+}
+
+describe('Gallery showcase visibility', () => {
+  const fiddle = entry(FIDDLE_SHOWCASE_NAME);
+  const hello = entry(HELLO_SHOWCASE_NAME);
+  const regular = entry('@lynxtron-examples/native-texture-canvas');
+
+  it('hides internal Gallery entries when the build switch is off', () => {
+    expect(resolveGalleryShowcases([fiddle, hello, regular], false)).toEqual({
+      featured: [regular],
+      fiddleShowcase: undefined,
+    });
+  });
+
+  it('restores the collection and Hello card when the build switch is on', () => {
+    expect(resolveGalleryShowcases([fiddle, hello, regular], true)).toEqual({
+      featured: [hello, regular],
+      fiddleShowcase: fiddle,
+    });
+  });
+});

lynxtron-go/src/app/components/Gallery/gallery-visibility.ts

@@ -0,0 +1,21 @@
+import {
+  FIDDLE_SHOWCASE_NAME,
+  HELLO_SHOWCASE_NAME,
+  type ShowcaseEntry,
+} from '../../store';
+
+/** Resolve only the Gallery surface; the full registry remains available elsewhere. */
+export function resolveGalleryShowcases(
+  entries: ShowcaseEntry[],
+  internalShowcasesEnabled: boolean,
+): { featured: ShowcaseEntry[]; fiddleShowcase?: ShowcaseEntry } {
+  const fiddleShowcase = internalShowcasesEnabled
+    ? entries.find(entry => entry.name === FIDDLE_SHOWCASE_NAME)
+    : undefined;
+  const featured = entries.filter(entry => (
+    entry.name !== FIDDLE_SHOWCASE_NAME
+    && (internalShowcasesEnabled || entry.name !== HELLO_SHOWCASE_NAME)
+  ));
+
+  return { featured, fiddleShowcase };
+}

lynxtron-go/src/app/store.ts

@@ -125,6 +125,7 @@ export const HELLO_SHOWCASE_NAME = '@lynxtron-examples/hello-lynxtron';
 declare const __SHOWCASE_REGISTRY__: ShowcaseEntry[];
 declare const __SHOWCASE_PREVIEW__: boolean;
 declare const __SHOWCASE_LOCAL_WORKSPACE__: boolean;
+declare const __GALLERY_INTERNAL_SHOWCASES__: boolean;
 
 const BAKED_SHOWCASE_REGISTRY: ShowcaseEntry[] =
   typeof __SHOWCASE_REGISTRY__ !== 'undefined' ? __SHOWCASE_REGISTRY__ : [];
@@ -136,6 +137,9 @@ export const SHOWCASE_PREVIEW: boolean =
   typeof __SHOWCASE_PREVIEW__ !== 'undefined' ? __SHOWCASE_PREVIEW__ : false;
 export const SHOWCASE_LOCAL_WORKSPACE: boolean =
   typeof __SHOWCASE_LOCAL_WORKSPACE__ !== 'undefined' ? __SHOWCASE_LOCAL_WORKSPACE__ : false;
+/** Build-time switch for internal cards/cases on the Gallery surface only. */
+export const GALLERY_INTERNAL_SHOWCASES: boolean =
+  typeof __GALLERY_INTERNAL_SHOWCASES__ !== 'undefined' ? __GALLERY_INTERNAL_SHOWCASES__ : false;
 
 /**
  * file:// URLs of the Lynxtron mark beside app.asar; empty under vitest.