fimo 0.9.0 → 0.10.0-experimental.1

package/assets/content-templates/types-template.eta

@@ -48,9 +48,9 @@ export interface <%= model.pascal %> extends WithReferences<<%= model.pascal %>R
 // Generate interface properties based on fields
 if (model.fields) {
   Object.entries(model.fields).forEach(([key, field]) => {
-    const type = getTypeForField(field);
+    const type = isNullableRichTextField(field) ? `${getTypeForField(field)} | null` : getTypeForField(field);
 -%>
-  <%= key %>: <%= type %>;
+  <%= key %><%= isOptionalOutputField(field) ? '?' : '' %>: <%= type %>;
 <%
   });
 }
@@ -68,7 +68,9 @@ export interface <%= model.pascal %>Input {
 <%
 if (model.fields) {
   Object.entries(model.fields).forEach(([key, field]) => {
-    const type = getInputTypeForField(field);
+    const type = isNullableRichTextField(field)
+      ? `${getInputTypeForField(field)} | null`
+      : getInputTypeForField(field);
 -%>
   <%= key %><%= isRequiredField(field) ? '' : '?' %>: <%= type %>;
 <%
@@ -85,6 +87,7 @@ if (model.fields) {
 function getTypeForField(field) {
   switch(field.type) {
     case 'string':
+      return getStringLiteralUnion(field) || 'FimoString';
     case 'text':
       return 'FimoString';
     case 'richtext':
@@ -113,6 +116,7 @@ function getTypeForField(field) {
 function getInputTypeForField(field) {
   switch(field.type) {
     case 'string':
+      return getStringLiteralUnion(field) || 'string';
     case 'text':
       return 'string';
     case 'richtext':
@@ -143,6 +147,7 @@ function getInputTypeForField(field) {
 function getNestedFieldType(field, input) {
   switch(field.type) {
     case 'string':
+      return getStringLiteralUnion(field) || 'string';
     case 'text':
       return 'string';
     case 'richtext':
@@ -195,9 +200,31 @@ function getBlocksType(field, input) {
   return `${item}[]`;
 }
 
+function getStringLiteralUnion(field) {
+  if (!Array.isArray(field.options) || field.options.length === 0) {
+    return null;
+  }
+  return field.options.map((option) => JSON.stringify(String(option))).join(' | ');
+}
+
 function isRequiredField(field) {
+  if (isConditionalField(field)) {
+    return false;
+  }
   return Boolean(field.required || (field.type === 'blocks' && Number(field.min || 0) > 0));
 }
+
+function isNullableRichTextField(field) {
+  return field.type === 'richtext' && !isRequiredField(field);
+}
+
+function isOptionalOutputField(field) {
+  return isConditionalField(field) || isNullableRichTextField(field);
+}
+
+function isConditionalField(field) {
+  return field.showIf !== undefined || field.showIfAny !== undefined;
+}
 -%>
 
 export interface <%= model.pascal %>References {

package/assets/skills/fimo-cli/references/content.md

@@ -94,9 +94,46 @@ fimo entries query --file query.sql
 cat query.sql | fimo entries query --stdin
 ```
 
-SQL exposes the raw internal representation. `document_id` is the stable ID used by `fimo entries`, content tools, references, and the API. `id` is the internal ID of one exact locale variant. When query results will feed another Fimo command or tool, select `document_id AS id`; use `locale` to select a variant.
+SQL exposes the raw internal representation. `document_id` is the stable ID used by `fimo entries`, content tools, references, and the API. `id` is the internal ID of one exact locale variant. Localized variants share one `document_id` and have one row per locale; non-localized entries have a null `locale`. When query results will feed another Fimo command or tool, select `document_id AS id`; use `locale` to select a variant.
+
+The supported content columns are `id`, `document_id`, `content_type`, `locale`, `slug`, `data`, `created_at`, and `updated_at`. Schema fields live inside the JSONB `data` column. Fimo may add internal columns, so select the fields you need instead of `SELECT *` and do not depend on other columns. If a safe read is blocked because a SQL function is unavailable, tell the user which function is missing and use the built-in `supportReport` tool when the platform gap materially blocks the task. Do not bypass the restriction with a write.
+
+For example, find English blog posts that do not yet have a Spanish variant:
+
+```sql
+SELECT source.document_id AS id, source.data
+FROM entries source
+WHERE source.content_type = 'BlogPost'
+  AND source.locale = 'en'
+  AND NOT EXISTS (
+    SELECT 1
+    FROM entries target
+    WHERE target.content_type = source.content_type
+      AND target.document_id = source.document_id
+      AND target.locale = 'es'
+  )
+```
+
+Find Spanish variants whose English source was edited later:
+
+```sql
+SELECT
+  target.document_id AS id,
+  target.content_type,
+  target.slug,
+  source.updated_at AS source_updated_at,
+  target.updated_at AS target_updated_at
+FROM entries source
+JOIN entries target
+  ON target.content_type = source.content_type
+  AND target.document_id = source.document_id
+WHERE source.locale = 'en'
+  AND target.locale = 'es'
+  AND source.updated_at > target.updated_at
+ORDER BY source.updated_at DESC
+```
 
-The available columns are `id`, `document_id`, `content_type`, `locale`, `slug`, `data`, `created_at`, and `updated_at`. Schema fields live inside the JSONB `data` column. If a safe read is blocked because a SQL function is unavailable, tell the user which function is missing and use the built-in `supportReport` tool when the platform gap materially blocks the task. Do not bypass the restriction with a write.
+Treat these results as possibly stale, not proof of a bad translation. The query only proves that the source row was edited later; an agent should review the content and link each target with its stable `id`.
 
 ### Bulk mutations
 

package/assets/skills/fimo-cli/references/webhooks.md

@@ -24,6 +24,10 @@ Run this before writing a custom payload. The list shows supported event types,
 - Analytics: `analytics.report_ready`
 - Media: uploaded/updated/deleted/generated/processing_failed
 - Entries: `entry.changed`
+- Domains: `domain.created`, `domain.deleted`
+- Labels: `label.changed`
+- Locales: `locale.created`, `locale.default_changed`, `locale.deleted`
+- Environments: `environment.created`, `environment.deleted`, `environment.merged`, `environment.restored`
 
 Do not guess variable paths. The common envelope is:
 

package/assets/skills/fimo-code/references/content.md

@@ -61,6 +61,48 @@ something else (e.g. `handle`, `permalink`).
 
 A `date` field currently generates as `any` in the TS client, so for typed access (and the `<Date>` component) prefer a `string` field holding an ISO date — which is what the `publishDate` examples below do.
 
+## Enumerated strings
+
+A `string` field may declare `options` to close its value set. The CMS renders a select, the API validates the value as an enum, and the generated client types the field as a literal union instead of `string`.
+
+```json
+"layout": { "type": "string", "options": ["article", "video"], "default": "article" }
+```
+
+- Values must be unique. Set a `default` that is one of them.
+- `options` cannot be combined with `regex`, `minLength`, or `maxLength`, and is rejected on every field type other than `string`.
+- Writes are validated against the set: a value outside it is rejected with a 400. An optional field also accepts `""` and `null` so the editor can clear the choice; a `required` one only accepts a declared value.
+- Removing an option that entries still hold fails the push, the same way an unsafe type change does. Migrate those entries to a remaining value first.
+
+## Conditional fields
+
+A field may declare `showIf` (every clause must match) or `showIfAny` (one clause is enough) to apply only in some entries. A clause names a sibling field and a value.
+
+```json
+{
+  "layout": { "type": "string", "options": ["article", "video"], "default": "article" },
+  "body": { "type": "richtext", "showIf": { "field": "layout", "equals": "article" } },
+  "videoUrl": { "type": "string", "required": true, "showIf": { "field": "layout", "equals": "video" } },
+  "transcript": {
+    "type": "text",
+    "showIfAny": [
+      { "field": "layout", "equals": "video" },
+      { "field": "hasAudio", "equals": true }
+    ]
+  }
+}
+```
+
+- A clause is `{ "field": "<sibling>", "equals": <value> }` or `{ "field": "<sibling>", "in": [<values>] }`. Use `in` for several values of one field.
+- `showIf` accepts one clause or an array of clauses, and every clause must match. `showIfAny` takes an array and one match is enough. A field declares one key or the other, never both.
+- **A hidden field is not rendered and not validated, so `required` does not apply to it.** An entry whose condition never held can be saved without ever filling the field.
+- **Hiding a field changes nothing about storage or reads.** The value stays in the entry and the API keeps returning it, so an editor who flips the trigger back gets their work back. Narrow on the trigger in site code rather than trusting the value.
+- Because a conditional field can be absent, it is always optional in the generated types even when `required` is set.
+- Conditions resolve against siblings in the same object. A field inside a block variant may only reference fields in that same block item.
+- A clause may reference a `boolean`, `number`, or `string` field. A `string` trigger must declare `options`, which is what lets `fimo validate` reject a clause value that could never match.
+- A trigger cannot itself be conditional — conditions are one level deep, so a chain like A shows B shows C is rejected.
+- `fimo validate` and `fimo schemas push` reject an unknown trigger name, a trigger of the wrong type, a value outside the trigger's `options`, and a trigger that is itself conditional.
+
 ## Blocks
 
 `blocks` is the only nested structured-content type and always stores an array. Use `schema.fields` for one homogeneous block shape. Set `max: 1` when the field is a single optional group. Use `schema.oneOf` when editors choose a variant for each item.
@@ -272,7 +314,7 @@ interface BlogPost {
   };
   title: FimoString;
   summary: FimoString;
-  body: FimoRichText;
+  body?: FimoRichText | null;
   coverImage: FimoMedia;
   publishDate: FimoString;
   featured: FimoBoolean;
@@ -282,6 +324,8 @@ interface BlogPost {
 
 Content fields live at the top level. Fimo-owned metadata that is not part of the user schema lives under `__fimo`, so a schema can safely define fields named `contentType`.
 
+Optional richtext fields are nullable in generated read and write types. `<RichText>` accepts the generated value directly and renders nothing when it is null or undefined. A non-conditional required richtext field stays non-null; conditional fields remain optional because their condition may not apply.
+
 ## Localized and shared content
 
 Localized content has one variant per locale. Generated hooks read the active Fimo locale automatically.

package/assets/skills/fimo-studio/references/cms.md

@@ -36,6 +36,17 @@ When you open a Collection, the entry list provides several tools:
 - **Columns** dropdown (the eye button) next to the search bar to show/hide columns and reorder them by dragging each column row by its grip handle.
 - **Pagination** at the bottom when there are many entries.
 
+## Completing Missing Translations
+
+Localized Collections show only entries for the locale selected beside the Collection name. When that locale is missing translations that exist in the project's default locale:
+
+1. Click the amber **N missing** warning beside the locale selector.
+2. Review the source and target languages in the popover.
+3. Choose **Create missing translations**.
+4. Review or edit the prompt placed in AI chat, then send it when ready.
+
+Fimo does not send the prompt automatically. After the AI finishes, translated entries appear in the selected locale and the warning updates.
+
 ## Creating a New Entry
 
 1. Navigate to the Collection you want to add content to.

package/assets/skills/fimo-studio/references/webhooks.md

@@ -15,7 +15,7 @@ Only project members with Full Access can see Webhooks in Settings or manage its
 5. Optionally narrow form, agent, media, or entry events with the filter shown for that event.
 6. Review the request and select **Save**.
 
-The event groups are Entries, Forms, Publish, Agents, Analytics, and Media. Webhooks belong to the project, with up to 20 configurations. They listen to main by default or can include every environment.
+The event groups are Entries, Forms, Publish, Agents, Analytics, Media, Domains, Labels, Locales, and Environments. Webhooks belong to the project, with up to 20 configurations. They listen to main by default or can include every environment.
 
 Entry webhooks show **Combine rapid changes**. The default waits 5 seconds after direct editing stops and sends one delivery with the combined changes. Immediate, 30-second, and 1-minute windows are also available. Bulk edits and environment merges already produce batches and send immediately.
 

package/dist/cli/bundle.json

@@ -1,7 +1,7 @@
 {
   "bundled": true,
   "bundler": "esbuild",
-  "bundledAt": "2026-07-24T11:14:53.290Z",
+  "bundledAt": "2026-07-26T16:18:23.038Z",
   "cliVersion": "0.9.0",
   "external": [
     "oxc-parser",