create-rudder-app 0.3.1 → 0.5.0

package/dist/templates/routes/api.js

@@ -0,0 +1,166 @@
+import { shouldScaffoldAnyDemo, shouldScaffoldDemo } from '../../templates.js';
+import { demosFibonacciApiBlock } from '../demos/fibonacci.js';
+import { demosSystemInfoApiBlock } from '../demos/system-info.js';
+import { demosAvatarApiBlock } from '../demos/avatar.js';
+import { demosCacheApiBlock } from '../demos/cache.js';
+import { demosQueueApiBlock } from '../demos/queue.js';
+import { demosMailApiBlock } from '../demos/mail.js';
+import { demosNotificationsApiBlock } from '../demos/notifications.js';
+import { demosLocalizationApiBlock } from '../demos/localization.js';
+import { demosHttpApiBlock } from '../demos/http.js';
+export function routesApi(ctx) {
+    const imports = [
+        "import { router } from '@rudderjs/router'",
+    ];
+    const lines = [];
+    if (ctx.packages.auth || ctx.packages.ai) {
+        imports.push("import { app } from '@rudderjs/core'");
+    }
+    if (ctx.packages.auth) {
+        imports.push("import { Auth, AuthManager, runWithAuth } from '@rudderjs/auth'");
+        imports.push("import { SessionMiddleware } from '@rudderjs/session'");
+    }
+    if (ctx.packages.ai) {
+        imports.push("import { AI } from '@rudderjs/ai'");
+    }
+    lines.push('');
+    lines.push("router.get('/api/health', (_req, res) => res.json({ status: 'ok' }))");
+    if (ctx.packages.auth) {
+        lines.push('');
+        lines.push(`// GET /api/me — returns current user or null (Laravel Sanctum SPA-style).
+// Api routes are stateless by default, so session is opted in per-route.
+// Session-mutating handlers (sign-in, sign-up, sign-out, password reset)
+// live in routes/web.ts so they inherit SessionMiddleware from the web group.
+router.get('/api/me', async (req, res) => {
+  const manager = app().make<AuthManager>('auth.manager')
+  let user: Record<string, unknown> | null = null
+  await runWithAuth(manager, async () => {
+    const authUser = await Auth.user()
+    if (authUser) {
+      user = { id: authUser.getAuthIdentifier() }
+    }
+  })
+  res.json({ user })
+}, [SessionMiddleware()])`);
+    }
+    if (ctx.packages.ai) {
+        lines.push('');
+        lines.push(`// POST /api/ai/chat — simple AI chat endpoint
+router.post('/api/ai/chat', async (req, res) => {
+  const { messages } = req.body as { messages: { role: string; content: string }[] }
+  const lastMessage  = messages.at(-1)?.content ?? ''
+  const response     = await AI.agent('You are a helpful assistant.').prompt(lastMessage)
+  res.json({ message: response.text })
+})`);
+    }
+    if (ctx.packages.passport) {
+        imports.push("import { registerPassportRoutes, RequireBearer, scope } from '@rudderjs/passport'");
+        lines.push('');
+        lines.push(`// ── Passport OAuth 2 routes ──────────────────────────────
+//
+// Registers /oauth/authorize, /oauth/token, /oauth/tokens/:id,
+// /oauth/scopes, /oauth/device/code, /oauth/device/approve.
+//
+// Requires: RSA keys via \`pnpm rudder passport:keys\` and an OAuth client
+// via \`pnpm rudder passport:client <name>\`.
+const passportRouter = {
+  get:    (path: string, handler: any) => router.get(path, handler),
+  post:   (path: string, handler: any) => router.post(path, handler),
+  delete: (path: string, handler: any) => router.delete(path, handler),
+}
+registerPassportRoutes(passportRouter as any)
+
+// Example: protected route requiring a Bearer token with 'read' scope
+router.get('/api/passport/me', async (req, res) => {
+  res.json({
+    user:   req.user ?? null,
+    scopes: (req.raw as any)?.__passport_scopes ?? [],
+  })
+}, [RequireBearer(), scope('read')])`);
+    }
+    if (shouldScaffoldAnyDemo(ctx)) {
+        const wantContact = shouldScaffoldDemo(ctx, 'contact');
+        const wantWs = shouldScaffoldDemo(ctx, 'ws');
+        const wantFibonacci = shouldScaffoldDemo(ctx, 'fibonacci');
+        const wantSystemInfo = shouldScaffoldDemo(ctx, 'system-info');
+        const wantAvatar = shouldScaffoldDemo(ctx, 'avatar');
+        if (wantContact)
+            imports.push(`import { z } from '@rudderjs/core'`);
+        if (wantContact && ctx.packages.auth)
+            imports.push(`import { CsrfMiddleware } from '@rudderjs/middleware'`);
+        if (wantWs)
+            imports.push(`import { broadcast, broadcastStats } from '@rudderjs/broadcast'`);
+        lines.push('');
+        lines.push(`// ── Demos ────────────────────────────────────────────────`);
+        if (wantContact) {
+            lines.push(`// POST /api/contact — Zod validation${ctx.packages.auth ? ' + CSRF' : ''}.
+const contactSchema = z.object({
+  name:    z.string().min(2,  'Name must be at least 2 characters.'),
+  email:   z.string().email('Please enter a valid email address.'),
+  message: z.string().min(10, 'Message must be at least 10 characters.'),
+})
+
+router.post('/api/contact', async (req, res) => {
+  const result = contactSchema.safeParse(req.body)
+  if (!result.success) {
+    const errors = Object.fromEntries(result.error.issues.map(i => [i.path[0], i.message]))
+    return res.status(422).json({ errors })
+  }
+  return res.json({ ok: true, message: \`Thanks \${result.data.name}, your message has been received!\` })
+}${ctx.packages.auth ? ', [CsrfMiddleware()]' : ''})`);
+        }
+        if (wantWs) {
+            lines.push('');
+            lines.push(`// POST /api/ws/broadcast — push a chat message to subscribers of the 'chat' channel.
+router.post('/api/ws/broadcast', async (req, res) => {
+  const { user, text } = req.body as { user: string; text: string }
+  broadcast('chat', 'message', { user, text, ts: Date.now() })
+  res.json({ ok: true })
+})
+
+// GET /api/ws/ping — current connection / channel counts.
+router.get('/api/ws/ping', (_req, res) => res.json(broadcastStats()))`);
+        }
+        if (wantFibonacci) {
+            lines.push('');
+            lines.push(demosFibonacciApiBlock());
+        }
+        if (wantSystemInfo) {
+            lines.push('');
+            lines.push(demosSystemInfoApiBlock());
+        }
+        if (wantAvatar) {
+            lines.push('');
+            lines.push(demosAvatarApiBlock());
+        }
+        if (shouldScaffoldDemo(ctx, 'cache')) {
+            lines.push('');
+            lines.push(demosCacheApiBlock());
+        }
+        if (shouldScaffoldDemo(ctx, 'queue')) {
+            lines.push('');
+            lines.push(demosQueueApiBlock());
+        }
+        if (shouldScaffoldDemo(ctx, 'mail')) {
+            lines.push('');
+            lines.push(demosMailApiBlock());
+        }
+        if (shouldScaffoldDemo(ctx, 'notifications')) {
+            lines.push('');
+            lines.push(demosNotificationsApiBlock());
+        }
+        if (shouldScaffoldDemo(ctx, 'localization')) {
+            lines.push('');
+            lines.push(demosLocalizationApiBlock());
+        }
+        if (shouldScaffoldDemo(ctx, 'http')) {
+            lines.push('');
+            lines.push(demosHttpApiBlock());
+        }
+    }
+    lines.push('');
+    lines.push("// Catch-all: any unmatched /api/* route returns 404");
+    lines.push("router.all('/api/*', (_req, res) => res.status(404).json({ message: 'Route not found.' }))");
+    return imports.join('\n') + '\n' + lines.join('\n') + '\n';
+}
+//# sourceMappingURL=api.js.map

package/dist/templates/routes/api.js.map

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

package/dist/templates/routes/console.d.ts

@@ -0,0 +1,2 @@
+export declare function routesConsole(): string;
+//# sourceMappingURL=console.d.ts.map

package/dist/templates/routes/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../../src/templates/routes/console.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,IAAI,MAAM,CAoBtC"}

package/dist/templates/routes/console.js

@@ -0,0 +1,22 @@
+export function routesConsole() {
+    return `import { rudder } from '@rudderjs/console'
+
+rudder.command('inspire', () => {
+  const quotes = [
+    'The best way to predict the future is to create it.',
+    'Build something people want.',
+    'Stay hungry, stay foolish.',
+    'Code is poetry.',
+    'Simplicity is the soul of efficiency.',
+  ]
+  const quote = quotes[Math.floor(Math.random() * quotes.length)]!
+  console.log(\`\\n  "\${quote}"\\n\`)
+}).description('Display an inspiring quote')
+
+rudder.command('db:seed', async () => {
+  // TODO: add your seed data here
+  console.log('No seed data configured. Edit routes/console.ts to add seed logic.')
+}).description('Seed the database with sample data')
+`;
+}
+//# sourceMappingURL=console.js.map

package/dist/templates/routes/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../../src/templates/routes/console.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa;IAC3B,OAAO;;;;;;;;;;;;;;;;;;CAkBR,CAAA;AACD,CAAC"}

package/dist/templates/routes/web.d.ts

@@ -0,0 +1,4 @@
+import { type TemplateContext } from '../../templates.js';
+export declare function routesWeb(ctx: TemplateContext): string;
+export declare function welcomeExt(fw: 'react' | 'vue' | 'solid'): string;
+//# sourceMappingURL=web.d.ts.map

package/dist/templates/routes/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../src/templates/routes/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6C,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEpG,wBAAgB,SAAS,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CA+ItD;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAEhE"}

package/dist/templates/routes/web.js

@@ -0,0 +1,155 @@
+import { shouldScaffoldAnyDemo, shouldScaffoldDemo } from '../../templates.js';
+export function routesWeb(ctx) {
+    const hasAuth = ctx.packages.auth;
+    const hasWelcome = ctx.frameworks.length === 1;
+    // ── imports ─────────────────────────────────────────────
+    const imports = [`import { Route } from '@rudderjs/router'`];
+    if (hasWelcome) {
+        imports.push(`import { createRequire } from 'node:module'`);
+        imports.push(`import { view } from '@rudderjs/view'`);
+        imports.push(`import { config } from '@rudderjs/core'`);
+    }
+    if (hasAuth) {
+        imports.push(`import { CsrfMiddleware } from '@rudderjs/middleware'`);
+        imports.push(`import { registerAuthRoutes } from '@rudderjs/auth/routes'`);
+        imports.push(`import { auth } from '@rudderjs/auth'`);
+        imports.push(`import { AuthController } from '../app/Http/Controllers/AuthController.ts'`);
+    }
+    // ── middleware chain shared with auth routes + welcome ─
+    // SessionMiddleware + AuthMiddleware are auto-installed on the web group by
+    // their providers. Only CSRF stays per-route so specific endpoints (webhooks,
+    // server-to-server callbacks) can opt out.
+    const webMwBlock = hasAuth
+        ? `
+// Per-route web middleware — session + auth are auto-applied on the web group.
+const webMw = [CsrfMiddleware()]
+`
+        : '';
+    // ── auth UI wiring ──────────────────────────────────────
+    // GET view pages come from `registerAuthRoutes`; the POST submit handlers
+    // come from `AuthController` (extends @rudderjs/auth's BaseAuthController).
+    // Both live in routes/web.ts so they inherit SessionMiddleware + AuthMiddleware
+    // from the web group. Customize the flow by editing app/Http/Controllers/AuthController.ts.
+    const authBlock = hasAuth
+        ? `
+// GET pages — login/register/forgot-password/reset-password
+// Views live in app/Views/Auth/ (vendored from @rudderjs/auth/views/${ctx.primary}/)
+registerAuthRoutes(Route, { middleware: webMw })
+
+// POST handlers — sign-in/email, sign-up/email, sign-out, password reset.
+// Edit app/Http/Controllers/AuthController.ts to customize.
+Route.registerController(AuthController)
+`
+        : '';
+    // ── welcome page wiring ─────────────────────────────────
+    const welcomeBlock = hasWelcome
+        ? `
+// Read RudderJS version from @rudderjs/core's package.json at boot time.
+const _require = createRequire(import.meta.url)
+const rudderCorePkg = _require('@rudderjs/core/package.json') as { version: string }
+
+// Welcome page — delete this route and app/Views/Welcome.${welcomeExt(ctx.primary)} to replace it.
+Route.get('/', async () => {${hasAuth ? `
+  // Resolve the current user (if signed in) — AuthMiddleware auto-installs on
+  // the web group, so auth() has a populated ALS context here.
+  const current = await auth().user() as Record<string, unknown> | null
+  const user    = current
+    ? { name: String(current['name'] ?? ''), email: String(current['email'] ?? '') }
+    : null` : `
+  // Auth is not installed, so the welcome page never shows a signed-in user.
+  const user = null`}
+  return view('welcome', {
+    appName:       config<string>('app.name', 'RudderJS'),
+    rudderVersion: rudderCorePkg.version,
+    nodeVersion:   process.version.replace(/^v/, ''),
+    env:           config<string>('app.env', 'development'),
+    user,
+    // Laravel's Route::has() — the welcome nav renders Log in / Register links
+    // only when the auth package registered these named routes. Install
+    // @rudderjs/auth + call registerAuthRoutes() and they appear automatically;
+    // uninstall and they vanish. No scaffold-time flag.
+    loginUrl:    Route.getNamedRoute('login')    ?? null,
+    registerUrl: Route.getNamedRoute('register') ?? null,
+  })
+}${hasAuth ? ', webMw' : ''})
+`
+        : '';
+    // ── demos wiring ────────────────────────────────────────
+    // Controllers for /demos and /demos/<name>. Views live under app/Views/Demos/.
+    let demosBlock = '';
+    if (shouldScaffoldAnyDemo(ctx)) {
+        if (!hasWelcome) {
+            // Demo files exist but routesWeb already has `view` imports if hasWelcome.
+            // For multi-framework projects (no welcome) we still need the view import here.
+            imports.push(`import { view } from '@rudderjs/view'`);
+        }
+        if (shouldScaffoldDemo(ctx, 'todos')) {
+            imports.push(`import { resolve } from '@rudderjs/core'`);
+            imports.push(`import { TodoService } from '../app/Modules/Todo/TodoService.ts'`);
+        }
+        if (shouldScaffoldDemo(ctx, 'pennant')) {
+            imports.push(`import { Feature, FeatureMiddleware } from '@rudderjs/pennant'`);
+            // auth().user() — Pennant demo gates on `auth` so the import is always available
+            // when this branch fires; it's also already imported above when hasAuth.
+        }
+        const lines = [
+            `// Demos — see app/Views/Demos/`,
+            `Route.get('/demos',         async () => view('demos.index'))`,
+        ];
+        if (shouldScaffoldDemo(ctx, 'contact'))
+            lines.push(`Route.get('/demos/contact', async () => view('demos.contact'))`);
+        if (shouldScaffoldDemo(ctx, 'todos')) {
+            lines.push(`Route.get('/demos/todos',   async () => {`);
+            lines.push(`  const todos = await resolve<TodoService>(TodoService).findAll()`);
+            lines.push(`  return view('demos.todos', { todos })`);
+            lines.push(`})`);
+        }
+        if (shouldScaffoldDemo(ctx, 'avatar'))
+            lines.push(`Route.get('/demos/avatar',        async () => view('demos.avatar'))`);
+        if (shouldScaffoldDemo(ctx, 'fibonacci'))
+            lines.push(`Route.get('/demos/fibonacci',     async () => view('demos.fibonacci'))`);
+        if (shouldScaffoldDemo(ctx, 'system-info'))
+            lines.push(`Route.get('/demos/system-info',   async () => view('demos.system-info'))`);
+        if (shouldScaffoldDemo(ctx, 'cache'))
+            lines.push(`Route.get('/demos/cache',         async () => view('demos.cache'))`);
+        if (shouldScaffoldDemo(ctx, 'queue'))
+            lines.push(`Route.get('/demos/queue',         async () => view('demos.queue'))`);
+        if (shouldScaffoldDemo(ctx, 'mail'))
+            lines.push(`Route.get('/demos/mail',          async () => view('demos.mail'))`);
+        if (shouldScaffoldDemo(ctx, 'notifications'))
+            lines.push(`Route.get('/demos/notifications', async () => view('demos.notifications'))`);
+        if (shouldScaffoldDemo(ctx, 'localization'))
+            lines.push(`Route.get('/demos/localization',  async () => view('demos.localization'))`);
+        if (shouldScaffoldDemo(ctx, 'http'))
+            lines.push(`Route.get('/demos/http',          async () => view('demos.http'))`);
+        if (shouldScaffoldDemo(ctx, 'pennant')) {
+            lines.push(`Route.get('/demos/pennant', async () => {`);
+            lines.push(`  const current = await auth().user() as Record<string, unknown> | null`);
+            lines.push(`  const values = await Feature.values(`);
+            lines.push(`    ['dark-mode', 'max-uploads', 'beta-dashboard', 'new-checkout'],`);
+            lines.push(`    current as { id: string | number; [k: string]: unknown } | null,`);
+            lines.push(`  )`);
+            lines.push(`  const user = current`);
+            lines.push(`    ? { id: String(current['id']), name: String(current['name'] ?? ''), email: String(current['email'] ?? '') }`);
+            lines.push(`    : null`);
+            lines.push(`  return view('demos.pennant', { user, values })`);
+            lines.push(`})`);
+            lines.push(`Route.get('/demos/pennant/beta', async () => view('demos.pennant-beta'), [FeatureMiddleware('beta-dashboard')])`);
+        }
+        if (shouldScaffoldDemo(ctx, 'ws'))
+            lines.push(`Route.get('/demos/ws',      async () => view('demos.ws'))`);
+        if (shouldScaffoldDemo(ctx, 'sync'))
+            lines.push(`Route.get('/demos/sync',    async () => view('demos.sync'))`);
+        demosBlock = '\n' + lines.join('\n') + '\n';
+    }
+    return `${imports.join('\n')}
+${webMwBlock}${authBlock}${welcomeBlock}${demosBlock}
+// Web routes — HTML redirects, guards, and non-API server responses
+// These run before Vike's file-based page routing
+// Use this file for: redirects, server-side auth guards, download routes, sitemaps, etc.
+`;
+}
+export function welcomeExt(fw) {
+    return fw === 'vue' ? 'vue' : 'tsx';
+}
+//# sourceMappingURL=web.js.map

package/dist/templates/routes/web.js.map

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

package/dist/templates/server.d.ts

@@ -0,0 +1,2 @@
+export declare function serverTs(): string;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/templates/server.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,IAAI,MAAM,CAQjC"}

package/dist/templates/server.js

@@ -0,0 +1,10 @@
+export function serverTs() {
+    return `import type { Server } from 'vike/types'
+import app from './bootstrap/app.js'
+
+export default {
+  fetch: app.fetch,
+} satisfies Server
+`;
+}
+//# sourceMappingURL=server.js.map

package/dist/templates/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/templates/server.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ;IACtB,OAAO;;;;;;CAMR,CAAA;AACD,CAAC"}

package/dist/templates/tsconfig.d.ts

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

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

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

package/dist/templates/tsconfig.js

@@ -0,0 +1,33 @@
+export function tsconfigJson(ctx) {
+    const hasReact = ctx.frameworks.includes('react');
+    const hasSolid = ctx.frameworks.includes('solid');
+    const compilerOptions = {
+        target: 'ES2022',
+        module: 'ESNext',
+        moduleResolution: 'bundler',
+        lib: ['ES2022', 'DOM', 'DOM.Iterable'],
+        strict: true,
+        exactOptionalPropertyTypes: true,
+        noUncheckedIndexedAccess: true,
+        experimentalDecorators: true,
+        emitDecoratorMetadata: true,
+        skipLibCheck: true,
+        noEmit: true,
+        baseUrl: '.',
+        paths: { '@/*': ['./src/*'], 'App/*': ['./app/*'] },
+        allowImportingTsExtensions: true,
+    };
+    if (hasReact) {
+        compilerOptions['jsx'] = 'react-jsx';
+    }
+    else if (hasSolid) {
+        compilerOptions['jsx'] = 'preserve';
+        compilerOptions['jsxImportSource'] = 'solid-js';
+    }
+    // Vue only — no jsx field needed
+    return JSON.stringify({
+        compilerOptions,
+        include: ['src/**/*', 'pages/**/*', 'app/**/*', 'bootstrap/**/*', 'routes/**/*', 'config/**/*', '*.ts', '*.tsx'],
+    }, null, 2) + '\n';
+}
+//# sourceMappingURL=tsconfig.js.map

package/dist/templates/tsconfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsconfig.js","sourceRoot":"","sources":["../../src/templates/tsconfig.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAAC,GAAoB;IAC/C,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IACjD,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IAEjD,MAAM,eAAe,GAA4B;QAC/C,MAAM,EAAsB,QAAQ;QACpC,MAAM,EAAsB,QAAQ;QACpC,gBAAgB,EAAY,SAAS;QACrC,GAAG,EAAyB,CAAC,QAAQ,EAAE,KAAK,EAAE,cAAc,CAAC;QAC7D,MAAM,EAAsB,IAAI;QAChC,0BAA0B,EAAE,IAAI;QAChC,wBAAwB,EAAI,IAAI;QAChC,sBAAsB,EAAM,IAAI;QAChC,qBAAqB,EAAO,IAAI;QAChC,YAAY,EAAgB,IAAI;QAChC,MAAM,EAAsB,IAAI;QAChC,OAAO,EAAqB,GAAG;QAC/B,KAAK,EAAuB,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE;QACxE,0BAA0B,EAAE,IAAI;KACjC,CAAA;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,eAAe,CAAC,KAAK,CAAC,GAAG,WAAW,CAAA;IACtC,CAAC;SAAM,IAAI,QAAQ,EAAE,CAAC;QACpB,eAAe,CAAC,KAAK,CAAC,GAAe,UAAU,CAAA;QAC/C,eAAe,CAAC,iBAAiB,CAAC,GAAG,UAAU,CAAA;IACjD,CAAC;IACD,iCAAiC;IAEjC,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,eAAe;QACf,OAAO,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC;KACjH,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAA;AACpB,CAAC"}

package/dist/templates/views/welcome.d.ts

@@ -0,0 +1,6 @@
+import type { TemplateContext } from '../../templates.js';
+export declare function welcomeView(ctx: TemplateContext): string;
+export declare function welcomeViewReact(ctx: TemplateContext): string;
+export declare function welcomeViewVue(ctx: TemplateContext): string;
+export declare function welcomeViewSolid(ctx: TemplateContext): string;
+//# sourceMappingURL=welcome.d.ts.map

package/dist/templates/views/welcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome.d.ts","sourceRoot":"","sources":["../../../src/templates/views/welcome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEzD,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAMxD;AAsCD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAgH7D;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAiH3D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CA6H7D"}