@thinhnguyencth1204/nextcli 0.7.0 → 0.8.0

package/README.md

@@ -32,9 +32,18 @@ This command is fully interactive:
 - normalizes project directory name into a safe project slug for generated `package.json` and env placeholders
 - ships `SETUP.md` and `PROJECT_STRUCTURE.md` in the generated project root
 
-**Default output is minimal:** Next.js shell, branding, theme, and UI primitives only. Database, auth, dashboard, and other stacks are added only when selected.
+**Default output is minimal:** Next.js shell, branding, theme, UI primitives, and Lexical rich text adapters only. Database, auth, dashboard, and other stacks are added only when selected.
 
-## Optional modules
+## Rich text (base)
+
+All generated projects include Lexical rich text building blocks:
+
+- `EditorField` — swappable `textarea` or `lexical` adapter for forms
+- `RichTextRenderer` — read-only playback of Lexical JSON from API data
+- Toolbar: bold/italic/underline, emoji picker, image URL insertion
+- Demo page: `/blog-demo`
+
+Lexical content is stored as JSON (`SerializedEditorState`). With the `supabase` module, removed Supabase-managed image URLs trigger storage cleanup via `syncRemovedSupabaseRichTextImages`.
 
 Available during `create` and `add module`:
 
@@ -174,6 +183,7 @@ Optional flags:
 - shadcn-style shared UI folder (base)
 - Zod validation (base)
 - Sonner notifications (base)
+- Lexical rich text editor + renderer (base)
 - Optional: chat, supabase-realtime, seo, email
 
 ## Template structure

package/dist/cli.js

@@ -811,7 +811,7 @@ import { readdir as readdir3, readFile as readFile6, writeFile as writeFile6 } f
 import path7 from "path";
 import { readdir as readdir2, readFile as readFile5, writeFile as writeFile5 } from "fs/promises";
 var defaultManifest = {
-  cli: "0.7.0",
+  cli: "0.8.0",
   defaultLocale: "vi",
   locales: [],
   namespaces: [],
@@ -2113,7 +2113,7 @@ function registerAddCommand(program2) {
 // src/commands/create.ts
 import { spawn as spawn2 } from "child_process";
 import path11 from "path";
-var CLI_VERSION = "0.7.0";
+var CLI_VERSION = "0.8.0";
 async function runInstall(packageManager, cwd) {
   const installArgsMap = {
     npm: ["install"],
@@ -2494,7 +2494,7 @@ var NexTCLICommand = class _NexTCLICommand extends Command {
 
 // src/cli.ts
 var program = new NexTCLICommand();
-program.name("nextcli").description("Scaffold outsource-ready Next.js projects").version("0.7.0");
+program.name("nextcli").description("Scaffold outsource-ready Next.js projects").version("0.8.0");
 registerCreateCommand(program);
 registerAddCommand(program);
 registerMigrateCommand(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinhnguyencth1204/nextcli",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "CLI scaffolder for outsourced Next.js projects",
   "type": "module",
   "bin": {
@@ -15,8 +15,9 @@
     "build": "tsup",
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",
-    "test": "bun test src/core/add-feature.test.ts",
-    "test:add-feature": "bun run build && bun test src/core/add-feature.test.ts",
+    "test": "bun test tests",
+    "test:add-feature": "bun run build && bun test tests/core",
+    "test:rich-text": "bun test tests/templates/next-base",
     "smoke": "node dist/cli.js --help",
     "smoke:full": "bun run build && bun run test && bun run scripts/pre-publish-smoke.ts",
     "prepublishOnly": "npm run build"
@@ -40,6 +41,7 @@
   },
   "devDependencies": {
     "@types/node": "^22.15.29",
+    "lexical": "^0.45.0",
     "tsup": "^8.1.0",
     "typescript": "^5.5.4"
   }

package/templates/features/supabase/src/lib/supabase/rich-text-image-sync.ts

@@ -0,0 +1,28 @@
+import { removeResource } from "@/lib/supabase/storage";
+import {
+  isSupabaseManagedImageUrl,
+  syncRemovedRichTextImages,
+  type RemoveManagedImageFn,
+} from "@/lib/rich-text";
+import type { SerializedEditorState } from "lexical";
+
+export const removeSupabaseManagedImage: RemoveManagedImageFn = async (
+  _url,
+  ref,
+) => {
+  await removeResource(ref.path, ref.bucket);
+};
+
+/**
+ * Deletes Supabase storage objects for images removed from rich text content.
+ * Only URLs belonging to this project's configured Supabase bucket are removed.
+ */
+export async function syncRemovedSupabaseRichTextImages(
+  previous: SerializedEditorState | null | undefined,
+  next: SerializedEditorState | null | undefined,
+) {
+  return syncRemovedRichTextImages(previous, next, {
+    isManagedUrl: isSupabaseManagedImageUrl,
+    removeManagedImage: removeSupabaseManagedImage,
+  });
+}

package/templates/next-base/PROJECT_STRUCTURE.md

@@ -17,6 +17,7 @@ Generated by NexTCLI. Folders marked **(module)** appear only when that add-on i
 | ------------- | --------------------------------------- |
 | `layout.tsx`  | Root layout, metadata from `branding`   |
 | `page.tsx`    | Welcome landing page                    |
+| `blog-demo/`  | Rich text create/edit/read demo         |
 | `globals.css` | Design tokens (`nextcli:theme` markers) |
 
 ## `src/config/`
@@ -27,27 +28,37 @@ Generated by NexTCLI. Folders marked **(module)** appear only when that add-on i
 
 ## `src/components/`
 
-| Path                | Purpose                 |
-| ------------------- | ----------------------- |
-| `branding/logo.tsx` | Logo + project name     |
-| `ui/`               | shadcn-style primitives |
-| `providers/`        | Theme provider          |
+| Path                | Purpose                                 |
+| ------------------- | --------------------------------------- |
+| `branding/logo.tsx` | Logo + project name                     |
+| `rich-text/`        | Lexical editor adapters, renderer, demo |
+| `ui/`               | shadcn-style primitives                 |
+| `providers/`        | Theme provider                          |
+
+## `src/lib/rich-text/` (base)
+
+| Path                       | Purpose                                              |
+| -------------------------- | ---------------------------------------------------- |
+| `image-urls.ts`            | Extract image URLs from Lexical JSON                 |
+| `supabase-url.ts`          | Map Supabase public URLs to storage paths            |
+| `sync-removed-images.ts`   | Lifecycle helper for removed images                  |
+| `default-image-removal.ts` | No-op remover (swap when `supabase` module is added) |
 
 ## Optional modules (via `nextcli add module`)
 
-| Module              | Adds                                                         |
-| ------------------- | ------------------------------------------------------------ |
-| `database`          | Prisma schema, client, `DATABASE_URL`, db scripts            |
-| `supabase`          | Supabase browser client + Storage helpers                    |
-| `auth`              | Better Auth, sign-in pages, user APIs, bootstrap admin       |
-| `api`               | Axios client, API envelope helpers, React Query provider     |
-| `i18n`              | next-intl config, messages, locale switcher                  |
-| `dashboard`         | Protected dashboard shell, sidebar, data-table UI            |
-| `example`           | Starter CRUD demo feature + `Example` Prisma model           |
-| `chat`              | Chat routes, hooks, Prisma chat models (+ auto deps)         |
-| `supabase-realtime` | Realtime channel helpers (+ auto `supabase`)                 |
-| `seo`               | robots/sitemap/JSON-LD helpers                               |
-| `email`             | `src/lib/email/*`, `src/emails/*` (provider: SMTP or Resend) |
+| Module              | Adds                                                                  |
+| ------------------- | --------------------------------------------------------------------- |
+| `database`          | Prisma schema, client, `DATABASE_URL`, db scripts                     |
+| `supabase`          | Supabase browser client + Storage helpers + `rich-text-image-sync.ts` |
+| `auth`              | Better Auth, sign-in pages, user APIs, bootstrap admin                |
+| `api`               | Axios client, API envelope helpers, React Query provider              |
+| `i18n`              | next-intl config, messages, locale switcher                           |
+| `dashboard`         | Protected dashboard shell, sidebar, data-table UI                     |
+| `example`           | Starter CRUD demo feature + `Example` Prisma model                    |
+| `chat`              | Chat routes, hooks, Prisma chat models (+ auto deps)                  |
+| `supabase-realtime` | Realtime channel helpers (+ auto `supabase`)                          |
+| `seo`               | robots/sitemap/JSON-LD helpers                                        |
+| `email`             | `src/lib/email/*`, `src/emails/*` (provider: SMTP or Resend)          |
 
 Module **env variables** and where to find them: see `SETUP.md` → **Optional module environment**.