@donotdev/cli 0.0.7 → 0.0.8

package/dist/index.js

@@ -897,6 +897,7 @@ __export(cli_output_exports, {
   success: () => success,
   warn: () => warn
 });
+import "node:os";
 function supportsColor() {
   if (process.env.NO_COLOR) return false;
   if (process.platform === "win32") {
@@ -6730,7 +6731,16 @@ var init_constants = __esm({
       },
       i18n: {
         eager: ["src/locales/*_*.json"],
-        lazy: ["src/**/locales/*_*.json", "!src/locales/*_*.json"],
+        lazy: [
+          "src/**/locales/*_*.json",
+          "!src/locales/*_*.json",
+          // Auto-detect shared entity translations in monorepos (if exists, use it; if not, no problem)
+          "../../entities/locales/*_*.json"
+        ],
+        // Additional paths from workspace packages (e.g., shared entities)
+        // Consumers can still configure via i18n.additionalPaths in dndev/vite config for custom paths
+        // Example: ['../../packages/shared/locales/*_*.json']
+        additional: [],
         framework: {
           eager: [`${I18N_PATHS.SOURCE_EAGER}/*_*.json`],
           lazy: [`${I18N_PATHS.SOURCE_LAZY}/*_*.json`]
@@ -6823,6 +6833,7 @@ var init_constants = __esm({
 
 // packages/core/config/utils/PathResolver.ts
 import * as fs from "node:fs";
+import "node:fs";
 import { createRequire } from "node:module";
 import {
   resolve,
@@ -8290,6 +8301,7 @@ var init_pathResolver = __esm({
 
 // packages/tooling/src/bundler/utils.ts
 import { Buffer as Buffer2 } from "node:buffer";
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2 } from "node:fs";
 import { createRequire as createRequire3 } from "node:module";
 import { dirname as dirname3, resolve as resolve3 } from "node:path";
 import process from "node:process";
@@ -11250,6 +11262,23 @@ function generatePackageJson(templateName, mode, options = {}) {
       }
     }
   }
+  if (mode === "published") {
+    const overrides = {};
+    for (const [groupName, group] of Object.entries(matrix.groups || {})) {
+      if (groupName.startsWith("@donotdev/")) {
+        const version = group.packages?.[groupName];
+        if (version) {
+          overrides[groupName] = version.replace(/^\^/, "");
+        }
+      }
+    }
+    if (matrix.overrides) {
+      Object.assign(overrides, matrix.overrides);
+    }
+    if (Object.keys(overrides).length > 0) {
+      result.overrides = overrides;
+    }
+  }
   return result;
 }
 
@@ -12006,7 +12035,7 @@ init_cli_output();
 init_errors();
 init_pathResolver();
 import { spawnSync as spawnSync9 } from "node:child_process";
-import { EOL } from "node:os";
+import { EOL as EOL2 } from "node:os";
 async function main9(options = {}) {
   const dryRun = options.dryRun ?? false;
   const verbose = options.verbose ?? false;
@@ -12124,7 +12153,7 @@ async function addPathComments(files, rootDir, dryRun, verbose) {
       let modified = false;
       if (contentLines.length === 0) {
         if (!dryRun) {
-          writeSync(file, `${expectedPathComment}${EOL}`, {
+          writeSync(file, `${expectedPathComment}${EOL2}`, {
             overwrite: true
           });
         }
@@ -12249,7 +12278,7 @@ async function addPathComments(files, rootDir, dryRun, verbose) {
           newLines.push("");
         }
         newLines.push(...contentLines);
-        const newContent = newLines.join(EOL);
+        const newContent = newLines.join(EOL2);
         const contentChanged = fileContent !== newContent;
         if (contentChanged) {
           try {
@@ -12576,69 +12605,6 @@ ${stderr}` : "");
   }
 }
 
-// packages/tooling/src/quality/lint.ts
-init_utils();
-init_cli_output();
-init_errors();
-init_pathResolver();
-import { spawnSync as spawnSync10 } from "node:child_process";
-async function main10(options = {}) {
-  const fix = options.fix ?? false;
-  const cwd = process.cwd();
-  const eslintConfigs = [
-    "eslint.config.js",
-    "eslint.config.mjs",
-    "eslint.config.cjs"
-  ];
-  const hasEslintConfig = eslintConfigs.some(
-    (config) => pathExists(joinPath(cwd, config))
-  );
-  if (!hasEslintConfig) {
-    log.info("No eslint.config.js found in current directory. Skipping lint.");
-    log.info("To enable linting, create an eslint.config.js file.");
-    return 0;
-  }
-  const eslintArgs = fix ? ["--fix"] : [];
-  if (options.debug) {
-    eslintArgs.push("--debug");
-  }
-  if (options.quiet) {
-    eslintArgs.push("--quiet");
-  }
-  if (options.debug || options.verbose) {
-    log.debug(`Linting code${fix ? " and fixing issues" : ""}...`);
-    log.debug(`   Working directory: ${cwd}`);
-    log.debug(`   ESLint args: ${eslintArgs.join(" ")}`);
-  } else {
-    log.info(fix ? "Linting and fixing code..." : "Linting code...");
-  }
-  try {
-    const result = spawnSync10("bunx", ["eslint", ".", ...eslintArgs], {
-      cwd,
-      stdio: "inherit",
-      env: process.env,
-      shell: true
-    });
-    const exitCode = result.status ?? 1;
-    if (exitCode === 0) {
-      if (!options.debug && !options.verbose) {
-        log.success("Linting completed successfully");
-      }
-    } else {
-      if (!options.debug && !options.verbose) {
-        log.error("Linting found issues (see above for details)");
-      }
-    }
-    return exitCode;
-  } catch (err) {
-    throw DoNotDevError.from(
-      err,
-      "Failed to run ESLint",
-      "cli-execution-error"
-    );
-  }
-}
-
 // packages/tooling/src/maintenance/cacheout.ts
 init_utils();
 init_cli_output();
@@ -12765,7 +12731,7 @@ function removeItem(path, rootDir, dryRun, verbose) {
     return false;
   }
 }
-async function main11(options) {
+async function main10(options) {
   const opts = options;
   const targetDir = opts.app ? joinPath(process.cwd(), "apps", opts.app) : process.cwd();
   if (opts.app && !pathExists(targetDir)) {
@@ -12814,14 +12780,13 @@ async function main11(options) {
 }
 export {
   main as build,
-  main11 as cacheout,
+  main10 as cacheout,
   main7 as createApp,
   main8 as createProject,
   main5 as deploy,
   main2 as dev,
   main3 as emu,
   main9 as format,
-  main10 as lint,
   main4 as preview,
   main6 as syncSecrets
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAE5B;;;;;GAKG;AAEH,qFAAqF;AACrF,OAAO,EACL,SAAS,EACT,aAAa,EACb,MAAM,EACN,IAAI,EACJ,GAAG,EACH,KAAK,EACL,OAAO,EACP,GAAG,EACH,QAAQ,EACR,WAAW,EACX,MAAM,GACP,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAE5B;;;;;GAKG;AAEH,qFAAqF;AACrF,OAAO,EACL,SAAS,EACT,aAAa,EACb,MAAM,EACN,GAAG,EACH,KAAK,EACL,OAAO,EACP,GAAG,EACH,QAAQ,EACR,WAAW,EACX,MAAM,GACP,MAAM,mBAAmB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@donotdev/cli",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "Command-line interface for DoNotDev Framework",
   "type": "module",
   "private": false,

package/templates/root-consumer/entities/demo.ts.example

@@ -16,6 +16,7 @@ const demoEntity = defineEntity({
   name: 'Demo',
   collection: 'demos',
   // collection: 'users/{userId}/demos', // Subcollection syntax
+  // namespace: 'entity-demo', // Optional: defaults to entity-${name.toLowerCase()}
 
   listFields: ['title', 'status', 'category', 'price'],
   listCardFields: ['images', 'title', 'price'],
@@ -113,6 +114,19 @@ const demoEntity = defineEntity({
       validation: { required: false },
     },
 
+    year: {
+      name: 'year',
+      label: 'year',
+      type: 'year',                // Year combobox (type or select)
+      visibility: 'guest',
+      editable: 'owner',
+      validation: {
+        required: true,
+        min: 1900,                 // Optional: defaults to 1900
+        max: 2100,                 // Optional: defaults to current year + 10
+      },
+    },
+
     // =========================================================================
     // CONTACT
     // =========================================================================

package/templates/root-consumer/eslint.config.js.example

@@ -19,7 +19,8 @@ import react from 'eslint-plugin-react';
 import reactRefresh from 'eslint-plugin-react-refresh';
 import globals from 'globals';
 
-import customPlugin from '@donotdev/core/config/eslint';
+// ESLint is not provided by the framework - set up your own configuration
+// This is just a basic example template
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -106,7 +107,6 @@ export default [
       'jsx-a11y': jsxA11y,
       prettier: prettierPlugin,
       '@typescript-eslint': tsPlugin,
-      '@donotdev/config': customPlugin,
     },
     settings: {
       react: {
@@ -120,9 +120,6 @@ export default [
       },
     },
     rules: {
-      '@donotdev/config/no-singleton-lifecycle': 'error',
-      '@donotdev/config/react-19-ssr-safe': 'error',
-      '@donotdev/config/prefer-framework-utils': 'warn',
       'react/no-unstable-nested-components': 'error',
       'no-restricted-globals': [
         'error',
@@ -203,81 +200,6 @@ export default [
         'warn',
         { argsIgnorePattern: '^_', varsIgnorePattern: '^_' },
       ],
-      '@donotdev/config/require-use-client': [
-        'warn',
-        {
-          clientPatterns: [
-            'useState',
-            'useEffect',
-            'useCallback',
-            'useMemo',
-            'useRef',
-            'useContext',
-            'useReducer',
-            'useLayoutEffect',
-            'useImperativeHandle',
-            'useDebugValue',
-            'useId',
-            'useSyncExternalStore',
-            'useTransition',
-            'useDeferredValue',
-            'useInsertionEffect',
-            'onClick',
-            'onChange',
-            'onSubmit',
-            'onFocus',
-            'onBlur',
-            'onMouseEnter',
-            'onMouseLeave',
-            'onKeyDown',
-            'onKeyUp',
-            'onKeyPress',
-            'onScroll',
-            'onResize',
-            'onLoad',
-            'onError',
-            'window',
-            'document',
-            'localStorage',
-            'sessionStorage',
-            'navigator',
-            'location',
-            'history',
-            'addEventListener',
-            'removeEventListener',
-            'useAuth',
-            'useTranslation',
-            'useLocalStorage',
-            'useTheme',
-            'useRouter',
-            'usePathname',
-            'useSearchParams',
-            'framer-motion',
-            'lottie',
-            'gsap',
-            'shiki',
-          ],
-          filePatterns: ['**/*.{ts,tsx}'],
-          excludePatterns: [
-            '**/*.config.{js,ts}',
-            '**/*.d.ts',
-            '**/types/**',
-            '**/constants/**',
-            '**/utils/**',
-            '**/helpers/**',
-            '**/stores/**',
-            '**/api/**',
-            '**/functions/**',
-            '**/lib/**',
-            '**/server/**',
-            '**/middleware/**',
-            '**/edge/**',
-            '**/node_modules/**',
-            '**/dist/**',
-            '**/build/**',
-          ],
-        },
-      ],
       'import/no-named-export': 'off',
     },
   },

package/templates/root-consumer/guides/dndev/SETUP_CRUD.md.example

@@ -13,6 +13,7 @@ import { defineEntity } from '@donotdev/core';
 export const productEntity = defineEntity({
   name: 'Product',
   collection: 'products',
+  // namespace: 'entity-product', // Optional: defaults to entity-${name.toLowerCase()}
   fields: {
     name: {
       name: 'name',
@@ -135,23 +136,70 @@ export default function ProductPage() {
 
 ```tsx
 import { EntityList } from '@donotdev/crud';
+import { useAuth } from '@donotdev/auth';
+import { PageContainer, useNavigate } from '@donotdev/ui';
 import { productEntity } from 'entities';
 
 export default function ProductsPage() {
-  return <EntityList entity={productEntity} onRowClick={(p) => navigate(`/products/${p.id}`)} />;
+  const user = useAuth('user');
+  const navigate = useNavigate();
+
+  return (
+    <PageContainer>
+      <EntityList
+        entity={productEntity}
+        userRole={user?.role}
+        // Required: Edit handler - navigates to edit page when edit button clicked
+        onEdit={(id) => navigate(`/products/${id}`)}
+        // Optional: Create handler - navigates to create page when "Add New" clicked
+        onCreate={() => navigate('/products/new')}
+        // Optional: View handler - called when row is clicked
+        onView={(id) => navigate(`/products/${id}`)}
+      />
+    </PageContainer>
+  );
 }
 ```
 
+**Props:**
+- `onEdit` **(required)** - Function `(id: string) => void` called when edit button is clicked. Typically navigates to `/${collection}/${id}` (e.g., `/products/${id}`).
+- `onCreate` **(optional)** - Function `() => void` called when "Add New" button is clicked. Typically navigates to `/${collection}/new`.
+- `onView` **(optional)** - Function `(id: string) => void` called when a table row is clicked. Useful for view-only pages or detail navigation.
+- `userRole` **(optional)** - Current user role for field visibility filtering (backend still enforces security).
+
+**Routing Convention:**
+- Default edit route: `/${entity.collection}/${id}` (e.g., `/products/abc123`)
+- You must create a page at `/${collection}/:id` route to handle the edit page
+
 ### Card Grid
 
 ```tsx
 import { EntityCardList } from '@donotdev/crud';
+import { PageContainer, useNavigate } from '@donotdev/ui';
+import { productEntity } from 'entities';
 
 export default function ShopPage() {
-  return <EntityCardList entity={productEntity} />;
+  const navigate = useNavigate();
+
+  return (
+    <PageContainer>
+      <EntityCardList
+        entity={productEntity}
+        // Required: View handler - called when card is clicked
+        onView={(id) => navigate(`/products/${id}`)}
+      />
+    </PageContainer>
+  );
 }
 ```
 
+**Props:**
+- `onView` **(required)** - Function `(id: string) => void` called when a card is clicked. Typically navigates to `/${collection}/${id}` (e.g., `/products/${id}`).
+- `cols` **(optional)** - Responsive column breakpoints `[mobile, tablet, desktop, wide]` (default: `[1, 2, 3, 4]`).
+- `staleTime` **(optional)** - Cache stale time in milliseconds (default: 30 minutes).
+- `filter` **(optional)** - Filter function `(item: any) => boolean` to filter items client-side.
+- `hideFilters` **(optional)** - Hide filters section (default: `false`).
+
 ---
 
 ## 5. Field Types
@@ -169,6 +217,7 @@ export default function ShopPage() {
 ### Numbers
 - `number` - Numeric input
 - `range` - Slider input
+- `year` - Year input (combobox: type or select from dropdown)
 
 ### Boolean
 - `checkbox` - Checkbox input
@@ -226,14 +275,18 @@ category: {
 }
 ```
 
-### Year Dropdown
+### Year Field
 
-```typescript
-import { yearOptions } from '@donotdev/crud';
+Use `type: 'year'` for year inputs (combobox with type-or-select UX):
 
+```typescript
 year: {
-  type: 'select',
-  validation: { options: yearOptions(1990) } // 1990 to now, descending
+  type: 'year',
+  validation: { 
+    required: true,
+    min: 1900,  // Optional: defaults to 1900
+    max: 2100   // Optional: defaults to current year + 10
+  }
 }
 ```
 
@@ -447,9 +500,22 @@ export function CustomProductForm() {
 
 ## 9. i18n
 
-**Namespace:** `entity-${entity.name.toLowerCase()}`
+**Namespace:** Automatically set to `entity-${entity.name.toLowerCase()}` (e.g., `entity-product`)
+
+You can customize it by setting `namespace` in your entity definition:
+
+```typescript
+export const productEntity = defineEntity({
+  name: 'Product',
+  collection: 'products',
+  namespace: 'custom-namespace', // Optional: override default
+  fields: { ... }
+});
+```
+
+**Default behavior:** If not specified, the namespace is automatically set to `entity-${entity.name.toLowerCase()}`.
 
-**File:** `locales/entity-product_en.json`
+**Translation file:** `locales/entity-product_en.json` (or your custom namespace)
 ```json
 {
   "fields": {

package/templates/root-consumer/guides/dndev/SETUP_I18N.md.example

@@ -184,4 +184,50 @@ const { languages, currentLanguage } = useLanguageSelector();
 
 ---
 
+## Advanced: Shared Entity Translations (Monorepos)
+
+**Auto-detected:** The framework automatically scans `../../entities/locales/*_*.json` for shared entity translations. If the path exists, translations are loaded; if not, nothing happens.
+
+**File naming:** `entity-car_en.json`, `entity-car_fr.json`
+
+**Merge behavior:** Base translations from shared package, app can override any key. Deep merge, app wins.
+
+**Example structure:**
+```
+monorepo/
+  entities/
+    locales/
+      entity-car_en.json    # ✅ Auto-detected - no config needed
+      entity-car_fr.json
+  apps/
+    admin/                  # ✅ Just works - framework auto-detects
+    public/                 # ✅ Just works - framework auto-detects
+```
+
+**Custom paths:** If your shared translations are in a different location, use `additionalPaths`:
+
+**Vite:**
+```ts
+// vite.config.ts
+export default defineViteConfig({
+  appConfig,
+  i18n: {
+    additionalPaths: ['../../packages/shared/locales']  // Custom path
+  }
+})
+```
+
+**Next.js:**
+```ts
+// next.config.ts
+export default defineNextConfig({
+  appConfig,
+  i18n: {
+    additionalPaths: ['../../packages/shared/locales']  // Custom path
+  }
+})
+```
+
+---
+
 **Drop files, get languages. Framework handles the rest.**