create-semaphor-app 0.1.5 → 0.1.6

package/README.md

@@ -35,8 +35,8 @@ Options:
 --template-ref <ref>      Git branch/tag for the default starter repo. Defaults to main.
 --shadcn-preset <preset>  Apply a shadcn preset before adding Semaphor components.
 --shadcn-base <base>      Pass base or radix to shadcn init when using a preset.
---components <list>       Add Semaphor registry components. Defaults to all. Use none, query, metrics,
-                          filters, card, table, matrix, recommended, all, or a comma-separated list.
+--components <list>       Add Semaphor registry components. Defaults to all. Use none, kit, query,
+                          metrics, filters, card, table, matrix, recommended, all, or a comma-separated list.
 --yes                     Use noninteractive defaults; skip optional plugin installs unless explicit.
 --help                    Show help.
 ```
@@ -67,6 +67,7 @@ Component presets:
 | Value | Installs |
 | --- | --- |
 | `none` | No Semaphor registry components. |
+| `kit` | `data-app-kit`, the one-command registry bundle. |
 | `query` | `query-state` |
 | `metrics` | `query-state-boundary`, `metric-kpis` |
 | `filters` | `filter-controls` |
@@ -74,10 +75,16 @@ Component presets:
 | `table` | `query-state`, `server-data-table` |
 | `matrix` | `query-state`, `matrix-table` |
 | `recommended` | `query-state`, `query-state-boundary`, `view-card`, `metric-kpis`, `filter-controls`, `server-data-table` |
-| `all` | `query-state`, `query-state-boundary`, `view-card`, `metric-kpis`, `filter-controls`, `server-data-table`, `matrix-table`. This is the default. |
+| `all` | Full component set, installed through `data-app-kit`. This is the default. |
 
 Registry components install as source into the generated app. They are optional
 UI accelerators and do not replace `react-semaphor/data-app-sdk`.
+The default starter keeps its shadcn primitives aligned with the public
+registry, so default component installs should not ask overwrite questions.
+`create-semaphor-app` does not pass `--overwrite`; customer-owned base
+components stay intact. During the `data-app-kit` rollout, the CLI falls back
+to one multi-component install if an older registry deployment does not have
+the kit item yet.
 
 `--shadcn-preset` and installed registry components run the shadcn CLI. To skip
 installs, pass `--no-install --components none`, then run the shadcn commands

package/bin/create-semaphor-app.mjs

@@ -14,6 +14,7 @@ const DEFAULT_APP_NAME = 'semaphor-data-app';
 const MARKETPLACE = 'semaphor-analytics/agent-plugin';
 const PLUGIN_ID = 'semaphor@semaphor-analytics';
 const SEMAPHOR_COMPONENT_REGISTRY = 'semaphor-analytics/semaphor-data-app-components';
+const SEMAPHOR_COMPONENT_KIT = 'data-app-kit';
 const SEMAPHOR_COMPONENT_PRESETS = Object.freeze({
   none: [],
   query: ['query-state'],
@@ -41,6 +42,8 @@ const SEMAPHOR_COMPONENT_PRESETS = Object.freeze({
   ],
 });
 const SEMAPHOR_COMPONENT_ALIASES = Object.freeze({
+  kit: SEMAPHOR_COMPONENT_KIT,
+  'data-app-kit': SEMAPHOR_COMPONENT_KIT,
   'query-state': 'query-state',
   'query-state-boundary': 'query-state-boundary',
   'view-card': 'view-card',
@@ -74,8 +77,8 @@ Options:
   --template-ref <ref>      Git branch/tag for the default starter repo.
   --shadcn-preset <preset>  Apply a shadcn preset before adding Semaphor components.
   --shadcn-base <base>      Pass base or radix to shadcn init when using a preset.
-  --components <list>       Add Semaphor registry components. Defaults to all. Use none, query, metrics,
-                            filters, card, table, matrix, recommended, all, or a comma-separated list.
+  --components <list>       Add Semaphor registry components. Defaults to all. Use none, kit, query,
+                            metrics, filters, card, table, matrix, recommended, all, or a comma-separated list.
   --yes, -y                 Use noninteractive defaults; skip optional plugin installs unless explicit.
   --help, -h                Show this help.
 `;
@@ -407,7 +410,7 @@ function normalizeSemaphorComponents(value) {
     }
     if (!hasOwn(SEMAPHOR_COMPONENT_ALIASES, entry)) {
       throw new Error(
-        `Unsupported Semaphor component "${entry}". Use none, query, metrics, filters, card, table, matrix, recommended, all, or one of ${Object.keys(SEMAPHOR_COMPONENT_ALIASES).join(', ')}.`,
+        `Unsupported Semaphor component "${entry}". Use none, kit, query, metrics, filters, card, table, matrix, recommended, all, or one of ${Object.keys(SEMAPHOR_COMPONENT_ALIASES).join(', ')}.`,
       );
     }
     components.push(SEMAPHOR_COMPONENT_ALIASES[entry]);
@@ -453,6 +456,44 @@ function runShadcn(packageManager, targetDir, args) {
   });
 }
 
+function selectedComponentsUseFullKit(components) {
+  const selected = new Set(components);
+  const full = SEMAPHOR_COMPONENT_PRESETS.all;
+  return selected.size === full.length && full.every((component) => selected.has(component));
+}
+
+function componentRegistryAddress(component) {
+  return `${SEMAPHOR_COMPONENT_REGISTRY}/${component}`;
+}
+
+function installSemaphorRegistryComponents(packageManager, targetDir, components) {
+  if (components.length === 0) return [];
+
+  if (selectedComponentsUseFullKit(components)) {
+    try {
+      runShadcn(packageManager, targetDir, [
+        'add',
+        componentRegistryAddress(SEMAPHOR_COMPONENT_KIT),
+      ]);
+      console.log(`✓ Added ${SEMAPHOR_COMPONENT_KIT}`);
+      return [SEMAPHOR_COMPONENT_KIT];
+    } catch {
+      console.log(
+        'data-app-kit was not available from the registry yet; falling back to individual Semaphor components.',
+      );
+    }
+  }
+
+  runShadcn(packageManager, targetDir, [
+    'add',
+    ...components.map(componentRegistryAddress),
+  ]);
+  for (const component of components) {
+    console.log(`✓ Added ${component}`);
+  }
+  return components;
+}
+
 function customizeShadcn(args, packageManager, targetDir) {
   const components = normalizeSemaphorComponents(args.components);
   const shadcnBase = normalizeShadcnBase(args.shadcnBase);
@@ -481,13 +522,7 @@ function customizeShadcn(args, packageManager, targetDir) {
 
   if (components.length > 0) {
     console.log('\nAdding Semaphor registry components...');
-    for (const component of components) {
-      runShadcn(packageManager, targetDir, [
-        'add',
-        `${SEMAPHOR_COMPONENT_REGISTRY}/${component}`,
-      ]);
-      console.log(`✓ Added ${component}`);
-    }
+    installSemaphorRegistryComponents(packageManager, targetDir, components);
   }
 
   return { presetApplied: Boolean(args.shadcnPreset), components };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-semaphor-app",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Create a Semaphor Data App starter project.",
   "type": "module",
   "bin": {

package/scripts/smoke-test.mjs

@@ -205,20 +205,10 @@ async function main() {
       const npmInstallLog = fs.readFileSync(npmLog, 'utf8');
       assert(npmInstallLog.includes('npm install'), 'expected npm install command');
       const log = fs.readFileSync(shadcnLog, 'utf8');
-      for (const component of [
-        'query-state',
-        'query-state-boundary',
-        'view-card',
-        'metric-kpis',
-        'filter-controls',
-        'server-data-table',
-        'matrix-table',
-      ]) {
-        assert(
-          log.includes(`npx shadcn@latest add semaphor-analytics/semaphor-data-app-components/${component}`),
-          `expected default ${component} registry add command`,
-        );
-      }
+      assert(
+        log.includes('npx shadcn@latest add semaphor-analytics/semaphor-data-app-components/data-app-kit'),
+        'expected default data-app-kit registry add command',
+      );
       console.log('✓ default Semaphor registry component install');
     }
 
@@ -262,34 +252,89 @@ async function main() {
         'expected shadcn preset init command',
       );
       assert(
-        log.includes('npx shadcn@latest add semaphor-analytics/semaphor-data-app-components/query-state'),
-        'expected query-state registry add command',
-      );
-      assert(
-        log.includes('npx shadcn@latest add semaphor-analytics/semaphor-data-app-components/query-state-boundary'),
-        'expected query-state-boundary registry add command',
-      );
-      assert(
-        log.includes('npx shadcn@latest add semaphor-analytics/semaphor-data-app-components/view-card'),
-        'expected view-card registry add command',
-      );
-      assert(
-        log.includes('npx shadcn@latest add semaphor-analytics/semaphor-data-app-components/metric-kpis'),
-        'expected metric-kpis registry add command',
-      );
-      assert(
-        log.includes('npx shadcn@latest add semaphor-analytics/semaphor-data-app-components/filter-controls'),
-        'expected filter-controls registry add command',
+        log.includes('npx shadcn@latest add semaphor-analytics/semaphor-data-app-components/data-app-kit'),
+        'expected full component selection to use data-app-kit registry add command',
       );
+      console.log('✓ shadcn preset and registry component path');
+    }
+
+    {
+      const root = createTempRoot('component-kit-alias-');
+      const binDir = path.join(root, 'bin');
+      fs.mkdirSync(binDir, { recursive: true });
+      const shadcnLog = path.join(root, 'shadcn.log');
+      const npmLog = path.join(root, 'npm.log');
+      createFakeCommand(binDir, 'npx', shadcnLog);
+      createFakeCommand(binDir, 'npm', npmLog);
+
+      const result = runCli([
+        'kit-alias-app',
+        '--template',
+        defaultLocalStarterPath,
+        '--skip-plugin',
+        '--yes',
+        '--package-manager',
+        'npm',
+        '--components',
+        'kit',
+      ], {
+        cwd: root,
+        env: {
+          ...process.env,
+          PATH: `${binDir}${path.delimiter}${process.env.PATH || ''}`,
+        },
+      });
+      assertSuccess(result, 'component kit alias install');
+      assertScaffold(root, 'kit-alias-app');
+      const log = fs.readFileSync(shadcnLog, 'utf8');
       assert(
-        log.includes('npx shadcn@latest add semaphor-analytics/semaphor-data-app-components/server-data-table'),
-        'expected server-data-table registry add command',
+        log.includes('npx shadcn@latest add semaphor-analytics/semaphor-data-app-components/data-app-kit'),
+        'expected kit alias to use data-app-kit registry add command',
       );
+      console.log('✓ Semaphor data-app-kit component alias');
+    }
+
+    {
+      const root = createTempRoot('component-subset-');
+      const binDir = path.join(root, 'bin');
+      fs.mkdirSync(binDir, { recursive: true });
+      const shadcnLog = path.join(root, 'shadcn.log');
+      const npmLog = path.join(root, 'npm.log');
+      createFakeCommand(binDir, 'npx', shadcnLog);
+      createFakeCommand(binDir, 'npm', npmLog);
+
+      const result = runCli([
+        'subset-app',
+        '--template',
+        defaultLocalStarterPath,
+        '--skip-plugin',
+        '--yes',
+        '--package-manager',
+        'npm',
+        '--components',
+        'table,filters',
+      ], {
+        cwd: root,
+        env: {
+          ...process.env,
+          PATH: `${binDir}${path.delimiter}${process.env.PATH || ''}`,
+        },
+      });
+      assertSuccess(result, 'component subset install');
+      assertScaffold(root, 'subset-app');
+      const log = fs.readFileSync(shadcnLog, 'utf8');
       assert(
-        log.includes('npx shadcn@latest add semaphor-analytics/semaphor-data-app-components/matrix-table'),
-        'expected matrix-table registry add command',
+        log.includes(
+          [
+            'npx shadcn@latest add',
+            'semaphor-analytics/semaphor-data-app-components/query-state',
+            'semaphor-analytics/semaphor-data-app-components/server-data-table',
+            'semaphor-analytics/semaphor-data-app-components/filter-controls',
+          ].join(' '),
+        ),
+        'expected subset components to install in one registry add command',
       );
-      console.log('✓ shadcn preset and registry component path');
+      console.log('✓ Semaphor component subset installs in one command');
     }
 
     {