@codenotch/codenotch.cli 1.0.35 → 1.0.37

package/dist/utils/ProjectTemplates.js

@@ -0,0 +1,284 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NPM_INSTALL_STEP = void 0;
+const TemplateUtils_1 = __importDefault(require("./TemplateUtils"));
+const ManifestUtils_1 = __importDefault(require("./ManifestUtils"));
+const DEFAULT_APP_NAME = 'index';
+/** The install step of the next steps, as 'cn project new' drops it once it ran it */
+exports.NPM_INSTALL_STEP = 'npm install';
+/** Versions pinned by the templates. React 19 is the only supported major */
+const VERSIONS = {
+    reactRouter: '^7.6.0',
+    tailwind: '^4.1.0',
+    tailwindPostcss: '^4.1.0',
+    postcss: '^8.5.0'
+};
+/**
+ * The starting points 'cn project new' can scaffold.
+ *
+ * 'default' is the bare project with a routed React app, 'tailwind' adds Tailwind CSS to it, and
+ * 'todolist' builds a complete application on top of that: tables, processes, queries and
+ * translations. Each of these extends the previous one, so what is fixed in one is fixed in all.
+ * 'api' stands apart: a table and its endpoints, without any app nor React.
+ *
+ * Where the runtime API is not settled yet (`@codenotch/process`, `@codenotch/orm`, `startProcess`),
+ * the generated code carries a TODO rather than a guess.
+ */
+class ProjectTemplates {
+    static TEMPLATES = [
+        { name: 'default', description: 'Empty project with a routed React 19 app' },
+        { name: 'tailwind', description: 'Same, styled with Tailwind CSS 4 (light and dark themes)' },
+        { name: 'todolist', description: 'Complete todo list app: tables, CRUD processes, queries, translations' },
+        { name: 'api', description: 'API only: a table and its endpoints, no app at all' }
+    ];
+    static isTemplateName(value) {
+        return this.TEMPLATES.some(template => template.name === value);
+    }
+    static build(name, context) {
+        switch (name) {
+            case 'default': return this.buildDefault(context);
+            case 'tailwind': return this.buildTailwind(context);
+            case 'todolist': return this.buildTodolist(context);
+            case 'api': return this.buildApi(context);
+        }
+    }
+    // ------------------------------------------------------------------ default
+    static buildDefault(context, styled = false) {
+        const manifest = ManifestUtils_1.default.createManifest(context.projectName, { serviceName: context.serviceName });
+        manifest.languages = [...context.languages];
+        return {
+            folders: [...TemplateUtils_1.default.PROJECT_FOLDERS],
+            files: [
+                { path: 'manifest.json', content: ManifestUtils_1.default.serialize(manifest) },
+                { path: 'readme.md', content: TemplateUtils_1.default.createReadmeMd(context.projectName, context.serviceName) },
+                { path: '.gitignore', content: TemplateUtils_1.default.createGitignore() },
+                {
+                    path: 'package.json',
+                    content: this.toJson(TemplateUtils_1.default.createPackageJson(context.serviceName, {
+                        dependencies: { 'react-router': VERSIONS.reactRouter }
+                    }))
+                },
+                { path: `apps/${DEFAULT_APP_NAME}.manifest.json`, content: this.toJson(this.createAppManifest(context.projectName)) },
+                { path: `apps/${DEFAULT_APP_NAME}.tsx`, content: this.createRoutedApp(styled) },
+                { path: 'apps/components/Layout.tsx', content: this.createLayout(styled) },
+                { path: 'apps/pages/HomePage.tsx', content: this.createHomePage(styled) },
+                { path: 'apps/pages/AboutPage.tsx', content: this.createAboutPage(styled) },
+                { path: 'apps/pages/HelloPage.tsx', content: this.createHelloPage(styled) },
+                { path: `apps/${DEFAULT_APP_NAME}.scss`, content: this.createDefaultScss() }
+            ],
+            nextSteps: [
+                exports.NPM_INSTALL_STEP,
+                'cn project start'
+            ]
+        };
+    }
+    static createAppManifest(projectName) {
+        const manifest = TemplateUtils_1.default.createAppManifest(DEFAULT_APP_NAME);
+        // The tab of the browser is better named after the project than after 'index'
+        manifest.html = { ...manifest.html, title: projectName };
+        return manifest;
+    }
+    /**
+     * The entry of the app: a HashRouter, which keeps the routing client side whatever URL the
+     * runtime serves the app from, and one route per page
+     */
+    static createRoutedApp(styled) {
+        return this.lines(`import React from 'react';`, `import { HashRouter, Route, Routes } from 'react-router';`, `import './${DEFAULT_APP_NAME}.scss';`, `import Layout from './components/Layout';`, `import HomePage from './pages/HomePage';`, `import AboutPage from './pages/AboutPage';`, `import HelloPage from './pages/HelloPage';`, ``, `// HashRouter keeps the routing client side, whatever URL the runtime serves the app from`, `const ${DEFAULT_APP_NAME}: React.FC<{}> = () => {`, `\treturn <HashRouter>`, `\t\t<Routes>`, `\t\t\t<Route element={<Layout />}>`, `\t\t\t\t<Route index element={<HomePage />} />`, `\t\t\t\t<Route path="about" element={<AboutPage />} />`, `\t\t\t\t<Route path="hello/:name" element={<HelloPage />} />`, `\t\t\t</Route>`, `\t\t</Routes>`, `\t</HashRouter>;`, `};`, ``, `export default ${DEFAULT_APP_NAME};`, ``);
+    }
+    static createLayout(styled) {
+        const c = this.classes(styled);
+        return this.lines(`import React from 'react';`, `import { NavLink, Outlet } from 'react-router';`, `import { useCodenotch } from '@codenotch/codenotch.react';`, ``, `// Shared frame of every page: the navigation, then the page itself in <Outlet />`, `const Layout: React.FC<{}> = () => {`, `\tconst cn = useCodenotch();`, styled ? `\tconst theme = cn.getTheme() ?? 'light';` : undefined, ``, `\treturn <div${c('min-h-screen bg-white text-gray-900 dark:bg-gray-900 dark:text-gray-100')}>`, `\t\t<nav${c('flex items-center gap-4 border-b border-gray-200 px-6 py-3 dark:border-gray-700')}>`, `\t\t\t<NavLink to="/"${c('hover:underline')}>Home</NavLink>`, `\t\t\t<NavLink to="/about"${c('hover:underline')}>About</NavLink>`, `\t\t\t<NavLink to="/hello/codenotch"${c('hover:underline')}>Hello</NavLink>`, styled ? `\t\t\t<button${c('ml-auto rounded border border-gray-300 px-3 py-1 text-sm dark:border-gray-600')} onClick={() => cn.setTheme(theme === 'dark' ? 'light' : 'dark')}>` : undefined, styled ? `\t\t\t\t{theme === 'dark' ? 'Light theme' : 'Dark theme'}` : undefined, styled ? `\t\t\t</button>` : undefined, `\t\t</nav>`, `\t\t<main${c('p-6')}>`, `\t\t\t<Outlet />`, `\t\t</main>`, `\t</div>;`, `};`, ``, `export default Layout;`, ``);
+    }
+    static createHomePage(styled) {
+        const c = this.classes(styled);
+        return this.lines(`import React from 'react';`, `import { useCodenotch } from '@codenotch/codenotch.react';`, ``, `const HomePage: React.FC<{}> = () => {`, `\tconst cn = useCodenotch();`, ``, `\treturn <div>`, `\t\t<h1${c('text-2xl font-bold')}>My new Codenotch App</h1>`, `\t\t<p${c('mt-2 text-gray-600 dark:text-gray-400')}>The environment the runtime gave this app:</p>`, `\t\t<pre${c('mt-4 overflow-x-auto rounded bg-gray-100 p-4 text-sm dark:bg-gray-800')}>{JSON.stringify(cn.env, null, 4)}</pre>`, `\t</div>;`, `};`, ``, `export default HomePage;`, ``);
+    }
+    static createAboutPage(styled) {
+        const c = this.classes(styled);
+        return this.lines(`import React from 'react';`, `import { Link } from 'react-router';`, ``, `const AboutPage: React.FC<{}> = () => {`, `\treturn <div>`, `\t\t<h1${c('text-2xl font-bold')}>About</h1>`, `\t\t<p${c('mt-2')}>This page is reached through the router, without reloading the app.</p>`, `\t\t<Link to="/"${c('mt-4 inline-block underline')}>Back home</Link>`, `\t</div>;`, `};`, ``, `export default AboutPage;`, ``);
+    }
+    static createHelloPage(styled) {
+        const c = this.classes(styled);
+        return this.lines(`import React from 'react';`, `import { useParams } from 'react-router';`, ``, `// The ':name' segment of the route is read with useParams()`, `const HelloPage: React.FC<{}> = () => {`, `\tconst { name } = useParams<{ name: string }>();`, ``, `\treturn <div>`, `\t\t<h1${c('text-2xl font-bold')}>Hello {name}!</h1>`, `\t\t<p${c('mt-2')}>Change the name in the URL to greet someone else.</p>`, `\t</div>;`, `};`, ``, `export default HelloPage;`, ``);
+    }
+    /**
+     * The stylesheet of the default app: scss on purpose, so variables, nesting and the rest
+     * of the language are ready to use
+     */
+    static createDefaultScss() {
+        return this.lines(`// The stylesheet of the app. Scss is the default here: variables, nesting, functions...`, `$accent: #2563eb;`, `$spacing: 1.5rem;`, ``, `nav {`, `	display: flex;`, `	gap: $spacing;`, `	padding: 0.75rem $spacing;`, `	border-bottom: 1px solid #e5e7eb;`, ``, `	a {`, `		color: inherit;`, `		text-decoration: none;`, ``, `		&:hover {`, `			color: $accent;`, `			text-decoration: underline;`, `		}`, `	}`, `}`, ``, `main {`, `	padding: $spacing;`, ``, `	pre {`, `		overflow-x: auto;`, `		padding: 1rem;`, `		background: #f3f4f6;`, `		border-radius: 0.25rem;`, `	}`, `}`, ``);
+    }
+    /**
+     * The stylesheet of the tailwind flavoured templates: tailwind first, scss for whatever
+     * the utilities do not cover
+     */
+    static createTailwindScss() {
+        return this.lines(`@import "tailwindcss";`, ``, `/* useCodenotch().setTheme('dark') toggles the 'dark' class on <html>: key the dark: variants on it */`, `@custom-variant dark (&:where(.dark, .dark *));`, ``, `// Scss on top of tailwind, for what the utilities do not cover`, `$accent: #2563eb;`, ``, `.accent-link {`, `	color: $accent;`, ``, `	&:hover {`, `		text-decoration: underline;`, `	}`, `}`, ``);
+    }
+    // ------------------------------------------------------------------ tailwind
+    static buildTailwind(context) {
+        const scaffold = this.buildDefault(context, true);
+        this.replaceFile(scaffold, 'package.json', this.toJson(TemplateUtils_1.default.createPackageJson(context.serviceName, {
+            dependencies: { 'react-router': VERSIONS.reactRouter },
+            devDependencies: {
+                'tailwindcss': VERSIONS.tailwind,
+                '@tailwindcss/postcss': VERSIONS.tailwindPostcss,
+                'postcss': VERSIONS.postcss
+            }
+        })));
+        this.replaceFile(scaffold, `apps/${DEFAULT_APP_NAME}.scss`, this.createTailwindScss());
+        scaffold.files.push({
+            path: 'postcss.config.js',
+            // Picked up by the Vite build of 'cn react build', which mirrors the project layout
+            content: this.lines(`module.exports = {`, `    plugins: {`, `        '@tailwindcss/postcss': {}`, `    }`, `};`, ``)
+        });
+        return scaffold;
+    }
+    // ------------------------------------------------------------------ todolist
+    static buildTodolist(context) {
+        const scaffold = this.buildTailwind(context);
+        scaffold.folders.push('queries');
+        // The routed pages of the default app give way to the ones of the todo list
+        scaffold.files = scaffold.files.filter(file => !file.path.startsWith('apps/pages/'));
+        this.replaceFile(scaffold, `apps/${DEFAULT_APP_NAME}.tsx`, this.createTodolistApp());
+        this.replaceFile(scaffold, 'apps/components/Layout.tsx', this.createTodolistLayout(context.languages));
+        this.replaceFile(scaffold, 'readme.md', TemplateUtils_1.default.createReadmeMd(context.projectName, context.serviceName) + this.createTodolistReadme());
+        scaffold.files.push({ path: 'tables/todolist.ts', content: this.createTodoListTable() }, { path: 'tables/todo.ts', content: this.createTodoTable() }, { path: 'processes/todolists.ts', content: this.createTodoListProcesses() }, { path: 'processes/todos.ts', content: this.createTodoProcesses() }, { path: 'queries/all-todolists.cnql', content: this.createAllTodoListsQuery(context.serviceName) }, { path: 'queries/todos-of-list.cnql', content: this.createTodosOfListQuery(context.serviceName) }, { path: 'globals.i18n.csv', content: this.createTodolistI18n(context.languages) }, { path: 'apps/api.ts', content: this.createTodolistApi() }, { path: 'apps/pages/TodoListsPage.tsx', content: this.createTodoListsPage() }, { path: 'apps/pages/TodoListPage.tsx', content: this.createTodoListPage() });
+        scaffold.nextSteps.push(`Search the sources for 'TODO' to see the three points waiting for the runtime API`);
+        return scaffold;
+    }
+    static createTodoListTable() {
+        return this.lines(`import { defineEntity, type InferEntity, p } from '@codenotch/orm';`, ``, `export const TodoList = defineEntity({`, `  name: 'TodoList',`, `  properties: {`, `    id: p.uuid().primary(),`, `    name: p.string().notNull(),`, `    // Deleting a list deletes its todos`, `    todos: p.hasMany('Todo').linkBehaviour('Delete'),`, `  },`, `});`, ``, `export type ITodoList = InferEntity<typeof TodoList>;`, ``);
+    }
+    static createTodoTable() {
+        return this.lines(`import { defineEntity, type InferEntity, p } from '@codenotch/orm';`, ``, `export const Todo = defineEntity({`, `  name: 'Todo',`, `  properties: {`, `    id: p.uuid().primary(),`, `    title: p.string().notNull(),`, `    done: p.boolean().default(false),`, `    list: p.belongsTo('TodoList').notNull(),`, `  },`, `});`, ``, `export type ITodo = InferEntity<typeof Todo>;`, ``);
+    }
+    static createTodoListProcesses() {
+        return this.lines(`import { process, api, Context } from '@codenotch/process'`, `import type { ITodoList } from '../tables/todolist'`, ``, `// TODO: 'ctx.tables.<name>' follows the collections of the generated db-schema.ts ('todolists', 'todos').`, `// Adjust the names here if the runtime exposes the tables differently.`, ``, `export const listTodoLists = process({`, `  id: 'ListTodoLists',`, `  description: 'Every todo list, oldest first',`, `  auth: { scope: 'internal' },`, `  trigger: api.get('/todolists'),`, `  run: async (ctx: Context): Promise<ITodoList[]> => {`, `    return ctx.query<ITodoList>('queries/all-todolists.cnql')`, `  },`, `})`, ``, `export const createTodoList = process({`, `  id: 'CreateTodoList',`, `  description: 'Creates an empty todo list',`, `  auth: { scope: 'internal' },`, `  trigger: api.post('/todolists'),`, `  run: async (ctx: Context, input: { name: string }): Promise<{ id: string }> => {`, `    const id = ctx.uuid()`, `    await ctx.tables.todolists.write(id, { name: input.name })`, `    return { id }`, `  },`, `})`, ``, `export const deleteTodoList = process({`, `  id: 'DeleteTodoList',`, `  description: 'Deletes a todo list and, through the relation, its todos',`, `  auth: { scope: 'internal' },`, `  trigger: api.delete('/todolists/:listId'),`, `  run: async (ctx: Context, input: { listId: string }): Promise<{ deleted: boolean }> => {`, `    await ctx.tables.todolists.delete(input.listId)`, `    return { deleted: true }`, `  },`, `})`, ``);
+    }
+    static createTodoProcesses() {
+        return this.lines(`import { process, api, Context } from '@codenotch/process'`, `import type { ITodo } from '../tables/todo'`, ``, `export const listTodos = process({`, `  id: 'ListTodos',`, `  description: 'The todos of a list',`, `  auth: { scope: 'internal' },`, `  trigger: api.get('/todolists/:listId/todos'),`, `  run: async (ctx: Context, input: { listId: string }): Promise<ITodo[]> => {`, `    return ctx.query<ITodo>('queries/todos-of-list.cnql', { listId: input.listId })`, `  },`, `})`, ``, `export const createTodo = process({`, `  id: 'CreateTodo',`, `  description: 'Adds a todo to a list',`, `  auth: { scope: 'internal' },`, `  trigger: api.post('/todolists/:listId/todos'),`, `  run: async (ctx: Context, input: { listId: string; title: string }): Promise<{ id: string }> => {`, `    const id = ctx.uuid()`, `    await ctx.tables.todos.write(id, { title: input.title, done: false, listId: input.listId })`, `    return { id }`, `  },`, `})`, ``, `export const toggleTodo = process({`, `  id: 'ToggleTodo',`, `  description: 'Marks a todo as done, or as to do again',`, `  auth: { scope: 'internal' },`, `  trigger: api.put('/todos/:todoId/toggle'),`, `  run: async (ctx: Context, input: { todoId: string }): Promise<{ done: boolean }> => {`, `    const todo = await ctx.tables.todos.require(input.todoId)`, `    await ctx.tables.todos.write(todo.id, { done: !todo.done })`, `    return { done: !todo.done }`, `  },`, `})`, ``, `export const deleteTodo = process({`, `  id: 'DeleteTodo',`, `  description: 'Removes a todo',`, `  auth: { scope: 'internal' },`, `  trigger: api.delete('/todos/:todoId'),`, `  run: async (ctx: Context, input: { todoId: string }): Promise<{ deleted: boolean }> => {`, `    await ctx.tables.todos.delete(input.todoId)`, `    return { deleted: true }`, `  },`, `})`, ``);
+    }
+    static createAllTodoListsQuery(serviceName) {
+        return this.lines(`<CNQL xmlns="${serviceName}" PageSize="100" PageIndex="0">`, `    <TodoList Ref="results">`, `        <Id />`, `        <Name />`, `        <CreatedAt />`, `    </TodoList>`, `</CNQL>`, ``);
+    }
+    static createTodosOfListQuery(serviceName) {
+        return this.lines(`<!-- TODO: filter on the 'listId' parameter passed by the process. The filtering syntax of CNQL is not settled yet. -->`, `<CNQL xmlns="${serviceName}" PageSize="100" PageIndex="0">`, `    <Todo Ref="results">`, `        <Id />`, `        <Title />`, `        <Done />`, `        <ListId />`, `        <CreatedAt />`, `    </Todo>`, `</CNQL>`, ``);
+    }
+    /** One column per language of the manifest, filled for the ones the template knows */
+    static createTodolistI18n(languages) {
+        const translations = {
+            appTitle: { en: 'My todo lists', de: 'Meine Aufgabenlisten', fr: 'Mes listes de tâches' },
+            lists: { en: 'Lists', de: 'Listen', fr: 'Listes' },
+            newListPlaceholder: { en: 'Name of the new list', de: 'Name der neuen Liste', fr: 'Nom de la nouvelle liste' },
+            newTodoPlaceholder: { en: 'What has to be done?', de: 'Was ist zu tun?', fr: 'Que faut-il faire ?' },
+            add: { en: 'Add', de: 'Hinzufügen', fr: 'Ajouter' },
+            delete: { en: 'Delete', de: 'Löschen', fr: 'Supprimer' },
+            backToLists: { en: 'Back to the lists', de: 'Zurück zu den Listen', fr: 'Retour aux listes' },
+            noLists: { en: 'No list yet, create the first one.', de: 'Noch keine Liste, erstelle die erste.', fr: 'Aucune liste, créez la première.' },
+            noTodos: { en: 'Nothing to do here.', de: 'Hier gibt es nichts zu tun.', fr: 'Rien à faire ici.' },
+            todoCount: { en: '{0} todo(s), {1} done', de: '{0} Aufgabe(n), {1} erledigt', fr: '{0} tâche(s), {1} terminée(s)' },
+            loading: { en: 'Loading...', de: 'Laden...', fr: 'Chargement...' },
+            error: { en: 'Something went wrong: {0}', de: 'Etwas ist schiefgelaufen: {0}', fr: 'Une erreur est survenue : {0}' }
+        };
+        const quote = (value) => /[",\n]/.test(value) ? `"${value.replaceAll('"', '""')}"` : value;
+        const rows = Object.entries(translations).map(([key, values]) => 
+        // A language the template does not know gets the english text, to be translated
+        [key, ...languages.map(language => quote(values[language] ?? values['en']))].join(','));
+        return [['key', ...languages].join(','), ...rows].join('\n') + '\n';
+    }
+    /**
+     * The calls the pages make, in one place. Typed with the row types of the tables, so the UI
+     * and the processes cannot drift apart silently.
+     */
+    static createTodolistApi() {
+        return this.lines(`import { getCodenotch } from '@codenotch/codenotch.react';`, `import type { ITodoList } from '../tables/todolist';`, `import type { ITodo } from '../tables/todo';`, ``, `// TODO: startProcess() is not implemented yet in @codenotch/codenotch.react 2.0.1 (it throws 'Not implemented.').`, `// The calls below are typed against the processes of ./processes and will work as is once it lands;`, `// until then the pages show the error it raises.`, `async function call<TInput, TOutput>(processId: string, input: TInput): Promise<TOutput> {`, `\tconst result = await getCodenotch().startProcess<string, TInput, TOutput>(processId, input);`, `\tif (result.isError) {`, `\t\tthrow new Error(result.errorMessage);`, `\t}`, `\treturn result.output;`, `}`, ``, `export const listTodoLists = () => call<{}, ITodoList[]>('ListTodoLists', {});`, `export const createTodoList = (name: string) => call<{ name: string }, { id: string }>('CreateTodoList', { name });`, `export const deleteTodoList = (listId: string) => call<{ listId: string }, { deleted: boolean }>('DeleteTodoList', { listId });`, ``, `export const listTodos = (listId: string) => call<{ listId: string }, ITodo[]>('ListTodos', { listId });`, `export const createTodo = (listId: string, title: string) => call<{ listId: string; title: string }, { id: string }>('CreateTodo', { listId, title });`, `export const toggleTodo = (todoId: string) => call<{ todoId: string }, { done: boolean }>('ToggleTodo', { todoId });`, `export const deleteTodo = (todoId: string) => call<{ todoId: string }, { deleted: boolean }>('DeleteTodo', { todoId });`, ``);
+    }
+    static createTodolistApp() {
+        return this.lines(`import React from 'react';`, `import { HashRouter, Route, Routes } from 'react-router';`, `import './${DEFAULT_APP_NAME}.scss';`, `import Layout from './components/Layout';`, `import TodoListsPage from './pages/TodoListsPage';`, `import TodoListPage from './pages/TodoListPage';`, ``, `// HashRouter keeps the routing client side, whatever URL the runtime serves the app from`, `const ${DEFAULT_APP_NAME}: React.FC<{}> = () => {`, `\treturn <HashRouter>`, `\t\t<Routes>`, `\t\t\t<Route element={<Layout />}>`, `\t\t\t\t<Route index element={<TodoListsPage />} />`, `\t\t\t\t<Route path="lists/:listId" element={<TodoListPage />} />`, `\t\t\t</Route>`, `\t\t</Routes>`, `\t</HashRouter>;`, `};`, ``, `export default ${DEFAULT_APP_NAME};`, ``);
+    }
+    static createTodolistLayout(languages) {
+        return this.lines(`import React from 'react';`, `import { Link, Outlet } from 'react-router';`, `import { useCodenotch } from '@codenotch/codenotch.react';`, `import globals from '../../globals.i18n';`, ``, `// Shared frame of every page: title, language and theme switches, then the page itself in <Outlet />`, `const Layout: React.FC<{}> = () => {`, `\tconst cn = useCodenotch();`, `\tconst theme = cn.getTheme() ?? 'light';`, `\tconst language = cn.getLanguage() ?? '${languages[0] ?? 'en'}';`, ``, `\t// The generated translation class follows the language of the runtime`, `\tglobals.setLanguage(language);`, ``, `\treturn <div className="min-h-screen bg-white text-gray-900 dark:bg-gray-900 dark:text-gray-100">`, `\t\t<nav className="flex items-center gap-4 border-b border-gray-200 px-6 py-3 dark:border-gray-700">`, `\t\t\t<Link to="/" className="text-lg font-semibold">{globals.appTitle()}</Link>`, `\t\t\t<div className="ml-auto flex items-center gap-2 text-sm">`, `\t\t\t\t{cn.getLanguages().map(lang =>`, `\t\t\t\t\t<button key={lang} onClick={() => cn.setLanguage(lang)}`, `\t\t\t\t\t\tclassName={'rounded px-2 py-1 ' + (lang === language ? 'bg-gray-200 dark:bg-gray-700' : 'hover:underline')}>`, `\t\t\t\t\t\t{lang.toUpperCase()}`, `\t\t\t\t\t</button>)}`, `\t\t\t\t<button className="rounded border border-gray-300 px-3 py-1 dark:border-gray-600" onClick={() => cn.setTheme(theme === 'dark' ? 'light' : 'dark')}>`, `\t\t\t\t\t{theme === 'dark' ? 'Light' : 'Dark'}`, `\t\t\t\t</button>`, `\t\t\t</div>`, `\t\t</nav>`, `\t\t<main className="mx-auto max-w-2xl p-6">`, `\t\t\t<Outlet />`, `\t\t</main>`, `\t</div>;`, `};`, ``, `export default Layout;`, ``);
+    }
+    static createTodoListsPage() {
+        return this.lines(`import React, { useEffect, useState } from 'react';`, `import { Link } from 'react-router';`, `import type { ITodoList } from '../../tables/todolist';`, `import globals from '../../globals.i18n';`, `import { createTodoList, deleteTodoList, listTodoLists } from '../api';`, ``, `const TodoListsPage: React.FC<{}> = () => {`, `\tconst [lists, setLists] = useState<ITodoList[] | undefined>(undefined);`, `\tconst [name, setName] = useState('');`, `\tconst [error, setError] = useState<string | undefined>(undefined);`, ``, `\tconst refresh = () => listTodoLists().then(setLists).catch(e => setError(String(e)));`, ``, `\tuseEffect(() => { refresh(); }, []);`, ``, `\tconst add = async (event: React.FormEvent) => {`, `\t\tevent.preventDefault();`, `\t\tif (name.trim() === '') {`, `\t\t\treturn;`, `\t\t}`, `\t\ttry {`, `\t\t\tawait createTodoList(name.trim());`, `\t\t\tsetName('');`, `\t\t\tawait refresh();`, `\t\t}`, `\t\tcatch (e) {`, `\t\t\tsetError(String(e));`, `\t\t}`, `\t};`, ``, `\tconst remove = async (listId: string) => {`, `\t\ttry {`, `\t\t\tawait deleteTodoList(listId);`, `\t\t\tawait refresh();`, `\t\t}`, `\t\tcatch (e) {`, `\t\t\tsetError(String(e));`, `\t\t}`, `\t};`, ``, `\treturn <div>`, `\t\t<h1 className="text-2xl font-bold">{globals.lists()}</h1>`, ``, `\t\t<form onSubmit={add} className="mt-4 flex gap-2">`, `\t\t\t<input value={name} onChange={e => setName(e.target.value)} placeholder={globals.newListPlaceholder()}`, `\t\t\t\tclassName="flex-1 rounded border border-gray-300 px-3 py-2 dark:border-gray-600 dark:bg-gray-800" />`, `\t\t\t<button type="submit" className="rounded bg-blue-600 px-4 py-2 text-white hover:bg-blue-700">{globals.add()}</button>`, `\t\t</form>`, ``, `\t\t{error && <p className="mt-4 rounded bg-red-100 p-3 text-red-800 dark:bg-red-900 dark:text-red-200">{globals.error(error)}</p>}`, `\t\t{lists === undefined && !error && <p className="mt-4 text-gray-500">{globals.loading()}</p>}`, `\t\t{lists !== undefined && lists.length === 0 && <p className="mt-4 text-gray-500">{globals.noLists()}</p>}`, ``, `\t\t<ul className="mt-4 divide-y divide-gray-200 dark:divide-gray-700">`, `\t\t\t{lists?.map(list =>`, `\t\t\t\t<li key={list.id} className="flex items-center justify-between py-3">`, `\t\t\t\t\t<Link to={'/lists/' + list.id} className="hover:underline">{list.name}</Link>`, `\t\t\t\t\t<button onClick={() => remove(list.id)} className="text-sm text-red-600 hover:underline">{globals.delete()}</button>`, `\t\t\t\t</li>)}`, `\t\t</ul>`, `\t</div>;`, `};`, ``, `export default TodoListsPage;`, ``);
+    }
+    static createTodoListPage() {
+        return this.lines(`import React, { useEffect, useState } from 'react';`, `import { Link, useParams } from 'react-router';`, `import type { ITodo } from '../../tables/todo';`, `import globals from '../../globals.i18n';`, `import { createTodo, deleteTodo, listTodos, toggleTodo } from '../api';`, ``, `const TodoListPage: React.FC<{}> = () => {`, `\tconst { listId } = useParams<{ listId: string }>();`, `\tconst [todos, setTodos] = useState<ITodo[] | undefined>(undefined);`, `\tconst [title, setTitle] = useState('');`, `\tconst [error, setError] = useState<string | undefined>(undefined);`, ``, `\tconst refresh = () => listTodos(listId!).then(setTodos).catch(e => setError(String(e)));`, ``, `\tuseEffect(() => { refresh(); }, [listId]);`, ``, `\t// Every change goes through a process, then the list is read again: the server is the truth`, `\tconst run = async (action: () => Promise<unknown>) => {`, `\t\ttry {`, `\t\t\tawait action();`, `\t\t\tawait refresh();`, `\t\t}`, `\t\tcatch (e) {`, `\t\t\tsetError(String(e));`, `\t\t}`, `\t};`, ``, `\tconst add = (event: React.FormEvent) => {`, `\t\tevent.preventDefault();`, `\t\tif (title.trim() !== '') {`, `\t\t\trun(() => createTodo(listId!, title.trim())).then(() => setTitle(''));`, `\t\t}`, `\t};`, ``, `\tconst done = todos?.filter(todo => todo.done).length ?? 0;`, ``, `\treturn <div>`, `\t\t<Link to="/" className="text-sm underline">{globals.backToLists()}</Link>`, `\t\t<h1 className="mt-2 text-2xl font-bold">{globals.appTitle()}</h1>`, `\t\t{todos !== undefined && <p className="text-sm text-gray-500">{globals.todoCount(String(todos.length), String(done))}</p>}`, ``, `\t\t<form onSubmit={add} className="mt-4 flex gap-2">`, `\t\t\t<input value={title} onChange={e => setTitle(e.target.value)} placeholder={globals.newTodoPlaceholder()}`, `\t\t\t\tclassName="flex-1 rounded border border-gray-300 px-3 py-2 dark:border-gray-600 dark:bg-gray-800" />`, `\t\t\t<button type="submit" className="rounded bg-blue-600 px-4 py-2 text-white hover:bg-blue-700">{globals.add()}</button>`, `\t\t</form>`, ``, `\t\t{error && <p className="mt-4 rounded bg-red-100 p-3 text-red-800 dark:bg-red-900 dark:text-red-200">{globals.error(error)}</p>}`, `\t\t{todos === undefined && !error && <p className="mt-4 text-gray-500">{globals.loading()}</p>}`, `\t\t{todos !== undefined && todos.length === 0 && <p className="mt-4 text-gray-500">{globals.noTodos()}</p>}`, ``, `\t\t<ul className="mt-4 divide-y divide-gray-200 dark:divide-gray-700">`, `\t\t\t{todos?.map(todo =>`, `\t\t\t\t<li key={todo.id} className="flex items-center gap-3 py-3">`, `\t\t\t\t\t<input type="checkbox" checked={todo.done} onChange={() => run(() => toggleTodo(todo.id))} />`, `\t\t\t\t\t<span className={'flex-1 ' + (todo.done ? 'text-gray-400 line-through' : '')}>{todo.title}</span>`, `\t\t\t\t\t<button onClick={() => run(() => deleteTodo(todo.id))} className="text-sm text-red-600 hover:underline">{globals.delete()}</button>`, `\t\t\t\t</li>)}`, `\t\t</ul>`, `\t</div>;`, `};`, ``, `export default TodoListPage;`, ``);
+    }
+    static createTodolistReadme() {
+        return this.lines(``, `## The todo list template`, ``, `| Path | Role |`, `| --- | --- |`, `| \`tables/todolist.ts\`, \`tables/todo.ts\` | the two tables, a list having many todos |`, `| \`processes/todolists.ts\`, \`processes/todos.ts\` | one process per operation, each exposed as an API endpoint |`, `| \`queries/*.cnql\` | the read queries the processes run |`, `| \`globals.i18n.csv\` | the texts of the app in every language of the manifest |`, `| \`apps/api.ts\` | the typed calls the pages make to the processes |`, `| \`apps/pages/\` | the list of lists, and the todos of one list |`, `| \`db-schema.xml\`, \`db-schema.ts\`, \`globals.i18n.ts\`, \`openapi.json\` | generated from the files above, never edit them |`, ``, `After a change to the tables, the translations or the processes, regenerate the derived files:`, ``, '```sh', `cn generate dbcontext -f .`, `cn generate i18n -f globals.i18n.csv`, `cn generate openapi -f .`, '```', ``, `Three points wait for the runtime API and are marked \`TODO\` in the sources: the client call of a`, `process (\`apps/api.ts\`), the filter of a query (\`queries/todos-of-list.cnql\`) and the names the`, `tables are reached under from a process (\`processes/*.ts\`).`, ``);
+    }
+    // ------------------------------------------------------------------ api
+    /**
+     * A project exposing an API and nothing else: no app, no React, no translations.
+     * The product catalog it manages is small on purpose, every kind of endpoint is there once.
+     */
+    static buildApi(context) {
+        const manifest = ManifestUtils_1.default.createManifest(context.projectName, { serviceName: context.serviceName });
+        manifest.languages = [...context.languages];
+        return {
+            folders: [...TemplateUtils_1.default.PROJECT_FOLDERS.filter(folder => folder !== 'apps'), 'queries'],
+            files: [
+                { path: 'manifest.json', content: ManifestUtils_1.default.serialize(manifest) },
+                { path: 'readme.md', content: TemplateUtils_1.default.createReadmeMd(context.projectName, context.serviceName) + this.createApiReadme() },
+                { path: '.gitignore', content: TemplateUtils_1.default.createGitignore() },
+                { path: 'package.json', content: this.toJson(TemplateUtils_1.default.createPackageJson(context.serviceName, {}, false)) },
+                { path: 'tables/product.ts', content: this.createProductTable() },
+                { path: 'processes/products.ts', content: this.createProductProcesses() },
+                { path: 'processes/maintenance.ts', content: this.createMaintenanceProcesses() },
+                { path: 'queries/all-products.cnql', content: this.createAllProductsQuery(context.serviceName) },
+                { path: 'queries/low-stock.cnql', content: this.createLowStockQuery(context.serviceName) }
+            ],
+            nextSteps: [
+                exports.NPM_INSTALL_STEP,
+                'cn project start',
+                `Search the sources for 'TODO' to see the points waiting for the runtime API`
+            ]
+        };
+    }
+    static createProductTable() {
+        return this.lines(`import { defineEntity, type InferEntity, p } from '@codenotch/orm';`, ``, `export const Product = defineEntity({`, `  name: 'Product',`, `  properties: {`, `    id: p.uuid().primary(),`, `    sku: p.string().notNull().unique(),`, `    name: p.string().notNull(),`, `    price: p.decimal().notNull(),`, `    stock: p.integer().default(0),`, `    active: p.boolean().default(true),`, `  },`, `});`, ``, `export type IProduct = InferEntity<typeof Product>;`, ``);
+    }
+    /** One process per operation of the catalog, each exposed as an endpoint */
+    static createProductProcesses() {
+        return this.lines(`import { process, api, Context } from '@codenotch/process'`, `import type { IProduct } from '../tables/product'`, ``, `// TODO: 'ctx.tables.<name>' follows the collections of the generated db-schema.ts ('products').`, `// Adjust the name here if the runtime exposes the table differently.`, ``, `export const listProducts = process({`, `  id: 'ListProducts',`, `  description: 'The products of the catalog, optionally the active ones only',`, `  auth: { scope: 'public' },`, `  trigger: api.get('/products'),`, `  run: async (ctx: Context, input: { activeOnly?: boolean }): Promise<IProduct[]> => {`, `    return ctx.query<IProduct>('queries/all-products.cnql', { activeOnly: input.activeOnly ?? false })`, `  },`, `})`, ``, `export const getProduct = process({`, `  id: 'GetProduct',`, `  description: 'One product by id, 404 when it does not exist',`, `  auth: { scope: 'public' },`, `  trigger: api.get('/products/:productId'),`, `  run: async (ctx: Context, input: { productId: string }): Promise<IProduct> => {`, `    // require() throws when the id is unknown, which an api process turns into a 404`, `    return ctx.tables.products.require(input.productId)`, `  },`, `})`, ``, `export const createProduct = process({`, `  id: 'CreateProduct',`, `  description: 'Adds a product to the catalog',`, `  auth: { scope: 'internal' },`, `  trigger: api.post('/products'),`, `  run: async (ctx: Context, input: { sku: string; name: string; price: number; stock?: number }): Promise<{ id: string }> => {`, `    const id = ctx.uuid()`, `    await ctx.tables.products.write(id, { sku: input.sku, name: input.name, price: input.price, stock: input.stock ?? 0, active: true })`, `    return { id }`, `  },`, `})`, ``, `export const updateProduct = process({`, `  id: 'UpdateProduct',`, `  description: 'Changes the given fields of a product, the others are left as they are',`, `  auth: { scope: 'internal' },`, `  trigger: api.put('/products/:productId'),`, `  run: async (ctx: Context, input: { productId: string; name?: string; price?: number; stock?: number; active?: boolean }): Promise<{ updated: boolean }> => {`, `    const { productId, ...changes } = input`, `    // Only the fields actually sent are written, an absent one must not erase the current value`, `    const patch = Object.fromEntries(Object.entries(changes).filter(([, value]) => value !== undefined))`, `    await ctx.tables.products.require(productId)`, `    await ctx.tables.products.write(productId, patch)`, `    return { updated: true }`, `  },`, `})`, ``, `export const deleteProduct = process({`, `  id: 'DeleteProduct',`, `  description: 'Removes a product from the catalog',`, `  auth: { scope: 'internal' },`, `  trigger: api.delete('/products/:productId'),`, `  run: async (ctx: Context, input: { productId: string }): Promise<{ deleted: boolean }> => {`, `    await ctx.tables.products.delete(input.productId)`, `    return { deleted: true }`, `  },`, `})`, ``);
+    }
+    /** What an API project runs on its own: a health check and a scheduled report */
+    static createMaintenanceProcesses() {
+        return this.lines(`import { process, api, timer, Context } from '@codenotch/process'`, `import type { IProduct } from '../tables/product'`, ``, `export const health = process({`, `  id: 'Health',`, `  description: 'Tells the monitoring the service is up',`, `  auth: { scope: 'public' },`, `  trigger: api.get('/health'),`, `  run: async (): Promise<{ status: 'ok' }> => ({ status: 'ok' }),`, `})`, ``, `// No endpoint here: the runtime starts this one every morning at 7`, `export const lowStockReport = process({`, `  id: 'LowStockReport',`, `  description: 'Logs the products running out of stock',`, `  auth: { scope: 'system' },`, `  trigger: timer('0 7 * * *'),`, `  run: async (ctx: Context): Promise<{ lowStock: number }> => {`, `    const products = await ctx.query<IProduct>('queries/low-stock.cnql', { threshold: 5 })`, `    for (const product of products) {`, `      ctx.log.info('low stock', { sku: product.sku, stock: product.stock })`, `    }`, `    return { lowStock: products.length }`, `  },`, `})`, ``);
+    }
+    static createAllProductsQuery(serviceName) {
+        return this.lines(`<!-- TODO: filter on 'activeOnly' when it is true. The filtering syntax of CNQL is not settled yet. -->`, `<CNQL xmlns="${serviceName}" PageSize="100" PageIndex="0">`, `    <Product Ref="results">`, `        <Id />`, `        <Sku />`, `        <Name />`, `        <Price />`, `        <Stock />`, `        <Active />`, `    </Product>`, `</CNQL>`, ``);
+    }
+    static createLowStockQuery(serviceName) {
+        return this.lines(`<!-- TODO: keep the products whose Stock is below the 'threshold' parameter. The filtering syntax of CNQL is not settled yet. -->`, `<CNQL xmlns="${serviceName}" PageSize="100" PageIndex="0">`, `    <Product Ref="results">`, `        <Id />`, `        <Sku />`, `        <Stock />`, `    </Product>`, `</CNQL>`, ``);
+    }
+    static createApiReadme() {
+        return this.lines(``, `## The API template`, ``, `This project has no app: it exposes the endpoints of \`openapi.json\` and nothing else, so`, `\`package.json\` carries no React at all.`, ``, `| Path | Role |`, `| --- | --- |`, `| \`tables/product.ts\` | the catalog table |`, `| \`processes/products.ts\` | one process per operation, each exposed as an endpoint |`, `| \`processes/maintenance.ts\` | the health check, and a report the runtime schedules every morning |`, `| \`queries/*.cnql\` | the read queries the processes run |`, `| \`db-schema.xml\`, \`db-schema.ts\`, \`openapi.json\` | generated from the files above, never edit them |`, ``, `After a change to the table or the processes, regenerate the derived files:`, ``, '```sh', `cn generate dbcontext -f .`, `cn generate openapi -f .`, '```', ``, `Two points wait for the runtime API and are marked \`TODO\` in the sources: the filters of the`, `queries (\`queries/*.cnql\`) and the name the table is reached under from a process (\`processes/*.ts\`).`, ``);
+    }
+    // ------------------------------------------------------------------ helpers
+    /** Joins lines, dropping the undefined ones so that optional lines read naturally */
+    static lines(...lines) {
+        return lines.filter((line) => line !== undefined).join('\n');
+    }
+    /** ` className="..."` when the template is styled, nothing otherwise */
+    static classes(styled) {
+        return classNames => styled ? ` className="${classNames}"` : '';
+    }
+    static replaceFile(scaffold, path, content) {
+        const file = scaffold.files.find(candidate => candidate.path === path);
+        if (file === undefined) {
+            throw new Error(`Template file '${path}' not found`);
+        }
+        file.content = content;
+    }
+    static toJson(value) {
+        return JSON.stringify(value, null, 4) + '\n';
+    }
+}
+exports.default = ProjectTemplates;
+//# sourceMappingURL=ProjectTemplates.js.map

package/dist/utils/ProjectTemplates.js.map

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

package/dist/utils/ProjectUtils.d.ts

@@ -1,5 +1,140 @@
-import { IScenarioProjectManifest } from '../models/Codenotch';
 import { CompilationResult } from './ProjectCompilationUtils';
+import { LiteralValue } from './ScriptDeclarationUtils';
+import { IJsonSchema } from './TypeSchemaUtils';
+import { IAppManifest, ICodenotchProjectManifest } from '@codenotch/codenotch.core';
+/** A *.i18n.csv file found in a project */
+export interface IDiscoveredI18n {
+    /** Absolute path of the file */
+    filePath: string;
+    /** Translation keys it declares, in file order. Empty when its header has no 'key' column */
+    keys: string[];
+    /** Languages of its columns, e.g. ['en', 'de'] */
+    languages: string[];
+}
+/** A call applied to the type of a column, e.g. `.default('')` or `.primary()` */
+export interface IColumnModifier {
+    name: string;
+    arguments: LiteralValue[];
+}
+/** A column of a table, read from `fullName: p.string()` */
+export interface ITableColumn {
+    /** Name of the column, e.g. 'fullName' */
+    name: string;
+    /** Type it is built with, e.g. 'string', 'integer', 'text' */
+    type?: string;
+    /** Arguments given to the type itself, e.g. the 255 of p.string(255) */
+    typeArguments: LiteralValue[];
+    /** True when '.primary()' is applied */
+    isPrimary: boolean;
+    /** Value given to '.default(...)' when it is a literal */
+    defaultValue?: LiteralValue;
+    /** Every call applied after the type, in source order */
+    modifiers: IColumnModifier[];
+}
+/** A `defineEntity({ ... })` declaration found in a project */
+export interface IDiscoveredTable {
+    /** Absolute path of the script declaring it */
+    filePath: string;
+    /** Value of its 'name' property, e.g. 'User' */
+    name?: string;
+    /** False when the table has a name that is built at runtime, so it cannot be known from the sources */
+    isNameStatic: boolean;
+    /** Name of the variable it is assigned to, e.g. 'User' */
+    variableName?: string;
+    /** True when that variable is exported */
+    isExported: boolean;
+    /** 1-based line of the declaration, to point at it in a diagnostic */
+    line: number;
+    /** Columns of the table, in source order */
+    columns: ITableColumn[];
+    /** Name of its exported row type, e.g. 'IUser' from `export type IUser = InferEntity<typeof User>` */
+    typeName?: string;
+    /**
+     * Line to paste to use that type, with a path relative to the root of the project, e.g.
+     * "import { IUser } from './tables/user';". Use {@link ProjectUtils.getTableTypeImport}
+     * to get it relative to another file.
+     */
+    importStatement?: string;
+    /** Every property written literally, for whatever is not covered by the fields above */
+    properties: Record<string, LiteralValue>;
+}
+/** A field of a document. Same shape as a table column, since both are declared the same way */
+export type IDocumentField = ITableColumn;
+/** A `defineDocument({ ... })` declaration found in a project */
+export interface IDiscoveredDocument extends Omit<IDiscoveredTable, 'columns'> {
+    /** Fields of the document, in source order */
+    fields: IDocumentField[];
+}
+/** A React app found in a project: a tsx/jsx script and its sibling manifest */
+export interface IDiscoveredApp {
+    /** Absolute path of the '<App>.manifest.json' */
+    manifestPath: string;
+    /** Absolute path of the '<App>.tsx' or '<App>.jsx' */
+    scriptPath: string;
+    /** Syntax of the script */
+    type: 'jsx' | 'tsx';
+    /** Name shared by both files, e.g. 'Dashboard' for 'Dashboard.tsx' */
+    name: string;
+    /** Content of the manifest, empty when it cannot be parsed */
+    manifest: IAppManifest;
+}
+/** How a process is started, read from its `trigger` property */
+export type IProcessTrigger = 
+/** trigger: api.post('/books') */
+{
+    kind: 'api';
+    method: string;
+    route: string;
+}
+/** trigger: timer('0 8 * * *') */
+ | {
+    kind: 'timer';
+    cron: string;
+}
+/** trigger: signal('book.returned') */
+ | {
+    kind: 'signal';
+    ref: string;
+}
+/** trigger: install({ once: true }) */
+ | {
+    kind: 'install';
+    options: Record<string, LiteralValue>;
+}
+/** A trigger that is not one of the known factories, or that is built at runtime */
+ | {
+    kind: 'unknown';
+    callee: string;
+};
+/** A `process({ ... })` declaration found in a project */
+export interface IDiscoveredProcess {
+    /** Absolute path of the script declaring it */
+    filePath: string;
+    /** Value of its 'id', undefined when absent or computed (see isIdStatic) */
+    id?: string;
+    /** False when the process has an id that is built at runtime, so it cannot be known from the sources */
+    isIdStatic: boolean;
+    /** Name of the variable it is assigned to, e.g. 'createBook' */
+    variableName?: string;
+    /** True when that variable is exported, which a process needs to be reachable */
+    isExported: boolean;
+    /** 1-based line of the declaration, to point at it in a diagnostic */
+    line: number;
+    /** Value of 'auth.scope', e.g. 'internal' or 'system' */
+    scope?: string;
+    /** How it is started, undefined when it has no trigger and is only reachable through ctx.call */
+    trigger?: IProcessTrigger;
+    /** True when 'run' declares a second parameter, whether or not it is typed */
+    takesInput: boolean;
+    /** Schema of the second parameter of 'run' (its input), when it carries a type annotation */
+    input?: IJsonSchema;
+    /** Schema of the declared return type of 'run', `Promise<T>` unwrapped, when it carries one */
+    output?: IJsonSchema;
+    /** Literal 'description' of the declaration, when any */
+    description?: string;
+    /** Every property written literally, for whatever is not covered by the fields above */
+    properties: Record<string, LiteralValue>;
+}
 export default abstract class ProjectUtils {
     /**
      * Compile and package the project to prepare it for deployment
@@ -7,9 +142,87 @@ export default abstract class ProjectUtils {
      * Output a zip file that can be deployed to Codenotch
      */
     static packageProject(sourcePath: string, outputPath: string, ignoreErrors?: boolean): Promise<CompilationResult>;
-    static isManifestCompiled(projectPath: string): Promise<boolean>;
     private static getCollectionCount;
-    static getManifest(projectPath: string): Promise<IScenarioProjectManifest>;
+    static getManifest(projectPath: string): Promise<ICodenotchProjectManifest>;
     static getProjectServiceName(projectPath: string): Promise<string>;
-    static inspectProject(projectPath: string): Promise<void>;
+    static inspectProject(projectPath: string): Promise<{
+        manifest: ICodenotchProjectManifest | undefined;
+        processes: IDiscoveredProcess[];
+        tables: IDiscoveredTable[];
+        documents: IDiscoveredDocument[];
+        apps: IDiscoveredApp[];
+        i18ns: IDiscoveredI18n[];
+        pkgJson: {
+            name?: string;
+            version?: string;
+        } | undefined;
+    }>;
+    /** Short human readable form of a process trigger, e.g. 'POST /books' or 'cron 0 8 * * *' */
+    private static describeTrigger;
+    /**
+     * Find all file (recursivly) in a given folder (workspacePath) that contains a table declaration ('defineEntity').
+     */
+    static discoverTableFiles(workspacePath: string): Promise<IDiscoveredTable[]>;
+    /**
+     * Shared by the tables and the documents, which only differ by the factory they are declared with
+     *
+     * @param factoryName 'defineEntity' or 'defineDocument'
+     * @param typeHelperNames helpers building their row type, e.g. ['InferEntity']
+     */
+    private static discoverOrmDeclarations;
+    /**
+     * Line to paste to use the type of a table from another file, e.g.
+     * "import { IUser } from '../tables/user';"
+     *
+     * @param table table to import the type of
+     * @param fromFilePath file the import would be written in
+     */
+    static getTableTypeImport(table: IDiscoveredTable, fromFilePath: string): string | undefined;
+    private static buildTypeImport;
+    /**
+     * Turns the `properties` of a table into columns: `bio: p.text().default('')` gives the
+     * type 'text' and the modifier 'default' with its value.
+     */
+    private static readColumns;
+    /**
+     * Find all file (recursivly) in a given folder (workspacePath) that contains a document declaration ('defineDocument').
+     */
+    static discoverDocumentFiles(workspacePath: string): Promise<IDiscoveredDocument[]>;
+    /**
+     * Line to paste to use the type of a document from another file, e.g.
+     * "import { ISettings } from '../documents/settings';"
+     *
+     * @param document document to import the type of
+     * @param fromFilePath file the import would be written in
+     */
+    static getDocumentTypeImport(document: IDiscoveredDocument, fromFilePath: string): string | undefined;
+    /**
+     * Find all file (recursivly) in a given folder (workspacePath) that contains a table declaration ('process').
+     */
+    static discoverProcessFiles(workspacePath: string): Promise<IDiscoveredProcess[]>;
+    /** Value of `auth: { scope: 'internal' }` when it is written literally */
+    private static readScope;
+    /**
+     * Turns the `trigger` property into something usable, e.g. `api.post('/books')` into
+     * { kind: 'api', method: 'POST', route: '/books' }.
+     * A process without trigger is only reachable through ctx.call, and returns undefined.
+     */
+    private static readTrigger;
+    private static getAllScriptFile;
+    /**
+     * An app is a tsx/jsx file with a sibling *.manifest.json.
+     *
+     * A script without its manifest is not an app and is left out, whereas an app whose manifest
+     * cannot be parsed is still reported, with an empty manifest: it exists on disk, and saying
+     * why its manifest is wrong is the job of the validators.
+     */
+    static discoverAppsFiles(workspacePath: string): Promise<IDiscoveredApp[]>;
+    /**
+     * Find all *.i18n.csv files (recursively) in a given folder (workspacePath), with the keys
+     * they declare and the languages they translate them into.
+     *
+     * A file whose first column is not 'key' is reported with no key and no language rather than
+     * being read wrong: saying why it is malformed is the job of the validators.
+     */
+    static discoverI18nsFiles(workspacePath: string): Promise<IDiscoveredI18n[]>;
 }