@effijs/templates 0.0.0-stage → 1.0.0-alpha.0

package/CONTRIBUTING.md

@@ -0,0 +1,27 @@
+# Contributing
+
+## Add a component, service, or utility
+
+1. Create `platforms/<platform>/solutions/<type>/<Name>/` or `shared/solutions/utils/<name>/` when the code does not import React Native.
+2. Add `solution.js` with `id`, `type` (`component`, `service`, or `util`), `platforms`, `title`, `description`, `status` (`stable`, `experimental`, or `stub`), `since`, `tags`, `requires`, `dependencies` (keys from the platform matrix), `files`, `register` (`file`, `marker`, `code`), and `manual`.
+3. Add `README.md` with purpose, API, example, dependencies, manual steps, and the version that added it.
+4. Put copied files under `files/`. Registration code must target an existing `// forge:<name>` marker.
+5. Run `npm run docs` and `npm test`.
+
+`forge g util` is `add` filtered to `type: util`. A utility that is already listed in `.forge/state.json`, or whose first file already exists, is skipped.
+
+## Add a generator
+
+1. Add `platforms/<platform>/generators/<name>/generator.js` exporting `{ description, prompts, actions }`.
+2. Register it on the preset and in `forge.manifest.js` (prompts and flags).
+3. Put defaults on the prompts. `forge g --yes` applies those defaults.
+4. Custom actions must honor `data.dryRun`.
+5. Insert code with `append`, `pattern`, `before: true`, and `unique: true` at a `// forge:<name>` marker.
+6. Copy static trees with `addMany`. Files that are not `.hbs` are byte copies, so JSX and binaries stay intact. Use `.hbs` only when a value must be substituted.
+
+## Add a platform
+
+1. Add `platforms/<id>/platform.js` with `id`, navigator or router list, markers, and a compat matrix.
+2. Add `presets/<preset>/index.js` whose `id` is the generator namespace (`rn-fsd` today, `react-fsd` later).
+3. Keep `lib/` free of platform imports. Pass platform data into generators.
+4. Add the platform to `forge.manifest.js` and regenerate the catalog.

package/LICENSE

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2020-2026 Yevhenii Kyrychok
+
+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/README.md

@@ -1,3 +1,33 @@
-# Temporary Holding Version
+# @effijs/templates
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Forge presets for EffiJS. React Native Feature-Sliced Design is ready. A React (web) preset is planned and will use the same platform contract.
+
+## Platforms
+
+| Platform | Preset | Status |
+| --- | --- | --- |
+| React Native | `rn-fsd` | Ready |
+| React | `react-fsd` | Planned |
+
+## Quick start
+
+```bash
+npx @react-native-community/cli init MyApp --version 0.86.3
+cd MyApp
+yarn add -D @effijs/forge @effijs/templates
+npx forge init
+npx forge g setup
+npx forge g init
+```
+
+`setup` installs dependencies and patches configs. `init` copies the `src` base. Optional next steps: `forge g demo`, `forge g entity`, `forge g feature`, `forge g component`, `forge g add`.
+
+`setup` writes `presetMap` as the package path `@effijs/templates/presets/react-native-fsd`. `addMany` byte-copies every file that is not `.hbs`; Handlebars runs only on `.hbs` and the suffix is stripped, so JSX `{{` stays intact. Barrel lines are an `append` with `pattern`, `before: true`, and `unique: true`, which inserts once in front of `// forge:<name>`.
+
+## Docs
+
+- [React Native guide](platforms/react-native/README.md)
+- [Catalog](docs/catalog.md)
+- [Contributing](CONTRIBUTING.md)
+
+`npm run docs` regenerates the catalog from manifests. `npm run docs:check` fails when the catalog is stale or a solution is missing its README.

package/ai/SETUP.md

@@ -0,0 +1,5 @@
+# Setup guide
+
+The React Native requirements live in [platforms/react-native/ai/SETUP.md](../platforms/react-native/ai/SETUP.md).
+
+Migration files tell an agent to follow `node_modules/@effijs/templates/platforms/react-native/ai/SETUP.md`.

package/docs/catalog.md

@@ -0,0 +1,85 @@
+<!-- GENERATED. Не редагувати вручну. Run `npm run docs` in @effijs/templates. -->
+
+# Catalog
+
+Generated from solution manifests, the init kit, and forge.manifest.js.
+
+## react-native
+
+Status: ready.
+
+### Генератори
+
+| Command | Description |
+| --- | --- |
+| forge g setup | Install EffiJS dependencies and patch React Native configs. |
+| forge g init | Copy the FSD base: app shell, auth, profile, http, theme, and the base UI kit. |
+| forge g demo | Add product and category on top of init, including BottomSheet and Image. |
+| forge g entity | Add an entity. crud matches product; simple matches category. |
+| forge g feature | Add a feature and the screens you select. filter implies list. search still generates the list item. |
+| forge g component | Add a props-manager component: Common, pm, types, and index. |
+| forge g add | Install a catalog solution and its requirements. |
+| forge g util | Install a utility. Same engine as add, filtered to type util. |
+
+### Базовий набір (init)
+
+| Name | Type | Path | Description |
+| --- | --- | --- | --- |
+| Box | component | ui/components/Box | View with theme color, radius, and shadow props. |
+| Grid | component | ui/components/Grid | Layout primitive with spacing and alignment props. |
+| Text | component | ui/components/Text | Themed text with typography props. |
+| Button | component | ui/components/Button | Pressable button. Loading uses ActivityIndicator. |
+| Screen | component | ui/components/Screen | Screen shell with header, content, and safe area. Built for Wix navigation. |
+| Form | component | ui/components/Form | EffiJS form bindings. DateTimePicker, SelectPicker, and InputSecurity are separate solutions. |
+| TextInput | component | ui/components/TextInput | Themed text input. OTP is a separate solution. |
+| Icon | component | ui/components/Icon | Icon font glyph. |
+| Loading | component | ui/components/Loading | Loading overlay driven by a small store. |
+| ThemePicker | component | ui/components/ThemePicker | Switches the active theme scheme. |
+| toast | widget | ui/widgets/toast | Toast stack shown through navigation.widgets.showToast. |
+| http | service | services/http | HTTP client with token and error middleware. |
+| string | util | utils/string.ts | Text transforms used by form inputs. |
+| date | util | utils/date.ts | Date helpers. |
+| store.persistent | util | utils/store.persistent.ts | MMKV-backed persistent store. |
+| auth | entity | entity/auth | Session, sign-in, and sign-up entity. |
+| auth | feature | feature/auth | Sign-in and sign-up screens. |
+| profile | feature | feature/profile | Profile screen and theme picker. |
+
+### Компоненти
+
+| Id | Status | Description |
+| --- | --- | --- |
+| component:BottomSheet | stable | Gesture-driven sheet with header and content slots. |
+| component:BottomSheetWidgets | stable | List and date-time sheets, plus Form.Element.SelectPicker. |
+| component:Calendar | experimental | Calendar from the previous template kit. Treat the API as experimental until it is wired into a screen. |
+| component:Chart | experimental | Chart from the previous template kit. Treat the API as experimental until it is wired into a screen. |
+| component:CheckBox | stable | Themed checkbox and the matching form element. |
+| component:DateTimePicker | stable | Form date field that opens the bottom-sheet picker. |
+| component:Image | stable | Native and SVG image with theme sizing. SVG rendering uses Skia. |
+| component:InputSecurity | experimental | Sanitize and validate text with the validator package. |
+| component:OTP | stable | One-time code field attached to TextInput. |
+| component:ProgressIndicator | stable | Linear and circular progress drawn with Skia. |
+| component:Ruler | experimental | Ruler from the previous template kit. Treat the API as experimental until it is wired into a screen. |
+| component:Section | stable | Segmented section control. |
+| component:Slider | experimental | Slider from the previous template kit. Treat the API as experimental until it is wired into a screen. |
+| component:Switch | stable | Themed switch. |
+
+### Сервіси
+
+| Id | Status | Description |
+| --- | --- | --- |
+| service:firebase-core | stable | Resolves the default Firebase app. |
+| service:firebase-messaging | stable | Requests notification permission and reads the FCM token. |
+
+### Утиліти
+
+| Id | Status | Description |
+| --- | --- | --- |
+| util:permissions | stable | Asks for notification permission on iOS and Android. |
+| util:date | stable | Pure date helpers. init already copies this file for React Native. |
+| util:string | stable | Pure string transforms. init already copies this file for React Native. |
+
+## react
+
+Status: planned.
+
+Not implemented yet.

package/forge.manifest.js

@@ -0,0 +1,75 @@
+export default {
+  platforms: [
+    { id: 'react-native', status: 'ready', preset: 'rn-fsd', doc: 'platforms/react-native/README.md' },
+    { id: 'react', status: 'planned', preset: 'react-fsd', doc: null },
+  ],
+  presets: {
+    'rn-fsd': './presets/react-native-fsd',
+  },
+  generators: [
+    {
+      id: 'rn-fsd:setup',
+      command: 'forge g setup',
+      description: 'Install EffiJS dependencies and patch React Native configs.',
+      platforms: ['react-native'],
+      prompts: ['packageManager', 'navigator', 'moveStarter'],
+      flags: ['--package-manager', '--navigator', '--link-local <path>', '--move-starter', '--yes'],
+    },
+    {
+      id: 'rn-fsd:init',
+      command: 'forge g init',
+      description: 'Copy the FSD base: app shell, auth, profile, http, theme, and the base UI kit.',
+      platforms: ['react-native'],
+      prompts: ['apiUrl'],
+      flags: ['--api-url', '--navigator', '--yes'],
+    },
+    {
+      id: 'rn-fsd:demo',
+      command: 'forge g demo',
+      description: 'Add product and category on top of init, including BottomSheet and Image.',
+      platforms: ['react-native'],
+      prompts: [],
+      flags: ['--yes'],
+    },
+    {
+      id: 'rn-fsd:entity',
+      command: 'forge g entity',
+      description: 'Add an entity. crud matches product; simple matches category.',
+      platforms: ['react-native'],
+      prompts: ['name', 'variant', 'apiUrl', 'fields'],
+      flags: ['--name', '--variant crud|simple', '--api-url', '--fields title:string,price:number'],
+    },
+    {
+      id: 'rn-fsd:feature',
+      command: 'forge g feature',
+      description: 'Add a feature and the screens you select. filter implies list. search still generates the list item.',
+      platforms: ['react-native'],
+      prompts: ['name', 'entity', 'screens', 'tab'],
+      flags: ['--name', '--entity', '--screens all', '--tab'],
+    },
+    {
+      id: 'rn-fsd:component',
+      command: 'forge g component',
+      description: 'Add a props-manager component: Common, pm, types, and index.',
+      platforms: ['react-native'],
+      prompts: ['name', 'base', 'extend', 'slots', 'location'],
+      flags: ['--name', '--base View|Pressable|Text', '--extend Box|Grid|Text|none', '--slots container', '--location ui'],
+    },
+    {
+      id: 'rn-fsd:add',
+      command: 'forge g add',
+      description: 'Install a catalog solution and its requirements.',
+      platforms: ['react-native'],
+      prompts: ['id'],
+      flags: ['--id component:BottomSheet'],
+    },
+    {
+      id: 'rn-fsd:util',
+      command: 'forge g util',
+      description: 'Install a utility. Same engine as add, filtered to type util.',
+      platforms: ['react-native'],
+      prompts: ['id'],
+      flags: ['--id util:permissions'],
+    },
+  ],
+};

package/lib/compat.js

@@ -0,0 +1,40 @@
+import semver from 'semver';
+
+export function resolveRange(version, matrix) {
+  const coerced = semver.coerce(version);
+  if (!coerced) {
+    const fallback = matrix[matrix.length - 1];
+    return {
+      entry: fallback,
+      warning: `Could not parse React Native version "${version}". Using the newest matrix range ${fallback.id}.`,
+    };
+  }
+
+  const exact = matrix.find((entry) => semver.satisfies(coerced, entry.range));
+  if (exact) return { entry: exact, warning: null };
+
+  const ranked = matrix
+    .map((entry) => {
+      const min = semver.minVersion(entry.range);
+      return { entry, distance: Math.abs(coerced.compare(min)) };
+    })
+    .sort((a, b) => a.distance - b.distance || semver.compare(semver.minVersion(b.entry.range), semver.minVersion(a.entry.range)));
+
+  const nearest = ranked[0]?.entry ?? matrix[matrix.length - 1];
+  return {
+    entry: nearest,
+    warning: `React Native ${coerced.version} is outside the compatibility matrix. Using the nearest range ${nearest.id} (${nearest.range}).`,
+  };
+}
+
+export function depsByKeys(entry, keys = []) {
+  const dependencies = {};
+  const devDependencies = {};
+  for (const key of keys) {
+    const block = entry.optional?.[key];
+    if (!block) continue;
+    Object.assign(block.dev ? devDependencies : dependencies, block.dependencies ?? {});
+    Object.assign(devDependencies, block.devDependencies ?? {});
+  }
+  return { dependencies, devDependencies };
+}

package/lib/docs/build.js

@@ -0,0 +1,146 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+import { packageRoot } from '../paths.js';
+import { loadSolutions, solutionReadmePath } from '../registry.js';
+import { matrix } from '../../platforms/react-native/compat/matrix.js';
+
+const HEADER = '<!-- GENERATED. Не редагувати вручну. Run `npm run docs` in @effijs/templates. -->\n';
+
+export async function buildCatalogs() {
+  const root = packageRoot();
+  const manifest = (await import(pathToFileURL(path.join(root, 'forge.manifest.js')).href)).default;
+  const solutions = await loadSolutions(root);
+  for (const solution of solutions) {
+    if (!fs.existsSync(solutionReadmePath(solution))) {
+      throw new Error(`${solution.id} is missing README.md`);
+    }
+  }
+  const kit = (await import(pathToFileURL(path.join(root, 'platforms/react-native/generators/init/kit.js')).href)).default;
+  const byPlatform = new Map();
+  for (const platform of manifest.platforms) {
+    byPlatform.set(platform.id, {
+      platform,
+      solutions: solutions.filter((solution) => solution.platforms.includes(platform.id)),
+      generators: manifest.generators.filter((generator) => generator.platforms.includes(platform.id)),
+      kit: kit.platform === platform.id ? kit.items : [],
+    });
+  }
+
+  const catalog = [HEADER, '# Catalog', '', 'Generated from solution manifests, the init kit, and forge.manifest.js.', ''];
+  for (const platform of manifest.platforms) {
+    catalog.push(`## ${platform.id}`, '', `Status: ${platform.status}.`, '');
+    if (platform.status !== 'ready') {
+      catalog.push('Not implemented yet.', '');
+      continue;
+    }
+    const bucket = byPlatform.get(platform.id);
+    catalog.push('### Генератори', '', table(bucket.generators.map((item) => [item.command, item.description])));
+    catalog.push('### Базовий набір (init)', '', table(bucket.kit.map((item) => [item.name, item.type, item.path, item.description])));
+    catalog.push('### Компоненти', '', table(ofType(bucket.solutions, 'component').map(solutionRow)));
+    catalog.push('### Сервіси', '', table(ofType(bucket.solutions, 'service').map(solutionRow)));
+    catalog.push('### Утиліти', '', table(ofType(bucket.solutions, 'util').map(solutionRow)));
+  }
+
+  const files = {
+    [path.join(root, 'docs/catalog.md')]: catalog.join('\n'),
+  };
+  for (const [id, bucket] of byPlatform) {
+    if (bucket.platform.status !== 'ready') continue;
+    files[path.join(root, 'platforms', id, 'CATALOG.md')] = renderPlatform(bucket, path.join(root, 'platforms', id));
+  }
+  return files;
+}
+
+function renderPlatform(bucket, dir) {
+  const lines = [HEADER, `# ${bucket.platform.id} catalog`, ''];
+  lines.push('## Генератори', '');
+  for (const generator of bucket.generators) {
+    lines.push(`### ${generator.id}`, '', generator.description, '', `Command: \`${generator.command}\``, '', `Prompts: ${generator.prompts.join(', ') || 'none'}`, '', `Flags: ${generator.flags.join(', ')}`, '');
+  }
+  lines.push('## Базовий набір (init)', '');
+  for (const item of bucket.kit) {
+    lines.push(`### ${item.name}`, '', `- Type: ${item.type}`, `- Path: \`${item.path}\``, `- ${item.description}`, '');
+  }
+  for (const type of ['component', 'service', 'util']) {
+    lines.push(`## ${label(type)}`, '');
+    for (const solution of ofType(bucket.solutions, type)) {
+      lines.push(renderSolution(solution, dir));
+    }
+  }
+  return lines.join('\n');
+}
+
+function renderSolution(solution, dir) {
+  const deps = npmDeps(solution);
+  const command = `forge g ${solution.type === 'util' ? 'util' : 'add'} --id ${solution.id}`;
+  const readme = path.relative(dir, solutionReadmePath(solution));
+  return [
+    `### ${solution.id}`,
+    '',
+    `- Status: ${solution.status}`,
+    `- ${solution.description}`,
+    `- Requires: ${solution.requires.length ? solution.requires.join(', ') : 'none'}`,
+    `- npm: ${deps.length ? deps.join(', ') : 'none'}`,
+    `- Command: \`${command}\``,
+    `- Manual: ${solution.manual.length ? solution.manual.join(' ') : 'none'}`,
+    `- Guide: [${readme}](${readme})`,
+    '',
+  ].join('\n');
+}
+
+function npmDeps(solution) {
+  const names = new Set();
+  for (const entry of matrix) {
+    for (const key of solution.dependencies ?? []) {
+      const block = entry.optional?.[key];
+      for (const name of Object.keys(block?.dependencies ?? {})) names.add(name);
+    }
+  }
+  return [...names];
+}
+
+function ofType(solutions, type) {
+  return solutions.filter((solution) => solution.type === type);
+}
+
+function solutionRow(solution) {
+  return [solution.id, solution.status, solution.description];
+}
+
+function label(type) {
+  if (type === 'component') return 'Компоненти';
+  if (type === 'service') return 'Сервіси';
+  return 'Утиліти';
+}
+
+function table(rows) {
+  if (!rows.length) return 'None yet.\n';
+  const width = rows[0].length;
+  const head = width === 4 ? ['Name', 'Type', 'Path', 'Description'] : width === 3 ? ['Id', 'Status', 'Description'] : ['Command', 'Description'];
+  const line = (cells) => `| ${cells.join(' | ')} |`;
+  return [line(head), line(head.map(() => '---')), ...rows.map((row) => line(row)), ''].join('\n');
+}
+
+async function main() {
+  const files = await buildCatalogs();
+  const check = process.argv.includes('--check');
+  let dirty = false;
+  for (const [file, content] of Object.entries(files)) {
+    const current = fs.existsSync(file) ? fs.readFileSync(file, 'utf8') : '';
+    if (current !== content) {
+      dirty = true;
+      if (check) console.error(`Out of date: ${path.relative(packageRoot(), file)}`);
+      else {
+        fs.mkdirSync(path.dirname(file), { recursive: true });
+        fs.writeFileSync(file, content);
+      }
+    }
+  }
+  if (check && dirty) process.exit(1);
+  if (!check) console.log('Wrote catalog docs');
+}
+
+const invoked = process.argv[1] && fileURLToPath(import.meta.url) === path.resolve(process.argv[1]);
+if (invoked) main();

package/lib/install.js

@@ -0,0 +1,51 @@
+import { execSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+
+export function formatPackageSpec(name, version) {
+  return version ? `${name}@${version}` : name;
+}
+
+export function installCommand(packageManager, dependencies = {}, devDependencies = {}) {
+  const deps = Object.entries(dependencies).map(([name, version]) => formatPackageSpec(name, version));
+  const dev = Object.entries(devDependencies).map(([name, version]) => formatPackageSpec(name, version));
+  const commands = [];
+  if (deps.length) {
+    if (packageManager === 'yarn') commands.push(`yarn add ${deps.join(' ')}`);
+    else if (packageManager === 'pnpm') commands.push(`pnpm add ${deps.join(' ')}`);
+    else commands.push(`npm install ${deps.join(' ')}`);
+  }
+  if (dev.length) {
+    if (packageManager === 'yarn') commands.push(`yarn add -D ${dev.join(' ')}`);
+    else if (packageManager === 'pnpm') commands.push(`pnpm add -D ${dev.join(' ')}`);
+    else commands.push(`npm install -D ${dev.join(' ')}`);
+  }
+  return commands.join(' && ');
+}
+
+export function mergePackageJson(root, { dependencies = {}, devDependencies = {} }) {
+  const file = path.join(root, 'package.json');
+  const pkg = JSON.parse(fs.readFileSync(file, 'utf8'));
+  pkg.dependencies = { ...(pkg.dependencies ?? {}), ...dependencies };
+  pkg.devDependencies = { ...(pkg.devDependencies ?? {}), ...devDependencies };
+  fs.writeFileSync(file, `${JSON.stringify(pkg, null, 2)}\n`);
+  return file;
+}
+
+export function installPackages({ root, packageManager, dependencies = {}, devDependencies = {}, dryRun = false }) {
+  const command = installCommand(packageManager, dependencies, devDependencies);
+  if (!command) return { success: true, skipped: true };
+  if (dryRun) {
+    console.log(`[dry-run] Would run: ${command}`);
+    return { success: true, dryRun: true, command };
+  }
+  try {
+    execSync(command, { cwd: root, stdio: 'inherit' });
+    return { success: true, command };
+  } catch (error) {
+    mergePackageJson(root, { dependencies, devDependencies });
+    console.warn(`Dependency install failed (${error.message}). Versions were merged into package.json.`);
+    console.warn(`Run manually: ${command}`);
+    return { success: true, merged: true, command, error: error.message };
+  }
+}

package/lib/journal.js

@@ -0,0 +1,40 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+import { stamp } from './patch.js';
+
+export async function readState(root) {
+  const file = path.join(root, '.forge/state.json');
+  try {
+    return JSON.parse(await fs.promises.readFile(file, 'utf8'));
+  } catch {
+    return { installed: [] };
+  }
+}
+
+export async function writeState(root, state, { dryRun = false } = {}) {
+  if (dryRun) return;
+  const file = path.join(root, '.forge/state.json');
+  await fs.promises.mkdir(path.dirname(file), { recursive: true });
+  await fs.promises.writeFile(file, `${JSON.stringify(state, null, 2)}\n`);
+}
+
+export async function markInstalled(root, id, { dryRun = false } = {}) {
+  const state = await readState(root);
+  const installed = new Set(state.installed ?? []);
+  installed.add(id);
+  state.installed = [...installed];
+  await writeState(root, state, { dryRun });
+  return state;
+}
+
+export async function writeSummary(root, { generator, name, lines, dryRun = false }) {
+  const text = [`# ${generator}${name ? `: ${name}` : ''}`, '', ...lines.map((line) => `- ${line}`), ''].join('\n');
+  console.log(`\n${text}`);
+  if (dryRun) return null;
+  const dir = path.join(root, '.forge/summary');
+  await fs.promises.mkdir(dir, { recursive: true });
+  const file = path.join(dir, `${stamp()}-${generator}${name ? `-${name}` : ''}.md`);
+  await fs.promises.writeFile(file, text);
+  return file;
+}

package/lib/jsonConfig.js

@@ -0,0 +1,33 @@
+import { applyEdits, modify } from 'jsonc-parser';
+
+const formattingOptions = { insertSpaces: true, tabSize: 2 };
+
+export function setJsonPath(text, jsonPath, value) {
+  const edits = modify(text, jsonPath, value, { formattingOptions });
+  return applyEdits(text, edits);
+}
+
+export function patchTsconfig(text, { paths, types, exclude }) {
+  let next = text;
+  next = setJsonPath(next, ['compilerOptions', 'experimentalDecorators'], true);
+  next = setJsonPath(next, ['compilerOptions', 'emitDecoratorMetadata'], true);
+  if (types) next = setJsonPath(next, ['compilerOptions', 'types'], types);
+  if (paths) next = setJsonPath(next, ['compilerOptions', 'paths'], paths);
+  if (exclude) next = setJsonPath(next, ['exclude'], exclude);
+  if (!next.endsWith('\n')) next += '\n';
+  return next;
+}
+
+export const TSCONFIG_PATHS = {
+  '@*': ['./src/*'],
+  '@components': ['./src/ui/components'],
+  '@components/*': ['./src/ui/components/*'],
+  '@icons': ['./src/ui/icons'],
+  '@icons/*': ['./src/ui/icons/*'],
+  '@images': ['./src/ui/images'],
+  '@images/*': ['./src/ui/images/*'],
+  '@widgets': ['./src/ui/widgets'],
+  '@widgets/*': ['./src/ui/widgets/*'],
+  '@theme': ['./src/ui/theme'],
+  '@theme/*': ['./src/ui/theme/*'],
+};

package/lib/migration.js

@@ -0,0 +1,35 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+import { stamp } from './patch.js';
+
+export function migrationFileName(target) {
+  const base = path.basename(target).replace(/[^\w.]+/g, '-');
+  return `${stamp()}-${base}.md`;
+}
+
+export async function writeMigration(root, { title, target, reason, required, prompt }) {
+  const dir = path.join(root, '.forge/migrations');
+  await fs.promises.mkdir(dir, { recursive: true });
+  const file = path.join(dir, migrationFileName(target));
+  const body = `# ${title}
+
+Target: \`${target}\`
+
+${reason}
+
+## Required change
+
+${required}
+
+## AI prompt
+
+${prompt}
+`;
+  await fs.promises.writeFile(file, body);
+  return file;
+}
+
+export function aiPrompt(relativeMigration) {
+  return `Apply \`${relativeMigration}\` following \`node_modules/@effijs/templates/platforms/react-native/ai/SETUP.md\`.`;
+}

package/lib/names.js

@@ -0,0 +1,42 @@
+export function kebabCase(value) {
+  return String(value ?? '')
+    .trim()
+    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+    .replace(/[\s_]+/g, '-')
+    .replace(/[^a-zA-Z0-9-]/g, '')
+    .replace(/-+/g, '-')
+    .replace(/^-|-$/g, '')
+    .toLowerCase();
+}
+
+export function pascalCase(value) {
+  return kebabCase(value)
+    .split('-')
+    .filter(Boolean)
+    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+    .join('');
+}
+
+export function camelCase(value) {
+  const pascal = pascalCase(value);
+  return pascal ? pascal.charAt(0).toLowerCase() + pascal.slice(1) : '';
+}
+
+export function pluralize(value) {
+  const kebab = kebabCase(value);
+  if (!kebab) return kebab;
+  if (kebab.endsWith('s')) return kebab;
+  if (kebab.endsWith('y') && !/[aeiou]y$/.test(kebab)) return `${kebab.slice(0, -1)}ies`;
+  return `${kebab}s`;
+}
+
+export function namesOf(value) {
+  const kebab = kebabCase(value);
+  return {
+    raw: String(value ?? '').trim(),
+    kebab,
+    pascal: pascalCase(kebab),
+    camel: camelCase(kebab),
+    plural: pluralize(kebab),
+  };
+}