@digital-gravy/etch-public-api 0.8.2 → 0.10.0

package/dist/index.d.cts

@@ -340,15 +340,26 @@ interface EtchLoopBlockJson extends EtchBlockCommon {
     type: 'etch/loop';
     /** Variable name bound to the current item (e.g. `item`). */
     itemId: string;
-    /** What the block iterates over (a dynamic path); omitted when bound via `loopId`. */
+    /**
+     * What the block iterates over.
+     *
+     * On a `dataSources` runtime this is the whole binding and is **required**:
+     * any dynamic expression yielding a list — `data('products').items`, an
+     * enclosing loop's `item.tags`, `range(1, 10)`. On a `loops` runtime it is
+     * optional and means a sub-path within the loop bound by `loopId`.
+     */
     target?: string;
     /** Variable name bound to the current index. */
     indexId?: string;
-    /** Id of a registered loop definition this block is bound to. */
+    /**
+     * Id of a registered loop definition this block is bound to.
+     * **Requires the `loops` capability** — ignored where loops are not backed.
+     */
     loopId?: string;
     /**
      * Values for the bound loop's parameters. Every key must be a `$`-prefixed
      * parameter reference (e.g. `$count`).
+     * **Requires the `loops` capability** — ignored where loops are not backed.
      */
     loopParams?: Record<LoopParamRef, unknown>;
 }
@@ -390,12 +401,32 @@ interface EtchRawHtmlBlockJson extends EtchBlockCommon {
     /** The original, unsanitized HTML as authored. */
     unsafe: string;
 }
-/** A pass-through wrapper around a native Gutenberg block (`etch/passthrough`). */
+/**
+ * A pass-through wrapper around a native Gutenberg block (`etch/passthrough`).
+ *
+ * **Not registered on every build** — this one is WordPress-only. Check
+ * `etch.environment.blockTypes` before authoring it; creating a block type the
+ * runtime does not register is rejected.
+ */
 interface EtchPassthroughBlockJson extends EtchBlockCommon {
     type: 'etch/passthrough';
     /** The wrapped Gutenberg block. */
     gutenbergBlock: GutenbergBlock;
 }
+/**
+ * Renders whatever {@link EtchRenderBlockJson.target} resolves to, as long as it
+ * resolves to Etch block JSON — for content that only exists as data at render
+ * time, such as a content-type field. Its children are the resolved JSON, so it
+ * accepts no authored children.
+ *
+ * **Not registered on every build** — this one is Studio-only. Check
+ * `etch.environment.blockTypes` before authoring it.
+ */
+interface EtchRenderBlockJson extends EtchBlockCommon {
+    type: 'etch/render';
+    /** The dynamic expression to render, e.g. `post.content`. */
+    target: string;
+}
 /**
  * A block as plain, structured-clone-safe JSON — the shape accepted by
  * `blocks.create()` / `blocks.replace()`.
@@ -404,7 +435,7 @@ interface EtchPassthroughBlockJson extends EtchBlockCommon {
  * payload does not match its declared `type` (e.g. an `etch/text` block missing
  * `text`, or carrying an `etch/element`'s `tag`).
  */
-type EtchBlockJson = EtchTextBlockJson | EtchElementBlockJson | EtchDynamicElementBlockJson | EtchDynamicImageBlockJson | EtchSvgBlockJson | EtchLoopBlockJson | EtchConditionBlockJson | EtchComponentBlockJson | EtchSlotContentBlockJson | EtchSlotPlaceholderBlockJson | EtchPostContentBlockJson | EtchRawHtmlBlockJson | EtchPassthroughBlockJson;
+type EtchBlockJson = EtchTextBlockJson | EtchElementBlockJson | EtchDynamicElementBlockJson | EtchDynamicImageBlockJson | EtchSvgBlockJson | EtchLoopBlockJson | EtchConditionBlockJson | EtchComponentBlockJson | EtchSlotContentBlockJson | EtchSlotPlaceholderBlockJson | EtchPostContentBlockJson | EtchRawHtmlBlockJson | EtchPassthroughBlockJson | EtchRenderBlockJson;
 /** Every known block `type` string (the discriminants of {@link EtchBlockJson}). */
 type EtchBlockTypeName = EtchBlockJson['type'];
 /** Read-only identity attached to every serialized (read) block. */
@@ -469,6 +500,12 @@ interface BlockPatch {
     attributes?: Record<string, string | undefined>;
     /** Replace the text content. Only valid on text blocks. */
     text?: string;
+    /**
+     * Re-point what the block resolves at: the iterated expression of an
+     * `etch/loop` block, or the rendered expression of an `etch/render` block.
+     * Only valid on those two types.
+     */
+    target?: string;
 }
 /**
  * A portable, JSON-serializable snapshot of a block subtree produced by
@@ -642,6 +679,74 @@ interface EtchBlocksApi {
     saveComponentEditModeAsync(): Promise<void>;
 }
 
+/**
+ * What this Etch runtime actually is, and which optional surfaces it backs.
+ *
+ * Etch ships as more than one product against **one** contract: `etch-wp` runs
+ * inside WordPress, `etch-studio` is standalone. They expose the same `etch`
+ * namespaces, but a namespace can be declared and not implemented — those
+ * methods throw `EtchApiError` with code `NOT_AVAILABLE`.
+ *
+ * `etch.environment` is how a caller finds that out **without** calling and
+ * catching. It is deliberately a description of the runtime rather than of the
+ * product: prefer `capabilities.loops` over `product === 'etch-wp'`, because
+ * capabilities move between products over time (the data manager, for one, is
+ * on its way to WordPress) while a product check silently rots the day they do.
+ */
+/** Which build of Etch is running. Identity — not a capability check. */
+type EtchProduct = 'etch-wp' | 'etch-studio' | (string & {});
+/**
+ * Optional surfaces a runtime may or may not back.
+ *
+ * `loops` and `dataSources` are the two dynamic-data models, and they decide
+ * how an `etch/loop` block is authored — check which one you are on before
+ * writing one:
+ *
+ * - `loops` — a registry of named loop definitions. A loop block binds to one
+ *   by `loopId` (plus `$`-prefixed `loopParams`), and `target` is an optional
+ *   sub-path within it.
+ * - `dataSources` — named, typed project sources (`json`, `api`, `js`), reached
+ *   through a `data('key')` expression. A loop block carries **only** a
+ *   required `target`, and that target is any *dynamic expression* yielding a
+ *   list — a data source, a path into one (`data('products').items`), nested
+ *   data from an enclosing loop (`item.tags`), or a generated list
+ *   (`range(1, 10)`). There is no `loopId`/`loopParams`. This model supersedes
+ *   `loops` and is expected on both products eventually.
+ *
+ * The rest:
+ *
+ * - `fields` — `etch.fields.*` is backed by a real field store.
+ * - `templates` — template posts exist and `navigation.goTo('templates')` works.
+ * - `wpMedia` — media ids resolve against the **WordPress media library**, so a
+ *   URL can be turned into an id through `/wp/v2/media`. Without it the ids are
+ *   the product's own asset store instead. Either way an `etch/dynamic-image`
+ *   block binds the same: a numeric `mediaId` attribute.
+ */
+type EtchCapability = 'loops' | 'dataSources' | 'fields' | 'templates' | 'wpMedia';
+/**
+ * Capability map. Every key is optional on purpose: a runtime older than a
+ * capability's introduction simply omits it, so **absent means unavailable**.
+ * Test with `=== true` rather than truthiness of a possibly-missing key.
+ */
+type EtchCapabilities = Readonly<Partial<Record<EtchCapability, boolean>>>;
+/** Runtime self-description, exposed as `etch.environment`. */
+interface EtchEnvironment {
+    /**
+     * Which build this is — identity, for display and diagnostics. Every
+     * behavioral decision belongs to {@link capabilities} instead; a product
+     * check goes wrong the moment a capability moves between products.
+     */
+    readonly product: EtchProduct;
+    /** Which optional surfaces this runtime actually backs. */
+    readonly capabilities: EtchCapabilities;
+    /**
+     * Every block `type` this runtime can construct, sorted. Read this instead
+     * of assuming a block exists: `etch/passthrough` is WordPress-only and
+     * `etch/render` is Studio-only, and the list grows with each release.
+     */
+    readonly blockTypes: readonly string[];
+}
+
 /**
  * Global style (CSS rule) shapes and the `etch.styles` API surface.
  */
@@ -1490,6 +1595,16 @@ interface Etch {
     readonly apiVersion: string;
     /** The Etch builder (product) version, for capability checks. */
     readonly version: string;
+    /**
+     * What this runtime is and which optional surfaces it backs. Read this
+     * before using `loops`, `fields`, templates or WordPress media, and before
+     * authoring a block type that may not exist here.
+     *
+     * Optional: runtimes older than the descriptor omit it. Treat a missing
+     * `environment` as `etch-wp` on WordPress with everything available, which
+     * is what every runtime that predates it was.
+     */
+    readonly environment?: EtchEnvironment;
 }
 
 declare global {
@@ -1554,4 +1669,4 @@ declare function isEtchApiError(value: unknown): value is EtchApiError;
  */
 declare const ETCH_API_VERSION = "0.x";
 
-export { type ArrayComponentProperty, type BlockLoopBinding, type BlockPatch, type BooleanComponentProperty, type BooleanParam, type BridgeConnectOptions, type ClassComponentProperty, type ColorScheme, type ComponentPatch, type ComponentProperty, type ComponentPropertyBase, type ConditionComponentProperty, type ConnectOptions, type CopyObject, type CustomField, type CustomFieldAssignment, type CustomFieldGroup, type CustomFieldType, ETCH_API_VERSION, type Etch, type EtchAiApi, EtchApiError, type EtchApiErrorCode, type EtchBlockCommon, type EtchBlockContext, type EtchBlockJson, type EtchBlockOptions, type EtchBlockScript, type EtchBlockType, type EtchBlockTypeName, type EtchBlocksApi, type EtchBridgeConnection, type EtchComponentBlockJson, type EtchComponentsApi, type EtchConditionBlockJson, type EtchDynamicElementBlockJson, type EtchDynamicImageBlockJson, type EtchElementBlockJson, type EtchFieldsApi, type EtchHistoryApi, type EtchHtmlAttributes, type EtchLoop, type EtchLoopBlockJson, type EtchLoopConfig, type EtchLoopObj, type EtchLoopsApi, type EtchNavigationApi, type EtchPassthroughBlockJson, type EtchPostContentBlockJson, type EtchRawHtmlBlockJson, type EtchSkillsApi, type EtchSlotContentBlockJson, type EtchSlotPlaceholderBlockJson, type EtchStylesApi, type EtchStylesheetsApi, type EtchSvgBlockJson, type EtchTextBlockJson, type EtchUiApi, type ExternalAiState, type FindBlocksPredicate, type GroupComponentProperty, type GutenbergBlock, type LoopParamRef, type MetaQueryItem, type NavigationPlace, type NumberComponentProperty, type NumericParam, type ObjectComponentProperty, type PostCustomFieldGroupEntry, type PostCustomFieldValueEntry, type PostCustomFieldValueResponse, type PostCustomFieldValuesResponse, type PostSummary, type PublicBlockJson, type PublicComponentJson, type PublicComponentSummary, type RepeaterComponentProperty, type ResolvedCustomField, type SelectOptionsString, type SkillDetail, type SkillSummary, type StringComponentProperty, type StyleListFilter, type StylePatch, type StyleSelectorType, type StyleSummary, type StylesheetInput, type StylesheetPatch, type StylesheetSummary, type StylesheetType, type TaxQueryItem, type TemplateSummary, type WpQueryArgs, type WpTermsArgs, type WpUsersArgs, getEtch, isEtchApiError, isEtchAvailable };
+export { type ArrayComponentProperty, type BlockLoopBinding, type BlockPatch, type BooleanComponentProperty, type BooleanParam, type BridgeConnectOptions, type ClassComponentProperty, type ColorScheme, type ComponentPatch, type ComponentProperty, type ComponentPropertyBase, type ConditionComponentProperty, type ConnectOptions, type CopyObject, type CustomField, type CustomFieldAssignment, type CustomFieldGroup, type CustomFieldType, ETCH_API_VERSION, type Etch, type EtchAiApi, EtchApiError, type EtchApiErrorCode, type EtchBlockCommon, type EtchBlockContext, type EtchBlockJson, type EtchBlockOptions, type EtchBlockScript, type EtchBlockType, type EtchBlockTypeName, type EtchBlocksApi, type EtchBridgeConnection, type EtchCapabilities, type EtchCapability, type EtchComponentBlockJson, type EtchComponentsApi, type EtchConditionBlockJson, type EtchDynamicElementBlockJson, type EtchDynamicImageBlockJson, type EtchElementBlockJson, type EtchEnvironment, type EtchFieldsApi, type EtchHistoryApi, type EtchHtmlAttributes, type EtchLoop, type EtchLoopBlockJson, type EtchLoopConfig, type EtchLoopObj, type EtchLoopsApi, type EtchNavigationApi, type EtchPassthroughBlockJson, type EtchPostContentBlockJson, type EtchProduct, type EtchRawHtmlBlockJson, type EtchRenderBlockJson, type EtchSkillsApi, type EtchSlotContentBlockJson, type EtchSlotPlaceholderBlockJson, type EtchStylesApi, type EtchStylesheetsApi, type EtchSvgBlockJson, type EtchTextBlockJson, type EtchUiApi, type ExternalAiState, type FindBlocksPredicate, type GroupComponentProperty, type GutenbergBlock, type LoopParamRef, type MetaQueryItem, type NavigationPlace, type NumberComponentProperty, type NumericParam, type ObjectComponentProperty, type PostCustomFieldGroupEntry, type PostCustomFieldValueEntry, type PostCustomFieldValueResponse, type PostCustomFieldValuesResponse, type PostSummary, type PublicBlockJson, type PublicComponentJson, type PublicComponentSummary, type RepeaterComponentProperty, type ResolvedCustomField, type SelectOptionsString, type SkillDetail, type SkillSummary, type StringComponentProperty, type StyleListFilter, type StylePatch, type StyleSelectorType, type StyleSummary, type StylesheetInput, type StylesheetPatch, type StylesheetSummary, type StylesheetType, type TaxQueryItem, type TemplateSummary, type WpQueryArgs, type WpTermsArgs, type WpUsersArgs, getEtch, isEtchApiError, isEtchAvailable };

package/dist/index.d.ts

@@ -340,15 +340,26 @@ interface EtchLoopBlockJson extends EtchBlockCommon {
     type: 'etch/loop';
     /** Variable name bound to the current item (e.g. `item`). */
     itemId: string;
-    /** What the block iterates over (a dynamic path); omitted when bound via `loopId`. */
+    /**
+     * What the block iterates over.
+     *
+     * On a `dataSources` runtime this is the whole binding and is **required**:
+     * any dynamic expression yielding a list — `data('products').items`, an
+     * enclosing loop's `item.tags`, `range(1, 10)`. On a `loops` runtime it is
+     * optional and means a sub-path within the loop bound by `loopId`.
+     */
     target?: string;
     /** Variable name bound to the current index. */
     indexId?: string;
-    /** Id of a registered loop definition this block is bound to. */
+    /**
+     * Id of a registered loop definition this block is bound to.
+     * **Requires the `loops` capability** — ignored where loops are not backed.
+     */
     loopId?: string;
     /**
      * Values for the bound loop's parameters. Every key must be a `$`-prefixed
      * parameter reference (e.g. `$count`).
+     * **Requires the `loops` capability** — ignored where loops are not backed.
      */
     loopParams?: Record<LoopParamRef, unknown>;
 }
@@ -390,12 +401,32 @@ interface EtchRawHtmlBlockJson extends EtchBlockCommon {
     /** The original, unsanitized HTML as authored. */
     unsafe: string;
 }
-/** A pass-through wrapper around a native Gutenberg block (`etch/passthrough`). */
+/**
+ * A pass-through wrapper around a native Gutenberg block (`etch/passthrough`).
+ *
+ * **Not registered on every build** — this one is WordPress-only. Check
+ * `etch.environment.blockTypes` before authoring it; creating a block type the
+ * runtime does not register is rejected.
+ */
 interface EtchPassthroughBlockJson extends EtchBlockCommon {
     type: 'etch/passthrough';
     /** The wrapped Gutenberg block. */
     gutenbergBlock: GutenbergBlock;
 }
+/**
+ * Renders whatever {@link EtchRenderBlockJson.target} resolves to, as long as it
+ * resolves to Etch block JSON — for content that only exists as data at render
+ * time, such as a content-type field. Its children are the resolved JSON, so it
+ * accepts no authored children.
+ *
+ * **Not registered on every build** — this one is Studio-only. Check
+ * `etch.environment.blockTypes` before authoring it.
+ */
+interface EtchRenderBlockJson extends EtchBlockCommon {
+    type: 'etch/render';
+    /** The dynamic expression to render, e.g. `post.content`. */
+    target: string;
+}
 /**
  * A block as plain, structured-clone-safe JSON — the shape accepted by
  * `blocks.create()` / `blocks.replace()`.
@@ -404,7 +435,7 @@ interface EtchPassthroughBlockJson extends EtchBlockCommon {
  * payload does not match its declared `type` (e.g. an `etch/text` block missing
  * `text`, or carrying an `etch/element`'s `tag`).
  */
-type EtchBlockJson = EtchTextBlockJson | EtchElementBlockJson | EtchDynamicElementBlockJson | EtchDynamicImageBlockJson | EtchSvgBlockJson | EtchLoopBlockJson | EtchConditionBlockJson | EtchComponentBlockJson | EtchSlotContentBlockJson | EtchSlotPlaceholderBlockJson | EtchPostContentBlockJson | EtchRawHtmlBlockJson | EtchPassthroughBlockJson;
+type EtchBlockJson = EtchTextBlockJson | EtchElementBlockJson | EtchDynamicElementBlockJson | EtchDynamicImageBlockJson | EtchSvgBlockJson | EtchLoopBlockJson | EtchConditionBlockJson | EtchComponentBlockJson | EtchSlotContentBlockJson | EtchSlotPlaceholderBlockJson | EtchPostContentBlockJson | EtchRawHtmlBlockJson | EtchPassthroughBlockJson | EtchRenderBlockJson;
 /** Every known block `type` string (the discriminants of {@link EtchBlockJson}). */
 type EtchBlockTypeName = EtchBlockJson['type'];
 /** Read-only identity attached to every serialized (read) block. */
@@ -469,6 +500,12 @@ interface BlockPatch {
     attributes?: Record<string, string | undefined>;
     /** Replace the text content. Only valid on text blocks. */
     text?: string;
+    /**
+     * Re-point what the block resolves at: the iterated expression of an
+     * `etch/loop` block, or the rendered expression of an `etch/render` block.
+     * Only valid on those two types.
+     */
+    target?: string;
 }
 /**
  * A portable, JSON-serializable snapshot of a block subtree produced by
@@ -642,6 +679,74 @@ interface EtchBlocksApi {
     saveComponentEditModeAsync(): Promise<void>;
 }
 
+/**
+ * What this Etch runtime actually is, and which optional surfaces it backs.
+ *
+ * Etch ships as more than one product against **one** contract: `etch-wp` runs
+ * inside WordPress, `etch-studio` is standalone. They expose the same `etch`
+ * namespaces, but a namespace can be declared and not implemented — those
+ * methods throw `EtchApiError` with code `NOT_AVAILABLE`.
+ *
+ * `etch.environment` is how a caller finds that out **without** calling and
+ * catching. It is deliberately a description of the runtime rather than of the
+ * product: prefer `capabilities.loops` over `product === 'etch-wp'`, because
+ * capabilities move between products over time (the data manager, for one, is
+ * on its way to WordPress) while a product check silently rots the day they do.
+ */
+/** Which build of Etch is running. Identity — not a capability check. */
+type EtchProduct = 'etch-wp' | 'etch-studio' | (string & {});
+/**
+ * Optional surfaces a runtime may or may not back.
+ *
+ * `loops` and `dataSources` are the two dynamic-data models, and they decide
+ * how an `etch/loop` block is authored — check which one you are on before
+ * writing one:
+ *
+ * - `loops` — a registry of named loop definitions. A loop block binds to one
+ *   by `loopId` (plus `$`-prefixed `loopParams`), and `target` is an optional
+ *   sub-path within it.
+ * - `dataSources` — named, typed project sources (`json`, `api`, `js`), reached
+ *   through a `data('key')` expression. A loop block carries **only** a
+ *   required `target`, and that target is any *dynamic expression* yielding a
+ *   list — a data source, a path into one (`data('products').items`), nested
+ *   data from an enclosing loop (`item.tags`), or a generated list
+ *   (`range(1, 10)`). There is no `loopId`/`loopParams`. This model supersedes
+ *   `loops` and is expected on both products eventually.
+ *
+ * The rest:
+ *
+ * - `fields` — `etch.fields.*` is backed by a real field store.
+ * - `templates` — template posts exist and `navigation.goTo('templates')` works.
+ * - `wpMedia` — media ids resolve against the **WordPress media library**, so a
+ *   URL can be turned into an id through `/wp/v2/media`. Without it the ids are
+ *   the product's own asset store instead. Either way an `etch/dynamic-image`
+ *   block binds the same: a numeric `mediaId` attribute.
+ */
+type EtchCapability = 'loops' | 'dataSources' | 'fields' | 'templates' | 'wpMedia';
+/**
+ * Capability map. Every key is optional on purpose: a runtime older than a
+ * capability's introduction simply omits it, so **absent means unavailable**.
+ * Test with `=== true` rather than truthiness of a possibly-missing key.
+ */
+type EtchCapabilities = Readonly<Partial<Record<EtchCapability, boolean>>>;
+/** Runtime self-description, exposed as `etch.environment`. */
+interface EtchEnvironment {
+    /**
+     * Which build this is — identity, for display and diagnostics. Every
+     * behavioral decision belongs to {@link capabilities} instead; a product
+     * check goes wrong the moment a capability moves between products.
+     */
+    readonly product: EtchProduct;
+    /** Which optional surfaces this runtime actually backs. */
+    readonly capabilities: EtchCapabilities;
+    /**
+     * Every block `type` this runtime can construct, sorted. Read this instead
+     * of assuming a block exists: `etch/passthrough` is WordPress-only and
+     * `etch/render` is Studio-only, and the list grows with each release.
+     */
+    readonly blockTypes: readonly string[];
+}
+
 /**
  * Global style (CSS rule) shapes and the `etch.styles` API surface.
  */
@@ -1490,6 +1595,16 @@ interface Etch {
     readonly apiVersion: string;
     /** The Etch builder (product) version, for capability checks. */
     readonly version: string;
+    /**
+     * What this runtime is and which optional surfaces it backs. Read this
+     * before using `loops`, `fields`, templates or WordPress media, and before
+     * authoring a block type that may not exist here.
+     *
+     * Optional: runtimes older than the descriptor omit it. Treat a missing
+     * `environment` as `etch-wp` on WordPress with everything available, which
+     * is what every runtime that predates it was.
+     */
+    readonly environment?: EtchEnvironment;
 }
 
 declare global {
@@ -1554,4 +1669,4 @@ declare function isEtchApiError(value: unknown): value is EtchApiError;
  */
 declare const ETCH_API_VERSION = "0.x";
 
-export { type ArrayComponentProperty, type BlockLoopBinding, type BlockPatch, type BooleanComponentProperty, type BooleanParam, type BridgeConnectOptions, type ClassComponentProperty, type ColorScheme, type ComponentPatch, type ComponentProperty, type ComponentPropertyBase, type ConditionComponentProperty, type ConnectOptions, type CopyObject, type CustomField, type CustomFieldAssignment, type CustomFieldGroup, type CustomFieldType, ETCH_API_VERSION, type Etch, type EtchAiApi, EtchApiError, type EtchApiErrorCode, type EtchBlockCommon, type EtchBlockContext, type EtchBlockJson, type EtchBlockOptions, type EtchBlockScript, type EtchBlockType, type EtchBlockTypeName, type EtchBlocksApi, type EtchBridgeConnection, type EtchComponentBlockJson, type EtchComponentsApi, type EtchConditionBlockJson, type EtchDynamicElementBlockJson, type EtchDynamicImageBlockJson, type EtchElementBlockJson, type EtchFieldsApi, type EtchHistoryApi, type EtchHtmlAttributes, type EtchLoop, type EtchLoopBlockJson, type EtchLoopConfig, type EtchLoopObj, type EtchLoopsApi, type EtchNavigationApi, type EtchPassthroughBlockJson, type EtchPostContentBlockJson, type EtchRawHtmlBlockJson, type EtchSkillsApi, type EtchSlotContentBlockJson, type EtchSlotPlaceholderBlockJson, type EtchStylesApi, type EtchStylesheetsApi, type EtchSvgBlockJson, type EtchTextBlockJson, type EtchUiApi, type ExternalAiState, type FindBlocksPredicate, type GroupComponentProperty, type GutenbergBlock, type LoopParamRef, type MetaQueryItem, type NavigationPlace, type NumberComponentProperty, type NumericParam, type ObjectComponentProperty, type PostCustomFieldGroupEntry, type PostCustomFieldValueEntry, type PostCustomFieldValueResponse, type PostCustomFieldValuesResponse, type PostSummary, type PublicBlockJson, type PublicComponentJson, type PublicComponentSummary, type RepeaterComponentProperty, type ResolvedCustomField, type SelectOptionsString, type SkillDetail, type SkillSummary, type StringComponentProperty, type StyleListFilter, type StylePatch, type StyleSelectorType, type StyleSummary, type StylesheetInput, type StylesheetPatch, type StylesheetSummary, type StylesheetType, type TaxQueryItem, type TemplateSummary, type WpQueryArgs, type WpTermsArgs, type WpUsersArgs, getEtch, isEtchApiError, isEtchAvailable };
+export { type ArrayComponentProperty, type BlockLoopBinding, type BlockPatch, type BooleanComponentProperty, type BooleanParam, type BridgeConnectOptions, type ClassComponentProperty, type ColorScheme, type ComponentPatch, type ComponentProperty, type ComponentPropertyBase, type ConditionComponentProperty, type ConnectOptions, type CopyObject, type CustomField, type CustomFieldAssignment, type CustomFieldGroup, type CustomFieldType, ETCH_API_VERSION, type Etch, type EtchAiApi, EtchApiError, type EtchApiErrorCode, type EtchBlockCommon, type EtchBlockContext, type EtchBlockJson, type EtchBlockOptions, type EtchBlockScript, type EtchBlockType, type EtchBlockTypeName, type EtchBlocksApi, type EtchBridgeConnection, type EtchCapabilities, type EtchCapability, type EtchComponentBlockJson, type EtchComponentsApi, type EtchConditionBlockJson, type EtchDynamicElementBlockJson, type EtchDynamicImageBlockJson, type EtchElementBlockJson, type EtchEnvironment, type EtchFieldsApi, type EtchHistoryApi, type EtchHtmlAttributes, type EtchLoop, type EtchLoopBlockJson, type EtchLoopConfig, type EtchLoopObj, type EtchLoopsApi, type EtchNavigationApi, type EtchPassthroughBlockJson, type EtchPostContentBlockJson, type EtchProduct, type EtchRawHtmlBlockJson, type EtchRenderBlockJson, type EtchSkillsApi, type EtchSlotContentBlockJson, type EtchSlotPlaceholderBlockJson, type EtchStylesApi, type EtchStylesheetsApi, type EtchSvgBlockJson, type EtchTextBlockJson, type EtchUiApi, type ExternalAiState, type FindBlocksPredicate, type GroupComponentProperty, type GutenbergBlock, type LoopParamRef, type MetaQueryItem, type NavigationPlace, type NumberComponentProperty, type NumericParam, type ObjectComponentProperty, type PostCustomFieldGroupEntry, type PostCustomFieldValueEntry, type PostCustomFieldValueResponse, type PostCustomFieldValuesResponse, type PostSummary, type PublicBlockJson, type PublicComponentJson, type PublicComponentSummary, type RepeaterComponentProperty, type ResolvedCustomField, type SelectOptionsString, type SkillDetail, type SkillSummary, type StringComponentProperty, type StyleListFilter, type StylePatch, type StyleSelectorType, type StyleSummary, type StylesheetInput, type StylesheetPatch, type StylesheetSummary, type StylesheetType, type TaxQueryItem, type TemplateSummary, type WpQueryArgs, type WpTermsArgs, type WpUsersArgs, getEtch, isEtchApiError, isEtchAvailable };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@digital-gravy/etch-public-api",
-	"version": "0.8.2",
+	"version": "0.10.0",
 	"description": "MIT-licensed typed client and contract for the Etch builder scripting API (window.etch). Etch itself is a separate proprietary product governed by its own commercial terms.",
 	"license": "MIT",
 	"repository": {