@plutocms/pluto 0.9.1 → 0.11.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@plutocms/pluto",
   "type": "module",
-  "version": "0.9.1",
+  "version": "0.11.0",
   "description": "The layerable CMS",
   "author": "Victor Ribeiro",
   "license": "MIT",
@@ -42,31 +42,31 @@
     "vue-demi"
   ],
   "dependencies": {
-    "@iconify-json/lucide": "^1.2.116",
-    "@iconify-json/simple-icons": "^1.2.89",
-    "@internationalized/date": "^3.12.2",
-    "@nuxt/eslint": "^1.16.0",
-    "@nuxt/ui": "^4.9.0",
+    "@iconify-json/lucide": "^1.2.144",
+    "@iconify-json/simple-icons": "^1.2.100",
+    "@internationalized/date": "^3.12.4",
+    "@nuxt/eslint": "^1.17.0",
+    "@nuxt/ui": "^4.12.0",
     "@plutocms/utils": "^0.2.1",
-    "@vueuse/nuxt": "^14.3.0",
-    "reka-ui": "^2.10.1",
-    "tailwind-merge": "^3.6.0"
+    "@vueuse/nuxt": "^14.4.0",
+    "reka-ui": "^2.11.0",
+    "tailwind-merge": "^3.7.0"
   },
   "devDependencies": {
-    "@antfu/eslint-config": "^9.1.0",
-    "@tailwindcss/vite": "^4.2.1",
-    "@types/bun": "^1.3.14",
-    "eslint": "^10.6.0",
-    "mysql2": "^3.22.6",
-    "nuxt": "^4.3.1",
-    "prettier": "^3.9.4",
-    "prettier-plugin-tailwindcss": "^0.8.0",
-    "tailwindcss": "^4.3.2",
+    "@antfu/eslint-config": "^9.5.1",
+    "@tailwindcss/vite": "^4.3.3",
+    "@types/bun": "^1.4.3",
+    "eslint": "^10.12.0",
+    "mysql2": "^3.24.6",
+    "nuxt": "^4.6.1",
+    "prettier": "^3.9.10",
+    "prettier-plugin-tailwindcss": "^0.8.1",
+    "tailwindcss": "^4.3.3",
     "typescript": "6.0.3",
-    "vitest": "^5.0.0",
-    "vue": "^3.5.39",
-    "vue-router": "^5.1.0",
-    "vue-tsc": "^3.3.7"
+    "vitest": "^5.0.5",
+    "vue": "^3.5.44",
+    "vue-router": "^5.4.0",
+    "vue-tsc": "^3.3.13"
   },
   "overrides": {
     "eslint-flat-config-utils": "^3.2.0"

package/shared/types/content.ts

@@ -25,6 +25,8 @@ export interface PlutoFieldBase {
   description?: string
   /** Storage column, when it differs from `name`. Falls back to `name` when unset. */
   column?: string
+  /** This field has no storage column. Its value never reaches `mapFieldsToColumns`'s output, but still passes through validation and the generic form payload — letting a `hooks.afterCreate`/`afterUpdate` read it from `rawBody` without a matching database column. */
+  virtual?: boolean
   required?: boolean
   /** Show this field as a column in the generic list view. Default false. */
   inList?: boolean
@@ -108,6 +110,8 @@ export interface PlutoContentTypeCapabilities {
   read?: string
   write?: string
   delete?: string
+  /** Capability required to publish. Falls back to `write` when unset. */
+  publish?: string
 }
 
 export interface PlutoContentStatus {
@@ -207,6 +211,17 @@ export interface PlutoContentType {
   editPath?: (id: string | number) => string
   navOrder?: number
   i18n?: PlutoContentI18n
+  /** Layout options for the generic content form (a later wave). */
+  form?: {
+    /** 'default' = heading + container. 'focus' = minimal chrome for a writing surface. */
+    layout?: 'default' | 'focus'
+    /** true = always show. false = never. 'auto' (default) = show when any field has region 'side'. */
+    aside?: boolean | 'auto'
+    /** Aside starts closed. Default false, or true when layout is 'focus'. */
+    asideCollapsed?: boolean
+    /** Drop the max-width container in the main region. Default false, or true when layout is 'focus'. */
+    width?: 'container' | 'full'
+  }
   /**
    * Server-only lifecycle hooks, run by the generic write handlers
    * (`server/utils/pluto-content-handlers.ts`) after the adapter call

package/shared/types/registry.ts

@@ -113,6 +113,34 @@ export interface PlutoMediaAdapterEntry extends PlutoEntry {
   adapter: PlutoMediaAdapter
 }
 
+/** State passed to a `PlutoContentAction`'s `show` test and `onSelect` handler. */
+export interface PlutoContentActionContext {
+  type: PlutoContentType
+  item: Record<string, unknown>
+  editing: boolean
+  saving: boolean
+  save: () => Promise<void>
+  remove: () => Promise<void>
+}
+
+/**
+ * A button a layer adds to the generic content form (a later wave). Matched
+ * against a content type the same way `PlutoContentFieldWidget` matches a
+ * field: by exact name, or by `'*'` for every content type.
+ */
+export interface PlutoContentAction extends PlutoEntry {
+  /** Content type `name`, or '*' for every content type. */
+  contentType: string | '*'
+  label: string
+  icon?: string
+  color?: string
+  variant?: string
+  /** Where the action renders. Default 'toolbar'. */
+  placement?: 'toolbar' | 'aside'
+  show?: (ctx: PlutoContentActionContext) => boolean
+  onSelect: (ctx: PlutoContentActionContext) => void | Promise<void>
+}
+
 export interface PlutoExtension {
   /** Layer name. Use the package's $meta.name, e.g. 'supabase-blog'. */
   id: string
@@ -127,6 +155,7 @@ export interface PlutoExtension {
   permissionsDriver?: PlutoPermissionsDriver
   contentTypes?: PlutoContentTypeEntry[]
   contentFieldWidgets?: PlutoContentFieldWidget[]
+  contentActions?: PlutoContentAction[]
   mediaAdapters?: PlutoMediaAdapterEntry[]
 }
 
@@ -154,5 +183,6 @@ export interface PlutoRegistry {
   permissionsDrivers: PlutoRegistryBucket<PlutoPermissionsDriver>
   contentTypes: PlutoRegistryBucket<PlutoContentTypeEntry>
   contentFieldWidgets: PlutoRegistryBucket<PlutoContentFieldWidget>
+  contentActions: PlutoRegistryBucket<PlutoContentAction>
   mediaAdapters: PlutoRegistryBucket<PlutoMediaAdapterEntry>
 }

package/shared/utils/content-map.ts

@@ -11,6 +11,9 @@ export function fieldColumn(field: PlutoField): string {
  * left out of the result, so a partial update payload stays partial after
  * mapping. An adapter (a later wave) sends the result straight to its
  * storage layer.
+ *
+ * A field with `virtual: true` never appears in the result, even when
+ * `payload` has a value for it — it has no storage column by design.
  */
 export function mapFieldsToColumns(
   type: PlutoContentType,
@@ -19,6 +22,9 @@ export function mapFieldsToColumns(
   const columns: Record<string, unknown> = {}
 
   for (const field of type.fields) {
+    if (field.virtual) {
+      continue
+    }
     if (Object.hasOwn(payload, field.name)) {
       columns[fieldColumn(field)] = payload[field.name]
     }
@@ -32,6 +38,19 @@ export function mapFieldsToColumns(
  * every field in `type.fields`, plus the primary key column (`type.primaryKey`,
  * default `'id'`) mapped to `item.id`. A column absent from `row` is left
  * out of the result field.
+ *
+ * A field with `virtual: true` is skipped, for symmetry with
+ * `mapFieldsToColumns` — it has no column to read back from `row` in the
+ * first place, so this only guards against a stray column that happens to
+ * share the field's name.
+ *
+ * When `type.status` is set, this also maps the status column
+ * (`type.status.column`, default `'status'`) to `item.status`, unless a
+ * declared field already set `item.status` above. This mirrors the write
+ * side: `@plutocms/supabase`'s `content-adapter.ts` already writes the
+ * status column for a content type with workflow enabled, even when no
+ * field named `status` is declared. Without this, a generic list/form
+ * read back a row with no `status` key at all.
  */
 export function mapColumnsToFields(
   type: PlutoContentType,
@@ -41,11 +60,21 @@ export function mapColumnsToFields(
   const item: Record<string, unknown> = { id: row[primaryKey] }
 
   for (const field of type.fields) {
+    if (field.virtual) {
+      continue
+    }
     const column = fieldColumn(field)
     if (Object.hasOwn(row, column)) {
       item[field.name] = row[column]
     }
   }
 
+  if (type.status) {
+    const statusColumn = type.status.column ?? 'status'
+    if (!Object.hasOwn(item, 'status') && Object.hasOwn(row, statusColumn)) {
+      item.status = row[statusColumn]
+    }
+  }
+
   return item as PlutoContentItem
 }