vyriy 0.4.1 → 0.4.4

package/README.md

@@ -78,26 +78,26 @@ Prepares every package inside the `dist/` directory for npm publishing:
 
 Registered presets:
 
-| Key       | Description                                   |
-| --------- | --------------------------------------------- |
-| `base`    | Minimal monorepo with config only             |
-| `library` | Workspaces layout with a sample React package |
-| `api`     | Backend API workspace with server/build setup |
+| Key       | Description                                    |
+| --------- | ---------------------------------------------- |
+| `base`    | Minimal monorepo with config only              |
+| `library` | Workspaces layout with a sample React package  |
+| `api`     | Backend API workspace with server/build setup  |
+| `ssr`     | Server-rendered React API with CMS placeholder |
+| `ssg`     | Static site generation workspace               |
+| `spa`     | Single-page application                        |
 
 Presets in progress:
 
-| Key    | Direction                      |
-| ------ | ------------------------------ |
-| `rest` | REST API project               |
-| `gql`  | GraphQL API project            |
-| `ssr`  | Server-side rendering project  |
-| `ssg`  | Static site generation project |
-| `spa`  | Single-page application        |
-| `mfe`  | Micro-frontend project         |
+| Key    | Direction              |
+| ------ | ---------------------- |
+| `rest` | REST API project       |
+| `gql`  | GraphQL API project    |
+| `mfe`  | Micro-frontend project |
 
-Only registered presets are selectable by the wizard today. In-progress presets
-exist as source modules and are expected to become selectable as their generated
-project shape is finalized.
+Registered presets are selectable by the wizard. In-progress presets exist as
+source modules and are expected to become selectable as their generated project
+shape is finalized.
 
 ## Providers
 
@@ -108,6 +108,9 @@ Provider selections add files to the generated project.
 | `base`    | `gitlab`, `github` | none             |
 | `library` | `gitlab`, `github` | none             |
 | `api`     | `gitlab`, `github` | none             |
+| `ssr`     | `gitlab`, `github` | none             |
+| `ssg`     | `gitlab`, `github` | none             |
+| `spa`     | `gitlab`, `github` | none             |
 
 ## API
 

package/commands/create/plan/plan.d.ts

@@ -2,7 +2,7 @@ export declare const plan: (dirName: string, appPath: string) => Promise<{
     name: string;
     description: string;
     target: string;
-    preset: "base" | "api" | "library";
+    preset: "ssr" | "base" | "api" | "library" | "ssg" | "spa";
     scope: string | undefined;
     ci: import("../preset/types.js").CiProvider | undefined;
     deploy: import("../preset/types.js").DeployProvider | undefined;

package/commands/create/preset/api.js

@@ -36,7 +36,7 @@ export const api = {
                 'test:jest': 'jest',
                 postinstall: 'husky',
             },
-            devDependencies: {
+            dependencies: {
                 '@vyriy/typescript-config': `^${packageJson.version}`,
                 typescript: packageJson.peerDependencies.typescript,
                 '@vyriy/prettier-config': `^${packageJson.version}`,

package/commands/create/preset/base.js

@@ -154,7 +154,7 @@ export default {
             ],
         }, null, 2) + '\n',
         'prettier.config.ts': "export { default } from '@vyriy/prettier-config';\n",
-        '.prettierignore': 'node_modules\ndist\ncoverage\nstorybook-static\n',
+        '.prettierignore': 'node_modules\ndist\ncoverage\nstorybook-static\nconsumer\n',
         'eslint.config.ts': "export { default } from '@vyriy/eslint-config';\n",
         'jest.config.ts': "export { default } from '@vyriy/jest-config';\n",
     }),

package/commands/create/preset/index.d.ts

@@ -14,4 +14,19 @@ export declare const presets: {
         description: string;
         preset: import("./types.js").Preset;
     };
+    ssr: {
+        name: string;
+        description: string;
+        preset: import("./types.js").Preset;
+    };
+    ssg: {
+        name: string;
+        description: string;
+        preset: import("./types.js").Preset;
+    };
+    spa: {
+        name: string;
+        description: string;
+        preset: import("./types.js").Preset;
+    };
 };

package/commands/create/preset/index.js

@@ -1,6 +1,9 @@
 import { base } from './base.js';
 import { library } from './library.js';
 import { api } from './api.js';
+import { ssr } from './ssr.js';
+import { ssg } from './ssg.js';
+import { spa } from './spa.js';
 export const presets = {
     base: {
         name: 'Base',
@@ -17,4 +20,19 @@ export const presets = {
         description: 'Preset to generate simple API',
         preset: api,
     },
+    ssr: {
+        name: 'SSR',
+        description: 'Preset to generate simple Server Side Rendering (SSR) API',
+        preset: ssr,
+    },
+    ssg: {
+        name: 'SSG',
+        description: 'Preset for Static Site Generation (SSG)',
+        preset: ssg,
+    },
+    spa: {
+        name: 'SPA',
+        description: 'Preset for Single Page Application (SPA)',
+        preset: spa,
+    },
 };

package/commands/create/preset/library.js

@@ -44,7 +44,7 @@ export const library = {
                     'test:jest': 'jest',
                     postinstall: 'husky',
                 },
-                devDependencies: {
+                dependencies: {
                     '@vyriy/typescript-config': `^${packageJson.version}`,
                     typescript: packageJson.peerDependencies.typescript,
                     '@vyriy/prettier-config': `^${packageJson.version}`,

package/commands/create/preset/spa.js

@@ -1,16 +1,250 @@
+import packageJson from '../../../package.json' with { type: 'json' };
 import { base } from './base.js';
 export const spa = {
     files: (options) => ({
         ...base.files(options),
+        'package.json': JSON.stringify({
+            name: options.name,
+            version: '0.0.0',
+            description: options.description,
+            private: true,
+            type: 'module',
+            agents: './AGENTS.md',
+            packageManager: packageJson.packageManager,
+            engines: {
+                node: packageJson.engines.node,
+            },
+            workspaces: [
+                'packages/*',
+                'workspaces/*',
+            ],
+            scripts: {
+                storybook: 'cross-env STORYBOOK_DISABLE_TELEMETRY=1 storybook dev -p 6006 --disable-telemetry',
+                check: 'run-s lint build test',
+                fix: "run-s 'fix:*'",
+                start: "run-p 'start:*'",
+                lint: "run-s 'lint:*'",
+                build: "run-s 'build:*'",
+                test: "run-s 'test:*'",
+                'fix:prettier': 'prettier . --write',
+                'fix:eslint': 'eslint . --fix',
+                'fix:stylelint': 'stylelint "**/*.{css,scss}" --fix',
+                'start:spa': 'sh workspaces/spa/bin/start.sh',
+                'lint:ts': 'tsc',
+                'lint:prettier': 'prettier . --check',
+                'lint:eslint': 'eslint .',
+                'lint:stylelint': 'stylelint "**/*.{css,scss}"',
+                'build:spa': 'rimraf dist && sh workspaces/spa/bin/build.sh',
+                'build:storybook': 'cross-env STORYBOOK_DISABLE_TELEMETRY=1 storybook build --quiet --disable-telemetry',
+                'test:jest': 'jest',
+                postinstall: 'husky',
+            },
+            dependencies: {
+                '@vyriy/typescript-config': `^${packageJson.version}`,
+                typescript: packageJson.peerDependencies.typescript,
+                '@vyriy/prettier-config': `^${packageJson.version}`,
+                prettier: packageJson.peerDependencies.prettier,
+                '@vyriy/eslint-config': `^${packageJson.version}`,
+                eslint: packageJson.peerDependencies.eslint,
+                '@vyriy/jest-config': `^${packageJson.version}`,
+                jest: packageJson.peerDependencies.jest,
+                '@vyriy/storybook-config': `^${packageJson.version}`,
+                storybook: packageJson.peerDependencies.storybook,
+                '@vyriy/path': `^${packageJson.version}`,
+                vyriy: `^${packageJson.version}`,
+                husky: packageJson.peerDependencies.husky,
+                'npm-run-all2': packageJson.peerDependencies['npm-run-all2'],
+                'cross-env': packageJson.peerDependencies['cross-env'],
+                rimraf: packageJson.peerDependencies.rimraf,
+                '@vyriy/webpack-config': `^${packageJson.version}`,
+                tsx: packageJson.peerDependencies.tsx,
+                webpack: packageJson.peerDependencies.webpack,
+                'webpack-cli': packageJson.peerDependencies['webpack-cli'],
+                react: packageJson.peerDependencies.react,
+                'react-dom': packageJson.peerDependencies['react-dom'],
+                '@types/react': packageJson.peerDependencies['@types/react'],
+                '@types/react-dom': packageJson.peerDependencies['@types/react-dom'],
+                '@vyriy/stylelint-config': `^${packageJson.version}`,
+                '@vyriy/cn': `^${packageJson.version}`,
+                '@vyriy/html': `^${packageJson.version}`,
+                stylelint: packageJson.peerDependencies.stylelint,
+                '@vyriy/browserslist-config': `^${packageJson.version}`,
+            },
+        }, null, 2) + '\n',
+        'stylelint.config.ts': "export { default } from '@vyriy/stylelint-config';\n",
+        'assets.d.ts': "declare module '*.scss';\n",
+        '.browserslistrc': `[development]
+extends @vyriy/browserslist-config
+
+[ssr]
+extends @vyriy/browserslist-config
+
+[production]
+extends @vyriy/browserslist-config
+
+[modern]
+extends @vyriy/browserslist-config
+`,
+        'packages/components/package.json': JSON.stringify({
+            name: '@p/components',
+            private: true,
+            type: 'module',
+        }, null, 2) + '\n',
+        'packages/components/index.ts': "export * from './page/index.js';\n",
+        'packages/components/index.test.tsx': `import { describe, expect, it } from '@jest/globals';
+
+    import { Page } from './index.js';
+    import { Page as PageImplementation } from './page/index.js';
+
+    describe('packages/components/page', () => {
+      it('re-exports the page component', () => {
+        expect(Page).toBe(PageImplementation);
+      });
+    });
+    `,
+        'packages/components/page/index.ts': `export * from './page.js';
+    export type * from './types.js';
+    `,
+        'packages/components/page/index.test.ts': `import { describe, expect, it } from '@jest/globals';
+
+    import { Page } from './index.js';
+    import { Page as PageImplementation } from './page.js';
+
+    describe('packages/components/page', () => {
+      it('re-exports the page component', () => {
+        expect(Page).toBe(PageImplementation);
+      });
+    });
+    `,
+        'packages/components/page/types.ts': `import { FC } from 'react';
+
+    export type PageProps = {
+      content: string;
+    };
+
+    export type PageType = FC<PageProps>;
+    `,
+        'packages/components/page/page.tsx': `import type { PageType } from './types.js';
+
+    export const Page: PageType = ({ content }) => <div className="content">{content}</div>;
+    `,
+        'packages/components/page/styles.scss': `.content {
+      display: block;
+    }
+    `,
+        'packages/components/page/page.test.tsx': `import { renderToStaticMarkup } from 'react-dom/server';
+    import { describe, expect, it } from '@jest/globals';
+
+    import { Page } from './page.js';
+
+    describe('packages/components/page/page', () => {
+      it('renders content inside the page content container', () => {
+        expect(renderToStaticMarkup(<Page content="Page body" />)).toBe('<div class="content">Page body</div>');
+      });
+    });
+    `,
+        'workspaces/spa/bin/build.sh': `#!/usr/bin/env sh
+
+set -e
+
+scriptdir="$PWD/workspaces/spa";
+
+NODE_ENV=production npx webpack --config $scriptdir/webpack.config.ts
+`,
+        'workspaces/spa/bin/start.sh': `#!/usr/bin/env sh
+
+set -e
+
+scriptdir="$PWD/workspaces/spa";
+
+npx webpack serve --open --config $scriptdir/webpack.config.ts
+`,
+        'workspaces/spa/doc.mdx': `import { Meta, Markdown } from '@storybook/addon-docs/blocks';
+    import ReadMe from './README.md?raw';
+
+    <Meta title="Workspaces/SPA" />
+
+    <Markdown>{ReadMe}</Markdown>
+    `,
+        'workspaces/spa/README.md': `# ${options.name} SPA\n\n${options.description}\n`,
+        'workspaces/spa/webpack.config.ts': `import { csr, html } from '@vyriy/webpack-config';
+import { path } from '@vyriy/path';
+
+export default csr(
+  '@w/spa',
+  {
+    path: path('dist', 'spa'),
+    filename: 'index.js',
+  },
+  (config) => {
+    return {
+      ...config,
+      plugins: [
+        ...(config.plugins ?? []),
+        html({
+          title: '<title>SPA</title>',
+          body: '<div id="root"></div>',
+        }),
+      ],
+    };
+  },
+);
+`,
+        'workspaces/spa/package.json': JSON.stringify({
+            name: '@w/spa',
+            type: 'module',
+            private: true,
+        }, null, 2) + '\n',
+        'workspaces/spa/index.tsx': `import { createRoot } from 'react-dom/client';
+
+import { Page } from '@p/components';
+
+import '@p/components/page/styles.scss';
+
+createRoot(document.getElementById('root')!).render(<Page content="Test content" />);
+`,
+        'workspaces/spa/index.test.tsx': `import type { ReactElement, ReactNode } from 'react';
+import { describe, expect, it, jest } from '@jest/globals';
+
+const renderMock = jest.fn<(children: ReactNode) => void>();
+const createRootMock = jest.fn<(container: Element | DocumentFragment) => { render: typeof renderMock }>(() => ({
+  render: renderMock,
+}));
+const PageMock = jest.fn(({ content }: { content: string }) => <div>{content}</div>);
+
+jest.mock('react-dom/client', () => ({
+  createRoot: createRootMock,
+}));
+
+jest.mock('@p/components', () => ({
+  Page: PageMock,
+}));
+
+describe('workspaces/spa/index.tsx', () => {
+  it('mounts the page component into the root element', async () => {
+    document.body.innerHTML = '<div id="root"></div>';
+    const rootElement = document.getElementById('root');
+
+    if (!rootElement) {
+      throw new Error('Expected root element to exist.');
+    }
+
+    await import('./index.js');
+
+    expect(createRootMock).toHaveBeenCalledTimes(1);
+    expect(createRootMock.mock.calls[0]?.[0]).toBe(rootElement);
+    expect(renderMock).toHaveBeenCalledTimes(1);
+
+    const renderedElement = renderMock.mock.calls[0]?.[0] as ReactElement<{ content: string }>;
+
+    expect(renderedElement.type).toBe(PageMock);
+    expect(renderedElement.props.content).toBe('Test content');
+  });
+});
+`,
     }),
     ci: {
-        github: {
-            '.gitlab-ci.yml': 'code',
-        },
-    },
-    deploy: {
-        docker: {
-            Dockerfile: 'code',
-        },
+        ...base.ci,
     },
+    deploy: {},
 };

package/commands/create/preset/ssg.js

@@ -1,16 +1,316 @@
+import packageJson from '../../../package.json' with { type: 'json' };
 import { base } from './base.js';
 export const ssg = {
     files: (options) => ({
         ...base.files(options),
+        'package.json': JSON.stringify({
+            name: options.name,
+            version: '0.0.0',
+            description: options.description,
+            private: true,
+            type: 'module',
+            agents: './AGENTS.md',
+            packageManager: packageJson.packageManager,
+            engines: {
+                node: packageJson.engines.node,
+            },
+            workspaces: [
+                'packages/*',
+                'workspaces/*',
+            ],
+            scripts: {
+                storybook: 'cross-env STORYBOOK_DISABLE_TELEMETRY=1 storybook dev -p 6006 --disable-telemetry',
+                check: 'run-s lint build test',
+                fix: "run-s 'fix:*'",
+                start: "run-p 'start:*'",
+                lint: "run-s 'lint:*'",
+                build: "run-s 'build:*'",
+                test: "run-s 'test:*'",
+                'fix:prettier': 'prettier . --write',
+                'fix:eslint': 'eslint . --fix',
+                'fix:stylelint': 'stylelint "**/*.{css,scss}" --fix',
+                'start:ssg': 'sh workspaces/ssg/bin/start.sh',
+                'lint:ts': 'tsc',
+                'lint:prettier': 'prettier . --check',
+                'lint:eslint': 'eslint .',
+                'lint:stylelint': 'stylelint "**/*.{css,scss}"',
+                'build:ssg': 'rimraf dist && sh workspaces/ssg/bin/build.sh',
+                'build:storybook': 'cross-env STORYBOOK_DISABLE_TELEMETRY=1 storybook build --quiet --disable-telemetry',
+                'test:jest': 'jest',
+                postinstall: 'husky',
+            },
+            dependencies: {
+                '@vyriy/typescript-config': `^${packageJson.version}`,
+                typescript: packageJson.peerDependencies.typescript,
+                '@vyriy/prettier-config': `^${packageJson.version}`,
+                prettier: packageJson.peerDependencies.prettier,
+                '@vyriy/eslint-config': `^${packageJson.version}`,
+                eslint: packageJson.peerDependencies.eslint,
+                '@vyriy/jest-config': `^${packageJson.version}`,
+                jest: packageJson.peerDependencies.jest,
+                '@vyriy/storybook-config': `^${packageJson.version}`,
+                storybook: packageJson.peerDependencies.storybook,
+                '@vyriy/path': `^${packageJson.version}`,
+                vyriy: `^${packageJson.version}`,
+                husky: packageJson.peerDependencies.husky,
+                'npm-run-all2': packageJson.peerDependencies['npm-run-all2'],
+                'cross-env': packageJson.peerDependencies['cross-env'],
+                rimraf: packageJson.peerDependencies.rimraf,
+                '@vyriy/webpack-config': `^${packageJson.version}`,
+                '@vyriy/script': `^${packageJson.version}`,
+                tsx: packageJson.peerDependencies.tsx,
+                webpack: packageJson.peerDependencies.webpack,
+                'webpack-cli': packageJson.peerDependencies['webpack-cli'],
+                react: packageJson.peerDependencies.react,
+                'react-dom': packageJson.peerDependencies['react-dom'],
+                '@types/react': packageJson.peerDependencies['@types/react'],
+                '@types/react-dom': packageJson.peerDependencies['@types/react-dom'],
+                '@vyriy/stylelint-config': `^${packageJson.version}`,
+                '@vyriy/cn': `^${packageJson.version}`,
+                '@vyriy/html': `^${packageJson.version}`,
+                stylelint: packageJson.peerDependencies.stylelint,
+                sass: packageJson.peerDependencies.sass,
+            },
+        }, null, 2) + '\n',
+        'stylelint.config.ts': "export { default } from '@vyriy/stylelint-config';\n",
+        'assets.d.ts': "declare module '*.scss';\n",
+        'packages/components/package.json': JSON.stringify({
+            name: '@p/components',
+            private: true,
+            type: 'module',
+        }, null, 2) + '\n',
+        'packages/components/index.ts': "export * from './page/index.js';\n",
+        'packages/components/index.test.tsx': `import { describe, expect, it } from '@jest/globals';
+
+  import { Page } from './index.js';
+  import { Page as PageImplementation } from './page/index.js';
+
+  describe('packages/components/page', () => {
+    it('re-exports the page component', () => {
+      expect(Page).toBe(PageImplementation);
+    });
+  });
+  `,
+        'packages/components/page/index.ts': `export * from './page.js';
+  export type * from './types.js';
+  `,
+        'packages/components/page/index.test.ts': `import { describe, expect, it } from '@jest/globals';
+
+  import { Page } from './index.js';
+  import { Page as PageImplementation } from './page.js';
+
+  describe('packages/components/page', () => {
+    it('re-exports the page component', () => {
+      expect(Page).toBe(PageImplementation);
+    });
+  });
+  `,
+        'packages/components/page/types.ts': `import { FC } from 'react';
+
+  export type PageProps = {
+    content: string;
+  };
+
+  export type PageType = FC<PageProps>;
+  `,
+        'packages/components/page/page.tsx': `import type { PageType } from './types.js';
+
+  export const Page: PageType = ({ content }) => <div className="content">{content}</div>;
+  `,
+        'packages/components/page/styles.scss': `.content {
+    display: block;
+  }
+  `,
+        'packages/components/page/page.test.tsx': `import { renderToStaticMarkup } from 'react-dom/server';
+  import { describe, expect, it } from '@jest/globals';
+
+  import { Page } from './page.js';
+
+  describe('packages/components/page/page', () => {
+    it('renders content inside the page content container', () => {
+      expect(renderToStaticMarkup(<Page content="Page body" />)).toBe('<div class="content">Page body</div>');
+    });
+  });
+  `,
+        'packages/services/package.json': JSON.stringify({
+            name: '@p/services',
+            private: true,
+            type: 'module',
+        }, null, 2) + '\n',
+        'packages/services/cms/index.ts': `export const cms = {
+    getContent: async () => {
+      // Placeholder for fetching content from a CMS
+      return Promise.resolve({
+        title: 'Sample Content',
+        body: 'This is a sample content fetched from the CMS.',
+      });
+    },
+  };
+  `,
+        'packages/services/cms/index.test.ts': `import { describe, expect, it } from '@jest/globals';
+
+  import { cms } from './index.js';
+
+  describe('packages/services/cms', () => {
+    it('returns content for rendering a page', async () => {
+      await expect(cms.getContent()).resolves.toEqual({
+        title: 'Sample Content',
+        body: 'This is a sample content fetched from the CMS.',
+      });
+    });
+  });
+  `,
+        'workspaces/ssg/bin/build.sh': `#!/usr/bin/env sh
+
+set -e
+
+scriptdir="$PWD/workspaces/ssg";
+distdir="$PWD/dist/ssg";
+
+NODE_ENV=production npx webpack --config $scriptdir/webpack.config.ts
+
+yarn exec sass packages/components/page/styles.scss "$distdir/styles.css" --no-source-map --style=compressed
+cp $scriptdir/package.json "$distdir/package.json"
+npm pkg delete "type" --prefix "$distdir"
+npm pkg delete "private" --prefix "$distdir"
+`,
+        'workspaces/ssg/bin/start.sh': `#!/usr/bin/env sh
+
+set -e
+
+scriptdir="$PWD/workspaces/ssg";
+distdir="$PWD/dist/ssg";
+
+mkdir -p "$distdir"
+yarn exec sass packages/components/page/styles.scss "$distdir/styles.css" --no-source-map
+
+PROJECT_CWD="$distdir" NODE_ENV=production LOG_LEVEL=info "$PWD/node_modules/.bin/tsx" $scriptdir/index.tsx
+`,
+        'workspaces/ssg/doc.mdx': `import { Meta, Markdown } from '@storybook/addon-docs/blocks';
+  import ReadMe from './README.md?raw';
+
+  <Meta title="Workspaces/SSG" />
+
+  <Markdown>{ReadMe}</Markdown>
+  `,
+        'workspaces/ssg/README.md': `# ${options.name} SSG\n\n${options.description}\n`,
+        'workspaces/ssg/webpack.config.ts': `import { path } from '@vyriy/path';
+  import { ssr, external } from '@vyriy/webpack-config';
+
+  export default ssr(
+    '@w/ssg',
+    {
+      path: path('dist', 'ssg'),
+      filename: 'index.js',
+      library: { type: 'commonjs2' },
+    },
+    (config) => ({
+      ...config,
+      externals: [external({ allowlist: [/^@p/, /^@w/, /^@vyriy/] })],
+    }),
+  );
+  `,
+        'workspaces/ssg/package.json': JSON.stringify({
+            name: '@w/ssg',
+            type: 'module',
+            private: true,
+        }, null, 2) + '\n',
+        'workspaces/ssg/index.tsx': `import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { renderToString } from 'react-dom/server';
+
+import { script } from '@vyriy/script';
+import { html, minify } from '@vyriy/html';
+import { path } from '@vyriy/path';
+
+import { cms } from '@p/services/cms';
+import { Page } from '@p/components';
+
+const dashboardStyles = readFileSync(path('styles.css'), 'utf8');
+const staticPath = path('static');
+
+void script(async () => {
+  const content = await cms.getContent();
+
+  mkdirSync(staticPath, { recursive: true });
+
+  writeFileSync(
+    path(staticPath, 'index.html'),
+    minify(
+      html({
+        htmlAttributes: 'lang="en"',
+        title: \`<title>\${content.title}</title>\`,
+        meta: '<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />',
+        style: \`<style>\${dashboardStyles.trim()}</style>\`,
+        body: renderToString(<Page content={content.body} />),
+      }),
+    ),
+  );
+});
+`,
+        'workspaces/ssg/index.test.tsx': `import { describe, expect, it, jest } from '@jest/globals';
+
+const getContentMock = jest.fn(() =>
+  Promise.resolve({
+    title: 'Sample Content',
+    body: 'This is a sample content fetched from the CMS.',
+  }),
+);
+let scriptPromise: Promise<void> | undefined;
+const scriptMock = jest.fn((handler: () => Promise<void>) => {
+  scriptPromise = handler();
+
+  return scriptPromise;
+});
+const nodeFs = jest.requireActual<typeof import('node:fs')>('node:fs');
+const mkdirSyncMock = jest.fn();
+const readFileSyncMock = jest.fn<(path: string | URL, encoding: 'utf8') => string>(
+  () => '.content { display: block; }',
+);
+const writeFileSyncMock = jest.fn();
+
+jest.mock('node:fs', () => ({
+  ...nodeFs,
+  mkdirSync: mkdirSyncMock,
+  readFileSync: readFileSyncMock,
+  writeFileSync: writeFileSyncMock,
+}));
+
+jest.mock('@vyriy/script', () => ({
+  script: scriptMock,
+}));
+
+jest.mock('@p/services/cms', () => ({
+  cms: {
+    getContent: getContentMock,
+  },
+}));
+
+describe('workspaces/ssg/index.tsx', () => {
+  it('generates a static index HTML file', async () => {
+    await import('./index.js');
+    await scriptPromise;
+
+    expect(scriptMock).toHaveBeenCalledTimes(1);
+    expect(readFileSyncMock).toHaveBeenCalledWith(expect.stringContaining('styles.css'), 'utf8');
+    expect(getContentMock).toHaveBeenCalledTimes(1);
+    expect(mkdirSyncMock).toHaveBeenCalledWith(expect.stringContaining('static'), {
+      recursive: true,
+    });
+    expect(writeFileSyncMock).toHaveBeenCalledWith(
+      expect.stringContaining('static/index.html'),
+      expect.stringContaining('<title>Sample Content</title>'),
+    );
+
+    const generatedHtml = writeFileSyncMock.mock.calls[0]?.[1] as string;
+
+    expect(generatedHtml).toContain('<style>.content { display: block; }</style>');
+    expect(generatedHtml).toContain('This is a sample content fetched from the CMS.');
+  });
+});
+`,
     }),
     ci: {
-        github: {
-            '.gitlab-ci.yml': 'code',
-        },
-    },
-    deploy: {
-        docker: {
-            Dockerfile: 'code',
-        },
+        ...base.ci,
     },
+    deploy: {},
 };

package/commands/create/preset/ssr.js

@@ -1,16 +1,325 @@
+import packageJson from '../../../package.json' with { type: 'json' };
 import { base } from './base.js';
 export const ssr = {
     files: (options) => ({
         ...base.files(options),
+        'package.json': JSON.stringify({
+            name: options.name,
+            version: '0.0.0',
+            description: options.description,
+            private: true,
+            type: 'module',
+            agents: './AGENTS.md',
+            packageManager: packageJson.packageManager,
+            engines: {
+                node: packageJson.engines.node,
+            },
+            workspaces: [
+                'packages/*',
+                'workspaces/*',
+            ],
+            scripts: {
+                storybook: 'cross-env STORYBOOK_DISABLE_TELEMETRY=1 storybook dev -p 6006 --disable-telemetry',
+                check: 'run-s lint build test',
+                fix: "run-s 'fix:*'",
+                start: "run-p 'start:*'",
+                lint: "run-s 'lint:*'",
+                build: "run-s 'build:*'",
+                test: "run-s 'test:*'",
+                'fix:prettier': 'prettier . --write',
+                'fix:eslint': 'eslint . --fix',
+                'fix:stylelint': 'stylelint "**/*.{css,scss}" --fix',
+                'start:api': 'sh workspaces/api/bin/start.sh',
+                'lint:ts': 'tsc',
+                'lint:prettier': 'prettier . --check',
+                'lint:eslint': 'eslint .',
+                'lint:stylelint': 'stylelint "**/*.{css,scss}"',
+                'build:api': 'rimraf dist && sh workspaces/api/bin/build.sh',
+                'build:storybook': 'cross-env STORYBOOK_DISABLE_TELEMETRY=1 storybook build --quiet --disable-telemetry',
+                'test:jest': 'jest',
+                postinstall: 'husky',
+            },
+            dependencies: {
+                '@vyriy/typescript-config': `^${packageJson.version}`,
+                typescript: packageJson.peerDependencies.typescript,
+                '@vyriy/prettier-config': `^${packageJson.version}`,
+                prettier: packageJson.peerDependencies.prettier,
+                '@vyriy/eslint-config': `^${packageJson.version}`,
+                eslint: packageJson.peerDependencies.eslint,
+                '@vyriy/jest-config': `^${packageJson.version}`,
+                jest: packageJson.peerDependencies.jest,
+                '@vyriy/storybook-config': `^${packageJson.version}`,
+                storybook: packageJson.peerDependencies.storybook,
+                '@vyriy/path': `^${packageJson.version}`,
+                vyriy: `^${packageJson.version}`,
+                husky: packageJson.peerDependencies.husky,
+                'npm-run-all2': packageJson.peerDependencies['npm-run-all2'],
+                'cross-env': packageJson.peerDependencies['cross-env'],
+                rimraf: packageJson.peerDependencies.rimraf,
+                '@vyriy/webpack-config': `^${packageJson.version}`,
+                '@vyriy/handler': `^${packageJson.version}`,
+                '@vyriy/server': `^${packageJson.version}`,
+                tsx: packageJson.peerDependencies.tsx,
+                webpack: packageJson.peerDependencies.webpack,
+                'webpack-cli': packageJson.peerDependencies['webpack-cli'],
+                react: packageJson.peerDependencies.react,
+                'react-dom': packageJson.peerDependencies['react-dom'],
+                '@types/react': packageJson.peerDependencies['@types/react'],
+                '@types/react-dom': packageJson.peerDependencies['@types/react-dom'],
+                '@vyriy/stylelint-config': `^${packageJson.version}`,
+                '@vyriy/cn': `^${packageJson.version}`,
+                '@vyriy/html': `^${packageJson.version}`,
+                stylelint: packageJson.peerDependencies.stylelint,
+                sass: packageJson.peerDependencies.sass,
+            },
+        }, null, 2) + '\n',
+        'stylelint.config.ts': "export { default } from '@vyriy/stylelint-config';\n",
+        'assets.d.ts': "declare module '*.scss';\n",
+        'packages/components/package.json': JSON.stringify({
+            name: '@p/components',
+            private: true,
+            type: 'module',
+        }, null, 2) + '\n',
+        'packages/components/index.ts': "export * from './page/index.js';\n",
+        'packages/components/index.test.tsx': `import { describe, expect, it } from '@jest/globals';
+
+import { Page } from './index.js';
+import { Page as PageImplementation } from './page/index.js';
+
+describe('packages/components/page', () => {
+  it('re-exports the page component', () => {
+    expect(Page).toBe(PageImplementation);
+  });
+});
+`,
+        'packages/components/page/index.ts': `export * from './page.js';
+export type * from './types.js';
+`,
+        'packages/components/page/index.test.ts': `import { describe, expect, it } from '@jest/globals';
+
+import { Page } from './index.js';
+import { Page as PageImplementation } from './page.js';
+
+describe('packages/components/page', () => {
+  it('re-exports the page component', () => {
+    expect(Page).toBe(PageImplementation);
+  });
+});
+`,
+        'packages/components/page/types.ts': `import { FC } from 'react';
+
+export type PageProps = {
+  content: string;
+};
+
+export type PageType = FC<PageProps>;
+`,
+        'packages/components/page/page.tsx': `import type { PageType } from './types.js';
+
+export const Page: PageType = ({ content }) => <div className="content">{content}</div>;
+`,
+        'packages/components/page/styles.scss': `.content {
+  display: block;
+}
+`,
+        'packages/components/page/page.test.tsx': `import { renderToStaticMarkup } from 'react-dom/server';
+import { describe, expect, it } from '@jest/globals';
+
+import { Page } from './page.js';
+
+describe('packages/components/page/page', () => {
+  it('renders content inside the page content container', () => {
+    expect(renderToStaticMarkup(<Page content="Page body" />)).toBe('<div class="content">Page body</div>');
+  });
+});
+`,
+        'packages/services/package.json': JSON.stringify({
+            name: '@p/services',
+            private: true,
+            type: 'module',
+        }, null, 2) + '\n',
+        'packages/services/cms/index.ts': `export const cms = {
+  getContent: async () => {
+    // Placeholder for fetching content from a CMS
+    return Promise.resolve({
+      title: 'Sample Content',
+      body: 'This is a sample content fetched from the CMS.',
+    });
+  },
+};
+`,
+        'packages/services/cms/index.test.ts': `import { describe, expect, it } from '@jest/globals';
+
+import { cms } from './index.js';
+
+describe('packages/services/cms', () => {
+  it('returns content for rendering a page', async () => {
+    await expect(cms.getContent()).resolves.toEqual({
+      title: 'Sample Content',
+      body: 'This is a sample content fetched from the CMS.',
+    });
+  });
+});
+`,
+        'workspaces/api/bin/build.sh': `#!/usr/bin/env sh
+
+set -e
+
+scriptdir="$PWD/workspaces/api";
+distdir="$PWD/dist/api";
+
+NODE_ENV=production npx webpack --config $scriptdir/webpack.config.ts
+
+yarn exec sass packages/components/page/styles.scss "$distdir/styles.css" --no-source-map --style=compressed
+cp $scriptdir/package.json "$distdir/package.json"
+npm pkg delete "type" --prefix "$distdir"
+npm pkg delete "private" --prefix "$distdir"
+`,
+        'workspaces/api/bin/start.sh': `#!/usr/bin/env sh
+
+set -e
+
+scriptdir="$PWD/workspaces/api";
+distdir="$PWD/dist/api";
+
+mkdir -p "$distdir"
+yarn exec sass packages/components/page/styles.scss "$distdir/styles.css" --no-source-map
+
+PROJECT_CWD="$distdir" NODE_ENV=production LOG_LEVEL=info "$PWD/node_modules/.bin/tsx" $scriptdir/index.tsx
+`,
+        'workspaces/api/doc.mdx': `import { Meta, Markdown } from '@storybook/addon-docs/blocks';
+import ReadMe from './README.md?raw';
+
+<Meta title="Workspaces/API" />
+
+<Markdown>{ReadMe}</Markdown>
+`,
+        'workspaces/api/README.md': `# ${options.name} API\n\n${options.description}\n`,
+        'workspaces/api/webpack.config.ts': `import { path } from '@vyriy/path';
+import { ssr, external } from '@vyriy/webpack-config';
+
+export default ssr(
+  '@w/api',
+  {
+    path: path('dist', 'api'),
+    filename: 'index.js',
+    library: { type: 'commonjs2' },
+  },
+  (config) => ({
+    ...config,
+    externals: [external({ allowlist: [/^@p/, /^@w/, /^@vyriy/] })],
+  }),
+);
+`,
+        'workspaces/api/package.json': JSON.stringify({
+            name: '@w/api',
+            type: 'module',
+            private: true,
+        }, null, 2) + '\n',
+        'workspaces/api/index.tsx': `import { readFileSync } from 'node:fs';
+import { renderToString } from 'react-dom/server';
+
+import { server } from '@vyriy/server';
+import { api } from '@vyriy/handler';
+import { html, minify } from '@vyriy/html';
+import { path } from '@vyriy/path';
+
+import { cms } from '@p/services/cms';
+import { Page } from '@p/components';
+
+const dashboardStyles = readFileSync(path('styles.css'), 'utf8');
+
+server(
+  api(async () => {
+    const content = await cms.getContent();
+
+    return {
+      statusCode: 200,
+      headers: {
+        'content-type': 'text/html; charset=utf-8',
+      },
+      body: minify(
+        html({
+          htmlAttributes: 'lang="en"',
+          title: \`<title>\${content.title}</title>\`,
+          meta: '<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />',
+          style: \`<style>\${dashboardStyles.trim()}</style>\`,
+          body: renderToString(<Page content={content.body} />),
+        }),
+      ),
+    };
+  }),
+);
+`,
+        'workspaces/api/index.test.tsx': `import { describe, expect, it, jest } from '@jest/globals';
+
+const apiMock = jest.fn((handler) => ({
+  handler,
+}));
+const getContentMock = jest.fn(() =>
+  Promise.resolve({
+    title: 'Sample Content',
+    body: 'This is a sample content fetched from the CMS.',
+  }),
+);
+const nodeFs = jest.requireActual<typeof import('node:fs')>('node:fs');
+const readFileSyncMock = jest.fn<(path: string | URL, encoding: 'utf8') => string>(
+  () => '.content { display: block; }',
+);
+const serverMock = jest.fn();
+
+jest.mock('node:fs', () => ({
+  ...nodeFs,
+  readFileSync: readFileSyncMock,
+}));
+
+jest.mock('@vyriy/handler', () => ({
+  api: apiMock,
+}));
+
+jest.mock('@vyriy/server', () => ({
+  server: serverMock,
+}));
+
+jest.mock('@p/services/cms', () => ({
+  cms: {
+    getContent: getContentMock,
+  },
+}));
+
+describe('workspaces/api/index.tsx', () => {
+  it('starts the server with a handler that returns rendered page HTML', async () => {
+    await import('./index.js');
+
+    expect(apiMock).toHaveBeenCalledTimes(1);
+    expect(serverMock).toHaveBeenCalledTimes(1);
+    expect(serverMock).toHaveBeenCalledWith(apiMock.mock.results[0]?.value);
+
+    const handler = apiMock.mock.calls[0]?.[0] as () => Promise<{
+      statusCode: number;
+      headers: Record<string, string>;
+      body: string;
+    }>;
+
+    const response = await handler();
+
+    expect(response).toEqual({
+      statusCode: 200,
+      headers: {
+        'content-type': 'text/html; charset=utf-8',
+      },
+      body: expect.stringContaining('<title>Sample Content</title>'),
+    });
+    expect(response.body).toContain('<style>.content { display: block; }</style>');
+    expect(response.body).toContain('This is a sample content fetched from the CMS.');
+    expect(readFileSyncMock).toHaveBeenCalledWith(expect.stringContaining('styles.css'), 'utf8');
+    expect(getContentMock).toHaveBeenCalledTimes(1);
+  });
+});
+`,
     }),
     ci: {
-        github: {
-            '.gitlab-ci.yml': 'code',
-        },
-    },
-    deploy: {
-        docker: {
-            Dockerfile: 'code',
-        },
+        ...base.ci,
     },
+    deploy: {},
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vyriy",
-  "version": "0.4.1",
+  "version": "0.4.4",
   "description": "Interactive project master for calm cloud-ready applications.",
   "type": "module",
   "bin": "./bin/vyriy.js",
@@ -20,11 +20,12 @@
     "react": "^19.2.6",
     "react-dom": "^19.2.6",
     "rimraf": "^6.1.3",
+    "sass": "^1.100.0",
     "storybook": "^10.4.1",
     "stylelint": "^17.12.0",
     "tsx": "^4.22.3",
     "typescript": "^6.0.3",
-    "webpack": "^5.107.1",
+    "webpack": "^5.107.2",
     "webpack-cli": "^7.0.2"
   },
   "peerDependenciesMeta": {
@@ -64,6 +65,9 @@
     "rimraf": {
       "optional": true
     },
+    "sass": {
+      "optional": true
+    },
     "storybook": {
       "optional": true
     },