@taujs/create-taujs 0.4.0 → 0.6.0

package/dist/index.js

@@ -26,12 +26,12 @@ function generateClaudeMd() {
 
 This project runs a \u03C4js MCP server (\`taujs-mcp\`, wired in \`.mcp.json\`). **Prefer its
 tools over reading \`taujs.config.ts\` or server internals by hand** \u2014 they answer from the
-emitted request graph and live request traces:
+emitted request graph and live request episodes:
 
 - Start with \`taujs_overview\`; use \`taujs_list_routes\` / \`taujs_get_route\` /
   \`taujs_explain_route\` for structure.
 - \`taujs_who_calls_service\` maps route \u2192 service edges (labelled declared vs observed).
-- Live behaviour: \`taujs_get_recent_traces\` \u2192 \`taujs_get_trace\` \u2192 \`taujs_get_trace_logs\`
+- Live behaviour: \`taujs_get_recent_episodes\` \u2192 \`taujs_get_episode\` \u2192 \`taujs_get_episode_logs\`
   (requires the dev server: \`pnpm dev\`). \`taujs_doctor\` summarises problems.
 
 Tool responses cite staleness and label every joined fact's source. Field values in
@@ -273,6 +273,9 @@ function planFiles(config) {
     { path: "CLAUDE.md", content: generateClaudeMd() },
     { path: "src/client/index.html", content: generateIndexHtml() },
     { path: "src/client/styles.css", content: generateStyles() },
+    // The derived type contract (framework-independent): AppData/AppRouteContext come from
+    // taujs.config.ts, so client code never hand-writes a payload shape.
+    { path: "src/client/app-types.ts", content: generateAppTypes() },
     // server (framework-independent — a single shared source)
     { path: "src/server/index.ts", content: generateServerIndex() },
     { path: "src/server/services/registry.ts", content: generateServiceRegistry() },
@@ -483,7 +486,15 @@ import { reactRenderer } from '@taujs/react/renderer';`;
       renderer: vueRenderer(),` : framework === "solid" ? `
       renderer: solidRenderer({ project: './tsconfig.solid.json' }),` : `
       renderer: reactRenderer({ project: './tsconfig.json' }),`;
-  return `import { defineConfig } from '@taujs/server/config';${rendererImport}
+  return `import { createServiceData, defineConfig } from '@taujs/server/config';${rendererImport}
+
+import type { ServiceRegistry } from './src/server/services/registry.ts';
+
+// Registry-typed service declarations: the helper carries each method's RESULT type into
+// RouteData, so the app's types derive from this file instead of being hand-written
+// (see src/client/app-types.ts). Closure handlers and ctx.call remain available for dynamic
+// dispatch - https://taujs.dev/guides/services/
+const serviceData = createServiceData<ServiceRegistry>();
 
 export default defineConfig({
   server: {
@@ -507,10 +518,8 @@ export default defineConfig({
           attr: {
             render: 'ssr',
             hydrate: true,
-            // Direct service invocation: standard SSR
-            data: async (params, ctx) => {
-              return ctx.call('example', 'greet', { name: 'SSR' });
-            },
+            // Declared service edge: RouteData<typeof config, '/'> is greet()'s resolved result
+            data: serviceData('example', 'greet', () => ({ name: 'SSR' })),
           },
         },
         {
@@ -518,12 +527,8 @@ export default defineConfig({
           attr: {
             render: 'streaming',
             hydrate: true,
-            // Descriptor-based data: resolved by the server
-            data: async (params) => ({
-              args: { name: 'Streaming' },
-              serviceName: 'example',
-              serviceMethod: 'greet',
-            }),
+            // The same declared edge on a streaming route: the shell streams while greet() resolves
+            data: serviceData('example', 'greet', () => ({ name: 'Streaming' })),
             // meta recommended for streaming routes for SEO/social and render timing
             meta: {
               title: "\u03C4js \u2014 Streaming",
@@ -584,8 +589,10 @@ function generateReadme(projectName, packageManager, framework) {
   const clientTree = framework === "vue" ? `\u2502   \u2502   \u251C\u2500\u2500 App.vue             # Root component (route switch)
 \u2502   \u2502   \u251C\u2500\u2500 HomePage.vue        # SSR route (useSSRData + v-if)
 \u2502   \u2502   \u251C\u2500\u2500 StreamingPage.vue   # Streaming route (await useSSRDataAsync)
+\u2502   \u2502   \u251C\u2500\u2500 app-types.ts        # Types derived from taujs.config.ts
 \u2502   \u2502   \u251C\u2500\u2500 entry-client.ts     # Client hydration entry
 \u2502   \u2502   \u251C\u2500\u2500 entry-server.ts     # SSR render entry` : `\u2502   \u2502   \u251C\u2500\u2500 App.tsx             # Root component
+\u2502   \u2502   \u251C\u2500\u2500 app-types.ts        # Types derived from taujs.config.ts
 \u2502   \u2502   \u251C\u2500\u2500 entry-client.tsx    # Client hydration entry
 \u2502   \u2502   \u251C\u2500\u2500 entry-server.tsx    # SSR render entry`;
   const mainUi = framework === "vue" ? "App.vue" : "App.tsx";
@@ -680,13 +687,11 @@ import { useSSRStore } from '@taujs/react';
 
 import "./styles.css";
 
-type GreetingData = {
-  message: string;
-  timestamp: string;
-};
+import type { AppData } from './app-types';
 
 function GreetingCard() {
-  const data = useSSRStore<GreetingData>();
+  // AppData is derived from taujs.config.ts - greet()'s result, never hand-written.
+  const data = useSSRStore<AppData>();
 
   return (
     <section className="card card--primary">
@@ -740,9 +745,9 @@ export function App() {
           which is ideal for predictable latency and caching.
         </p>
         <p>
-          <strong>STREAM:</strong> The <code>/streaming</code> route uses a service descriptor
-          and returns a Promise. The <code>&lt;Suspense&gt;</code> boundary above shows
-          a fallback while the server resolves it, then progressively streams the final content.
+          <strong>STREAM:</strong> The <code>/streaming</code> route declares the same typed
+          service edge with streaming rendering. The <code>&lt;Suspense&gt;</code> boundary above
+          shows a fallback while the server resolves it, then progressively streams the final content.
         </p>
       </section>
 
@@ -980,6 +985,33 @@ code {
   text-align: center;
 }`;
 }
+function generateAppTypes() {
+  return `/**
+ * The application's type contract, DERIVED from taujs.config.ts - never hand-written.
+ * Every import here is type-only, so nothing from the config or server reaches the client bundle.
+ */
+import type config from '../../taujs.config.ts';
+import type { RouteContext, RouteData } from '@taujs/server/config';
+
+/** The route-discriminated context the host passes to appComponent and headContent. */
+export type AppRouteContext = RouteContext<typeof config>;
+
+/**
+ * The union of every declared route's resolved data - both scaffold routes resolve greet(), so
+ * one shared type serves the whole app.
+ *
+ * A declared route WITHOUT \`attr.data\` contributes \`Record<string, undefined>\` (the server
+ * supplies \`{}\` for it), so the union stays usable when such routes exist: reads become
+ * \`T | undefined\`, making code account for the no-data route. When routes diverge further,
+ * narrow per route with the derived aliases below - still from the config, never hand-written.
+ */
+export type AppData = RouteData<typeof config>;
+
+// Optional narrowing when routes diverge:
+// export type HomeData = RouteData<typeof config, '/'>;
+// export type StreamingData = RouteData<typeof config, '/streaming'>;
+`;
+}
 function generateViteEnv() {
   return `/// <reference types="vite/client" />
 `;
@@ -1070,13 +1102,11 @@ function generateHomePageVue() {
   return `<script setup lang="ts">
 import { useSSRData } from '@taujs/vue';
 
-type GreetingData = {
-  message: string;
-  timestamp: string;
-};
+import type { AppData } from './app-types';
 
 // Fallback idiom: non-blocking; \`data\` is undefined until ready, guarded with v-if.
-const data = useSSRData<GreetingData>();
+// AppData is derived from taujs.config.ts - greet()'s result, never hand-written.
+const data = useSSRData<AppData>();
 </script>
 
 <template>
@@ -1095,13 +1125,11 @@ function generateStreamingPageVue() {
   return `<script setup lang="ts">
 import { useSSRDataAsync } from '@taujs/vue';
 
-type GreetingData = {
-  message: string;
-  timestamp: string;
-};
+import type { AppData } from './app-types';
 
 // Suspense idiom: async setup blocks on the data, so streamed routes deliver it in the payload.
-const data = await useSSRDataAsync<GreetingData>();
+// AppData is derived from taujs.config.ts - greet()'s result, never hand-written.
+const data = await useSSRDataAsync<AppData>();
 </script>
 
 <template>
@@ -1129,13 +1157,17 @@ function generateEntryServerVue() {
 
 import App from './App.vue';
 
-export const { renderSSR, renderStream } = createRenderer({
+import type { AppData, AppRouteContext } from './app-types';
+
+// Generics derived from taujs.config.ts: typed data for headContent and the store, typed
+// routeContext for appComponent.
+export const { renderSSR, renderStream } = createRenderer<AppData, AppRouteContext>({
   appComponent: App,
   headContent: ({ data, meta }) => \`
     <title>\${meta?.title || "\u03C4js - Composing systems, not just apps"}</title>
     <meta name="description" content="\${
       meta?.description ||
-      (data as { message?: string })?.message ||
+      data?.message ||
       "\u03C4js - Composing systems, not just apps"
     }">
   \`,
@@ -1158,7 +1190,11 @@ function generateEntryServer() {
   return `import { createRenderer } from '@taujs/react';
 import { App } from './App';
 
-export const { renderSSR, renderStream } = createRenderer({
+import type { AppData, AppRouteContext } from './app-types';
+
+// Generics derived from taujs.config.ts: typed data for headContent and the store, typed
+// routeContext for appComponent.
+export const { renderSSR, renderStream } = createRenderer<AppData, AppRouteContext>({
   appComponent: () => <App />,
   headContent: ({ data, meta }) => \`
     <title>\${meta?.title || "\u03C4js - Composing systems, not just apps"}</title>
@@ -1194,12 +1230,13 @@ function generateAppComponentSolid() {
   return `import { Show } from 'solid-js';
 import { useSSRStore } from '@taujs/solid';
 
-type RouteData = { message?: string };
+import type { AppData } from './app-types';
 
 export function App() {
   // Route data arrives through the store, which the renderer provides. On the server it is already
   // committed before the render begins; on the client it is seeded from window.__INITIAL_DATA__.
-  const store = useSSRStore<RouteData>();
+  // AppData is derived from taujs.config.ts - greet()'s result, never hand-written.
+  const store = useSSRStore<AppData>();
 
   return (
     <main>
@@ -1234,7 +1271,11 @@ function generateEntryServerSolid() {
 import { App } from './App';
 import { RENDER_ID } from './renderId';
 
-export const { renderSSR, renderStream } = createRenderer({
+import type { AppData, AppRouteContext } from './app-types';
+
+// Generics derived from taujs.config.ts: typed data for headContent and the store, typed
+// routeContext for appComponent.
+export const { renderSSR, renderStream } = createRenderer<AppData, AppRouteContext>({
   appComponent: () => <App />,
   renderId: RENDER_ID,
   headContent: ({ data, meta }) => \`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taujs/create-taujs",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Scaffold a new τjs application",
   "author": "Aoede <taujs@aoede.uk.net> (https://www.aoede.uk.net)",
   "homepage": "https://taujs.dev/",