zinkee 0.1.7 → 0.1.8

package/dist/index.js

@@ -1615,132 +1615,484 @@ var fieldTypeDefinitions = [
     className: "TextField",
     aliases: ["text", "TextField"],
     description: "Plain text field.",
-    rawShape: '{"type":"text","slug":"name","label":"Name"}',
-    examplePayload: {
-      type: "text",
-      slug: "name",
-      label: "Name"
-    }
+    rawShape: '{"type":"TextField","slug":"name","label":"Name","config":{"textType":"NORMAL"}}',
+    examplePayloads: [
+      {
+        name: "Text field (normal)",
+        payload: {
+          type: "TextField",
+          slug: "customer-name",
+          label: "Customer Name",
+          required: true,
+          config: {
+            textType: "NORMAL",
+            defaultValue: null,
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Text field (long)",
+        payload: {
+          type: "TextField",
+          slug: "customer-notes",
+          label: "Customer Notes",
+          required: false,
+          config: {
+            textType: "LONG",
+            defaultValue: "Add internal notes here...",
+            conditionalFormatting: []
+          }
+        }
+      }
+    ]
   },
   {
     key: "number",
     className: "NumberField",
     aliases: ["number", "NumberField"],
     description: "Numeric field.",
-    rawShape: '{"type":"number","slug":"price-eur","label":"Price EUR","config":{"defaultValue":"0","formatOptions":{"format":"number","decimals":2,"thousandsSeparator":true,"symbolEnabled":true,"symbolValue":" \u20AC","symbolPosition":"right"}}}',
-    examplePayload: {
-      type: "number",
-      slug: "price-eur",
-      label: "Price EUR",
-      config: {
-        defaultValue: "0",
-        formatOptions: {
-          format: "number",
-          decimals: 2,
-          thousandsSeparator: true,
-          symbolEnabled: true,
-          symbolValue: " \u20AC",
-          symbolPosition: "right"
+    rawShape: '{"type":"NumberField","slug":"quantity","label":"Quantity","config":{"defaultValue":"0","formatOptions":{"format":"number","decimals":0,"thousandsSeparator":false}}}',
+    examplePayloads: [
+      {
+        name: "Number field (plain integer)",
+        payload: {
+          type: "NumberField",
+          slug: "quantity",
+          label: "Quantity",
+          required: false,
+          config: {
+            defaultValue: "0",
+            formatOptions: {
+              format: "number",
+              decimals: 0,
+              thousandsSeparator: false
+            },
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Number field (decimal with thousands)",
+        payload: {
+          type: "NumberField",
+          slug: "weight",
+          label: "Weight (kg)",
+          required: false,
+          config: {
+            defaultValue: "0",
+            formatOptions: {
+              format: "number",
+              decimals: 2,
+              thousandsSeparator: true,
+              negativesInRed: false
+            },
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Number field (currency \u20AC prefix)",
+        payload: {
+          type: "NumberField",
+          slug: "amount-eur",
+          label: "Amount (EUR)",
+          required: false,
+          config: {
+            defaultValue: "0",
+            formatOptions: {
+              format: "currency",
+              decimals: 2,
+              negativesInRed: true,
+              thousandsSeparator: true,
+              symbolEnabled: true,
+              symbolPosition: "before",
+              symbolValue: "\u20AC"
+            },
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Number field (currency $ suffix)",
+        payload: {
+          type: "NumberField",
+          slug: "amount-usd",
+          label: "Amount (USD)",
+          required: false,
+          config: {
+            defaultValue: "0",
+            formatOptions: {
+              format: "currency",
+              decimals: 2,
+              negativesInRed: false,
+              thousandsSeparator: true,
+              symbolEnabled: true,
+              symbolPosition: "right",
+              symbolValue: " $"
+            },
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Number field (percentage)",
+        payload: {
+          type: "NumberField",
+          slug: "discount-rate",
+          label: "Discount Rate",
+          required: false,
+          config: {
+            defaultValue: "0",
+            formatOptions: {
+              format: "percentage",
+              decimals: 1,
+              negativesInRed: true
+            },
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Number field (duration HH:MM)",
+        payload: {
+          type: "NumberField",
+          slug: "tracked-time",
+          label: "Tracked Time",
+          required: false,
+          config: {
+            defaultValue: "0",
+            formatOptions: {
+              format: "duration",
+              durationFormat: "HH:MM"
+            },
+            conditionalFormatting: []
+          }
         }
       }
-    }
+    ]
   },
   {
     key: "date",
     className: "DateField",
     aliases: ["date", "DateField"],
     description: "Date or datetime field.",
-    rawShape: '{"type":"date","slug":"due-date","label":"Due date"}',
-    examplePayload: {
-      type: "date",
-      slug: "due-date",
-      label: "Due date"
-    }
+    rawShape: '{"type":"DateField","slug":"due-date","label":"Due Date","config":{"formatOptions":{"format":"date","dateFormat":"YYYY-MM-DD","showTime":false}}}',
+    examplePayloads: [
+      {
+        name: "Date field (date only)",
+        payload: {
+          type: "DateField",
+          slug: "birth-date",
+          label: "Birth Date",
+          required: false,
+          config: {
+            defaultValue: null,
+            formatOptions: {
+              format: "date",
+              dateFormat: "YYYY-MM-DD",
+              showTime: false
+            },
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Date field (datetime EU)",
+        payload: {
+          type: "DateField",
+          slug: "due-date",
+          label: "Due Date",
+          required: false,
+          config: {
+            defaultValue: null,
+            formatOptions: {
+              format: "datetime",
+              dateFormat: "DD/MM/YYYY",
+              showTime: true
+            },
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Date field (datetime US)",
+        payload: {
+          type: "DateField",
+          slug: "appointment-at",
+          label: "Appointment",
+          required: false,
+          config: {
+            defaultValue: null,
+            formatOptions: {
+              format: "datetime",
+              dateFormat: "MM/DD/YYYY",
+              showTime: true
+            },
+            conditionalFormatting: []
+          }
+        }
+      }
+    ]
   },
   {
     key: "option",
     className: "OptionField",
     aliases: ["option", "OptionField"],
     description: "Dropdown/select field with options.",
-    rawShape: '{"type":"option","slug":"status","label":"Status","config":{"options":[{"id":1,"name":"Open","color":"default"},{"id":2,"name":"Closed","color":"success"}]}}',
-    examplePayload: {
-      type: "option",
-      slug: "status",
-      label: "Status",
-      config: {
-        options: [
-          {
-            id: 1,
-            name: "Open",
-            color: "default"
-          },
-          {
-            id: 2,
-            name: "Closed",
-            color: "success"
+    rawShape: '{"type":"OptionField","slug":"status","label":"Status","config":{"options":[{"id":1,"name":"Open","color":"default"},{"id":2,"name":"Closed","color":"success"}]}}',
+    examplePayloads: [
+      {
+        name: "Option field (select dropdown)",
+        payload: {
+          type: "OptionField",
+          slug: "priority",
+          label: "Priority",
+          required: false,
+          config: {
+            options: [
+              { id: 1, name: "Low", color: "default" },
+              { id: 2, name: "Medium", color: "warning" },
+              { id: 3, name: "High", color: "danger" }
+            ],
+            defaultValue: 1,
+            conditionalFormatting: [],
+            buttonConfig: null
           }
-        ]
+        }
+      },
+      {
+        name: "Option field (button cycle)",
+        payload: {
+          type: "OptionField",
+          slug: "stage",
+          label: "Stage",
+          required: false,
+          config: {
+            options: [
+              { id: 1, name: "To Do", color: "default" },
+              { id: 2, name: "Doing", color: "warning" },
+              { id: 3, name: "Done", color: "success" }
+            ],
+            defaultValue: 1,
+            conditionalFormatting: [],
+            buttonConfig: {
+              displayMode: "button",
+              buttonBehavior: {
+                mode: "cycle",
+                cycleOrder: [1, 2, 3],
+                requireConfirmation: false,
+                lockAfterSelection: false,
+                allowReselect: true
+              }
+            }
+          }
+        }
+      },
+      {
+        name: "Option field (button dropdown w/ confirm)",
+        payload: {
+          type: "OptionField",
+          slug: "status",
+          label: "Status",
+          required: false,
+          config: {
+            options: [
+              { id: 1, name: "Open", color: "default" },
+              { id: 2, name: "In Progress", color: "warning" },
+              { id: 3, name: "Done", color: "success" }
+            ],
+            defaultValue: 1,
+            conditionalFormatting: [],
+            buttonConfig: {
+              displayMode: "button",
+              buttonBehavior: {
+                mode: "dropdown",
+                requireConfirmation: true,
+                confirmationMessage: "Confirm status change",
+                useFixedLabel: true,
+                buttonLabel: "Set status",
+                allowReselect: true
+              }
+            }
+          }
+        }
       }
-    }
+    ]
   },
   {
     key: "file",
     className: "FileField",
     aliases: ["file", "FileField"],
     description: "File attachment field.",
-    rawShape: '{"type":"file","slug":"attachment","label":"Attachment"}',
-    examplePayload: {
-      type: "file",
-      slug: "attachment",
-      label: "Attachment"
-    }
+    rawShape: '{"type":"FileField","slug":"attachment","label":"Attachment","config":{}}',
+    examplePayloads: [
+      {
+        name: "File field",
+        payload: {
+          type: "FileField",
+          slug: "attachment",
+          label: "Attachment",
+          required: false,
+          config: {}
+        }
+      }
+    ]
   },
   {
     key: "reference",
     className: "ReferenceField",
     aliases: ["reference", "ReferenceField"],
     description: "Reference to another schema.",
-    rawShape: '{"type":"reference","slug":"project","label":"Project","config":{"targetSchema":"<schema-uuid>","targetDisplayField":"<field-uuid>","deleteBehavior":"SET_NULL"}}',
-    examplePayload: {
-      type: "reference",
-      slug: "project",
-      label: "Project",
-      config: {
-        targetSchema: "<schema-uuid>",
-        targetDisplayField: "<field-uuid>",
-        deleteBehavior: "SET_NULL"
+    rawShape: '{"type":"ReferenceField","slug":"company-ref","label":"Company","config":{"targetSchema":"<schema-uuid>","targetDisplayField":"<field-uuid>"}}',
+    examplePayloads: [
+      {
+        name: "Reference field (minimal)",
+        payload: {
+          type: "ReferenceField",
+          slug: "company-ref",
+          label: "Company",
+          required: false,
+          config: {
+            targetSchema: "5223cbc8-8c6c-4694-93bc-dd176364df9b",
+            targetDisplayField: "c60b8526-5835-4c9f-aecd-9a16c7704a34"
+          }
+        }
+      },
+      {
+        name: "Reference field (restrict + filter + description)",
+        payload: {
+          type: "ReferenceField",
+          slug: "customer-ref",
+          label: "Customer",
+          required: false,
+          config: {
+            targetSchema: "5223cbc8-8c6c-4694-93bc-dd176364df9b",
+            targetDisplayField: "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+            deleteBehavior: "RESTRICT",
+            defaultValue: "8ad602a1-f6e3-43f6-9ab2-f1c5afc99621::Ref A",
+            filterFields: [
+              {
+                fatherField: "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+                currentField: "45c5da96-0dc2-4cc1-ba61-7660a9c6da32",
+                comparison: "EQUAL",
+                value: null
+              }
+            ],
+            descriptionFields: [
+              {
+                id: "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
+                fieldType: "NumberField",
+                options: null,
+                format: "number"
+              }
+            ],
+            conditionalFormatting: []
+          }
+        }
       }
-    }
+    ]
   },
   {
     key: "formula",
     className: "FormulaField",
     aliases: ["formula", "FormulaField"],
     description: "Calculated field from a formula.",
-    rawShape: '{"type":"formula","slug":"total","label":"Total","config":{"formulaText":"{price} * {quantity}"}}',
-    examplePayload: {
-      type: "formula",
-      slug: "total",
-      label: "Total",
-      config: {
-        formulaText: "{price} * {quantity}"
+    rawShape: `{"type":"FormulaField","slug":"formula-summary","label":"Formula Summary","config":{"formulaText":"concat(firstName, ' ', lastName)","uiFormatKind":"none"}}`,
+    examplePayloads: [
+      {
+        name: "Formula field (none)",
+        payload: {
+          type: "FormulaField",
+          slug: "formula-summary",
+          label: "Formula Summary",
+          required: false,
+          config: {
+            formulaText: "concat(firstName, ' ', lastName)",
+            uiFormatKind: "none",
+            status: "ACTIVE",
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Formula field (number)",
+        payload: {
+          type: "FormulaField",
+          slug: "formula-total",
+          label: "Formula Total",
+          required: false,
+          config: {
+            formulaText: "amount * 1.21",
+            uiFormatKind: "number",
+            status: "ACTIVE",
+            numberFormatOptions: {
+              format: "number",
+              decimals: 2,
+              thousandsSeparator: true
+            },
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Formula field (date)",
+        payload: {
+          type: "FormulaField",
+          slug: "formula-deadline",
+          label: "Computed Deadline",
+          required: false,
+          config: {
+            formulaText: "addDays(startDate, 7)",
+            uiFormatKind: "date",
+            status: "ACTIVE",
+            dateFormatOptions: {
+              format: "date",
+              dateFormat: "DD/MM/YYYY",
+              showTime: false
+            },
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Formula field (member)",
+        payload: {
+          type: "FormulaField",
+          slug: "formula-assignee",
+          label: "Computed Assignee",
+          required: false,
+          config: {
+            formulaText: "manager",
+            uiFormatKind: "member",
+            status: "ACTIVE",
+            conditionalFormatting: []
+          }
+        }
       }
-    }
+    ]
   },
   {
     key: "member",
     className: "MemberField",
     aliases: ["member", "MemberField"],
     description: "Workspace member field.",
-    rawShape: '{"type":"member","slug":"owner","label":"Owner","config":{"defaultValue":"<member-id>"}}',
-    examplePayload: {
-      type: "member",
-      slug: "owner",
-      label: "Owner",
-      config: {
-        defaultValue: "<member-id>"
+    rawShape: '{"type":"MemberField","slug":"owner","label":"Owner","config":{"defaultValue":null}}',
+    examplePayloads: [
+      {
+        name: "Member field",
+        payload: {
+          type: "MemberField",
+          slug: "owner",
+          label: "Owner",
+          required: false,
+          config: {
+            defaultValue: null,
+            conditionalFormatting: []
+          }
+        }
       }
-    }
+    ]
   },
   {
     key: "autoincremental",
@@ -1752,15 +2104,74 @@ var fieldTypeDefinitions = [
       "AutoIncrementalField"
     ],
     description: "Auto-generated incremental counter.",
-    rawShape: '{"type":"autoincremental","slug":"counter","label":"Counter","config":{"segmentedByFieldId":null}}',
-    examplePayload: {
-      type: "autoincremental",
-      slug: "counter",
-      label: "Counter",
-      config: {
-        segmentedByFieldId: null
+    rawShape: '{"type":"AutoIncrementalField","slug":"order-number","label":"Order Number","config":{"segmentedByFieldId":null}}',
+    examplePayloads: [
+      {
+        name: "Autoincremental (global counter)",
+        payload: {
+          type: "AutoIncrementalField",
+          slug: "order-number",
+          label: "Order Number",
+          required: false,
+          config: {
+            segmentedByFieldId: null,
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Autoincremental (segmented)",
+        payload: {
+          type: "AutoIncrementalField",
+          slug: "sequence-code",
+          label: "Sequence Code",
+          required: false,
+          config: {
+            segmentedByFieldId: "45c5da96-0dc2-4cc1-ba61-7660a9c6da32",
+            conditionalFormatting: []
+          }
+        }
       }
-    }
+    ]
+  },
+  {
+    key: "schedule",
+    className: "ScheduleField",
+    aliases: ["schedule", "ScheduleField"],
+    description: "Recurrence/schedule field bound to a number reference and a date period (frequency: monthly or daily).",
+    rawShape: '{"type":"ScheduleField","slug":"recurrence","label":"Recurrence","config":{"referenceField":"<number-field-uuid>","beginningPeriodField":"<date-field-uuid>","endingPeriodField":"<date-field-uuid>","frequency":"monthly"}}',
+    examplePayloads: [
+      {
+        name: "Schedule field (monthly)",
+        payload: {
+          type: "ScheduleField",
+          slug: "monthly-recurrence",
+          label: "Monthly Recurrence",
+          required: false,
+          config: {
+            referenceField: "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
+            beginningPeriodField: "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+            endingPeriodField: "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+            frequency: "monthly"
+          }
+        }
+      },
+      {
+        name: "Schedule field (daily)",
+        payload: {
+          type: "ScheduleField",
+          slug: "daily-recurrence",
+          label: "Daily Recurrence",
+          required: false,
+          config: {
+            referenceField: "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
+            beginningPeriodField: "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+            endingPeriodField: "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+            frequency: "daily"
+          }
+        }
+      }
+    ]
   }
 ];
 var fieldTypeDefinitionByAlias = new Map(
@@ -1884,6 +2295,49 @@ function normalizeReferencePayload(input) {
   }
   return normalized;
 }
+var scheduleAllowedFrequencies = /* @__PURE__ */ new Set(["monthly", "daily"]);
+function normalizeSchedulePayload(input) {
+  const additionalProperties = toJsonObject(input.additionalProperties) ?? {};
+  const config = toJsonObject(input.config) ?? {};
+  const referenceField = config.referenceField ?? input.referenceField ?? additionalProperties.referenceField;
+  const beginningPeriodField = config.beginningPeriodField ?? input.beginningPeriodField ?? additionalProperties.beginningPeriodField;
+  const endingPeriodField = config.endingPeriodField ?? input.endingPeriodField ?? additionalProperties.endingPeriodField;
+  const frequency = config.frequency ?? input.frequency ?? additionalProperties.frequency;
+  const {
+    referenceField: _referenceField,
+    beginningPeriodField: _beginningPeriodField,
+    endingPeriodField: _endingPeriodField,
+    frequency: _frequency,
+    additionalProperties: _additionalProperties,
+    ...rest
+  } = input;
+  const normalized = {
+    ...rest,
+    config: {
+      ...config,
+      ...referenceField !== void 0 ? { referenceField } : {},
+      ...beginningPeriodField !== void 0 ? { beginningPeriodField } : {},
+      ...endingPeriodField !== void 0 ? { endingPeriodField } : {},
+      ...frequency !== void 0 ? { frequency } : {}
+    }
+  };
+  const normalizedConfig = toJsonObject(normalized.config) ?? {};
+  const definition = resolveSchemaFieldType("schedule");
+  if (!toStringValue2(normalizedConfig.referenceField) || !toStringValue2(normalizedConfig.beginningPeriodField) || !toStringValue2(normalizedConfig.endingPeriodField) || !toStringValue2(normalizedConfig.frequency)) {
+    throw new CliError(
+      "invalid_cli_usage",
+      `Schedule fields require "referenceField", "beginningPeriodField", "endingPeriodField" and "frequency". Expected raw shape: ${definition.rawShape}`
+    );
+  }
+  const frequencyValue = toStringValue2(normalizedConfig.frequency);
+  if (!scheduleAllowedFrequencies.has(frequencyValue)) {
+    throw new CliError(
+      "invalid_cli_usage",
+      `Schedule "frequency" must be "monthly" or "daily" (received "${frequencyValue}").`
+    );
+  }
+  return normalized;
+}
 function normalizeFormulaPayload(input) {
   const { status: _status, ...rest } = input;
   const rawAdditionalProperties = toJsonObject(input.additionalProperties);
@@ -1931,6 +2385,8 @@ function normalizeSchemaFieldCreatePayload(input) {
       return normalizeReferencePayload(normalizedWithType);
     case "formula":
       return normalizeFormulaPayload(normalizedWithType);
+    case "schedule":
+      return normalizeSchedulePayload(normalizedWithType);
     case "autoincremental": {
       const config = toJsonObject(normalizedWithType.config) ?? {};
       const segmentedByFieldId = config.segmentedByFieldId ?? normalizedWithType.segmentedByFieldId ?? null;
@@ -2167,13 +2623,10 @@ var specificExamples = {
   ]),
   "schemas update": buildCommandExamples([
     {
-      description: "Rename a schema and change its slug.",
-      command: 'zinkee --json schemas update contacts --name "Customer Contacts" --slug customer-contacts',
+      description: "Toggle the commentable flag on a schema.",
+      command: "zinkee --json schemas update contacts --commentable true",
       raw: `{
-  "set": {
-    "name": "Customer Contacts",
-    "slug": "customer-contacts"
-  }
+  "commentable": true
 }`,
       response: `{
   "id": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
@@ -2186,37 +2639,46 @@ var specificExamples = {
   },
   "auditable": true,
   "commentable": true,
-  "fields": []
+  "fields": [
+    {
+      "id": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+      "type": "TextField",
+      "slug": "contact-name",
+      "label": "Customer Name",
+      "required": true,
+      "system": false,
+      "config": {
+        "textType": "LONG",
+        "defaultValue": "Unknown",
+        "conditionalFormatting": []
+      }
+    }
+  ]
 }`
     },
     {
-      description: "Enable the audit log on a schema.",
-      command: "zinkee --json schemas update contacts --auditable true",
+      description: "Rename a schema and change its slug.",
+      command: 'zinkee --json schemas update contacts --name "Customer Contacts" --slug customer-contacts',
       raw: `{
-  "set": {
-    "auditable": true
-  }
+  "name": "Customer Contacts",
+  "slug": "customer-contacts"
 }`
     },
     {
-      description: "Toggle commentable off.",
-      command: "zinkee --json schemas update contacts --commentable false",
+      description: "Enable the audit log on a schema.",
+      command: "zinkee --json schemas update contacts --auditable true",
       raw: `{
-  "set": {
-    "commentable": false
-  }
+  "auditable": true
 }`
     }
   ]),
   "schemas fields update": buildCommandExamples([
     {
-      description: "Rename a field label and drop the required flag.",
-      command: 'zinkee --json schemas fields update contacts contact-name --label "Customer Full Name" --required false',
+      description: "Rename slug and label.",
+      command: `zinkee --json schemas fields update contacts contact-name --label "Customer Full Name" --raw '{"slug":"customer-full-name"}'`,
       raw: `{
-  "set": {
-    "label": "Customer Full Name",
-    "required": false
-  }
+  "slug": "customer-full-name",
+  "label": "Customer Full Name"
 }`,
       response: `{
   "schemaId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
@@ -2225,26 +2687,162 @@ var specificExamples = {
 }`
     },
     {
-      description: "Make a field required.",
+      description: "Toggle required.",
       command: "zinkee --json schemas fields update contacts status --required true",
       raw: `{
-  "set": {
-    "required": true
+  "required": true
+}`
+    },
+    {
+      description: "Patch text field (long with default).",
+      command: `zinkee --json schemas fields update contacts contact-name --raw '{"type":"TextField","label":"Customer Full Name","required":false,"config":{"textType":"LONG","defaultValue":"Unknown","conditionalFormatting":[]}}'`,
+      raw: `{
+  "type": "TextField",
+  "label": "Customer Full Name",
+  "required": false,
+  "config": {
+    "textType": "LONG",
+    "defaultValue": "Unknown",
+    "conditionalFormatting": []
   }
 }`
     },
     {
-      description: "Patch the format options of a number field through a raw set payload (no dedicated flag exists for nested config paths).",
-      command: `zinkee --json schemas fields update contacts amount --raw '{"set":{"config":{"formatOptions":{"format":"percent","decimals":1}}}}'`,
+      description: "Patch number field (to currency).",
+      command: `zinkee --json schemas fields update contacts amount --raw '{"type":"NumberField","config":{"defaultValue":"0","formatOptions":{"format":"currency","decimals":2,"thousandsSeparator":true,"symbolEnabled":true,"symbolPosition":"before","symbolValue":"\u20AC"},"conditionalFormatting":[]}}'`,
       raw: `{
-  "set": {
-    "config": {
-      "formatOptions": {
-        "format": "percent",
-        "decimals": 1
+  "type": "NumberField",
+  "config": {
+    "defaultValue": "0",
+    "formatOptions": {
+      "format": "currency",
+      "decimals": 2,
+      "thousandsSeparator": true,
+      "symbolEnabled": true,
+      "symbolPosition": "before",
+      "symbolValue": "\u20AC"
+    },
+    "conditionalFormatting": []
+  }
+}`
+    },
+    {
+      description: "Patch number field (to percentage).",
+      command: `zinkee --json schemas fields update contacts discount-rate --raw '{"type":"NumberField","config":{"defaultValue":"0","formatOptions":{"format":"percentage","decimals":1},"conditionalFormatting":[]}}'`,
+      raw: `{
+  "type": "NumberField",
+  "config": {
+    "defaultValue": "0",
+    "formatOptions": {
+      "format": "percentage",
+      "decimals": 1
+    },
+    "conditionalFormatting": []
+  }
+}`
+    },
+    {
+      description: "Patch date field (to date only).",
+      command: `zinkee --json schemas fields update contacts due-date --raw '{"type":"DateField","config":{"defaultValue":null,"formatOptions":{"format":"date","dateFormat":"YYYY-MM-DD","showTime":false},"conditionalFormatting":[]}}'`,
+      raw: `{
+  "type": "DateField",
+  "config": {
+    "defaultValue": null,
+    "formatOptions": {
+      "format": "date",
+      "dateFormat": "YYYY-MM-DD",
+      "showTime": false
+    },
+    "conditionalFormatting": []
+  }
+}`
+    },
+    {
+      description: "Patch option field (button cycle).",
+      command: `zinkee --json schemas fields update contacts stage --raw '{"type":"OptionField","config":{"options":[{"id":1,"name":"To Do","color":"default"},{"id":2,"name":"Doing","color":"warning"},{"id":3,"name":"Done","color":"success"}],"defaultValue":1,"conditionalFormatting":[],"buttonConfig":{"displayMode":"button","buttonBehavior":{"mode":"cycle","cycleOrder":[1,2,3],"allowReselect":true}}}}'`,
+      raw: `{
+  "type": "OptionField",
+  "config": {
+    "options": [
+      { "id": 1, "name": "To Do", "color": "default" },
+      { "id": 2, "name": "Doing", "color": "warning" },
+      { "id": 3, "name": "Done", "color": "success" }
+    ],
+    "defaultValue": 1,
+    "conditionalFormatting": [],
+    "buttonConfig": {
+      "displayMode": "button",
+      "buttonBehavior": {
+        "mode": "cycle",
+        "cycleOrder": [1, 2, 3],
+        "allowReselect": true
       }
     }
   }
+}`
+    },
+    {
+      description: "Patch option field (drop button mode).",
+      command: `zinkee --json schemas fields update contacts status --raw '{"type":"OptionField","config":{"options":[{"id":1,"name":"Open","color":"default"},{"id":2,"name":"In Progress","color":"warning"},{"id":3,"name":"Done","color":"success"}],"defaultValue":1,"conditionalFormatting":[],"buttonConfig":null}}'`,
+      raw: `{
+  "type": "OptionField",
+  "config": {
+    "options": [
+      { "id": 1, "name": "Open", "color": "default" },
+      { "id": 2, "name": "In Progress", "color": "warning" },
+      { "id": 3, "name": "Done", "color": "success" }
+    ],
+    "defaultValue": 1,
+    "conditionalFormatting": [],
+    "buttonConfig": null
+  }
+}`
+    },
+    {
+      description: "Patch formula field (formula text).",
+      command: `zinkee --json schemas fields update contacts formula-total --raw '{"type":"FormulaField","config":{"formulaText":"amount * 1.10","uiFormatKind":"number","status":"ACTIVE","numberFormatOptions":{"format":"number","decimals":2,"thousandsSeparator":true},"conditionalFormatting":[]}}'`,
+      raw: `{
+  "type": "FormulaField",
+  "config": {
+    "formulaText": "amount * 1.10",
+    "uiFormatKind": "number",
+    "status": "ACTIVE",
+    "numberFormatOptions": {
+      "format": "number",
+      "decimals": 2,
+      "thousandsSeparator": true
+    },
+    "conditionalFormatting": []
+  }
+}`
+    },
+    {
+      description: "Patch reference field (delete behavior).",
+      command: `zinkee --json schemas fields update contacts customer-ref --raw '{"type":"ReferenceField","config":{"targetSchema":"5223cbc8-8c6c-4694-93bc-dd176364df9b","targetDisplayField":"c60b8526-5835-4c9f-aecd-9a16c7704a34","deleteBehavior":"RESTRICT","defaultValue":null,"filterFields":[],"descriptionFields":[],"conditionalFormatting":[]}}'`,
+      raw: `{
+  "type": "ReferenceField",
+  "config": {
+    "targetSchema": "5223cbc8-8c6c-4694-93bc-dd176364df9b",
+    "targetDisplayField": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+    "deleteBehavior": "RESTRICT",
+    "defaultValue": null,
+    "filterFields": [],
+    "descriptionFields": [],
+    "conditionalFormatting": []
+  }
+}`
+    },
+    {
+      description: "Patch schedule field (to daily).",
+      command: `zinkee --json schemas fields update contacts recurrence --raw '{"type":"ScheduleField","config":{"referenceField":"c52efe3f-2825-4c60-a7e3-34dd4c1ce043","beginningPeriodField":"d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90","endingPeriodField":"d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90","frequency":"daily"}}'`,
+      raw: `{
+  "type": "ScheduleField",
+  "config": {
+    "referenceField": "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
+    "beginningPeriodField": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+    "endingPeriodField": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+    "frequency": "daily"
+  }
 }`
     }
   ]),
@@ -3460,27 +4058,22 @@ var specificExamples = {
       "required": true,
       "system": false,
       "config": {
-        "textType": "LONG",
+        "textType": "NORMAL",
         "defaultValue": "Unknown",
         "conditionalFormatting": []
       }
     },
     {
-      "id": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
-      "type": "OptionField",
-      "slug": "status",
-      "label": "Status",
+      "id": "1d2e3f4a-5b6c-7d8e-9f01-23456789abcd",
+      "type": "TextField",
+      "slug": "notes",
+      "label": "Notes",
       "required": false,
       "system": false,
       "config": {
-        "options": [
-          { "id": 1, "name": "Open", "color": "default" },
-          { "id": 2, "name": "In Progress", "color": "warning" },
-          { "id": 3, "name": "Done", "color": "success" }
-        ],
-        "defaultValue": 1,
-        "conditionalFormatting": [],
-        "buttonConfig": null
+        "textType": "LONG",
+        "defaultValue": null,
+        "conditionalFormatting": []
       }
     },
     {
@@ -3504,6 +4097,40 @@ var specificExamples = {
         "conditionalFormatting": []
       }
     },
+    {
+      "id": "2f3a4b5c-6d7e-8f90-1234-56789abcdef0",
+      "type": "NumberField",
+      "slug": "quantity",
+      "label": "Quantity",
+      "required": false,
+      "system": false,
+      "config": {
+        "defaultValue": "0",
+        "formatOptions": {
+          "format": "number",
+          "decimals": 0,
+          "thousandsSeparator": false
+        },
+        "conditionalFormatting": []
+      }
+    },
+    {
+      "id": "3a4b5c6d-7e8f-9012-3456-789abcdef012",
+      "type": "NumberField",
+      "slug": "discount-rate",
+      "label": "Discount Rate",
+      "required": false,
+      "system": false,
+      "config": {
+        "defaultValue": "0",
+        "formatOptions": {
+          "format": "percentage",
+          "decimals": 1,
+          "negativesInRed": true
+        },
+        "conditionalFormatting": []
+      }
+    },
     {
       "id": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
       "type": "DateField",
@@ -3521,6 +4148,203 @@ var specificExamples = {
         "conditionalFormatting": []
       }
     },
+    {
+      "id": "4b5c6d7e-8f90-1234-5678-9abcdef01234",
+      "type": "DateField",
+      "slug": "birth-date",
+      "label": "Birth Date",
+      "required": false,
+      "system": false,
+      "config": {
+        "defaultValue": null,
+        "formatOptions": {
+          "format": "date",
+          "dateFormat": "YYYY-MM-DD",
+          "showTime": false
+        },
+        "conditionalFormatting": []
+      }
+    },
+    {
+      "id": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+      "type": "OptionField",
+      "slug": "status",
+      "label": "Status",
+      "required": false,
+      "system": false,
+      "config": {
+        "options": [
+          { "id": 1, "name": "Open", "color": "default" },
+          { "id": 2, "name": "In Progress", "color": "warning" },
+          { "id": 3, "name": "Done", "color": "success" }
+        ],
+        "defaultValue": 1,
+        "conditionalFormatting": [],
+        "buttonConfig": null
+      }
+    },
+    {
+      "id": "5c6d7e8f-9012-3456-789a-bcdef0123456",
+      "type": "OptionField",
+      "slug": "stage",
+      "label": "Stage",
+      "required": false,
+      "system": false,
+      "config": {
+        "options": [
+          { "id": 1, "name": "To Do", "color": "default" },
+          { "id": 2, "name": "Doing", "color": "warning" },
+          { "id": 3, "name": "Done", "color": "success" }
+        ],
+        "defaultValue": 1,
+        "conditionalFormatting": [],
+        "buttonConfig": {
+          "displayMode": "button",
+          "buttonBehavior": {
+            "mode": "cycle",
+            "cycleOrder": [1, 2, 3],
+            "requireConfirmation": false,
+            "lockAfterSelection": false,
+            "allowReselect": true
+          }
+        }
+      }
+    },
+    {
+      "id": "3e9f8c12-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
+      "type": "FormulaField",
+      "slug": "formula-total",
+      "label": "Formula Total",
+      "required": false,
+      "system": false,
+      "config": {
+        "formulaText": "amount * 1.21",
+        "uiFormatKind": "number",
+        "status": "ACTIVE",
+        "defaultValue": null,
+        "numberFormatOptions": {
+          "format": "number",
+          "decimals": 2,
+          "thousandsSeparator": true
+        },
+        "conditionalFormatting": []
+      }
+    },
+    {
+      "id": "6d7e8f90-1234-5678-9abc-def012345678",
+      "type": "FormulaField",
+      "slug": "formula-deadline",
+      "label": "Computed Deadline",
+      "required": false,
+      "system": false,
+      "config": {
+        "formulaText": "addDays(startDate, 7)",
+        "uiFormatKind": "date",
+        "status": "ACTIVE",
+        "defaultValue": null,
+        "dateFormatOptions": {
+          "format": "date",
+          "dateFormat": "DD/MM/YYYY",
+          "showTime": false
+        },
+        "conditionalFormatting": []
+      }
+    },
+    {
+      "id": "45c5da96-0dc2-4cc1-ba61-7660a9c6da32",
+      "type": "ReferenceField",
+      "slug": "customer-ref",
+      "label": "Customer",
+      "required": false,
+      "system": false,
+      "config": {
+        "targetSchema": "5223cbc8-8c6c-4694-93bc-dd176364df9b",
+        "targetDisplayField": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+        "deleteBehavior": "SET_NULL",
+        "defaultValue": null,
+        "filterFields": [],
+        "descriptionFields": [],
+        "conditionalFormatting": []
+      }
+    },
+    {
+      "id": "7e8f9012-3456-789a-bcde-f01234567890",
+      "type": "ReferenceField",
+      "slug": "company-ref",
+      "label": "Company",
+      "required": false,
+      "system": false,
+      "config": {
+        "targetSchema": "5223cbc8-8c6c-4694-93bc-dd176364df9b",
+        "targetDisplayField": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+        "deleteBehavior": "RESTRICT",
+        "defaultValue": null,
+        "filterFields": [],
+        "descriptionFields": [],
+        "conditionalFormatting": []
+      }
+    },
+    {
+      "id": "b2c3d4e5-f6a7-8b9c-0d1e-2f3a4b5c6d7e",
+      "type": "AutoIncrementalField",
+      "slug": "sequence-code",
+      "label": "Sequence Code",
+      "required": false,
+      "system": true,
+      "config": {
+        "segmentedByFieldId": "45c5da96-0dc2-4cc1-ba61-7660a9c6da32",
+        "conditionalFormatting": []
+      }
+    },
+    {
+      "id": "8f901234-5678-9abc-def0-123456789012",
+      "type": "AutoIncrementalField",
+      "slug": "order-number",
+      "label": "Order Number",
+      "required": false,
+      "system": true,
+      "config": {
+        "segmentedByFieldId": null,
+        "conditionalFormatting": []
+      }
+    },
+    {
+      "id": "e5f6a7b8-c9d0-1e2f-3a4b-5c6d7e8f9012",
+      "type": "FileField",
+      "slug": "attachment",
+      "label": "Attachment",
+      "required": false,
+      "system": false,
+      "config": {}
+    },
+    {
+      "id": "f6a7b8c9-d0e1-2f3a-4b5c-6d7e8f901234",
+      "type": "ScheduleField",
+      "slug": "recurrence",
+      "label": "Recurrence",
+      "required": false,
+      "system": false,
+      "config": {
+        "referenceField": "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
+        "beginningPeriodField": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+        "endingPeriodField": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+        "frequency": "monthly"
+      }
+    },
+    {
+      "id": "9012abcd-ef01-2345-6789-abcdef012345",
+      "type": "ScheduleField",
+      "slug": "daily-recurrence",
+      "label": "Daily Recurrence",
+      "required": false,
+      "system": false,
+      "config": {
+        "referenceField": "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
+        "beginningPeriodField": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+        "endingPeriodField": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+        "frequency": "daily"
+      }
+    },
     {
       "id": "a7b8c9d0-e1f2-3a4b-5c6d-7e8f90123456",
       "type": "MemberField",
@@ -5055,24 +5879,28 @@ function buildSchemaFieldCreateExamples(type) {
   const definitions = getSchemaFieldTypeDefinitions();
   const selectedDefinition = resolveSchemaFieldType(type);
   const filteredDefinitions = selectedDefinition ? definitions.filter((definition) => definition.key === selectedDefinition.key) : definitions;
+  const flat = filteredDefinitions.flatMap(
+    (definition) => definition.examplePayloads.map((example) => ({ definition, example }))
+  );
   return buildCommandExamples(
-    filteredDefinitions.flatMap((definition) => {
-      if (definition.key !== "number") {
-        return [{
-          description: `Create a ${definition.key} field`,
-          command: `zinkee --json schemas fields create contacts --raw '${JSON.stringify(definition.examplePayload)}'`
-        }];
+    flat.map(({ example }, index) => {
+      const slug = typeof example.payload.slug === "string" ? example.payload.slug : "field";
+      const command = `zinkee --json schemas fields create contacts --raw '${JSON.stringify(example.payload)}'`;
+      if (index === 0) {
+        return {
+          description: example.name,
+          command,
+          response: `{
+  "schemaId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+  "fieldId": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+  "slug": "${slug}"
+}`
+        };
       }
-      return [
-        {
-          description: "Create a plain number field",
-          command: `zinkee --json schemas fields create contacts --raw '{"type":"number","slug":"amount","label":"Amount"}'`
-        },
-        {
-          description: "Create a number field formatted like Moneda",
-          command: `zinkee --json schemas fields create contacts --raw '${JSON.stringify(definition.examplePayload)}'`
-        }
-      ];
+      return {
+        description: example.name,
+        command
+      };
     })
   );
 }