create-rudder-app 0.3.0 → 0.4.0

package/dist/templates/views/welcome.js

@@ -0,0 +1,396 @@
+export function welcomeView(ctx) {
+    switch (ctx.primary) {
+        case 'vue': return welcomeViewVue(ctx);
+        case 'solid': return welcomeViewSolid(ctx);
+        default: return welcomeViewReact(ctx);
+    }
+}
+const WELCOME_FEATURES = `const DEFAULT_DOCS   = 'https://github.com/rudderjs/rudder'
+const DEFAULT_GITHUB = 'https://github.com/rudderjs/rudder'
+
+const features: Feature[] = [
+  {
+    title:       'Controllers & Routing',
+    description: 'Explicit routes in routes/api.ts with middleware, params, named routes, and return types that just work.',
+    href:        \`\${DEFAULT_DOCS}#routing\`,
+  },
+  {
+    title:       'Eloquent ORM',
+    description: 'Laravel-style models on Prisma or Drizzle. Query relationships, scopes, and eager loading without changing mental models.',
+    href:        \`\${DEFAULT_DOCS}#orm\`,
+  },
+  {
+    title:       'Controller Views',
+    description: "The page you're looking at — return view() from a controller, rendered through Vike SSR. Zero adapter, full SPA nav.",
+    href:        \`\${DEFAULT_DOCS}#views\`,
+  },
+  {
+    title:       'Rudder CLI',
+    description: 'Laravel-style make:* generators, schedule, db:seed, and custom commands. Run \\\`pnpm rudder\\\` for the full list.',
+    href:        \`\${DEFAULT_DOCS}#cli\`,
+  },
+  {
+    title:       'Queues & Jobs',
+    description: 'Dispatch background jobs with sync, database, or Redis drivers. Monitor them with @rudderjs/horizon.',
+    href:        \`\${DEFAULT_DOCS}#queue\`,
+  },
+  {
+    title:       'Auth, Guards, Policies',
+    description: 'Session-backed auth, password reset, gates, and RequireAuth / RequireGuest middleware — all through one provider.',
+    href:        \`\${DEFAULT_DOCS}#auth\`,
+  },
+]`;
+export function welcomeViewReact(ctx) {
+    const cssImport = `import '@/index.css'\n\n`;
+    return `${cssImport}// URL this view is served at — MUST match the Route.get('/', ...) in routes/web.ts.
+// The scanner reads this constant and writes it into the generated +route.ts,
+// so Vike's client router can SPA-navigate here instead of doing full reloads.
+export const route = '/'
+
+export interface WelcomeProps {
+  appName:       string
+  rudderVersion: string
+  nodeVersion:   string
+  env:           string
+  user:          { name: string; email: string } | null
+  // null when the auth package isn't installed (Laravel's Route::has() idiom).
+  loginUrl:      string | null
+  registerUrl:   string | null
+  signOutUrl?:   string
+  docsUrl?:      string
+  githubUrl?:    string
+}
+
+interface Feature {
+  title:       string
+  description: string
+  href:        string
+}
+
+${WELCOME_FEATURES}
+
+export default function Welcome(props: WelcomeProps) {
+  const signOutUrl  = props.signOutUrl  ?? '/api/auth/sign-out'
+  const docsUrl     = props.docsUrl     ?? DEFAULT_DOCS
+  const githubUrl   = props.githubUrl   ?? DEFAULT_GITHUB
+
+  async function handleSignOut() {
+    await fetch(signOutUrl, {
+      method:  'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body:    '{}',
+    })
+    // Full reload so the server resolves a fresh pageContext (logged-out user).
+    window.location.href = '/'
+  }
+
+  return (
+    <div className="page">
+      <nav className="page-nav">
+        <div className="brand">
+          <span className="brand-dot" />
+          RudderJS
+        </div>
+        <div className="nav-right">
+          {props.loginUrl && (props.user ? (
+            <>
+              <span className="nav-badge">
+                Signed in as <strong>{props.user.name}</strong>
+              </span>
+              <button type="button" onClick={handleSignOut} className="nav-button">
+                Sign out
+              </button>
+            </>
+          ) : (
+            <>
+              <a href={props.loginUrl} className="nav-link">Log in</a>
+              {props.registerUrl && (
+                <a href={props.registerUrl} className="nav-button">Register</a>
+              )}
+            </>
+          ))}
+        </div>
+      </nav>
+
+      <section className="hero">
+        <h1 className="hero-title">{props.appName}</h1>
+        <p className="hero-lead">
+          Laravel&apos;s developer experience, Vike&apos;s performance, Node&apos;s ecosystem.
+          This page is served by a controller, rendered through{' '}
+          <code className="inline-code">view(&apos;welcome&apos;)</code>.
+        </p>
+        <div className="hero-meta">
+          <span>RudderJS v{props.rudderVersion}</span>
+          <span>•</span>
+          <span>Node {props.nodeVersion}</span>
+          <span>•</span>
+          <span>env={props.env}</span>
+        </div>
+      </section>
+
+      <section className="feature-section">
+        <div className="feature-grid">
+          {features.map(f => (
+            <a key={f.title} href={f.href} className="feature-card">
+              <h3 className="feature-title">{f.title}</h3>
+              <p className="feature-desc">{f.description}</p>
+            </a>
+          ))}
+        </div>
+      </section>
+
+      <footer className="page-footer">
+        <div className="footer-inner">
+          <div>Built with RudderJS. Edit <code>app/Views/Welcome.tsx</code> to customize this page.</div>
+          <div className="footer-links">
+            <a href={docsUrl} className="footer-link">Docs</a>
+            <a href={githubUrl} className="footer-link">GitHub</a>
+          </div>
+        </div>
+      </footer>
+    </div>
+  )
+}
+`;
+}
+export function welcomeViewVue(ctx) {
+    const cssImport = `import '@/index.css'\n`;
+    // Vue SFC quirk: top-level `export` statements must live in a regular
+    // <script> block, NOT <script setup> (the compiler rejects exports there).
+    // The scanner reads both blocks as plain text, so the route override is
+    // still picked up. Keep this dual-script structure whenever a Vue view
+    // needs `export const route = '/...'`.
+    return `<script lang="ts">
+// URL this view is served at — see the React variant for rationale.
+export const route = '/'
+</script>
+
+<script setup lang="ts">
+${cssImport}
+export interface WelcomeProps {
+  appName:       string
+  rudderVersion: string
+  nodeVersion:   string
+  env:           string
+  user:          { name: string; email: string } | null
+  // null when the auth package isn't installed (Laravel's Route::has() idiom).
+  loginUrl:      string | null
+  registerUrl:   string | null
+  signOutUrl?:   string
+  docsUrl?:      string
+  githubUrl?:    string
+}
+
+const props = defineProps<WelcomeProps>()
+
+interface Feature {
+  title:       string
+  description: string
+  href:        string
+}
+
+${WELCOME_FEATURES}
+
+const signOutUrl  = props.signOutUrl  ?? '/api/auth/sign-out'
+const docsUrl     = props.docsUrl     ?? DEFAULT_DOCS
+const githubUrl   = props.githubUrl   ?? DEFAULT_GITHUB
+
+async function handleSignOut() {
+  await fetch(signOutUrl, {
+    method:  'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body:    '{}',
+  })
+  // Full reload so the server resolves a fresh pageContext (logged-out user).
+  window.location.href = '/'
+}
+</script>
+
+<template>
+  <div class="page">
+    <nav class="page-nav">
+      <div class="brand">
+        <span class="brand-dot"></span>
+        RudderJS
+      </div>
+      <div v-if="props.loginUrl" class="nav-right">
+        <template v-if="props.user">
+          <span class="nav-badge">
+            Signed in as <strong>{{ props.user.name }}</strong>
+          </span>
+          <button type="button" @click="handleSignOut" class="nav-button">
+            Sign out
+          </button>
+        </template>
+        <template v-else>
+          <a :href="props.loginUrl" class="nav-link">Log in</a>
+          <a v-if="props.registerUrl" :href="props.registerUrl" class="nav-button">Register</a>
+        </template>
+      </div>
+    </nav>
+
+    <section class="hero">
+      <h1 class="hero-title">{{ props.appName }}</h1>
+      <p class="hero-lead">
+        Laravel's developer experience, Vike's performance, Node's ecosystem.
+        This page is served by a controller, rendered through
+        <code class="inline-code">view('welcome')</code>.
+      </p>
+      <div class="hero-meta">
+        <span>RudderJS v{{ props.rudderVersion }}</span>
+        <span>•</span>
+        <span>Node {{ props.nodeVersion }}</span>
+        <span>•</span>
+        <span>env={{ props.env }}</span>
+      </div>
+    </section>
+
+    <section class="feature-section">
+      <div class="feature-grid">
+        <a v-for="f in features" :key="f.title" :href="f.href" class="feature-card">
+          <h3 class="feature-title">{{ f.title }}</h3>
+          <p class="feature-desc">{{ f.description }}</p>
+        </a>
+      </div>
+    </section>
+
+    <footer class="page-footer">
+      <div class="footer-inner">
+        <div>Built with RudderJS. Edit <code>app/Views/Welcome.vue</code> to customize this page.</div>
+        <div class="footer-links">
+          <a :href="docsUrl" class="footer-link">Docs</a>
+          <a :href="githubUrl" class="footer-link">GitHub</a>
+        </div>
+      </div>
+    </footer>
+  </div>
+</template>
+`;
+}
+export function welcomeViewSolid(ctx) {
+    const cssImport = `import '@/index.css'\n`;
+    return `${cssImport}import { For, Show } from 'solid-js'
+
+// URL this view is served at — see the React variant for rationale.
+export const route = '/'
+
+export interface WelcomeProps {
+  appName:       string
+  rudderVersion: string
+  nodeVersion:   string
+  env:           string
+  user:          { name: string; email: string } | null
+  // null when the auth package isn't installed (Laravel's Route::has() idiom).
+  loginUrl:      string | null
+  registerUrl:   string | null
+  signOutUrl?:   string
+  docsUrl?:      string
+  githubUrl?:    string
+}
+
+interface Feature {
+  title:       string
+  description: string
+  href:        string
+}
+
+${WELCOME_FEATURES}
+
+export default function Welcome(props: WelcomeProps) {
+  const signOutUrl  = () => props.signOutUrl  ?? '/api/auth/sign-out'
+  const docsUrl     = () => props.docsUrl     ?? DEFAULT_DOCS
+  const githubUrl   = () => props.githubUrl   ?? DEFAULT_GITHUB
+
+  async function handleSignOut() {
+    await fetch(signOutUrl(), {
+      method:  'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body:    '{}',
+    })
+    // Full reload so the server resolves a fresh pageContext (logged-out user).
+    window.location.href = '/'
+  }
+
+  return (
+    <div class="page">
+      <nav class="page-nav">
+        <div class="brand">
+          <span class="brand-dot" />
+          RudderJS
+        </div>
+        <Show when={props.loginUrl}>
+          {(loginUrl) => (
+            <div class="nav-right">
+              <Show
+                when={props.user}
+                fallback={
+                  <>
+                    <a href={loginUrl()} class="nav-link">Log in</a>
+                    <Show when={props.registerUrl}>
+                      {(registerUrl) => (
+                        <a href={registerUrl()} class="nav-button">Register</a>
+                      )}
+                    </Show>
+                  </>
+                }
+              >
+                {(user) => (
+                  <>
+                    <span class="nav-badge">
+                      Signed in as <strong>{user().name}</strong>
+                    </span>
+                    <button type="button" onClick={handleSignOut} class="nav-button">
+                      Sign out
+                    </button>
+                  </>
+                )}
+              </Show>
+            </div>
+          )}
+        </Show>
+      </nav>
+
+      <section class="hero">
+        <h1 class="hero-title">{props.appName}</h1>
+        <p class="hero-lead">
+          Laravel's developer experience, Vike's performance, Node's ecosystem.
+          This page is served by a controller, rendered through{' '}
+          <code class="inline-code">view('welcome')</code>.
+        </p>
+        <div class="hero-meta">
+          <span>RudderJS v{props.rudderVersion}</span>
+          <span>•</span>
+          <span>Node {props.nodeVersion}</span>
+          <span>•</span>
+          <span>env={props.env}</span>
+        </div>
+      </section>
+
+      <section class="feature-section">
+        <div class="feature-grid">
+          <For each={features}>
+            {(f) => (
+              <a href={f.href} class="feature-card">
+                <h3 class="feature-title">{f.title}</h3>
+                <p class="feature-desc">{f.description}</p>
+              </a>
+            )}
+          </For>
+        </div>
+      </section>
+
+      <footer class="page-footer">
+        <div class="footer-inner">
+          <div>Built with RudderJS. Edit <code>app/Views/Welcome.tsx</code> to customize this page.</div>
+          <div class="footer-links">
+            <a href={docsUrl()} class="footer-link">Docs</a>
+            <a href={githubUrl()} class="footer-link">GitHub</a>
+          </div>
+        </div>
+      </footer>
+    </div>
+  )
+}
+`;
+}
+//# sourceMappingURL=welcome.js.map

package/dist/templates/views/welcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome.js","sourceRoot":"","sources":["../../../src/templates/views/welcome.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,WAAW,CAAC,GAAoB;IAC9C,QAAQ,GAAG,CAAC,OAAO,EAAE,CAAC;QACpB,KAAK,KAAK,CAAC,CAAG,OAAO,cAAc,CAAC,GAAG,CAAC,CAAA;QACxC,KAAK,OAAO,CAAC,CAAC,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAA;QAC1C,OAAO,CAAC,CAAM,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAA;IAC5C,CAAC;AACH,CAAC;AAED,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCvB,CAAA;AAEF,MAAM,UAAU,gBAAgB,CAAC,GAAoB;IACnD,MAAM,SAAS,GAAG,0BAA0B,CAAA;IAC5C,OAAO,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;EAyBnB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoFjB,CAAA;AACD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAoB;IACjD,MAAM,SAAS,GAAG,wBAAwB,CAAA;IAC1C,sEAAsE;IACtE,2EAA2E;IAC3E,wEAAwE;IACxE,uEAAuE;IACvE,uCAAuC;IACvC,OAAO;;;;;;EAMP,SAAS;;;;;;;;;;;;;;;;;;;;;;;EAuBT,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4EjB,CAAA;AACD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAoB;IACnD,MAAM,SAAS,GAAG,wBAAwB,CAAA;IAC1C,OAAO,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;EAyBnB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiGjB,CAAA;AACD,CAAC"}

package/dist/templates/vite.d.ts

@@ -0,0 +1,3 @@
+import type { TemplateContext } from '../templates.js';
+export declare function viteConfig(ctx: TemplateContext): string;
+//# sourceMappingURL=vite.d.ts.map

package/dist/templates/vite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../../src/templates/vite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD,wBAAgB,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAyDvD"}

package/dist/templates/vite.js

@@ -0,0 +1,61 @@
+export function viteConfig(ctx) {
+    const { frameworks, primary, tailwind } = ctx;
+    const hasReact = frameworks.includes('react');
+    const hasVue = frameworks.includes('vue');
+    const hasSolid = frameworks.includes('solid');
+    const hasReactSolidConflict = hasReact && hasSolid;
+    const imports = [
+        `import { defineConfig } from 'vite'`,
+        `import rudderjs from '@rudderjs/vite'`,
+    ];
+    if (tailwind)
+        imports.push(`import tailwindcss from '@tailwindcss/vite'`);
+    if (hasReact)
+        imports.push(`import react from '@vitejs/plugin-react'`);
+    if (hasVue)
+        imports.push(`import vue from '@vitejs/plugin-vue'`);
+    if (hasSolid)
+        imports.push(`import solid from 'vike-solid/vite'`);
+    const plugins = ['rudderjs()'];
+    if (tailwind)
+        plugins.push('tailwindcss()');
+    if (hasReact) {
+        if (hasReactSolidConflict) {
+            if (primary === 'react') {
+                plugins.push(`react({ exclude: ['**/pages/solid-demo/**'] })`);
+            }
+            else {
+                plugins.push(`react({ include: ['**/pages/react-demo/**'] })`);
+            }
+        }
+        else {
+            plugins.push('react()');
+        }
+    }
+    if (hasVue) {
+        plugins.push('vue()');
+    }
+    if (hasSolid) {
+        if (hasReactSolidConflict) {
+            if (primary === 'solid') {
+                plugins.push(`solid({ exclude: ['**/pages/react-demo/**'] })`);
+            }
+            else {
+                plugins.push(`solid({ include: ['**/pages/solid-demo/**'] })`);
+            }
+        }
+        else {
+            plugins.push('solid()');
+        }
+    }
+    const pluginsStr = plugins.map(p => `    ${p},`).join('\n');
+    return `${imports.join('\n')}
+
+export default defineConfig({
+  plugins: [
+${pluginsStr}
+  ],
+})
+`;
+}
+//# sourceMappingURL=vite.js.map

package/dist/templates/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.js","sourceRoot":"","sources":["../../src/templates/vite.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,UAAU,CAAC,GAAoB;IAC7C,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAA;IAC7C,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC7C,MAAM,MAAM,GAAK,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC3C,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC7C,MAAM,qBAAqB,GAAG,QAAQ,IAAI,QAAQ,CAAA;IAElD,MAAM,OAAO,GAAa;QACxB,qCAAqC;QACrC,uCAAuC;KACxC,CAAA;IACD,IAAI,QAAQ;QAAE,OAAO,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAA;IACzE,IAAI,QAAQ;QAAG,OAAO,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAA;IACvE,IAAI,MAAM;QAAK,OAAO,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAA;IACnE,IAAI,QAAQ;QAAG,OAAO,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAA;IAElE,MAAM,OAAO,GAAa,CAAC,YAAY,CAAC,CAAA;IACxC,IAAI,QAAQ;QAAE,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;IAE3C,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,qBAAqB,EAAE,CAAC;YAC1B,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;gBACxB,OAAO,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAA;YAChE,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAA;YAChE,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACzB,CAAC;IACH,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACvB,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,qBAAqB,EAAE,CAAC;YAC1B,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;gBACxB,OAAO,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAA;YAChE,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAA;YAChE,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACzB,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAE3D,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;;;;EAI5B,UAAU;;;CAGX,CAAA;AACD,CAAC"}

package/dist/templates.d.ts

@@ -1,9 +1,13 @@
-export type PackageManager = 'pnpm' | 'npm' | 'yarn' | 'bun';
+import { detectPackageManager, pmExec, pmInstall, pmRun, type PackageManager } from './templates/package-managers.js';
+export { detectPackageManager, pmExec, pmInstall, pmRun };
+export type { PackageManager };
 export interface TemplateContext {
     name: string;
     db: 'sqlite' | 'postgresql' | 'mysql';
     orm: 'prisma' | 'drizzle' | false;
     authSecret: string;
+    /** Random base64-encoded 32-byte key for @rudderjs/crypt's APP_KEY. */
+    appKey: string;
     frameworks: ('react' | 'vue' | 'solid')[];
     primary: 'react' | 'vue' | 'solid';
     tailwind: boolean;
@@ -11,33 +15,40 @@ export interface TemplateContext {
     pm: PackageManager;
     packages: {
         auth: boolean;
-        cache: boolean;
+        sanctum: boolean;
+        passport: boolean;
+        socialite: boolean;
         queue: boolean;
         storage: boolean;
+        scheduler: boolean;
+        image: boolean;
         mail: boolean;
         notifications: boolean;
-        scheduler: boolean;
         broadcast: boolean;
         sync: boolean;
         ai: boolean;
         mcp: boolean;
-        passport: boolean;
+        boost: boolean;
         localization: boolean;
+        cashierPaddle: boolean;
+        pennant: boolean;
         telescope: boolean;
-        boost: boolean;
-        demos: boolean;
+        pulse: boolean;
+        horizon: boolean;
+        crypt: boolean;
+        http: boolean;
+        process: boolean;
+        concurrency: boolean;
     };
+    /** Demo IDs to scaffold (e.g. 'contact', 'ws', 'live'). See templates/demos/registry.ts. */
+    demos: string[];
 }
-/** Detect which package manager invoked the installer.
- *  1. Check npm_config_user_agent (set by pnpm/npm/yarn/bun create commands)
- *  2. Fall back to checking which binaries are available on PATH
- */
-export declare function detectPackageManager(): PackageManager;
-/** `<pm> exec <bin>` equivalent per package manager. */
-export declare function pmExec(pm: PackageManager, bin: string): string;
-/** `<pm> run <script>` equivalent (yarn/bun allow omitting "run"). */
-export declare function pmRun(pm: PackageManager, script: string): string;
-/** `<pm> install` command. */
-export declare function pmInstall(pm: PackageManager): string;
 export declare function getTemplates(ctx: TemplateContext): Record<string, string>;
+/**
+ * Demos are React-primary only for v1 — vue/solid variants aren't written yet.
+ * `name` is a demo ID from `templates/demos/registry.ts` (e.g. 'contact', 'ws', 'live').
+ * Returns true when the demo was selected AND its package gates are satisfied.
+ */
+export declare function shouldScaffoldDemo(ctx: TemplateContext, name: string): boolean;
+export declare function shouldScaffoldAnyDemo(ctx: TemplateContext): boolean;
 //# sourceMappingURL=templates.d.ts.map

package/dist/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAA;AAE5D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAQ,MAAM,CAAA;IAClB,EAAE,EAAU,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAA;IAC7C,GAAG,EAAS,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAA;IACxC,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,CAAC,OAAO,GAAG,KAAK,GAAG,OAAO,CAAC,EAAE,CAAA;IACzC,OAAO,EAAK,OAAO,GAAG,KAAK,GAAG,OAAO,CAAA;IACrC,QAAQ,EAAI,OAAO,CAAA;IACnB,MAAM,EAAM,OAAO,CAAA;IACnB,EAAE,EAAU,cAAc,CAAA;IAC1B,QAAQ,EAAE;QACR,IAAI,EAAW,OAAO,CAAA;QACtB,KAAK,EAAU,OAAO,CAAA;QACtB,KAAK,EAAU,OAAO,CAAA;QACtB,OAAO,EAAQ,OAAO,CAAA;QACtB,IAAI,EAAW,OAAO,CAAA;QACtB,aAAa,EAAE,OAAO,CAAA;QACtB,SAAS,EAAM,OAAO,CAAA;QACtB,SAAS,EAAM,OAAO,CAAA;QACtB,IAAI,EAAW,OAAO,CAAA;QACtB,EAAE,EAAa,OAAO,CAAA;QACtB,GAAG,EAAY,OAAO,CAAA;QACtB,QAAQ,EAAO,OAAO,CAAA;QACtB,YAAY,EAAG,OAAO,CAAA;QACtB,SAAS,EAAM,OAAO,CAAA;QACtB,KAAK,EAAU,OAAO,CAAA;QACtB,KAAK,EAAU,OAAO,CAAA;KACvB,CAAA;CACF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAerD;AAED,wDAAwD;AACxD,wBAAgB,MAAM,CAAC,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED,sEAAsE;AACtE,wBAAgB,KAAK,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED,8BAA8B;AAC9B,wBAAgB,SAAS,CAAC,EAAE,EAAE,cAAc,GAAG,MAAM,CAEpD;AAMD,wBAAgB,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA6GzE"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAW,KAAK,cAAc,EAAE,MAAM,iCAAiC,CAAA;AA0D9H,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAA;AACzD,YAAY,EAAE,cAAc,EAAE,CAAA;AAE9B,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAQ,MAAM,CAAA;IAClB,EAAE,EAAU,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAA;IAC7C,GAAG,EAAS,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAA;IACxC,UAAU,EAAE,MAAM,CAAA;IAClB,uEAAuE;IACvE,MAAM,EAAM,MAAM,CAAA;IAClB,UAAU,EAAE,CAAC,OAAO,GAAG,KAAK,GAAG,OAAO,CAAC,EAAE,CAAA;IACzC,OAAO,EAAK,OAAO,GAAG,KAAK,GAAG,OAAO,CAAA;IACrC,QAAQ,EAAI,OAAO,CAAA;IACnB,MAAM,EAAM,OAAO,CAAA;IACnB,EAAE,EAAU,cAAc,CAAA;IAC1B,QAAQ,EAAE;QACR,IAAI,EAAW,OAAO,CAAA;QACtB,OAAO,EAAQ,OAAO,CAAA;QACtB,QAAQ,EAAO,OAAO,CAAA;QACtB,SAAS,EAAM,OAAO,CAAA;QACtB,KAAK,EAAU,OAAO,CAAA;QACtB,OAAO,EAAQ,OAAO,CAAA;QACtB,SAAS,EAAM,OAAO,CAAA;QACtB,KAAK,EAAU,OAAO,CAAA;QACtB,IAAI,EAAW,OAAO,CAAA;QACtB,aAAa,EAAE,OAAO,CAAA;QACtB,SAAS,EAAM,OAAO,CAAA;QACtB,IAAI,EAAW,OAAO,CAAA;QACtB,EAAE,EAAa,OAAO,CAAA;QACtB,GAAG,EAAY,OAAO,CAAA;QACtB,KAAK,EAAU,OAAO,CAAA;QACtB,YAAY,EAAG,OAAO,CAAA;QACtB,aAAa,EAAE,OAAO,CAAA;QACtB,OAAO,EAAQ,OAAO,CAAA;QACtB,SAAS,EAAM,OAAO,CAAA;QACtB,KAAK,EAAU,OAAO,CAAA;QACtB,OAAO,EAAQ,OAAO,CAAA;QACtB,KAAK,EAAU,OAAO,CAAA;QACtB,IAAI,EAAW,OAAO,CAAA;QACtB,OAAO,EAAQ,OAAO,CAAA;QACtB,WAAW,EAAI,OAAO,CAAA;KACvB,CAAA;IACD,4FAA4F;IAC5F,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoHzE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAO9E;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAGnE"}