create-sovecom-theme 1.0.0-rc.1

package/dist/cli.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+export interface CliIo {
+    log: (message: string) => void;
+    err: (message: string) => void;
+    /** Base directory for a relative/omitted `--dir`. Defaults to `process.cwd()`. */
+    cwd?: string;
+}
+/**
+ * Parse argv (after `node script.js`) and scaffold. Returns a process exit code: 0 on success,
+ * 1 on a usage/validation/IO error. Never calls process.exit itself.
+ */
+export declare function runCli(argv: readonly string[], io: CliIo): number;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAoBA,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,MAAM,CAsDjE"}

package/dist/cli.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * the non-interactive CLI entrypoint.
+ *
+ *   create-sovecom-theme <theme-name> [--dir <path>]
+ *
+ * Built on Node built-ins ONLY: `node:util` parseArgs for flags. No commander/yargs/prompts/
+ * inquirer; no interactive prompts. `runCli` is pure (returns an exit code, takes injectable I/O)
+ * so it is unit-testable; the bottom-of-file bootstrap wires real argv + process.exit.
+ *
+ * The bin has ZERO `@sovecom/theme-sdk` runtime import — the only SDK rule it needs (the theme-name
+ * slug) is carried locally in `theme-name.ts` and drift-guarded by a conformance test. This is the
+ * Decision-052 lesson applied from the start: the SDK is source-first, so the emitted bin must not
+ * depend on it at runtime.
+ */
+import { parseArgs } from 'node:util';
+import { scaffoldTheme, InvalidThemeNameError } from './scaffold.js';
+const USAGE = 'usage: create-sovecom-theme <theme-name> [--dir <path>]';
+/**
+ * Parse argv (after `node script.js`) and scaffold. Returns a process exit code: 0 on success,
+ * 1 on a usage/validation/IO error. Never calls process.exit itself.
+ */
+export function runCli(argv, io) {
+    const cwd = io.cwd ?? process.cwd();
+    let positionals;
+    let values;
+    try {
+        const parsed = parseArgs({
+            args: argv,
+            allowPositionals: true,
+            options: {
+                dir: { type: 'string' },
+                help: { type: 'boolean', short: 'h' },
+            },
+        });
+        positionals = parsed.positionals;
+        values = parsed.values;
+    }
+    catch (error) {
+        io.err(`${error.message}\n${USAGE}`);
+        return 1;
+    }
+    if (values.help) {
+        io.log(USAGE);
+        return 0;
+    }
+    if (positionals.length === 0) {
+        io.err(`error: missing required <theme-name>\n${USAGE}`);
+        return 1;
+    }
+    if (positionals.length > 1) {
+        io.err(`error: unexpected extra arguments: ${positionals.slice(1).join(' ')}\n${USAGE}`);
+        return 1;
+    }
+    const themeName = positionals[0];
+    const targetDir = values.dir ?? cwd;
+    try {
+        const outDir = scaffoldTheme({ themeName, targetDir });
+        io.log(`Created SovEcom theme starter at ${outDir}`);
+        io.log('Next steps:');
+        io.log(`  cd ${themeName}`);
+        io.log('  pnpm install');
+        io.log('  pnpm typecheck');
+        return 0;
+    }
+    catch (error) {
+        if (error instanceof InvalidThemeNameError) {
+            io.err(`error: ${error.message}`);
+            return 1;
+        }
+        io.err(`error: ${error.message}`);
+        return 1;
+    }
+}
+/* istanbul ignore next — the real-process bootstrap is exercised by the end-to-end CLI run. */
+if (import.meta.url === `file://${process.argv[1]}`) {
+    const code = runCli(process.argv.slice(2), {
+        // eslint-disable-next-line no-console
+        log: (m) => console.log(m),
+        // eslint-disable-next-line no-console
+        err: (m) => console.error(m),
+    });
+    process.exit(code);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Public surface of the `create-sovecom-theme` scaffolder for programmatic consumers.
+ * The CLI bin lives in `cli.ts`.
+ */
+export { scaffoldTheme, assertValidThemeName, InvalidThemeNameError } from './scaffold.js';
+export type { ScaffoldOptions } from './scaffold.js';
+export { runCli } from './cli.js';
+export type { CliIo } from './cli.js';
+export { THEME_NAME_RE } from './theme-name.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3F,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * Public surface of the `create-sovecom-theme` scaffolder for programmatic consumers.
+ * The CLI bin lives in `cli.ts`.
+ */
+export { scaffoldTheme, assertValidThemeName, InvalidThemeNameError } from './scaffold.js';
+export { runCli } from './cli.js';
+export { THEME_NAME_RE } from './theme-name.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3F,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/scaffold.d.ts

@@ -0,0 +1,19 @@
+/** Thrown when the requested theme name is not a valid lowercase slug. */
+export declare class InvalidThemeNameError extends Error {
+    constructor(name: string);
+}
+export interface ScaffoldOptions {
+    /** The theme slug — also the package name and manifest `name`. */
+    readonly themeName: string;
+    /** Directory the new `<themeName>/` folder is created INSIDE. */
+    readonly targetDir: string;
+}
+/** Validate the theme name with the slug regex (a drift-guarded local copy of the SDK's rule). */
+export declare function assertValidThemeName(name: string): void;
+/**
+ * Scaffold a theme starter into `<targetDir>/<themeName>/`. Returns the absolute path of the
+ * created theme directory. Throws {@link InvalidThemeNameError} on a bad name and a plain
+ * `Error` if the destination already exists and is non-empty (never clobber an author's work).
+ */
+export declare function scaffoldTheme(opts: ScaffoldOptions): string;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AA0BA,0EAA0E;AAC1E,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,IAAI,EAAE,MAAM;CAOzB;AAED,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,kGAAkG;AAClG,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIvD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAW3D"}

package/dist/scaffold.js

@@ -0,0 +1,73 @@
+/**
+ * the theme-starter scaffolder.
+ *
+ * Pure file emission: validate the requested theme name against the theme-name slug rule
+ * (`THEME_NAME_RE`), then copy the in-package `templates/` tree into the target, substituting
+ * the theme name. No interactive prompts, no network, no code execution. ZERO runtime
+ * dependencies — only `./theme-name.js` (a drift-guarded local copy of the SDK's rule, so the
+ * built bin runs under plain `node` without loading the SDK's source-first entry; see
+ * `theme-name.ts`) and Node built-ins.
+ *
+ * Emits a minimal MIT skeleton without React/Next/tailwind/app files. The full Next.js theme
+ * starter is planned for a future release when the render runtime is ready.
+ */
+import { readdirSync, readFileSync, mkdirSync, writeFileSync, existsSync, statSync } from 'node:fs';
+import { join, resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { THEME_NAME_RE } from './theme-name.js';
+/** Placeholder token substituted with the theme slug throughout the template tree. */
+const NAME_PLACEHOLDER = '__THEME_NAME__';
+/** Templates are stored with a `.tmpl` suffix so they are not compiled/linted as package source. */
+const TEMPLATE_SUFFIX = '.tmpl';
+const templatesDir = resolve(fileURLToPath(new URL('.', import.meta.url)), '..', 'templates');
+/** Thrown when the requested theme name is not a valid lowercase slug. */
+export class InvalidThemeNameError extends Error {
+    constructor(name) {
+        super(`invalid theme name "${name}": must be a lowercase slug matching ${THEME_NAME_RE.source} ` +
+            `(e.g. "aurora", "minimal-shop")`);
+        this.name = 'InvalidThemeNameError';
+    }
+}
+/** Validate the theme name with the slug regex (a drift-guarded local copy of the SDK's rule). */
+export function assertValidThemeName(name) {
+    if (typeof name !== 'string' || !THEME_NAME_RE.test(name)) {
+        throw new InvalidThemeNameError(String(name));
+    }
+}
+/**
+ * Scaffold a theme starter into `<targetDir>/<themeName>/`. Returns the absolute path of the
+ * created theme directory. Throws {@link InvalidThemeNameError} on a bad name and a plain
+ * `Error` if the destination already exists and is non-empty (never clobber an author's work).
+ */
+export function scaffoldTheme(opts) {
+    assertValidThemeName(opts.themeName);
+    const outDir = resolve(opts.targetDir, opts.themeName);
+    if (existsSync(outDir) && statSync(outDir).isDirectory() && readdirSync(outDir).length > 0) {
+        throw new Error(`destination "${outDir}" already exists and is not empty; aborting`);
+    }
+    mkdirSync(outDir, { recursive: true });
+    copyTemplateTree(templatesDir, outDir, opts.themeName);
+    return outDir;
+}
+/** Recursively copy `from` → `to`, dropping the `.tmpl` suffix and substituting the theme name. */
+function copyTemplateTree(from, to, themeName) {
+    for (const entry of readdirSync(from, { withFileTypes: true })) {
+        const src = join(from, entry.name);
+        if (entry.isDirectory()) {
+            const destSub = join(to, entry.name);
+            mkdirSync(destSub, { recursive: true });
+            copyTemplateTree(src, destSub, themeName);
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        const destName = entry.name.endsWith(TEMPLATE_SUFFIX)
+            ? entry.name.slice(0, -TEMPLATE_SUFFIX.length)
+            : entry.name;
+        const dest = join(to, destName);
+        const content = readFileSync(src, 'utf8').split(NAME_PLACEHOLDER).join(themeName);
+        mkdirSync(dirname(dest), { recursive: true });
+        writeFileSync(dest, content, 'utf8');
+    }
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

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

package/dist/theme-name.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The theme-name slug rule, declared locally.
+ *
+ * The single source of truth for this rule is `THEME_NAME_RE` in `@sovecom/theme-sdk`. The
+ * compiled `dist/cli.js` binary must run under plain `node`, but the SDK ships source-first
+ * so a runtime import from the binary cannot load it without a bundler. This drift-guarded local
+ * copy is kept honest by a conformance test (`test/theme-name.conformance.test.ts`) that asserts
+ * this regex's `.source` and `.flags` equal the SDK's.
+ *
+ * MUST stay byte-for-byte equal to `@sovecom/theme-sdk`'s `THEME_NAME_RE`.
+ */
+export declare const THEME_NAME_RE: RegExp;
+//# sourceMappingURL=theme-name.d.ts.map

package/dist/theme-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-name.d.ts","sourceRoot":"","sources":["../src/theme-name.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,QAAsB,CAAC"}

package/dist/theme-name.js

@@ -0,0 +1,13 @@
+/**
+ * The theme-name slug rule, declared locally.
+ *
+ * The single source of truth for this rule is `THEME_NAME_RE` in `@sovecom/theme-sdk`. The
+ * compiled `dist/cli.js` binary must run under plain `node`, but the SDK ships source-first
+ * so a runtime import from the binary cannot load it without a bundler. This drift-guarded local
+ * copy is kept honest by a conformance test (`test/theme-name.conformance.test.ts`) that asserts
+ * this regex's `.source` and `.flags` equal the SDK's.
+ *
+ * MUST stay byte-for-byte equal to `@sovecom/theme-sdk`'s `THEME_NAME_RE`.
+ */
+export const THEME_NAME_RE = /^[a-z][a-z0-9-]*$/;
+//# sourceMappingURL=theme-name.js.map

package/dist/theme-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-name.js","sourceRoot":"","sources":["../src/theme-name.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,mBAAmB,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "create-sovecom-theme",
+  "version": "1.0.0-rc.1",
+  "license": "MIT",
+  "description": "Non-interactive scaffolder for a SovEcom theme starter.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "create-sovecom-theme": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^4.0.0",
+    "@sovecom/theme-sdk": "1.0.0-rc.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/asifwanders/SovEcom.git",
+    "directory": "packages/create-sovecom-theme"
+  },
+  "homepage": "https://github.com/asifwanders/SovEcom",
+  "bugs": {
+    "url": "https://github.com/asifwanders/SovEcom/issues"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint src --ext .ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  }
+}

package/templates/.gitignore.tmpl

@@ -0,0 +1,7 @@
+node_modules/
+dist/
+*.log
+.DS_Store
+.env
+.env.*
+!.env.example

package/templates/LICENSE.tmpl

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SovEcom
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/templates/README.md.tmpl

@@ -0,0 +1,50 @@
+# __THEME_NAME__
+
+A [SovEcom](https://github.com/) theme, scaffolded with `create-sovecom-theme`.
+
+## What's here
+
+```
+__THEME_NAME__/
+├── sovecom.theme.json      # the manifest: name, version, compatibleCore, slots, settingsSchema
+├── settings.schema.json    # JSON-schema describing your tunable settings (path is opaque to core)
+├── package.json            # depends on @sovecom/theme-sdk (dev); typechecks the authoring sources
+├── tsconfig.json           # typecheck-only (a theme is a declarative asset — no build output)
+├── src/
+│   ├── theme.ts            # the typed authoring view — `defineTheme({ ... })`
+│   ├── slots.ts            # the declarative slot slugs — `defineThemeSlots([...])`
+│   └── settings.ts         # typed default settings — `defineThemeSettings({ ... })`
+├── README.md
+├── .gitignore
+└── LICENSE                 # MIT
+```
+
+## The theme contract
+
+A theme is a **declarative ASSET**, not code. There is **no `activate`, no worker, no runtime
+entrypoint, no capabilities, no namespaced tables** — the core ingests your `sovecom.theme.json` and
+validates it; it never executes theme code. The entire store-facing
+runtime contract a theme touches is two already-shipped read-only endpoints:
+
+| Endpoint                | Shape                                          | Purpose                         |
+| ----------------------- | ---------------------------------------------- | ------------------------------- |
+| `GET /store/v1/theme`   | `{ name, version, settings }`                  | The active theme the storefront reads to render. |
+| `GET /store/v1/slots`   | `Record<slot, { module, component }>`          | The resolved slot map (conflicts omitted).       |
+
+`slots` are **declarative manifest metadata** — there is no runtime `registerSlot()`. The slot
+registry is derived from enabled **modules'** manifests.
+
+## Author
+
+```bash
+pnpm install
+pnpm typecheck   # tsc --noEmit over src/ — validates your defineTheme/defineThemeSlots config
+```
+
+`src/theme.ts` is the typed authoring view of `sovecom.theme.json`; keep the two in sync. The
+manifest (`sovecom.theme.json`) is the artifact the core ingests.
+
+## License
+
+MIT. See `LICENSE`. Themes are MIT-licensed — distinct from the AGPL core — so they can be authored
+and distributed commercially.

package/templates/package.json.tmpl

@@ -0,0 +1,16 @@
+{
+  "name": "__THEME_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "description": "A SovEcom theme.",
+  "license": "MIT",
+  "type": "module",
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "devDependencies": {
+    "@sovecom/theme-sdk": "^0.0.1",
+    "@types/node": "^24.0.0",
+    "typescript": "^5.4.0"
+  }
+}

package/templates/settings.schema.json.tmpl

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "__THEME_NAME__ settings",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "primaryColor": {
+      "type": "string",
+      "description": "Primary brand colour, as a CSS hex string.",
+      "default": "#111111"
+    },
+    "showBreadcrumbs": {
+      "type": "boolean",
+      "description": "Whether product pages render breadcrumbs.",
+      "default": true
+    }
+  }
+}

package/templates/sovecom.theme.json.tmpl

@@ -0,0 +1,8 @@
+{
+  "name": "__THEME_NAME__",
+  "displayName": "__THEME_NAME__",
+  "version": "0.1.0",
+  "compatibleCore": "^1.0.0",
+  "slots": ["product-page"],
+  "settingsSchema": "settings.schema.json"
+}

package/templates/src/settings.ts.tmpl

@@ -0,0 +1,16 @@
+/**
+ * __THEME_NAME__ — the typed default settings this theme exposes.
+ *
+ * `settingsSchema` in the manifest points at a JSON-schema file describing the tunable settings;
+ * that path stays OPAQUE — the core never reads or executes it at validation time.
+ * `defineThemeSettings` is purely COMPILE-TIME ergonomics: it types-and-returns your defaults so
+ * you get autocomplete and a single inferred shape to reuse. NO runtime behaviour, NO file read.
+ */
+import { defineThemeSettings } from '@sovecom/theme-sdk';
+
+export const settings = defineThemeSettings({
+  primaryColor: '#111111',
+  showBreadcrumbs: true,
+});
+
+export type ThemeSettingsShape = typeof settings;

package/templates/src/slots.ts.tmpl

@@ -0,0 +1,11 @@
+/**
+ * __THEME_NAME__ — the declarative slot slugs this theme exposes/renders.
+ *
+ * Slots are DECLARATIVE manifest metadata; the slot registry is DERIVED at runtime from enabled
+ * MODULES' manifests. `defineThemeSlots` is NOT an RPC and there is NO runtime `registerSlot()` —
+ * it just validates the slug shape (`^[a-z][a-z0-9-]*$`, no duplicates) and
+ * returns a frozen array dropped verbatim into the manifest's `slots`.
+ */
+import { defineThemeSlots } from '@sovecom/theme-sdk';
+
+export const slots = defineThemeSlots(['product-page']);

package/templates/src/theme.ts.tmpl

@@ -0,0 +1,25 @@
+/**
+ * __THEME_NAME__ — a SovEcom theme.
+ *
+ * A theme is a declarative ASSET: NO worker, NO runtime entrypoint, NO runtime lifecycle hook, NO
+ * capabilities, NO namespaced tables. `defineTheme(config)` validates your config
+ * against the SAME manifest schema the core runs at install time and returns the typed, validated
+ * `ThemeManifest` — a build-/author-time helper, never a runtime entry. A misconfigured theme
+ * fails fast here with a clear message, not as an opaque install rejection.
+ *
+ * The authored object below mirrors `sovecom.theme.json` (which is the artifact the core ingests).
+ * Keep them in sync — this file is the typed, validated authoring view of that manifest.
+ */
+import { defineTheme } from '@sovecom/theme-sdk';
+import { slots } from './slots.js';
+
+export const theme = defineTheme({
+  name: '__THEME_NAME__',
+  displayName: '__THEME_NAME__',
+  version: '0.1.0',
+  compatibleCore: '^1.0.0',
+  slots,
+  settingsSchema: 'settings.schema.json',
+});
+
+export default theme;

package/templates/tsconfig.json.tmpl

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022"],
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "types": ["node"],
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "noUncheckedIndexedAccess": true,
+    "noEmit": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules"]
+}