create-rudder-app 0.5.0 → 0.6.0

package/dist/templates/demos/index-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-view.d.ts","sourceRoot":"","sources":["../../../src/templates/demos/index-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAE7E,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CA+I3D"}
+{"version":3,"file":"index-view.d.ts","sourceRoot":"","sources":["../../../src/templates/demos/index-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAG7E,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CA6C3D"}

package/dist/templates/demos/index-view.js

@@ -1,110 +1,14 @@
 import { shouldScaffoldDemo } from '../../templates.js';
+import { DEMOS, demoHref, demoTitle } from './registry.js';
 export function demosIndexView(ctx) {
-    const cards = [
-        {
-            title: 'Contact form',
-            desc: 'CSRF-protected form with Zod validation. Demonstrates getCsrfToken() and FormRequest-style error handling.',
-            href: '/demos/contact',
-            pkgs: '@rudderjs/middleware · @rudderjs/core',
-            show: shouldScaffoldDemo(ctx, 'contact'),
-        },
-        {
-            title: 'Todos',
-            desc: 'ORM + interactive UI. Controller loads initial data, the view hydrates and POSTs to /api/todos/* for live updates.',
-            href: '/demos/todos',
-            pkgs: '@rudderjs/orm · @rudderjs/router',
-            show: shouldScaffoldDemo(ctx, 'todos'),
-        },
-        {
-            title: 'Avatar resize',
-            desc: 'Upload an image — server resizes it to 256×256 WebP via @rudderjs/image and saves to public storage. Side-by-side compare.',
-            href: '/demos/avatar',
-            pkgs: '@rudderjs/image · @rudderjs/storage',
-            show: shouldScaffoldDemo(ctx, 'avatar'),
-        },
-        {
-            title: 'System info',
-            desc: 'Three shell commands (git, node, uptime) executed via @rudderjs/process. Compares sequential vs parallel cost using Process.pool().',
-            href: '/demos/system-info',
-            pkgs: '@rudderjs/process',
-            show: shouldScaffoldDemo(ctx, 'system-info'),
-        },
-        {
-            title: 'Worker threads',
-            desc: 'Compute fib(n) sequentially on the main thread vs across @rudderjs/concurrency worker pool. Watch the parallel cost stay flat as you crank N.',
-            href: '/demos/fibonacci',
-            pkgs: '@rudderjs/concurrency',
-            show: shouldScaffoldDemo(ctx, 'fibonacci'),
-        },
-        {
-            title: 'Feature flags',
-            desc: 'Boolean, value, scoped, and Lottery features resolved against the current user. Sub-route guarded by FeatureMiddleware to demonstrate 403 blocking.',
-            href: '/demos/pennant',
-            pkgs: '@rudderjs/pennant',
-            show: shouldScaffoldDemo(ctx, 'pennant'),
-        },
-        {
-            title: 'Cache counter',
-            desc: 'Persistent view counter via Cache.get + Cache.set. Demonstrates the Cache facade with the in-memory driver.',
-            href: '/demos/cache',
-            pkgs: '@rudderjs/cache',
-            show: shouldScaffoldDemo(ctx, 'cache'),
-        },
-        {
-            title: 'Queue dispatch',
-            desc: 'Click to enqueue ExampleJob via @rudderjs/queue. The handler logs to the server terminal.',
-            href: '/demos/queue',
-            pkgs: '@rudderjs/queue',
-            show: shouldScaffoldDemo(ctx, 'queue'),
-        },
-        {
-            title: 'Mail send',
-            desc: 'Send a Mailable via Mail.to(...).send(). Default driver is "log" — output appears in the dev terminal.',
-            href: '/demos/mail',
-            pkgs: '@rudderjs/mail',
-            show: shouldScaffoldDemo(ctx, 'mail'),
-        },
-        {
-            title: 'Notifications',
-            desc: 'Multi-channel notification via notify(notifiable, notification). Mail channel uses the log driver.',
-            href: '/demos/notifications',
-            pkgs: '@rudderjs/notification · @rudderjs/mail',
-            show: shouldScaffoldDemo(ctx, 'notifications'),
-        },
-        {
-            title: 'Localization',
-            desc: 'Pick a locale to fetch the same keys via trans() server-side. Strings live in lang/<locale>/messages.json.',
-            href: '/demos/localization',
-            pkgs: '@rudderjs/localization',
-            show: shouldScaffoldDemo(ctx, 'localization'),
-        },
-        {
-            title: 'HTTP client',
-            desc: 'Server-side Http.retry(3, 200).timeout(5000).get(url) against a public API. The 500 endpoint exercises retry.',
-            href: '/demos/http',
-            pkgs: '@rudderjs/http',
-            show: shouldScaffoldDemo(ctx, 'http'),
-        },
-        {
-            title: 'WebSocket chat',
-            desc: 'Real-time chat + presence using @rudderjs/broadcast — multi-channel pub/sub over a single WebSocket connection.',
-            href: '/demos/ws',
-            pkgs: '@rudderjs/broadcast',
-            show: shouldScaffoldDemo(ctx, 'ws'),
-        },
-        {
-            title: 'Collaborative editor',
-            desc: 'Yjs CRDT live document with awareness cursors. Open in two tabs to see real-time sync over @rudderjs/sync.',
-            href: '/demos/sync',
-            pkgs: '@rudderjs/sync',
-            show: shouldScaffoldDemo(ctx, 'sync'),
-        },
-    ].filter(c => c.show);
-    const cardsJsx = cards.map(c => `        <a key="${c.href}" href="${c.href}" className="feature-card">
-          <h3 className="feature-title">${c.title}</h3>
-          <p className="feature-desc">${c.desc}</p>
-          <p className="feature-desc" style={{ fontSize: '0.7rem', opacity: 0.7 }}>${c.pkgs}</p>
-        </a>`).join('\n');
+    const cards = DEMOS
+        .filter(d => shouldScaffoldDemo(ctx, d.value))
+        .map(d => `        <a key="${demoHref(d)}" href="${demoHref(d)}" className="feature-card">
+          <h3 className="feature-title">${demoTitle(d)}</h3>
+          <p className="feature-desc">${escapeJsxText(d.description)}</p>
+          <p className="feature-desc" style={{ fontSize: '0.7rem', opacity: 0.7 }}>${d.packages.join(' · ')}</p>
+        </a>`)
+        .join('\n');
     return `import '@/index.css'
 
 // Override the id-derived URL ('/demos/index') so SPA nav matches the controller ('/demos').
@@ -133,7 +37,7 @@ export default function DemosIndex() {
 
       <section className="feature-section">
         <div className="feature-grid">
-${cardsJsx}
+${cards}
         </div>
       </section>
     </div>
@@ -141,4 +45,10 @@ ${cardsJsx}
 }
 `;
 }
+// Description strings live as plain text in the registry, but they're emitted
+// inside JSX text nodes. Escape '<' and '>' so a raw '<name>' (e.g. in the
+// localization description) doesn't get parsed as a JSX element.
+function escapeJsxText(s) {
+    return s.replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
 //# sourceMappingURL=index-view.js.map

package/dist/templates/demos/index-view.js.map

@@ -1 +1 @@
-{"version":3,"file":"index-view.js","sourceRoot":"","sources":["../../../src/templates/demos/index-view.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index-view.js","sourceRoot":"","sources":["../../../src/templates/demos/index-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAwB,MAAM,oBAAoB,CAAA;AAC7E,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE1D,MAAM,UAAU,cAAc,CAAC,GAAoB;IACjD,MAAM,KAAK,GAAG,KAAK;SAChB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;SAC7C,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,mBAAmB,QAAQ,CAAC,CAAC,CAAC,WAAW,QAAQ,CAAC,CAAC,CAAC;0CACxB,SAAS,CAAC,CAAC,CAAC;wCACd,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC;qFACiB,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;aAC9F,CAAC;SACT,IAAI,CAAC,IAAI,CAAC,CAAA;IAEb,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BP,KAAK;;;;;;CAMN,CAAA;AACD,CAAC;AAED,8EAA8E;AAC9E,2EAA2E;AAC3E,iEAAiE;AACjE,SAAS,aAAa,CAAC,CAAS;IAC9B,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;AACtD,CAAC"}

package/dist/templates/demos/registry.d.ts

@@ -1,13 +1,26 @@
 import type { TemplateContext } from '../../templates.js';
 export interface DemoSpec {
+    /** Stable id used in URLs, file names, and the prompt multiselect. */
     value: string;
+    /** Short label shown in the @clack/prompts multiselect. */
     label: string;
+    /** Single-line hint shown next to the label in the prompt. */
     hint?: string;
+    /** Card title shown on /demos. Falls back to `label` when omitted. */
+    title?: string;
+    /** Long description shown on the /demos card in the scaffolded app + playground. */
+    description: string;
+    /** Packages this demo exercises — rendered under each /demos card. */
+    packages: ReadonlyArray<string>;
     /** Package keys that must all be selected for this demo to scaffold. */
     requires?: ReadonlyArray<keyof TemplateContext['packages']>;
     /** True if this demo requires a database/ORM. */
     requiresOrm?: boolean;
 }
+/** Card title used on /demos — falls back to `label` when not overridden. */
+export declare function demoTitle(spec: DemoSpec): string;
 export declare const DEMOS: ReadonlyArray<DemoSpec>;
 export declare function availableDemos(orm: TemplateContext['orm'], packages: TemplateContext['packages']): DemoSpec[];
+/** Default href for a demo card — `/demos/<value>`. */
+export declare function demoHref(spec: Pick<DemoSpec, 'value'>): string;
 //# sourceMappingURL=registry.d.ts.map

package/dist/templates/demos/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/templates/demos/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEzD,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAS,MAAM,CAAA;IACpB,KAAK,EAAS,MAAM,CAAA;IACpB,IAAI,CAAC,EAAS,MAAM,CAAA;IACpB,wEAAwE;IACxE,QAAQ,CAAC,EAAK,aAAa,CAAC,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC,CAAA;IAC9D,iDAAiD;IACjD,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,eAAO,MAAM,KAAK,EAAE,aAAa,CAAC,QAAQ,CAezC,CAAA;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,eAAe,CAAC,KAAK,CAAC,EAC3B,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,GACpC,QAAQ,EAAE,CAMZ"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/templates/demos/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEzD,MAAM,WAAW,QAAQ;IACvB,sEAAsE;IACtE,KAAK,EAAS,MAAM,CAAA;IACpB,2DAA2D;IAC3D,KAAK,EAAS,MAAM,CAAA;IACpB,8DAA8D;IAC9D,IAAI,CAAC,EAAS,MAAM,CAAA;IACpB,sEAAsE;IACtE,KAAK,CAAC,EAAQ,MAAM,CAAA;IACpB,oFAAoF;IACpF,WAAW,EAAG,MAAM,CAAA;IACpB,sEAAsE;IACtE,QAAQ,EAAM,aAAa,CAAC,MAAM,CAAC,CAAA;IACnC,wEAAwE;IACxE,QAAQ,CAAC,EAAK,aAAa,CAAC,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC,CAAA;IAC9D,iDAAiD;IACjD,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEhD;AAED,eAAO,MAAM,KAAK,EAAE,aAAa,CAAC,QAAQ,CAiHzC,CAAA;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,eAAe,CAAC,KAAK,CAAC,EAC3B,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,GACpC,QAAQ,EAAE,CAMZ;AAED,uDAAuD;AACvD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,MAAM,CAE9D"}

package/dist/templates/demos/registry.js

@@ -1,18 +1,120 @@
+/** Card title used on /demos — falls back to `label` when not overridden. */
+export function demoTitle(spec) {
+    return spec.title ?? spec.label;
+}
 export const DEMOS = [
-    { value: 'contact', label: 'Contact form', hint: 'CSRF + Zod validation' },
-    { value: 'cache', label: 'Cache counter', hint: 'Cache.get + Cache.set round-trip' },
-    { value: 'todos', label: 'Todos CRUD', hint: 'requires ORM', requiresOrm: true },
-    { value: 'queue', label: 'Queue dispatch', hint: 'requires Queue', requires: ['queue'] },
-    { value: 'mail', label: 'Mail send', hint: 'requires Mail', requires: ['mail'] },
-    { value: 'notifications', label: 'Notifications', hint: 'requires Notifications + Mail', requires: ['notifications', 'mail'] },
-    { value: 'localization', label: 'Localization', hint: 'requires Localization', requires: ['localization'] },
-    { value: 'http', label: 'HTTP client', hint: 'requires HTTP', requires: ['http'] },
-    { value: 'avatar', label: 'Avatar resize', hint: 'requires Storage + Image', requires: ['storage', 'image'] },
-    { value: 'fibonacci', label: 'Worker threads', hint: 'requires Concurrency', requires: ['concurrency'] },
-    { value: 'system-info', label: 'System info', hint: 'requires Process', requires: ['process'] },
-    { value: 'pennant', label: 'Feature flags', hint: 'requires Pennant + Auth', requires: ['pennant', 'auth'] },
-    { value: 'ws', label: 'WebSocket chat', hint: 'requires WebSocket / Broadcast', requires: ['broadcast'] },
-    { value: 'sync', label: 'Yjs collaboration', hint: 'requires Sync', requires: ['sync'] },
+    {
+        value: 'contact',
+        label: 'Contact form',
+        hint: 'CSRF + Zod validation',
+        description: 'CSRF-protected form with Zod validation. Demonstrates getCsrfToken() and FormRequest-style error handling.',
+        packages: ['@rudderjs/middleware', '@rudderjs/core'],
+    },
+    {
+        value: 'cache',
+        label: 'Cache counter',
+        hint: 'Cache.get + Cache.set round-trip',
+        description: 'Click "Bump" to read the current value via Cache.get, increment it, and write it back via Cache.set. Default driver is in-memory.',
+        packages: ['@rudderjs/cache'],
+    },
+    {
+        value: 'todos',
+        label: 'Todos CRUD',
+        title: 'Todos',
+        hint: 'requires ORM',
+        description: 'ORM + interactive UI. Controller loads initial data, the view hydrates and POSTs to /api/todos/* for live updates.',
+        packages: ['@rudderjs/orm', '@rudderjs/router'],
+        requiresOrm: true,
+    },
+    {
+        value: 'queue',
+        label: 'Queue dispatch',
+        hint: 'requires Queue',
+        description: 'Dispatch ExampleJob via @rudderjs/queue. The handler logs to the server terminal — install @rudderjs/horizon for a UI.',
+        packages: ['@rudderjs/queue'],
+        requires: ['queue'],
+    },
+    {
+        value: 'mail',
+        label: 'Mail send',
+        hint: 'requires Mail',
+        description: 'Send a DemoMail via @rudderjs/mail. Default driver is log — output lands in the dev server terminal.',
+        packages: ['@rudderjs/mail'],
+        requires: ['mail'],
+    },
+    {
+        value: 'notifications',
+        label: 'Notifications',
+        hint: 'requires Notifications + Mail',
+        description: "Dispatch a WelcomeNotification via notify(). The notification's via() picks the channel(s); mail routes through the log driver.",
+        packages: ['@rudderjs/notification', '@rudderjs/mail'],
+        requires: ['notifications', 'mail'],
+    },
+    {
+        value: 'localization',
+        label: 'Localization',
+        hint: 'requires Localization',
+        description: 'Locale switcher resolves the same keys server-side via trans(). Strings live in lang/<locale>/messages.json.',
+        packages: ['@rudderjs/localization'],
+        requires: ['localization'],
+    },
+    {
+        value: 'http',
+        label: 'HTTP client',
+        hint: 'requires HTTP',
+        description: 'Server-side Http.retry(3, 200).timeout(5000).get(url) against a public API. The 500 endpoint exercises the retry path.',
+        packages: ['@rudderjs/http'],
+        requires: ['http'],
+    },
+    {
+        value: 'avatar',
+        label: 'Avatar resize',
+        hint: 'requires Storage + Image',
+        description: 'Upload an image — server resizes it to 256×256 WebP via @rudderjs/image and saves to public storage. Side-by-side compare.',
+        packages: ['@rudderjs/image', '@rudderjs/storage'],
+        requires: ['storage', 'image'],
+    },
+    {
+        value: 'fibonacci',
+        label: 'Worker threads',
+        hint: 'requires Concurrency',
+        description: 'Compute fib(n) sequentially on the main thread vs across @rudderjs/concurrency worker pool. Watch the parallel cost stay flat as you crank N.',
+        packages: ['@rudderjs/concurrency'],
+        requires: ['concurrency'],
+    },
+    {
+        value: 'system-info',
+        label: 'System info',
+        hint: 'requires Process',
+        description: 'Three shell commands (git, node, uptime) executed via @rudderjs/process. Compares sequential vs parallel cost using Process.pool().',
+        packages: ['@rudderjs/process'],
+        requires: ['process'],
+    },
+    {
+        value: 'pennant',
+        label: 'Feature flags',
+        hint: 'requires Pennant + Auth',
+        description: 'Boolean, value, scoped, and Lottery features resolved against the current user. Sub-route guarded by FeatureMiddleware to demonstrate 403 blocking.',
+        packages: ['@rudderjs/pennant'],
+        requires: ['pennant', 'auth'],
+    },
+    {
+        value: 'ws',
+        label: 'WebSocket chat',
+        hint: 'requires WebSocket / Broadcast',
+        description: 'Real-time chat + presence using @rudderjs/broadcast — multi-channel pub/sub over a single WebSocket connection.',
+        packages: ['@rudderjs/broadcast'],
+        requires: ['broadcast'],
+    },
+    {
+        value: 'sync',
+        label: 'Yjs collaboration',
+        title: 'Collaborative editor',
+        hint: 'requires Sync',
+        description: 'Yjs CRDT live document with awareness cursors. Open in two tabs to see real-time sync over @rudderjs/sync.',
+        packages: ['@rudderjs/sync'],
+        requires: ['sync'],
+    },
 ];
 export function availableDemos(orm, packages) {
     return DEMOS.filter(d => {
@@ -23,4 +125,8 @@ export function availableDemos(orm, packages) {
         return true;
     });
 }
+/** Default href for a demo card — `/demos/<value>`. */
+export function demoHref(spec) {
+    return `/demos/${spec.value}`;
+}
 //# sourceMappingURL=registry.js.map

package/dist/templates/demos/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/templates/demos/registry.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,KAAK,GAA4B;IAC5C,EAAE,KAAK,EAAE,SAAS,EAAQ,KAAK,EAAE,cAAc,EAAO,IAAI,EAAE,uBAAuB,EAAE;IACrF,EAAE,KAAK,EAAE,OAAO,EAAU,KAAK,EAAE,eAAe,EAAM,IAAI,EAAE,kCAAkC,EAAE;IAChG,EAAE,KAAK,EAAE,OAAO,EAAU,KAAK,EAAE,YAAY,EAAS,IAAI,EAAE,cAAc,EAAoB,WAAW,EAAE,IAAI,EAAE;IACjH,EAAE,KAAK,EAAE,OAAO,EAAU,KAAK,EAAE,gBAAgB,EAAK,IAAI,EAAE,gBAAgB,EAAkB,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE;IACnH,EAAE,KAAK,EAAE,MAAM,EAAW,KAAK,EAAE,WAAW,EAAU,IAAI,EAAE,eAAe,EAAmB,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE;IAClH,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,EAAM,IAAI,EAAE,+BAA+B,EAAG,QAAQ,EAAE,CAAC,eAAe,EAAE,MAAM,CAAC,EAAE;IACnI,EAAE,KAAK,EAAE,cAAc,EAAG,KAAK,EAAE,cAAc,EAAO,IAAI,EAAE,uBAAuB,EAAW,QAAQ,EAAE,CAAC,cAAc,CAAC,EAAE;IAC1H,EAAE,KAAK,EAAE,MAAM,EAAW,KAAK,EAAE,aAAa,EAAQ,IAAI,EAAE,eAAe,EAAmB,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE;IAClH,EAAE,KAAK,EAAE,QAAQ,EAAS,KAAK,EAAE,eAAe,EAAM,IAAI,EAAE,0BAA0B,EAAQ,QAAQ,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE;IAC9H,EAAE,KAAK,EAAE,WAAW,EAAM,KAAK,EAAE,gBAAgB,EAAK,IAAI,EAAE,sBAAsB,EAAY,QAAQ,EAAE,CAAC,aAAa,CAAC,EAAE;IACzH,EAAE,KAAK,EAAE,aAAa,EAAI,KAAK,EAAE,aAAa,EAAQ,IAAI,EAAE,kBAAkB,EAAgB,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE;IACrH,EAAE,KAAK,EAAE,SAAS,EAAQ,KAAK,EAAE,eAAe,EAAM,IAAI,EAAE,yBAAyB,EAAS,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE;IAC7H,EAAE,KAAK,EAAE,IAAI,EAAa,KAAK,EAAE,gBAAgB,EAAK,IAAI,EAAE,gCAAgC,EAAE,QAAQ,EAAE,CAAC,WAAW,CAAC,EAAE;IACvH,EAAE,KAAK,EAAE,MAAM,EAAW,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,eAAe,EAAmB,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE;CACnH,CAAA;AAED,MAAM,UAAU,cAAc,CAC5B,GAA2B,EAC3B,QAAqC;IAErC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QACtB,IAAI,CAAC,CAAC,WAAW,IAAI,GAAG,KAAK,KAAK;YAAE,OAAO,KAAK,CAAA;QAChD,IAAI,CAAC,CAAC,QAAQ;YAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;QACzD,OAAO,IAAI,CAAA;IACb,CAAC,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/templates/demos/registry.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-rudder-app",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -19,6 +19,10 @@
   "exports": {
     ".": {
       "import": "./dist/index.js"
+    },
+    "./demos-registry": {
+      "types": "./dist/templates/demos/registry.d.ts",
+      "import": "./dist/templates/demos/registry.js"
     }
   },
   "dependencies": {