@riverbankcms/sdk 0.90.0 → 0.91.0

package/dist/cli/init-docs/content/workflow-add-block.md

@@ -49,6 +49,16 @@ riverbankcms block list home
 riverbankcms block upsert <page-id> <block-id> --kind <block-kind> --data '<json>'
 ```
 
+### Authoring Block JSON
+
+Use `block-types.md` and `block-types-site.md` as the source of truth for fields.
+
+- Fields marked `required` must be present with a valid value.
+- Fields not marked `required` may be omitted. You do not need to include every optional key or set unused optional values to `null`.
+- Defaults shown in the block reference are applied by the editor/rendering contract. Include an optional field only when you want to override that default.
+- For nested objects and repeaters, required child fields apply once you include the parent value. For example, an omitted `images` repeater is valid, but `images: [{}]` is not because the item is present and its required `image` field is missing.
+- `null` is only valid for field types that explicitly accept clearing to no value. When in doubt, omit optional fields instead of sending `null`.
+
 **Examples:**
 
 Add a hero block:
@@ -59,6 +69,44 @@ riverbankcms block upsert home main-hero \
   --data '{"heading": "Welcome", "subheading": "to our website"}'
 ```
 
+Add a minimal media and text block:
+
+`block.media-text` has many display and carousel fields, but most are optional controls with defaults. A minimal content-only block only needs rich text:
+
+```json
+{
+  "text": {
+    "type": "doc",
+    "content": [
+      {
+        "type": "paragraph",
+        "content": [{ "type": "text", "text": "Welcome to our space." }]
+      }
+    ]
+  }
+}
+```
+
+Add media only when you have a complete media item:
+
+```json
+{
+  "text": {
+    "type": "doc",
+    "content": [{ "type": "paragraph", "content": [] }]
+  },
+  "images": [
+    {
+      "image": {
+        "type": "image",
+        "src": "/images/studio.jpg",
+        "alt": "A bright studio room"
+      }
+    }
+  ]
+}
+```
+
 Add a body text block:
 
 ```bash

package/dist/cli/init-docs/content/workflow-custom-block.md

@@ -105,6 +105,16 @@ Common field types for custom blocks:
 | `repeater` | List of nested fields | `schema`, `minItems`, `maxItems` |
 | `group` | Grouped fields | `schema` |
 
+### Step 2.5: Model Required Fields Carefully
+
+The same content authoring rules apply to custom blocks and system blocks:
+
+- Leave `required` unset or `false` for fields that can be omitted from pushed JSON.
+- Use `defaultValue` for optional controls that should have a stable editor/rendering default.
+- Set `required: true` only when every pushed block must provide that field.
+- For repeaters and groups, required child fields apply when the parent item/object is present. If a repeater item has `{ id: 'title', required: true }`, then every item in that repeater must include `title`.
+- In React overrides, type optional fields as optional and handle missing values with defaults or conditional rendering.
+
 ### Step 3: Create React Override Component
 
 Create a component to render your block:

package/dist/client/{accordion-GXQNWQ6O.mjs → accordion-AFX37652.mjs}

@@ -1,5 +1,5 @@
-import { defineIslandPropsDecoder } from './chunk-6DPXDOIL.mjs';
-import './chunk-25W2EQUN.mjs';
+import { defineIslandPropsDecoder } from './chunk-MLBNVN4H.mjs';
+import './chunk-RWYFG625.mjs';
 
 // src/rendering/islands/enhancers/accordion.ts
 var decode = defineIslandPropsDecoder("accordion");

package/dist/client/{bookingForm-STLUJ36H.mjs → bookingForm-32V5QCOW.mjs}

@@ -1,15 +1,15 @@
 "use client";
-import { buildBookingPaymentSelectionViewModel, usePolling } from './chunk-4RTFGHZN.mjs';
-import { SpinnerNode } from './chunk-FHU6PFPM.mjs';
+import { buildBookingPaymentSelectionViewModel, usePolling } from './chunk-E6VIWZUG.mjs';
+import { SpinnerNode } from './chunk-ISAUXU5R.mjs';
 import { buildRouteIslandApiConfig } from './chunk-L4J5Y62O.mjs';
-import { scrollToBlock, useDiscountCodeUi, buildCheckoutReturnUrls, DiscountCodeDisclosure } from './chunk-NBFRJ5NB.mjs';
+import { scrollToBlock, useDiscountCodeUi, buildCheckoutReturnUrls, DiscountCodeDisclosure } from './chunk-CKXEUWWA.mjs';
 import { FieldValidationMessage, getFieldValidationControlProps } from './chunk-3DCJ45Z2.mjs';
 import './chunk-WBQG7VJA.mjs';
-import { isSpamProtectionEnabled, getChallengeUrl, AltchaWidget } from './chunk-HIHOQGIP.mjs';
+import { isSpamProtectionEnabled, getChallengeUrl, AltchaWidget } from './chunk-LJCX6V7Q.mjs';
 import { BlockApiProvider, useBlockApi, FeedbackMessage } from './chunk-WHZQDPBZ.mjs';
 import { mountReactIsland } from './chunk-N7PBWBWQ.mjs';
-import { defineIslandPropsDecoder, resolveBookingSiteId, resolveDefaultBookingServiceId, getBookingRedirectStateFromLocation, deriveBookingFormViewState, logger, getBookingSuccessMessage, resolveAppointmentCheckoutVerificationState, themeButtonClassName, toSelectedCollectionOptionKind, assertNever, prepareBookingSubmission, formatBookingSubmissionPreparationError, resolveBookingPaymentStep, BOOKING_FORM_DATA_RESERVED_KEYS, clearWorkflowFeedback, reportWorkflowError, reportWorkflowSuccess, okWith, err } from './chunk-6DPXDOIL.mjs';
-import { resolveBookingTimeZoneId, DEFAULT_BOOKING_TIME_ZONE, unsafeAsFormId, unsafeAsAppointmentResourceId, unsafeAsCustomerPassId, unsafeAsAppointmentServiceId, formatLocalScheduleDate, addLocalScheduleDays, parseBookingLocalDate, unsafeAsPassId, formatBookingInstant } from './chunk-25W2EQUN.mjs';
+import { defineIslandPropsDecoder, resolveBookingSiteId, resolveDefaultBookingServiceId, getBookingRedirectStateFromLocation, deriveBookingFormViewState, logger, getBookingSuccessMessage, resolveAppointmentCheckoutVerificationState, themeButtonClassName, toSelectedCollectionOptionKind, assertNever, prepareBookingSubmission, formatBookingSubmissionPreparationError, resolveBookingPaymentStep, BOOKING_FORM_DATA_RESERVED_KEYS, clearWorkflowFeedback, reportWorkflowError, reportWorkflowSuccess, okWith, err } from './chunk-MLBNVN4H.mjs';
+import { resolveBookingTimeZoneId, DEFAULT_BOOKING_TIME_ZONE, unsafeAsFormId, unsafeAsAppointmentResourceId, unsafeAsCustomerPassId, unsafeAsAppointmentServiceId, formatLocalScheduleDate, addLocalScheduleDays, parseBookingLocalDate, unsafeAsPassId, formatBookingInstant } from './chunk-RWYFG625.mjs';
 import React2, { useRef, useState, useMemo, useReducer, useEffect, useCallback, useLayoutEffect } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';