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

package/platforms/react-native/generators/add/generator.js

@@ -0,0 +1,12 @@
+import { addPrompts, runAdd } from './run.js';
+
+export default {
+  description: 'Install a ready-made component, service, or utility',
+  prompts: addPrompts(),
+  actions: [
+    {
+      type: 'custom',
+      action: (data, forge) => runAdd(data, forge),
+    },
+  ],
+};

package/platforms/react-native/generators/add/run.js

@@ -0,0 +1,64 @@
+import { resolveRange } from '../../../../lib/compat.js';
+import { writeSummary } from '../../../../lib/journal.js';
+import { packageRoot } from '../../../../lib/paths.js';
+import { detectPackageManager, detectReactNativeVersion, projectRoot } from '../../../../lib/project.js';
+import { expandRequires, filterByPlatform, isInstalled, loadSolutions } from '../../../../lib/registry.js';
+import platform from '../../platform.js';
+import { isDry } from '../../runtime.js';
+import { installSolution } from '../../solutions/install.js';
+
+export function addPrompts(type) {
+  return async (forge) => {
+    const solutions = filterByPlatform(await loadSolutions(packageRoot()), platform.id)
+      .filter((solution) => !type || solution.type === type);
+    return [
+      {
+        type: 'list',
+        name: 'id',
+        message: type === 'util' ? 'Utility:' : 'Solution:',
+        choices: solutions.map((solution) => ({
+          name: `${solution.title} — ${solution.description}`,
+          value: solution.id,
+        })),
+      },
+    ];
+  };
+}
+
+export async function runAdd(data, forge, type) {
+  if (!data.id) return { success: false, error: 'Pass --id, for example component:BottomSheet' };
+  const root = projectRoot(forge);
+  const all = filterByPlatform(await loadSolutions(packageRoot()), platform.id);
+  const target = all.find((solution) => solution.id === data.id);
+  if (!target) return { success: false, error: `Unknown solution "${data.id}"` };
+  if (type && target.type !== type) return { success: false, error: `${data.id} is not a ${type}` };
+  let selected;
+  try {
+    selected = expandRequires([data.id], all);
+  } catch (error) {
+    return { success: false, error: error.message };
+  }
+  const version = detectReactNativeVersion(root);
+  const compat = version ? resolveRange(version, platform.matrix).entry : platform.matrix.at(-1);
+  const dryRun = isDry(data, forge);
+  const force = Boolean(data.force || forge.runOptions?.force);
+  const notes = [];
+  for (const solution of selected) {
+    if (!force && (await isInstalled(root, solution))) {
+      notes.push(`Skipped ${solution.id} (already installed)`);
+      continue;
+    }
+    const result = await installSolution(solution, {
+      forge,
+      outputDir: forge.resolveOutputDir(type === 'util' ? 'rn-fsd:util' : 'rn-fsd:add'),
+      dryRun,
+      force,
+      compat,
+      packageManager: data.packageManager || forge.config.packageManager || detectPackageManager(root),
+    });
+    if (!result.success) return result;
+    notes.push(`Installed ${solution.id}`, ...result.notes);
+  }
+  await writeSummary(root, { generator: type === 'util' ? 'util' : 'add', name: data.id, lines: notes, dryRun });
+  return { success: true };
+}

package/platforms/react-native/generators/component/generator.js

@@ -0,0 +1,75 @@
+import { writeSummary } from '../../../../lib/journal.js';
+import { projectRoot } from '../../../../lib/project.js';
+import { isDry } from '../../runtime.js';
+import { componentPrompts, prepareComponent } from './render.js';
+
+const uiOnly = (data) => data.location !== 'ui';
+
+export default {
+  description: 'Add a props-manager component (Common, pm, types, index)',
+  prompts: componentPrompts,
+  actions: [
+    {
+      type: 'custom',
+      action(data) {
+        const error = prepareComponent(data);
+        if (error) return { success: false, error };
+      },
+    },
+    {
+      type: 'add',
+      path: '{{folder}}/Common.tsx',
+      templateFile: 'component/templates/Common.tsx.hbs',
+    },
+    {
+      type: 'add',
+      path: '{{folder}}/{{names.kebab}}.pm.ts',
+      templateFile: 'component/templates/pm.ts.hbs',
+    },
+    {
+      type: 'add',
+      path: '{{folder}}/{{names.kebab}}.types.ts',
+      templateFile: 'component/templates/types.ts.hbs',
+    },
+    {
+      type: 'add',
+      path: '{{folder}}/index.ts',
+      templateFile: 'component/templates/index.ts.hbs',
+    },
+    {
+      type: 'append',
+      path: 'ui/components/index.ts',
+      pattern: /\/\/ forge:components-import$/m,
+      before: true,
+      unique: true,
+      template: "import {{names.pascal}} from './{{names.pascal}}';\n",
+      skip: uiOnly,
+    },
+    {
+      type: 'append',
+      path: 'ui/components/index.ts',
+      pattern: /  \/\/ forge:components-export$/m,
+      before: true,
+      unique: true,
+      template: '  {{names.pascal}},\n',
+      skip: uiOnly,
+    },
+    {
+      type: 'custom',
+      action: async (data, forge) => {
+        await writeSummary(projectRoot(forge), {
+          generator: 'component',
+          name: data.name,
+          lines: [
+            `Created ${data.folder}`,
+            `Base: ${data.base}`,
+            `Extends: ${data.extend}`,
+            `Slots: ${data.slots.join(', ')}`,
+          ],
+          dryRun: isDry(data, forge),
+        });
+        return { success: true };
+      },
+    },
+  ],
+};

package/platforms/react-native/generators/component/render.js

@@ -0,0 +1,69 @@
+import path from 'node:path';
+
+import { namesOf } from '../../../../lib/names.js';
+import { listDirs } from '../../../../lib/project.js';
+
+const BASES = ['View', 'Pressable', 'Text'];
+const EXTENDS = ['Box', 'Grid', 'Text', 'none'];
+
+export function componentPrompts(forge) {
+  const features = listDirs(path.join(forge.resolveOutputDir('rn-fsd:component'), 'feature'));
+  return [
+    {
+      type: 'input',
+      name: 'name',
+      message: 'Component name:',
+      validate: (input) => (input?.trim() ? true : 'Component name is required'),
+    },
+    {
+      type: 'list',
+      name: 'base',
+      message: 'Base element:',
+      choices: BASES,
+      default: 'View',
+    },
+    {
+      type: 'list',
+      name: 'extend',
+      message: 'Extend a props-manager node:',
+      choices: EXTENDS,
+      default: 'Grid',
+    },
+    {
+      type: 'input',
+      name: 'slots',
+      message: 'Slots (comma-separated):',
+      default: 'container',
+    },
+    {
+      type: 'list',
+      name: 'location',
+      message: 'Location:',
+      choices: [
+        { name: 'ui/components', value: 'ui' },
+        ...features.map((feature) => ({ name: `feature/${feature}/components`, value: feature })),
+      ],
+      default: 'ui',
+    },
+  ];
+}
+
+export function prepareComponent(data) {
+  if (!data.name || !String(data.name).trim()) return 'Component name is required. Pass --name.';
+  if (!BASES.includes(data.base)) return `Base must be one of ${BASES.join(', ')}`;
+  if (!EXTENDS.includes(data.extend)) return `Extend must be one of ${EXTENDS.join(', ')}`;
+  const slots = Array.isArray(data.slots)
+    ? data.slots.map((slot) => String(slot).trim()).filter(Boolean)
+    : String(data.slots ?? '').split(',').map((slot) => slot.trim()).filter(Boolean);
+  data.slots = slots.length ? slots : ['container'];
+  data.names = namesOf(data.name);
+  data.primary = data.slots[0];
+  data.rnImport = data.base === 'Text' ? 'Text as RNText' : data.base;
+  data.tag = data.base === 'Text' ? 'RNText' : data.base;
+  data.jsxOpen = `<${data.tag} {...slots.${data.primary}}>`;
+  data.jsxClose = `</${data.tag}>`;
+  data.folder = data.location === 'ui'
+    ? `ui/components/${data.names.pascal}`
+    : `feature/${data.location}/components/${data.names.pascal}`;
+  return null;
+}

package/platforms/react-native/generators/component/templates/Common.tsx.hbs

@@ -0,0 +1,13 @@
+import React from 'react';
+import { {{rnImport}}, type {{base}}Props } from 'react-native';
+
+import { useTheme } from '@theme';
+
+import { {{names.pascal}}PM } from './{{names.kebab}}.pm';
+import type { T{{names.pascal}}Props } from './{{names.kebab}}.types';
+
+export default function {{names.pascal}}Common({ children, ...commonProps }: T{{names.pascal}}Props & {{base}}Props) {
+  const theme = useTheme();
+  const slots = {{names.pascal}}PM.get({ theme, ...commonProps } as Record<string, unknown>);
+  return {{{jsxOpen}}}{children}{{{jsxClose}}};
+}

package/platforms/react-native/generators/component/templates/index.ts.hbs

@@ -0,0 +1,13 @@
+import Common from './Common';
+import { {{names.pascal}}PM } from './{{names.kebab}}.pm';
+
+type TCommon = typeof Common;
+
+interface I{{names.pascal}} extends TCommon {
+  PM: typeof {{names.pascal}}PM;
+}
+
+const {{names.pascal}} = Common as I{{names.pascal}};
+{{names.pascal}}.PM = {{names.pascal}}PM;
+
+export default {{names.pascal}};

package/platforms/react-native/generators/component/templates/pm.ts.hbs

@@ -0,0 +1,7 @@
+import { Node, Prop, PropertyManager } from '@effijs/props-manager';
+
+export const {{names.pascal}}PM = PropertyManager.create('{{names.pascal}}'){{#each slots}}.node(
+  Node('{{this}}'){{#if (eq this ../primary)}}{{#unless (eq ../extend "none")}}
+    .extends('{{../extend}}'){{/unless}}{{/if}}
+    .keys(Prop('style', ({ style }) => style)),
+){{/each}};

package/platforms/react-native/generators/component/templates/types.ts.hbs

@@ -0,0 +1,3 @@
+export interface T{{names.pascal}}Props {
+  style?: unknown;
+}

package/platforms/react-native/generators/demo/files/api/app.http

@@ -0,0 +1,8 @@
+### Get Products
+HEAD {{api}}/products
+Content-Type: application/json
+Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOjEsImlhdCI6MTc4OTA2MDMxNSwiZXhwIjoxNzkwNzg4MzE1fQ.y3eTFrMKw8dvGvMVbywbsuATtuTx6l1z_yH2-15iyhw
+
+> {%
+ console.log('LENGTH', response.body.length)
+ %}}

package/platforms/react-native/generators/demo/files/api/environment/http-client.env.json

@@ -0,0 +1,5 @@
+{
+  "dev": {
+    "api": "https://api.escuelajs.co/api/v1"
+  }
+}

package/platforms/react-native/generators/demo/files/entity/category/category.api.ts

@@ -0,0 +1,18 @@
+import { Entity } from '@effijs/common';
+
+import { HttpBase } from '@services/http/http.base';
+
+import { CategoryData } from './category.dto';
+
+@Entity.Decorators.ApiService()
+export class CategoryApi extends HttpBase {
+  protected url = 'categories';
+
+  list = (options?: { signal?: AbortSignal }) =>
+    this.request(
+      { url: '', method: 'get', signal: options?.signal },
+      {
+        response: raw => (Array.isArray(raw) ? raw.map(item => CategoryData.transform(item)) : []),
+      },
+    );
+}

package/platforms/react-native/generators/demo/files/entity/category/category.dto.ts

@@ -0,0 +1,15 @@
+import { Transform } from '@effijs/common';
+
+export class CategoryData extends Transform.WithTransform {
+  @Transform.Decorators.Property()
+  id!: number;
+
+  @Transform.Decorators.Property()
+  name!: string;
+
+  @Transform.Decorators.Property()
+  slug!: string;
+
+  @Transform.Decorators.Property()
+  image!: string;
+}

package/platforms/react-native/generators/demo/files/entity/category/category.service.ts

@@ -0,0 +1,42 @@
+import { Entity } from '@effijs/common';
+
+import { CategoryApi } from './category.api';
+import { CategoryData } from './category.dto';
+import { CategoryStore } from './category.store';
+
+const ENTITY_KEY = 'category';
+
+@Entity.Decorators.Service()
+export class CategoryService {
+  constructor(
+    private api: CategoryApi,
+    readonly store: CategoryStore,
+  ) {}
+
+  getById = (id: string | number) => this.store.getByPath(`${ENTITY_KEY}.${String(id)}`) as CategoryData | undefined;
+
+  getListIds = () => (this.store.getByPath('ids.list') as string[] | undefined) ?? [];
+
+  getListData = () =>
+    this.getListIds()
+      .map(id => this.getById(id))
+      .filter(Boolean) as CategoryData[];
+
+  upsertToStore = (data: CategoryData) => {
+    this.store.set(`${ENTITY_KEY}.${String(data.id)}`, data);
+    return data;
+  };
+
+  async fetchList(options?: { signal?: AbortSignal }) {
+    const { data } = await this.api.list({ signal: options?.signal });
+    const ids: string[] = [];
+
+    for (const item of data) {
+      this.upsertToStore(item);
+      ids.push(String(item.id));
+    }
+
+    this.store.set('ids.list', ids);
+    return data;
+  }
+}

package/platforms/react-native/generators/demo/files/entity/category/category.store.ts

@@ -0,0 +1,26 @@
+import { Entity, Store } from '@effijs/common';
+
+import { StoreRegistry } from '@utils';
+
+import { CategoryData } from './category.dto';
+
+export type CategoryStoreState = {
+  category: Record<string, CategoryData>;
+  ids: {
+    list: string[];
+  };
+};
+
+@Entity.Decorators.Store()
+export class CategoryStore extends Store.Common<CategoryStoreState> {
+  constructor(private registry: StoreRegistry) {
+    super({
+      category: {},
+      ids: {
+        list: [],
+      },
+    });
+
+    registry.register(this);
+  }
+}

package/platforms/react-native/generators/demo/files/entity/category/index.ts

@@ -0,0 +1,2 @@
+import './category.api';
+import './category.service';

package/platforms/react-native/generators/demo/files/entity/product/index.ts

@@ -0,0 +1,2 @@
+import './product.api';
+import './product.service';

package/platforms/react-native/generators/demo/files/entity/product/product.api.ts

@@ -0,0 +1,49 @@
+import { Entity } from '@effijs/common';
+
+import { HttpBase } from '@services/http/http.base';
+
+import { ProductCreatePayload, ProductData, ProductListQueryParams, ProductUpdatePayload } from './product.dto';
+
+@Entity.Decorators.ApiService()
+export class ProductApi extends HttpBase {
+  protected url = 'products';
+
+  list = (
+    params?: Partial<ProductListQueryParams>,
+    options?: {
+      signal?: AbortSignal;
+    },
+  ) =>
+    this.request(
+      {
+        url: '',
+        method: 'get',
+        params,
+        signal: options?.signal,
+      },
+      {
+        params: raw => ProductListQueryParams.transform(raw).toQueryParams(),
+        response: raw => (Array.isArray(raw) ? raw.map(item => ProductData.transform(item)) : []),
+      },
+    );
+
+  getById = (id: string, options?: { signal?: AbortSignal }) =>
+    this.request({ url: id, method: 'get', signal: options?.signal }, { response: raw => ProductData.transform(raw) });
+
+  create = (payload: ProductCreatePayload, options?: { signal?: AbortSignal }) =>
+    this.request(
+      { url: '', method: 'post', data: payload, signal: options?.signal },
+      {
+        data: raw => ProductCreatePayload.transform(raw),
+        response: raw => ProductData.transform(raw),
+      },
+    );
+
+  update = (payload: ProductUpdatePayload, options?: { signal?: AbortSignal }) =>
+    this.request(
+      { url: `${payload.id}`, method: 'put', data: payload, signal: options?.signal },
+      { data: raw => ProductUpdatePayload.transform(raw), response: raw => ProductData.transform(raw) },
+    );
+
+  delete = (id: string | number) => this.request({ url: `${id}`, method: 'delete' });
+}

package/platforms/react-native/generators/demo/files/entity/product/product.dto.ts

@@ -0,0 +1,120 @@
+import { Transform } from '@effijs/common';
+
+import { CategoryData } from '@entity/category/category.dto';
+
+export class ProductData extends Transform.WithTransform {
+  @Transform.Decorators.Property()
+  id!: number;
+
+  @Transform.Decorators.Property()
+  title!: string;
+
+  @Transform.Decorators.Property()
+  slug!: string;
+
+  @Transform.Decorators.Property()
+  price!: number;
+
+  @Transform.Decorators.Property()
+  description!: string;
+
+  @Transform.Decorators.Property()
+  @Transform.Decorators.Type(String)
+  images!: string[];
+
+  @Transform.Decorators.Property()
+  @Transform.Decorators.Type(CategoryData)
+  category!: CategoryData;
+
+  @Transform.Decorators.Property()
+  creationAt!: string;
+
+  @Transform.Decorators.Property()
+  updatedAt!: string;
+}
+
+// export type ProductListQuery = {
+//   title?: string;
+//   price?: number;
+//   price_min?: number;
+//   price_max?: number;
+//   categoryId?: number;
+// };
+
+export class ProductListQuery extends Transform.WithTransform {
+  @Transform.Decorators.Property()
+  @Transform.Decorators.Modify(value => value?.trim())
+  title?: string;
+
+  @Transform.Decorators.Property()
+  price?: number;
+
+  @Transform.Decorators.Property()
+  price_min?: number;
+
+  @Transform.Decorators.Property()
+  price_max?: number;
+
+  @Transform.Decorators.Property()
+  categoryId?: number;
+}
+
+export class ProductListQueryParams extends Transform.WithTransform {
+  @Transform.Decorators.Property()
+  offset?: number;
+
+  @Transform.Decorators.Property()
+  limit?: number;
+
+  @Transform.Decorators.Property()
+  title?: string;
+
+  @Transform.Decorators.Property()
+  price?: number;
+
+  @Transform.Decorators.Property()
+  price_min?: number;
+
+  @Transform.Decorators.Property()
+  price_max?: number;
+
+  @Transform.Decorators.Property()
+  categoryId?: number;
+
+  toQueryParams(): Record<string, string> {
+    const params: Record<string, string> = {};
+    if (this.offset !== undefined) params.offset = String(this.offset);
+    if (this.limit !== undefined) params.limit = String(this.limit);
+    if (this.title) params.title = this.title;
+    if (this.price !== undefined) params.price = String(this.price);
+    if (this.price_min !== undefined) params.price_min = String(this.price_min);
+    if (this.price_max !== undefined) params.price_max = String(this.price_max);
+    if (this.categoryId !== undefined) params.categoryId = String(this.categoryId);
+    return params;
+  }
+}
+
+export class ProductCreatePayload extends Transform.WithTransform {
+  @Transform.Decorators.Property()
+  title!: string;
+
+  @Transform.Decorators.Property()
+  @Transform.Decorators.Modify((v: unknown) => Number(v))
+  price!: number;
+
+  @Transform.Decorators.Property()
+  description!: string;
+
+  @Transform.Decorators.Property()
+  @Transform.Decorators.Modify((v: unknown) => Number(v))
+  categoryId!: number;
+
+  @Transform.Decorators.Property()
+  images!: string[];
+}
+
+export class ProductUpdatePayload extends ProductCreatePayload {
+  @Transform.Decorators.Property()
+  @Transform.Decorators.Modify((v: unknown) => Number(v))
+  id!: number;
+}