@ankhorage/zora 27.0.3 → 27.1.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 27.1.0
+
+### Minor Changes
+
+- 5d344e6: Expose generic authoring selection, property, binding, and theme editor adapters through the public API.
+
 ## 27.0.3
 
 ### Patch Changes

package/README.md

@@ -3,7 +3,7 @@
 
 # @ankhorage/zora
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v27.0.3](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![paradox: warnings](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v27.1.0](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![paradox: warnings](././paradox/badges/docs.svg)
 
 Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.
 

package/dist/authoring.d.ts

@@ -0,0 +1,6 @@
+export { AuthoringBindingEditorAdapter } from './features/registry/adapters/inbound/AuthoringBindingEditorAdapter';
+export { AuthoringPropertyInspectorAdapter } from './features/registry/adapters/inbound/AuthoringPropertyInspectorAdapter';
+export { AuthoringSelectionAdapter } from './features/registry/adapters/inbound/AuthoringSelectionAdapter';
+export { ThemeEditorAdapter } from './features/registry/adapters/inbound/ThemeEditorAdapter';
+export type { AuthoringBindingControlState, AuthoringBindingEditorAdapterProps, AuthoringPropertyControlState, AuthoringPropertyInspectorAdapterProps, AuthoringSelectionAdapterProps, AuthoringSelectionItemState, ThemeEditorAdapterProps, ThemeRecipeFieldControlState, } from './types/authoring-adapters';
+//# sourceMappingURL=authoring.d.ts.map

package/dist/authoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring.d.ts","sourceRoot":"","sources":["../src/authoring.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,oEAAoE,CAAC;AACnH,OAAO,EAAE,iCAAiC,EAAE,MAAM,wEAAwE,CAAC;AAC3H,OAAO,EAAE,yBAAyB,EAAE,MAAM,gEAAgE,CAAC;AAC3G,OAAO,EAAE,kBAAkB,EAAE,MAAM,yDAAyD,CAAC;AAC7F,YAAY,EACV,4BAA4B,EAC5B,kCAAkC,EAClC,6BAA6B,EAC7B,sCAAsC,EACtC,8BAA8B,EAC9B,2BAA2B,EAC3B,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,4BAA4B,CAAC"}

package/dist/authoring.js

@@ -0,0 +1,5 @@
+export { AuthoringBindingEditorAdapter } from './features/registry/adapters/inbound/AuthoringBindingEditorAdapter';
+export { AuthoringPropertyInspectorAdapter } from './features/registry/adapters/inbound/AuthoringPropertyInspectorAdapter';
+export { AuthoringSelectionAdapter } from './features/registry/adapters/inbound/AuthoringSelectionAdapter';
+export { ThemeEditorAdapter } from './features/registry/adapters/inbound/ThemeEditorAdapter';
+//# sourceMappingURL=authoring.js.map

package/dist/authoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring.js","sourceRoot":"","sources":["../src/authoring.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,oEAAoE,CAAC;AACnH,OAAO,EAAE,iCAAiC,EAAE,MAAM,wEAAwE,CAAC;AAC3H,OAAO,EAAE,yBAAyB,EAAE,MAAM,gEAAgE,CAAC;AAC3G,OAAO,EAAE,kBAAkB,EAAE,MAAM,yDAAyD,CAAC","sourcesContent":["export { AuthoringBindingEditorAdapter } from './features/registry/adapters/inbound/AuthoringBindingEditorAdapter';\nexport { AuthoringPropertyInspectorAdapter } from './features/registry/adapters/inbound/AuthoringPropertyInspectorAdapter';\nexport { AuthoringSelectionAdapter } from './features/registry/adapters/inbound/AuthoringSelectionAdapter';\nexport { ThemeEditorAdapter } from './features/registry/adapters/inbound/ThemeEditorAdapter';\nexport type {\n  AuthoringBindingControlState,\n  AuthoringBindingEditorAdapterProps,\n  AuthoringPropertyControlState,\n  AuthoringPropertyInspectorAdapterProps,\n  AuthoringSelectionAdapterProps,\n  AuthoringSelectionItemState,\n  ThemeEditorAdapterProps,\n  ThemeRecipeFieldControlState,\n} from './types/authoring-adapters';\n"]}

package/dist/features/button/utils/resolveButtonThemeRecipe.d.ts

@@ -7,5 +7,5 @@ export declare function resolveButtonThemeRecipe(input: {
     readonly variant?: ZoraButtonVariant;
     readonly size?: ZoraControlSize;
     readonly themeFields: Readonly<Record<string, ThemeRecipeOverrideValue>>;
-}): Pick<import("@ankhorage/surface").ButtonProps, "size" | "variant" | "color">;
+}): Pick<import("@ankhorage/surface").ButtonProps, "color" | "size" | "variant">;
 //# sourceMappingURL=resolveButtonThemeRecipe.d.ts.map

package/dist/features/registry/adapters/inbound/AuthoringBindingEditorAdapter.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { AuthoringBindingEditorAdapterProps } from '../../../../types/authoring-adapters';
+/*** Presents canonical bindable properties while leaving binding representation and mutation ownership external. */
+export declare function AuthoringBindingEditorAdapter<TNode, TBinding>({ node, component, getBinding, onBindingChange, renderBinding, isBindingDisabled, isBindingRequired, disabled, }: AuthoringBindingEditorAdapterProps<TNode, TBinding>): React.JSX.Element | null;
+//# sourceMappingURL=AuthoringBindingEditorAdapter.d.ts.map

package/dist/features/registry/adapters/inbound/AuthoringBindingEditorAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthoringBindingEditorAdapter.d.ts","sourceRoot":"","sources":["../../../../../src/features/registry/adapters/inbound/AuthoringBindingEditorAdapter.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,sCAAsC,CAAC;AAI/F,oHAAoH;AACpH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,QAAQ,EAAE,EAC7D,IAAI,EACJ,SAAS,EACT,UAAU,EACV,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,QAAgB,GACjB,EAAE,kCAAkC,CAAC,KAAK,EAAE,QAAQ,CAAC,4BAoCrD"}

package/dist/features/registry/adapters/inbound/AuthoringBindingEditorAdapter.js

@@ -0,0 +1,34 @@
+import React from 'react';
+import { Field } from '../../../form/public';
+import { View } from '../../../layout/public';
+/*** Presents canonical bindable properties while leaving binding representation and mutation ownership external. */
+export function AuthoringBindingEditorAdapter({ node, component, getBinding, onBindingChange, renderBinding, isBindingDisabled, isBindingRequired, disabled = false, }) {
+    if (node === null || component === null)
+        return null;
+    const bindings = component.bindings?.props;
+    if (bindings === undefined)
+        return null;
+    return (<View gap="m">
+      {Object.entries(bindings).map(([name, meta]) => {
+            const controlDisabled = disabled || isBindingDisabled?.(node, name) === true;
+            const required = isBindingRequired?.(node, name) === true;
+            return (<Field key={name} description={meta.description} disabled={controlDisabled} label={meta.label ?? name} required={required}>
+            {renderBinding({
+                    node,
+                    component,
+                    name,
+                    label: meta.label ?? name,
+                    description: meta.description,
+                    binding: getBinding(node, name),
+                    disabled: controlDisabled,
+                    required,
+                    onChange: (binding) => {
+                        if (!controlDisabled)
+                            onBindingChange?.(node, name, binding);
+                    },
+                })}
+          </Field>);
+        })}
+    </View>);
+}
+//# sourceMappingURL=AuthoringBindingEditorAdapter.js.map

package/dist/features/registry/adapters/inbound/AuthoringBindingEditorAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthoringBindingEditorAdapter.js","sourceRoot":"","sources":["../../../../../src/features/registry/adapters/inbound/AuthoringBindingEditorAdapter.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE9C,oHAAoH;AACpH,MAAM,UAAU,6BAA6B,CAAkB,EAC7D,IAAI,EACJ,SAAS,EACT,UAAU,EACV,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,GAAG,KAAK,GACoC;IACpD,IAAI,IAAI,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACrD,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC;IAC3C,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAExC,OAAO,CACL,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CACX;MAAA,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;YAC7C,MAAM,eAAe,GAAG,QAAQ,IAAI,iBAAiB,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC;YAC7E,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC;YAC1D,OAAO,CACL,CAAC,KAAK,CACJ,GAAG,CAAC,CAAC,IAAI,CAAC,CACV,WAAW,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAC9B,QAAQ,CAAC,CAAC,eAAe,CAAC,CAC1B,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAC1B,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAEnB;YAAA,CAAC,aAAa,CAAC;oBACb,IAAI;oBACJ,SAAS;oBACT,IAAI;oBACJ,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;oBACzB,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC;oBAC/B,QAAQ,EAAE,eAAe;oBACzB,QAAQ;oBACR,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE;wBACpB,IAAI,CAAC,eAAe;4BAAE,eAAe,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;oBAC/D,CAAC;iBACF,CAAC,CACJ;UAAA,EAAE,KAAK,CAAC,CACT,CAAC;QACJ,CAAC,CAAC,CACJ;IAAA,EAAE,IAAI,CAAC,CACR,CAAC;AACJ,CAAC","sourcesContent":["import React from 'react';\n\nimport type { AuthoringBindingEditorAdapterProps } from '../../../../types/authoring-adapters';\nimport { Field } from '../../../form/public';\nimport { View } from '../../../layout/public';\n\n/*** Presents canonical bindable properties while leaving binding representation and mutation ownership external. */\nexport function AuthoringBindingEditorAdapter<TNode, TBinding>({\n  node,\n  component,\n  getBinding,\n  onBindingChange,\n  renderBinding,\n  isBindingDisabled,\n  isBindingRequired,\n  disabled = false,\n}: AuthoringBindingEditorAdapterProps<TNode, TBinding>) {\n  if (node === null || component === null) return null;\n  const bindings = component.bindings?.props;\n  if (bindings === undefined) return null;\n\n  return (\n    <View gap=\"m\">\n      {Object.entries(bindings).map(([name, meta]) => {\n        const controlDisabled = disabled || isBindingDisabled?.(node, name) === true;\n        const required = isBindingRequired?.(node, name) === true;\n        return (\n          <Field\n            key={name}\n            description={meta.description}\n            disabled={controlDisabled}\n            label={meta.label ?? name}\n            required={required}\n          >\n            {renderBinding({\n              node,\n              component,\n              name,\n              label: meta.label ?? name,\n              description: meta.description,\n              binding: getBinding(node, name),\n              disabled: controlDisabled,\n              required,\n              onChange: (binding) => {\n                if (!controlDisabled) onBindingChange?.(node, name, binding);\n              },\n            })}\n          </Field>\n        );\n      })}\n    </View>\n  );\n}\n"]}

package/dist/features/registry/adapters/inbound/AuthoringPropertyInspectorAdapter.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { AuthoringPropertyInspectorAdapterProps } from '../../../../types/authoring-adapters';
+/*** Presents canonical component properties while keeping node storage and mutations with the consumer. */
+export declare function AuthoringPropertyInspectorAdapter<TNode>({ node, component, getPropertyValue, onPropertyChange, renderProperty, isPropertyDisabled, isPropertyRequired, disabled, }: AuthoringPropertyInspectorAdapterProps<TNode>): React.JSX.Element | null;
+//# sourceMappingURL=AuthoringPropertyInspectorAdapter.d.ts.map

package/dist/features/registry/adapters/inbound/AuthoringPropertyInspectorAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthoringPropertyInspectorAdapter.d.ts","sourceRoot":"","sources":["../../../../../src/features/registry/adapters/inbound/AuthoringPropertyInspectorAdapter.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,sCAAsC,CAAC;AAInG,2GAA2G;AAC3G,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,EACvD,IAAI,EACJ,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,QAAgB,GACjB,EAAE,sCAAsC,CAAC,KAAK,CAAC,4BAiC/C"}

package/dist/features/registry/adapters/inbound/AuthoringPropertyInspectorAdapter.js

@@ -0,0 +1,30 @@
+import React from 'react';
+import { Field } from '../../../form/public';
+import { View } from '../../../layout/public';
+/*** Presents canonical component properties while keeping node storage and mutations with the consumer. */
+export function AuthoringPropertyInspectorAdapter({ node, component, getPropertyValue, onPropertyChange, renderProperty, isPropertyDisabled, isPropertyRequired, disabled = false, }) {
+    if (node === null || component === null)
+        return null;
+    return (<View gap="m">
+      {Object.entries(component.props).map(([name, schema]) => {
+            const controlDisabled = disabled || isPropertyDisabled?.(node, name, schema) === true;
+            const required = isPropertyRequired?.(node, name, schema) === true;
+            return (<Field key={name} description={schema.label === undefined ? undefined : schema.category} disabled={controlDisabled} label={schema.label ?? name} required={required}>
+            {renderProperty({
+                    node,
+                    component,
+                    name,
+                    schema,
+                    value: getPropertyValue(node, name),
+                    disabled: controlDisabled,
+                    required,
+                    onChange: (value) => {
+                        if (!controlDisabled)
+                            onPropertyChange?.(node, name, value);
+                    },
+                })}
+          </Field>);
+        })}
+    </View>);
+}
+//# sourceMappingURL=AuthoringPropertyInspectorAdapter.js.map

package/dist/features/registry/adapters/inbound/AuthoringPropertyInspectorAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthoringPropertyInspectorAdapter.js","sourceRoot":"","sources":["../../../../../src/features/registry/adapters/inbound/AuthoringPropertyInspectorAdapter.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE9C,2GAA2G;AAC3G,MAAM,UAAU,iCAAiC,CAAQ,EACvD,IAAI,EACJ,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,QAAQ,GAAG,KAAK,GAC8B;IAC9C,IAAI,IAAI,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAErD,OAAO,CACL,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CACX;MAAA,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE;YACtD,MAAM,eAAe,GAAG,QAAQ,IAAI,kBAAkB,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;YACtF,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;YACnE,OAAO,CACL,CAAC,KAAK,CACJ,GAAG,CAAC,CAAC,IAAI,CAAC,CACV,WAAW,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CACtE,QAAQ,CAAC,CAAC,eAAe,CAAC,CAC1B,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,CAC5B,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAEnB;YAAA,CAAC,cAAc,CAAC;oBACd,IAAI;oBACJ,SAAS;oBACT,IAAI;oBACJ,MAAM;oBACN,KAAK,EAAE,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC;oBACnC,QAAQ,EAAE,eAAe;oBACzB,QAAQ;oBACR,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;wBAClB,IAAI,CAAC,eAAe;4BAAE,gBAAgB,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;oBAC9D,CAAC;iBACF,CAAC,CACJ;UAAA,EAAE,KAAK,CAAC,CACT,CAAC;QACJ,CAAC,CAAC,CACJ;IAAA,EAAE,IAAI,CAAC,CACR,CAAC;AACJ,CAAC","sourcesContent":["import React from 'react';\n\nimport type { AuthoringPropertyInspectorAdapterProps } from '../../../../types/authoring-adapters';\nimport { Field } from '../../../form/public';\nimport { View } from '../../../layout/public';\n\n/*** Presents canonical component properties while keeping node storage and mutations with the consumer. */\nexport function AuthoringPropertyInspectorAdapter<TNode>({\n  node,\n  component,\n  getPropertyValue,\n  onPropertyChange,\n  renderProperty,\n  isPropertyDisabled,\n  isPropertyRequired,\n  disabled = false,\n}: AuthoringPropertyInspectorAdapterProps<TNode>) {\n  if (node === null || component === null) return null;\n\n  return (\n    <View gap=\"m\">\n      {Object.entries(component.props).map(([name, schema]) => {\n        const controlDisabled = disabled || isPropertyDisabled?.(node, name, schema) === true;\n        const required = isPropertyRequired?.(node, name, schema) === true;\n        return (\n          <Field\n            key={name}\n            description={schema.label === undefined ? undefined : schema.category}\n            disabled={controlDisabled}\n            label={schema.label ?? name}\n            required={required}\n          >\n            {renderProperty({\n              node,\n              component,\n              name,\n              schema,\n              value: getPropertyValue(node, name),\n              disabled: controlDisabled,\n              required,\n              onChange: (value) => {\n                if (!controlDisabled) onPropertyChange?.(node, name, value);\n              },\n            })}\n          </Field>\n        );\n      })}\n    </View>\n  );\n}\n"]}

package/dist/features/registry/adapters/inbound/AuthoringSelectionAdapter.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { AuthoringSelectionAdapterProps } from '../../../../types/authoring-adapters';
+/*** Connects consumer-owned items to ZORA's controlled single-selection behavior. */
+export declare function AuthoringSelectionAdapter<TItem>({ items, selectedItemId, getItemId, onSelectionChange, renderItem, disabled, }: AuthoringSelectionAdapterProps<TItem>): React.JSX.Element;
+//# sourceMappingURL=AuthoringSelectionAdapter.d.ts.map

package/dist/features/registry/adapters/inbound/AuthoringSelectionAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthoringSelectionAdapter.d.ts","sourceRoot":"","sources":["../../../../../src/features/registry/adapters/inbound/AuthoringSelectionAdapter.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,sCAAsC,CAAC;AAG3F,qFAAqF;AACrF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,EAC/C,KAAK,EACL,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,QAAQ,GACT,EAAE,8BAA8B,CAAC,KAAK,CAAC,qBA4BvC"}

package/dist/features/registry/adapters/inbound/AuthoringSelectionAdapter.js

@@ -0,0 +1,22 @@
+import React from 'react';
+import { SelectableItem, SelectionProvider } from '../../../selection/public';
+/*** Connects consumer-owned items to ZORA's controlled single-selection behavior. */
+export function AuthoringSelectionAdapter({ items, selectedItemId, getItemId, onSelectionChange, renderItem, disabled, }) {
+    return (<SelectionProvider disabled={disabled} mode="single" selectedIds={selectedItemId === undefined ? [] : [selectedItemId]} onSelectionChange={(ids) => {
+            const [selectedId] = ids;
+            onSelectionChange?.(items.find((item) => getItemId(item) === selectedId) ?? null);
+        }}>
+      {items.map((item) => {
+            const id = getItemId(item);
+            return (<SelectableItem key={id} id={id} trigger="press">
+            {(state) => renderItem({
+                    item,
+                    selected: state.selected,
+                    disabled: state.disabled,
+                    select: state.select,
+                })}
+          </SelectableItem>);
+        })}
+    </SelectionProvider>);
+}
+//# sourceMappingURL=AuthoringSelectionAdapter.js.map

package/dist/features/registry/adapters/inbound/AuthoringSelectionAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthoringSelectionAdapter.js","sourceRoot":"","sources":["../../../../../src/features/registry/adapters/inbound/AuthoringSelectionAdapter.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9E,qFAAqF;AACrF,MAAM,UAAU,yBAAyB,CAAQ,EAC/C,KAAK,EACL,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,QAAQ,GAC8B;IACtC,OAAO,CACL,CAAC,iBAAiB,CAChB,QAAQ,CAAC,CAAC,QAAQ,CAAC,CACnB,IAAI,CAAC,QAAQ,CACb,WAAW,CAAC,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAClE,iBAAiB,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE;YACzB,MAAM,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC;YACzB,iBAAiB,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,IAAI,IAAI,CAAC,CAAC;QACpF,CAAC,CAAC,CAEF;MAAA,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAClB,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC3B,OAAO,CACL,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAC9C;YAAA,CAAC,CAAC,KAAK,EAAE,EAAE,CACT,UAAU,CAAC;oBACT,IAAI;oBACJ,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,MAAM,EAAE,KAAK,CAAC,MAAM;iBACrB,CACH,CACF;UAAA,EAAE,cAAc,CAAC,CAClB,CAAC;QACJ,CAAC,CAAC,CACJ;IAAA,EAAE,iBAAiB,CAAC,CACrB,CAAC;AACJ,CAAC","sourcesContent":["import React from 'react';\n\nimport type { AuthoringSelectionAdapterProps } from '../../../../types/authoring-adapters';\nimport { SelectableItem, SelectionProvider } from '../../../selection/public';\n\n/*** Connects consumer-owned items to ZORA's controlled single-selection behavior. */\nexport function AuthoringSelectionAdapter<TItem>({\n  items,\n  selectedItemId,\n  getItemId,\n  onSelectionChange,\n  renderItem,\n  disabled,\n}: AuthoringSelectionAdapterProps<TItem>) {\n  return (\n    <SelectionProvider\n      disabled={disabled}\n      mode=\"single\"\n      selectedIds={selectedItemId === undefined ? [] : [selectedItemId]}\n      onSelectionChange={(ids) => {\n        const [selectedId] = ids;\n        onSelectionChange?.(items.find((item) => getItemId(item) === selectedId) ?? null);\n      }}\n    >\n      {items.map((item) => {\n        const id = getItemId(item);\n        return (\n          <SelectableItem key={id} id={id} trigger=\"press\">\n            {(state) =>\n              renderItem({\n                item,\n                selected: state.selected,\n                disabled: state.disabled,\n                select: state.select,\n              })\n            }\n          </SelectableItem>\n        );\n      })}\n    </SelectionProvider>\n  );\n}\n"]}

package/dist/features/registry/adapters/inbound/ThemeEditorAdapter.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { ThemeEditorAdapterProps } from '../../../../types/authoring-adapters';
+/*** Presents ZORA recipe fields without taking ownership of a consumer's theme document. */
+export declare function ThemeEditorAdapter<TTheme>({ theme, recipes, getRecipeFieldValue, onRecipeFieldChange, renderField, isFieldDisabled, isFieldRequired, disabled, }: ThemeEditorAdapterProps<TTheme>): React.JSX.Element | null;
+//# sourceMappingURL=ThemeEditorAdapter.d.ts.map

package/dist/features/registry/adapters/inbound/ThemeEditorAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeEditorAdapter.d.ts","sourceRoot":"","sources":["../../../../../src/features/registry/adapters/inbound/ThemeEditorAdapter.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAMpF,4FAA4F;AAC5F,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,EACzC,KAAK,EACL,OAAgC,EAChC,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,eAAe,EACf,QAAgB,GACjB,EAAE,uBAAuB,CAAC,MAAM,CAAC,4BA0CjC"}

package/dist/features/registry/adapters/inbound/ThemeEditorAdapter.js

@@ -0,0 +1,37 @@
+import React from 'react';
+import { Card } from '../../../card/public';
+import { Field } from '../../../form/public';
+import { View } from '../../../layout/public';
+import { ZORA_THEME_RECIPE_META } from '../../themeRecipeMeta';
+/*** Presents ZORA recipe fields without taking ownership of a consumer's theme document. */
+export function ThemeEditorAdapter({ theme, recipes = ZORA_THEME_RECIPE_META, getRecipeFieldValue, onRecipeFieldChange, renderField, isFieldDisabled, isFieldRequired, disabled = false, }) {
+    if (theme === null)
+        return null;
+    return (<View gap="m">
+      {Object.entries(recipes).map(([recipeName, recipe]) => (<Card key={recipeName} description={recipe.description} title={recipe.name}>
+          <View gap="m">
+            {Object.entries(recipe.fields).map(([fieldName, field]) => {
+                const controlDisabled = disabled || isFieldDisabled?.(theme, recipeName, fieldName) === true;
+                const required = isFieldRequired?.(theme, recipeName, fieldName) === true;
+                return (<Field key={fieldName} description={field.description} disabled={controlDisabled} label={field.label} required={required}>
+                  {renderField({
+                        theme,
+                        recipeName,
+                        fieldName,
+                        field,
+                        value: getRecipeFieldValue(theme, recipeName, fieldName),
+                        disabled: controlDisabled,
+                        required,
+                        onChange: (value) => {
+                            if (!controlDisabled) {
+                                onRecipeFieldChange?.(theme, recipeName, fieldName, value);
+                            }
+                        },
+                    })}
+                </Field>);
+            })}
+          </View>
+        </Card>))}
+    </View>);
+}
+//# sourceMappingURL=ThemeEditorAdapter.js.map

package/dist/features/registry/adapters/inbound/ThemeEditorAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeEditorAdapter.js","sourceRoot":"","sources":["../../../../../src/features/registry/adapters/inbound/ThemeEditorAdapter.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,4FAA4F;AAC5F,MAAM,UAAU,kBAAkB,CAAS,EACzC,KAAK,EACL,OAAO,GAAG,sBAAsB,EAChC,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,eAAe,EACf,QAAQ,GAAG,KAAK,GACgB;IAChC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhC,OAAO,CACL,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CACX;MAAA,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CACrD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CACzE;UAAA,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CACX;YAAA,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE;gBACxD,MAAM,eAAe,GACnB,QAAQ,IAAI,eAAe,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,CAAC,KAAK,IAAI,CAAC;gBACvE,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,CAAC,KAAK,IAAI,CAAC;gBAC1E,OAAO,CACL,CAAC,KAAK,CACJ,GAAG,CAAC,CAAC,SAAS,CAAC,CACf,WAAW,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAC/B,QAAQ,CAAC,CAAC,eAAe,CAAC,CAC1B,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CACnB,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAEnB;kBAAA,CAAC,WAAW,CAAC;wBACX,KAAK;wBACL,UAAU;wBACV,SAAS;wBACT,KAAK;wBACL,KAAK,EAAE,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,CAAC;wBACxD,QAAQ,EAAE,eAAe;wBACzB,QAAQ;wBACR,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;4BAClB,IAAI,CAAC,eAAe,EAAE,CAAC;gCACrB,mBAAmB,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;4BAC7D,CAAC;wBACH,CAAC;qBACF,CAAC,CACJ;gBAAA,EAAE,KAAK,CAAC,CACT,CAAC;YACJ,CAAC,CAAC,CACJ;UAAA,EAAE,IAAI,CACR;QAAA,EAAE,IAAI,CAAC,CACR,CAAC,CACJ;IAAA,EAAE,IAAI,CAAC,CACR,CAAC;AACJ,CAAC","sourcesContent":["import React from 'react';\n\nimport type { ThemeEditorAdapterProps } from '../../../../types/authoring-adapters';\nimport { Card } from '../../../card/public';\nimport { Field } from '../../../form/public';\nimport { View } from '../../../layout/public';\nimport { ZORA_THEME_RECIPE_META } from '../../themeRecipeMeta';\n\n/*** Presents ZORA recipe fields without taking ownership of a consumer's theme document. */\nexport function ThemeEditorAdapter<TTheme>({\n  theme,\n  recipes = ZORA_THEME_RECIPE_META,\n  getRecipeFieldValue,\n  onRecipeFieldChange,\n  renderField,\n  isFieldDisabled,\n  isFieldRequired,\n  disabled = false,\n}: ThemeEditorAdapterProps<TTheme>) {\n  if (theme === null) return null;\n\n  return (\n    <View gap=\"m\">\n      {Object.entries(recipes).map(([recipeName, recipe]) => (\n        <Card key={recipeName} description={recipe.description} title={recipe.name}>\n          <View gap=\"m\">\n            {Object.entries(recipe.fields).map(([fieldName, field]) => {\n              const controlDisabled =\n                disabled || isFieldDisabled?.(theme, recipeName, fieldName) === true;\n              const required = isFieldRequired?.(theme, recipeName, fieldName) === true;\n              return (\n                <Field\n                  key={fieldName}\n                  description={field.description}\n                  disabled={controlDisabled}\n                  label={field.label}\n                  required={required}\n                >\n                  {renderField({\n                    theme,\n                    recipeName,\n                    fieldName,\n                    field,\n                    value: getRecipeFieldValue(theme, recipeName, fieldName),\n                    disabled: controlDisabled,\n                    required,\n                    onChange: (value) => {\n                      if (!controlDisabled) {\n                        onRecipeFieldChange?.(theme, recipeName, fieldName, value);\n                      }\n                    },\n                  })}\n                </Field>\n              );\n            })}\n          </View>\n        </Card>\n      ))}\n    </View>\n  );\n}\n"]}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+export type { AuthoringBindingControlState, AuthoringBindingEditorAdapterProps, AuthoringPropertyControlState, AuthoringPropertyInspectorAdapterProps, AuthoringSelectionAdapterProps, AuthoringSelectionItemState, ThemeEditorAdapterProps, ThemeRecipeFieldControlState, } from './authoring';
+export { AuthoringBindingEditorAdapter, AuthoringPropertyInspectorAdapter, AuthoringSelectionAdapter, ThemeEditorAdapter, } from './authoring';
 export type { ReaderColorScheme, ReaderDocumentFormat, ReaderErrorCode, ReaderErrorEvent, ReaderExternalLinkEvent, ReaderLineHeight, ReaderLocationChangeEvent, ReaderNavigationTrigger, ReaderProps, ReaderResolvedSource, ReaderStatus, } from './features/reader/public';
 export { Reader, resolveReaderProgress } from './features/reader/public';
 export { ZORA_COMPONENT_REGISTRY } from './features/registry/public';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,EAChB,yBAAyB,EACzB,uBAAuB,EACvB,WAAW,EACX,oBAAoB,EACpB,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,cAAc,cAAc,CAAC;AAC7B,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,4BAA4B,EAC5B,kCAAkC,EAClC,6BAA6B,EAC7B,sCAAsC,EACtC,8BAA8B,EAC9B,2BAA2B,EAC3B,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,EACjC,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,EAChB,yBAAyB,EACzB,uBAAuB,EACvB,WAAW,EACX,oBAAoB,EACpB,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,cAAc,cAAc,CAAC;AAC7B,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
+export { AuthoringBindingEditorAdapter, AuthoringPropertyInspectorAdapter, AuthoringSelectionAdapter, ThemeEditorAdapter, } from './authoring';
 export { Reader, resolveReaderProgress } from './features/reader/public';
 export { ZORA_COMPONENT_REGISTRY } from './features/registry/public';
 export * from './readerFree';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,cAAc,cAAc,CAAC","sourcesContent":["export type {\n  ReaderColorScheme,\n  ReaderDocumentFormat,\n  ReaderErrorCode,\n  ReaderErrorEvent,\n  ReaderExternalLinkEvent,\n  ReaderLineHeight,\n  ReaderLocationChangeEvent,\n  ReaderNavigationTrigger,\n  ReaderProps,\n  ReaderResolvedSource,\n  ReaderStatus,\n} from './features/reader/public';\nexport { Reader, resolveReaderProgress } from './features/reader/public';\nexport { ZORA_COMPONENT_REGISTRY } from './features/registry/public';\nexport * from './readerFree';\nexport type { ZoraComponentRegistry } from './types/registry';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,EACjC,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAcrB,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,cAAc,cAAc,CAAC","sourcesContent":["export type {\n  AuthoringBindingControlState,\n  AuthoringBindingEditorAdapterProps,\n  AuthoringPropertyControlState,\n  AuthoringPropertyInspectorAdapterProps,\n  AuthoringSelectionAdapterProps,\n  AuthoringSelectionItemState,\n  ThemeEditorAdapterProps,\n  ThemeRecipeFieldControlState,\n} from './authoring';\nexport {\n  AuthoringBindingEditorAdapter,\n  AuthoringPropertyInspectorAdapter,\n  AuthoringSelectionAdapter,\n  ThemeEditorAdapter,\n} from './authoring';\nexport type {\n  ReaderColorScheme,\n  ReaderDocumentFormat,\n  ReaderErrorCode,\n  ReaderErrorEvent,\n  ReaderExternalLinkEvent,\n  ReaderLineHeight,\n  ReaderLocationChangeEvent,\n  ReaderNavigationTrigger,\n  ReaderProps,\n  ReaderResolvedSource,\n  ReaderStatus,\n} from './features/reader/public';\nexport { Reader, resolveReaderProgress } from './features/reader/public';\nexport { ZORA_COMPONENT_REGISTRY } from './features/registry/public';\nexport * from './readerFree';\nexport type { ZoraComponentRegistry } from './types/registry';\n"]}

package/dist/types/authoring-adapters.d.ts

@@ -0,0 +1,79 @@
+import type React from 'react';
+import type { ZoraComponentMeta, ZoraComponentPropSchema, ZoraComponentPropValue } from './authoring';
+import type { ZoraThemeRecipeFieldMeta, ZoraThemeRecipeMetaRegistry } from './theme-recipe';
+export interface AuthoringSelectionItemState<TItem> {
+    readonly item: TItem;
+    readonly selected: boolean;
+    readonly disabled: boolean;
+    readonly select: () => void;
+}
+export interface AuthoringSelectionAdapterProps<TItem> {
+    readonly items: readonly TItem[];
+    readonly selectedItemId?: string;
+    readonly getItemId: (item: TItem) => string;
+    readonly onSelectionChange?: (item: TItem | null) => void;
+    readonly renderItem: (state: AuthoringSelectionItemState<TItem>) => React.ReactNode;
+    readonly disabled?: boolean;
+}
+export interface AuthoringPropertyControlState<TNode> {
+    readonly node: TNode;
+    readonly component: ZoraComponentMeta;
+    readonly name: string;
+    readonly schema: ZoraComponentPropSchema;
+    readonly value: ZoraComponentPropValue | undefined;
+    readonly disabled: boolean;
+    readonly required: boolean;
+    readonly onChange: (value: ZoraComponentPropValue | undefined) => void;
+}
+export interface AuthoringPropertyInspectorAdapterProps<TNode> {
+    readonly node: TNode | null;
+    readonly component: ZoraComponentMeta | null;
+    readonly getPropertyValue: (node: TNode, name: string) => ZoraComponentPropValue | undefined;
+    readonly onPropertyChange?: (node: TNode, name: string, value: ZoraComponentPropValue | undefined) => void;
+    readonly renderProperty: (state: AuthoringPropertyControlState<TNode>) => React.ReactNode;
+    readonly isPropertyDisabled?: (node: TNode, name: string, schema: ZoraComponentPropSchema) => boolean;
+    readonly isPropertyRequired?: (node: TNode, name: string, schema: ZoraComponentPropSchema) => boolean;
+    readonly disabled?: boolean;
+}
+export interface AuthoringBindingControlState<TNode, TBinding> {
+    readonly node: TNode;
+    readonly component: ZoraComponentMeta;
+    readonly name: string;
+    readonly label: string;
+    readonly description?: string;
+    readonly binding: TBinding | undefined;
+    readonly disabled: boolean;
+    readonly required: boolean;
+    readonly onChange: (binding: TBinding | undefined) => void;
+}
+export interface AuthoringBindingEditorAdapterProps<TNode, TBinding> {
+    readonly node: TNode | null;
+    readonly component: ZoraComponentMeta | null;
+    readonly getBinding: (node: TNode, name: string) => TBinding | undefined;
+    readonly onBindingChange?: (node: TNode, name: string, binding: TBinding | undefined) => void;
+    readonly renderBinding: (state: AuthoringBindingControlState<TNode, TBinding>) => React.ReactNode;
+    readonly isBindingDisabled?: (node: TNode, name: string) => boolean;
+    readonly isBindingRequired?: (node: TNode, name: string) => boolean;
+    readonly disabled?: boolean;
+}
+export interface ThemeRecipeFieldControlState<TTheme> {
+    readonly theme: TTheme;
+    readonly recipeName: string;
+    readonly fieldName: string;
+    readonly field: ZoraThemeRecipeFieldMeta;
+    readonly value: string | boolean | undefined;
+    readonly disabled: boolean;
+    readonly required: boolean;
+    readonly onChange: (value: string | boolean | undefined) => void;
+}
+export interface ThemeEditorAdapterProps<TTheme> {
+    readonly theme: TTheme | null;
+    readonly recipes?: ZoraThemeRecipeMetaRegistry;
+    readonly getRecipeFieldValue: (theme: TTheme, recipeName: string, fieldName: string) => string | boolean | undefined;
+    readonly onRecipeFieldChange?: (theme: TTheme, recipeName: string, fieldName: string, value: string | boolean | undefined) => void;
+    readonly renderField: (state: ThemeRecipeFieldControlState<TTheme>) => React.ReactNode;
+    readonly isFieldDisabled?: (theme: TTheme, recipeName: string, fieldName: string) => boolean;
+    readonly isFieldRequired?: (theme: TTheme, recipeName: string, fieldName: string) => boolean;
+    readonly disabled?: boolean;
+}
+//# sourceMappingURL=authoring-adapters.d.ts.map

package/dist/types/authoring-adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring-adapters.d.ts","sourceRoot":"","sources":["../../src/types/authoring-adapters.ts"],"names":[],"mappings":"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"}

package/dist/types/authoring-adapters.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=authoring-adapters.js.map

package/dist/types/authoring-adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring-adapters.js","sourceRoot":"","sources":["../../src/types/authoring-adapters.ts"],"names":[],"mappings":"","sourcesContent":["import type React from 'react';\n\nimport type {\n  ZoraComponentMeta,\n  ZoraComponentPropSchema,\n  ZoraComponentPropValue,\n} from './authoring';\nimport type { ZoraThemeRecipeFieldMeta, ZoraThemeRecipeMetaRegistry } from './theme-recipe';\n\nexport interface AuthoringSelectionItemState<TItem> {\n  readonly item: TItem;\n  readonly selected: boolean;\n  readonly disabled: boolean;\n  readonly select: () => void;\n}\n\nexport interface AuthoringSelectionAdapterProps<TItem> {\n  readonly items: readonly TItem[];\n  readonly selectedItemId?: string;\n  readonly getItemId: (item: TItem) => string;\n  readonly onSelectionChange?: (item: TItem | null) => void;\n  readonly renderItem: (state: AuthoringSelectionItemState<TItem>) => React.ReactNode;\n  readonly disabled?: boolean;\n}\n\nexport interface AuthoringPropertyControlState<TNode> {\n  readonly node: TNode;\n  readonly component: ZoraComponentMeta;\n  readonly name: string;\n  readonly schema: ZoraComponentPropSchema;\n  readonly value: ZoraComponentPropValue | undefined;\n  readonly disabled: boolean;\n  readonly required: boolean;\n  readonly onChange: (value: ZoraComponentPropValue | undefined) => void;\n}\n\nexport interface AuthoringPropertyInspectorAdapterProps<TNode> {\n  readonly node: TNode | null;\n  readonly component: ZoraComponentMeta | null;\n  readonly getPropertyValue: (node: TNode, name: string) => ZoraComponentPropValue | undefined;\n  readonly onPropertyChange?: (\n    node: TNode,\n    name: string,\n    value: ZoraComponentPropValue | undefined,\n  ) => void;\n  readonly renderProperty: (state: AuthoringPropertyControlState<TNode>) => React.ReactNode;\n  readonly isPropertyDisabled?: (\n    node: TNode,\n    name: string,\n    schema: ZoraComponentPropSchema,\n  ) => boolean;\n  readonly isPropertyRequired?: (\n    node: TNode,\n    name: string,\n    schema: ZoraComponentPropSchema,\n  ) => boolean;\n  readonly disabled?: boolean;\n}\n\nexport interface AuthoringBindingControlState<TNode, TBinding> {\n  readonly node: TNode;\n  readonly component: ZoraComponentMeta;\n  readonly name: string;\n  readonly label: string;\n  readonly description?: string;\n  readonly binding: TBinding | undefined;\n  readonly disabled: boolean;\n  readonly required: boolean;\n  readonly onChange: (binding: TBinding | undefined) => void;\n}\n\nexport interface AuthoringBindingEditorAdapterProps<TNode, TBinding> {\n  readonly node: TNode | null;\n  readonly component: ZoraComponentMeta | null;\n  readonly getBinding: (node: TNode, name: string) => TBinding | undefined;\n  readonly onBindingChange?: (node: TNode, name: string, binding: TBinding | undefined) => void;\n  readonly renderBinding: (state: AuthoringBindingControlState<TNode, TBinding>) => React.ReactNode;\n  readonly isBindingDisabled?: (node: TNode, name: string) => boolean;\n  readonly isBindingRequired?: (node: TNode, name: string) => boolean;\n  readonly disabled?: boolean;\n}\n\nexport interface ThemeRecipeFieldControlState<TTheme> {\n  readonly theme: TTheme;\n  readonly recipeName: string;\n  readonly fieldName: string;\n  readonly field: ZoraThemeRecipeFieldMeta;\n  readonly value: string | boolean | undefined;\n  readonly disabled: boolean;\n  readonly required: boolean;\n  readonly onChange: (value: string | boolean | undefined) => void;\n}\n\nexport interface ThemeEditorAdapterProps<TTheme> {\n  readonly theme: TTheme | null;\n  readonly recipes?: ZoraThemeRecipeMetaRegistry;\n  readonly getRecipeFieldValue: (\n    theme: TTheme,\n    recipeName: string,\n    fieldName: string,\n  ) => string | boolean | undefined;\n  readonly onRecipeFieldChange?: (\n    theme: TTheme,\n    recipeName: string,\n    fieldName: string,\n    value: string | boolean | undefined,\n  ) => void;\n  readonly renderField: (state: ThemeRecipeFieldControlState<TTheme>) => React.ReactNode;\n  readonly isFieldDisabled?: (theme: TTheme, recipeName: string, fieldName: string) => boolean;\n  readonly isFieldRequired?: (theme: TTheme, recipeName: string, fieldName: string) => boolean;\n  readonly disabled?: boolean;\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/zora",
   "type": "module",
-  "version": "27.0.3",
+  "version": "27.1.0",
   "description": "Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.",
   "homepage": "https://github.com/ankhorage/zora#readme",
   "bugs": {
@@ -118,6 +118,13 @@
       "import": "./dist/features/theme/public.js",
       "default": "./dist/features/theme/public.js"
     },
+    "./authoring": {
+      "react-native": "./src/authoring.ts",
+      "browser": "./src/authoring.ts",
+      "types": "./dist/authoring.d.ts",
+      "import": "./dist/authoring.js",
+      "default": "./dist/authoring.js"
+    },
     "./web/runtime": {
       "types": "./web-dist/runtime/ZoraProvider.d.ts",
       "import": "./web-dist/runtime/ZoraProvider.js",

package/src/authoring.ts

@@ -0,0 +1,14 @@
+export { AuthoringBindingEditorAdapter } from './features/registry/adapters/inbound/AuthoringBindingEditorAdapter';
+export { AuthoringPropertyInspectorAdapter } from './features/registry/adapters/inbound/AuthoringPropertyInspectorAdapter';
+export { AuthoringSelectionAdapter } from './features/registry/adapters/inbound/AuthoringSelectionAdapter';
+export { ThemeEditorAdapter } from './features/registry/adapters/inbound/ThemeEditorAdapter';
+export type {
+  AuthoringBindingControlState,
+  AuthoringBindingEditorAdapterProps,
+  AuthoringPropertyControlState,
+  AuthoringPropertyInspectorAdapterProps,
+  AuthoringSelectionAdapterProps,
+  AuthoringSelectionItemState,
+  ThemeEditorAdapterProps,
+  ThemeRecipeFieldControlState,
+} from './types/authoring-adapters';

package/src/features/registry/adapters/inbound/AuthoringBindingEditorAdapter.tsx

@@ -0,0 +1,53 @@
+import React from 'react';
+
+import type { AuthoringBindingEditorAdapterProps } from '../../../../types/authoring-adapters';
+import { Field } from '../../../form/public';
+import { View } from '../../../layout/public';
+
+/*** Presents canonical bindable properties while leaving binding representation and mutation ownership external. */
+export function AuthoringBindingEditorAdapter<TNode, TBinding>({
+  node,
+  component,
+  getBinding,
+  onBindingChange,
+  renderBinding,
+  isBindingDisabled,
+  isBindingRequired,
+  disabled = false,
+}: AuthoringBindingEditorAdapterProps<TNode, TBinding>) {
+  if (node === null || component === null) return null;
+  const bindings = component.bindings?.props;
+  if (bindings === undefined) return null;
+
+  return (
+    <View gap="m">
+      {Object.entries(bindings).map(([name, meta]) => {
+        const controlDisabled = disabled || isBindingDisabled?.(node, name) === true;
+        const required = isBindingRequired?.(node, name) === true;
+        return (
+          <Field
+            key={name}
+            description={meta.description}
+            disabled={controlDisabled}
+            label={meta.label ?? name}
+            required={required}
+          >
+            {renderBinding({
+              node,
+              component,
+              name,
+              label: meta.label ?? name,
+              description: meta.description,
+              binding: getBinding(node, name),
+              disabled: controlDisabled,
+              required,
+              onChange: (binding) => {
+                if (!controlDisabled) onBindingChange?.(node, name, binding);
+              },
+            })}
+          </Field>
+        );
+      })}
+    </View>
+  );
+}

package/src/features/registry/adapters/inbound/AuthoringPropertyInspectorAdapter.tsx

@@ -0,0 +1,50 @@
+import React from 'react';
+
+import type { AuthoringPropertyInspectorAdapterProps } from '../../../../types/authoring-adapters';
+import { Field } from '../../../form/public';
+import { View } from '../../../layout/public';
+
+/*** Presents canonical component properties while keeping node storage and mutations with the consumer. */
+export function AuthoringPropertyInspectorAdapter<TNode>({
+  node,
+  component,
+  getPropertyValue,
+  onPropertyChange,
+  renderProperty,
+  isPropertyDisabled,
+  isPropertyRequired,
+  disabled = false,
+}: AuthoringPropertyInspectorAdapterProps<TNode>) {
+  if (node === null || component === null) return null;
+
+  return (
+    <View gap="m">
+      {Object.entries(component.props).map(([name, schema]) => {
+        const controlDisabled = disabled || isPropertyDisabled?.(node, name, schema) === true;
+        const required = isPropertyRequired?.(node, name, schema) === true;
+        return (
+          <Field
+            key={name}
+            description={schema.label === undefined ? undefined : schema.category}
+            disabled={controlDisabled}
+            label={schema.label ?? name}
+            required={required}
+          >
+            {renderProperty({
+              node,
+              component,
+              name,
+              schema,
+              value: getPropertyValue(node, name),
+              disabled: controlDisabled,
+              required,
+              onChange: (value) => {
+                if (!controlDisabled) onPropertyChange?.(node, name, value);
+              },
+            })}
+          </Field>
+        );
+      })}
+    </View>
+  );
+}

package/src/features/registry/adapters/inbound/AuthoringSelectionAdapter.tsx

@@ -0,0 +1,42 @@
+import React from 'react';
+
+import type { AuthoringSelectionAdapterProps } from '../../../../types/authoring-adapters';
+import { SelectableItem, SelectionProvider } from '../../../selection/public';
+
+/*** Connects consumer-owned items to ZORA's controlled single-selection behavior. */
+export function AuthoringSelectionAdapter<TItem>({
+  items,
+  selectedItemId,
+  getItemId,
+  onSelectionChange,
+  renderItem,
+  disabled,
+}: AuthoringSelectionAdapterProps<TItem>) {
+  return (
+    <SelectionProvider
+      disabled={disabled}
+      mode="single"
+      selectedIds={selectedItemId === undefined ? [] : [selectedItemId]}
+      onSelectionChange={(ids) => {
+        const [selectedId] = ids;
+        onSelectionChange?.(items.find((item) => getItemId(item) === selectedId) ?? null);
+      }}
+    >
+      {items.map((item) => {
+        const id = getItemId(item);
+        return (
+          <SelectableItem key={id} id={id} trigger="press">
+            {(state) =>
+              renderItem({
+                item,
+                selected: state.selected,
+                disabled: state.disabled,
+                select: state.select,
+              })
+            }
+          </SelectableItem>
+        );
+      })}
+    </SelectionProvider>
+  );
+}

package/src/features/registry/adapters/inbound/ThemeEditorAdapter.tsx

@@ -0,0 +1,61 @@
+import React from 'react';
+
+import type { ThemeEditorAdapterProps } from '../../../../types/authoring-adapters';
+import { Card } from '../../../card/public';
+import { Field } from '../../../form/public';
+import { View } from '../../../layout/public';
+import { ZORA_THEME_RECIPE_META } from '../../themeRecipeMeta';
+
+/*** Presents ZORA recipe fields without taking ownership of a consumer's theme document. */
+export function ThemeEditorAdapter<TTheme>({
+  theme,
+  recipes = ZORA_THEME_RECIPE_META,
+  getRecipeFieldValue,
+  onRecipeFieldChange,
+  renderField,
+  isFieldDisabled,
+  isFieldRequired,
+  disabled = false,
+}: ThemeEditorAdapterProps<TTheme>) {
+  if (theme === null) return null;
+
+  return (
+    <View gap="m">
+      {Object.entries(recipes).map(([recipeName, recipe]) => (
+        <Card key={recipeName} description={recipe.description} title={recipe.name}>
+          <View gap="m">
+            {Object.entries(recipe.fields).map(([fieldName, field]) => {
+              const controlDisabled =
+                disabled || isFieldDisabled?.(theme, recipeName, fieldName) === true;
+              const required = isFieldRequired?.(theme, recipeName, fieldName) === true;
+              return (
+                <Field
+                  key={fieldName}
+                  description={field.description}
+                  disabled={controlDisabled}
+                  label={field.label}
+                  required={required}
+                >
+                  {renderField({
+                    theme,
+                    recipeName,
+                    fieldName,
+                    field,
+                    value: getRecipeFieldValue(theme, recipeName, fieldName),
+                    disabled: controlDisabled,
+                    required,
+                    onChange: (value) => {
+                      if (!controlDisabled) {
+                        onRecipeFieldChange?.(theme, recipeName, fieldName, value);
+                      }
+                    },
+                  })}
+                </Field>
+              );
+            })}
+          </View>
+        </Card>
+      ))}
+    </View>
+  );
+}

package/src/features/registry/adapters/inbound/authoringAdapters.test.tsx

@@ -0,0 +1,242 @@
+import { describe, expect, test } from 'bun:test';
+import { isValidElement, type ReactElement } from 'react';
+
+import type { ZoraComponentMeta } from '../../../../types/authoring';
+import type {
+  AuthoringBindingEditorAdapterProps,
+  AuthoringPropertyInspectorAdapterProps,
+  AuthoringSelectionAdapterProps,
+  ThemeEditorAdapterProps,
+} from '../../../../types/authoring-adapters';
+import type { ZoraThemeRecipeMetaRegistry } from '../../../../types/theme-recipe';
+
+type AuthoringSelectionAdapter = <TItem>(
+  props: AuthoringSelectionAdapterProps<TItem>,
+) => ReactElement;
+type AuthoringPropertyInspectorAdapter = <TNode>(
+  props: AuthoringPropertyInspectorAdapterProps<TNode>,
+) => ReactElement | null;
+type AuthoringBindingEditorAdapter = <TNode, TBinding>(
+  props: AuthoringBindingEditorAdapterProps<TNode, TBinding>,
+) => ReactElement | null;
+type ThemeEditorAdapter = <TTheme>(props: ThemeEditorAdapterProps<TTheme>) => ReactElement | null;
+
+interface LoadedAdapters {
+  readonly AuthoringBindingEditorAdapter: AuthoringBindingEditorAdapter;
+  readonly AuthoringPropertyInspectorAdapter: AuthoringPropertyInspectorAdapter;
+  readonly AuthoringSelectionAdapter: AuthoringSelectionAdapter;
+  readonly ThemeEditorAdapter: ThemeEditorAdapter;
+}
+
+const component: ZoraComponentMeta = {
+  name: 'Example',
+  category: 'component',
+  directManifestNode: true,
+  allowedChildren: [],
+  props: {
+    title: { type: 'string', category: 'Content', label: 'Title' },
+  },
+  bindings: {
+    props: {
+      title: {
+        label: 'Title binding',
+        value: { type: 'string' },
+        acceptsFallback: true,
+        acceptsTransforms: true,
+      },
+    },
+  },
+};
+
+const recipes: ZoraThemeRecipeMetaRegistry = {
+  Example: {
+    name: 'Example',
+    kind: 'component',
+    fields: {
+      color: { type: 'token', label: 'Color', tokenFamily: 'colors' },
+    },
+  },
+};
+
+describe('authoring adapters', () => {
+  test('maps consumer-owned selection data back from ZORA selection ids', async () => {
+    const { AuthoringSelectionAdapter } = await loadAdapters();
+    const selected: ({ id: string } | null)[] = [];
+    const element = AuthoringSelectionAdapter({
+      items: [{ id: 'first' }, { id: 'second' }],
+      selectedItemId: 'first',
+      getItemId: (item) => item.id,
+      onSelectionChange: (item) => selected.push(item),
+      renderItem: ({ item }) => <item data-id={item.id} />,
+    });
+    const change = findElement(element, 'SelectionProvider')?.props.onSelectionChange;
+
+    if (typeof change !== 'function') throw new Error('Missing selection mutation callback.');
+    Reflect.apply(change, undefined, [['second']]);
+    Reflect.apply(change, undefined, [[]]);
+
+    expect(selected).toEqual([{ id: 'second' }, null]);
+    expect(findElement(element, 'SelectionProvider')?.props.selectedIds).toEqual(['first']);
+  });
+
+  test('passes required state and real property mutations while preventing disabled mutations', async () => {
+    const { AuthoringPropertyInspectorAdapter } = await loadAdapters();
+    const mutations: [string, string | undefined][] = [];
+    const enabled = AuthoringPropertyInspectorAdapter({
+      node: { title: 'Current title' },
+      component,
+      getPropertyValue: (node, name) => (name === 'title' ? node.title : undefined),
+      onPropertyChange: (_node, name, value) => mutations.push([name, value as string | undefined]),
+      isPropertyRequired: () => true,
+      renderProperty: ({ disabled, onChange, required }) => (
+        <property disabled={disabled} onChange={onChange} required={required} />
+      ),
+    });
+    const enabledControl = findElement(enabled, 'property');
+    const change = readStringChange(enabledControl, 'property mutation callback');
+    change('Updated title');
+
+    const disabled = AuthoringPropertyInspectorAdapter({
+      node: { title: 'Current title' },
+      component,
+      getPropertyValue: (node, name) => (name === 'title' ? node.title : undefined),
+      onPropertyChange: (_node, name, value) => mutations.push([name, value as string | undefined]),
+      disabled: true,
+      renderProperty: ({ disabled: controlDisabled, onChange }) => (
+        <property disabled={controlDisabled} onChange={onChange} />
+      ),
+    });
+    const disabledChange = readStringChange(
+      findElement(disabled, 'property'),
+      'disabled property callback',
+    );
+    disabledChange('Ignored title');
+
+    expect(enabledControl?.props.required).toBe(true);
+    expect(findElement(disabled, 'property')?.props.disabled).toBe(true);
+    expect(mutations).toEqual([['title', 'Updated title']]);
+  });
+
+  test('passes disabled binding state and suppresses disabled binding mutations', async () => {
+    const { AuthoringBindingEditorAdapter } = await loadAdapters();
+    const mutations: [string, string | undefined][] = [];
+    const element = AuthoringBindingEditorAdapter({
+      node: { binding: 'source.title' },
+      component,
+      getBinding: (node) => node.binding,
+      onBindingChange: (_node, name, binding) => mutations.push([name, binding]),
+      disabled: true,
+      isBindingRequired: () => true,
+      renderBinding: ({ disabled, onChange, required }) => (
+        <binding disabled={disabled} onChange={onChange} required={required} />
+      ),
+    });
+    const control = findElement(element, 'binding');
+    const change = readStringChange(control, 'binding mutation callback');
+    change('replacement.title');
+
+    expect(control?.props.disabled).toBe(true);
+    expect(control?.props.required).toBe(true);
+    expect(mutations).toEqual([]);
+  });
+
+  test('passes theme field state and suppresses disabled theme mutations', async () => {
+    const { ThemeEditorAdapter } = await loadAdapters();
+    const mutations: [string, string, string | boolean | undefined][] = [];
+    const element = ThemeEditorAdapter({
+      theme: { color: 'primary' },
+      recipes,
+      getRecipeFieldValue: (theme) => theme.color,
+      onRecipeFieldChange: (_theme, recipeName, fieldName, value) =>
+        mutations.push([recipeName, fieldName, value]),
+      disabled: true,
+      isFieldRequired: () => true,
+      renderField: ({ disabled, onChange, required }) => (
+        <theme-field disabled={disabled} onChange={onChange} required={required} />
+      ),
+    });
+    const control = findElement(element, 'theme-field');
+    const change = readStringChange(control, 'theme mutation callback');
+    change('secondary');
+
+    expect(control?.props.disabled).toBe(true);
+    expect(control?.props.required).toBe(true);
+    expect(mutations).toEqual([]);
+  });
+});
+
+/*** Find a host element emitted by an adapter render prop without mounting platform controls. */
+function findElement(
+  node: unknown,
+  type: string,
+): ReactElement<Record<string, unknown>> | undefined {
+  if (Array.isArray(node)) {
+    return node.map((item) => findElement(item, type)).find((item) => item !== undefined);
+  }
+  if (!isValidElement<Record<string, unknown>>(node)) return undefined;
+  if (node.type === type) return node;
+  return findElement(node.props.children, type);
+}
+
+/*** Read the string-valued render-prop mutation callback after its runtime boundary check. */
+function readStringChange(
+  element: ReactElement<Record<string, unknown>> | undefined,
+  description: string,
+): (value: string) => void {
+  const value = element?.props.onChange;
+  if (typeof value !== 'function') throw new Error(`Missing ${description}.`);
+  return value as (nextValue: string) => void;
+}
+
+/*** Load adapter modules with inert ZORA controls so unit assertions stay at the public callback boundary. */
+async function loadAdapters(): Promise<LoadedAdapters> {
+  const build = await Bun.build({
+    entrypoints: [new URL('../../../../authoring.ts', import.meta.url).pathname],
+    target: 'bun',
+    plugins: [
+      {
+        name: 'inert-zora-authoring-controls',
+        setup(builder) {
+          builder.onResolve(
+            { filter: /(?:card|form|layout|registry|selection)\/public$/u },
+            ({ path }) => ({ path, namespace: 'inert-zora-controls' }),
+          );
+          builder.onLoad({ filter: /.*/u, namespace: 'inert-zora-controls' }, () => ({
+            loader: 'js',
+            contents: `export const Card='Card', Field='Field', View='View',
+              SelectableItem='SelectableItem', SelectionProvider='SelectionProvider';`,
+          }));
+        },
+      },
+    ],
+  });
+  if (!build.success || !build.outputs[0]) {
+    throw new Error(build.logs.map((log) => log.message).join('\n'));
+  }
+  const loaded: unknown = await import(
+    `data:text/javascript;base64,${Buffer.from(await build.outputs[0].text()).toString('base64')}`
+  );
+  return {
+    AuthoringBindingEditorAdapter: readAdapter(loaded, 'AuthoringBindingEditorAdapter'),
+    AuthoringPropertyInspectorAdapter: readAdapter(loaded, 'AuthoringPropertyInspectorAdapter'),
+    AuthoringSelectionAdapter: readAdapter(loaded, 'AuthoringSelectionAdapter'),
+    ThemeEditorAdapter: readAdapter(loaded, 'ThemeEditorAdapter'),
+  };
+}
+
+/*** Read one bundled adapter only after its runtime export has been verified as callable. */
+function readAdapter<TAdapter extends (...arguments_: never[]) => unknown>(
+  module: unknown,
+  name: string,
+): TAdapter {
+  const value = isRecord(module)
+    ? Object.entries(module).find(([key]) => key === name)?.[1]
+    : undefined;
+  if (typeof value !== 'function') throw new Error(`Missing ${name}.`);
+  return value as TAdapter;
+}
+
+/*** Narrow an unknown module namespace before reading a dynamic public export. */
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null;
+}

package/src/features/registry/registry.test.ts

@@ -126,4 +126,15 @@ describe('ZORA_COMPONENT_REGISTRY', () => {
     expect(registryEntries).not.toContain('ToastProvider');
     expect(registryEntries).not.toContain('SelectionProvider');
   });
+
+  test('keeps public authoring adapters outside the reader-free runtime catalog', async () => {
+    const [authoringSource, readerFreeSource] = await Promise.all([
+      Bun.file('src/authoring.ts').text(),
+      Bun.file('src/readerFree.ts').text(),
+    ]);
+
+    expect(authoringSource).toContain("from './features/registry/adapters/inbound/");
+    expect(readerFreeSource).not.toContain('AuthoringSelectionAdapter');
+    expect(await listRuntimeRegistryEntries()).not.toContain('AuthoringSelectionAdapter');
+  });
 });

package/src/index.ts

@@ -1,3 +1,19 @@
+export type {
+  AuthoringBindingControlState,
+  AuthoringBindingEditorAdapterProps,
+  AuthoringPropertyControlState,
+  AuthoringPropertyInspectorAdapterProps,
+  AuthoringSelectionAdapterProps,
+  AuthoringSelectionItemState,
+  ThemeEditorAdapterProps,
+  ThemeRecipeFieldControlState,
+} from './authoring';
+export {
+  AuthoringBindingEditorAdapter,
+  AuthoringPropertyInspectorAdapter,
+  AuthoringSelectionAdapter,
+  ThemeEditorAdapter,
+} from './authoring';
 export type {
   ReaderColorScheme,
   ReaderDocumentFormat,

package/src/types/authoring-adapters.ts

@@ -0,0 +1,112 @@
+import type React from 'react';
+
+import type {
+  ZoraComponentMeta,
+  ZoraComponentPropSchema,
+  ZoraComponentPropValue,
+} from './authoring';
+import type { ZoraThemeRecipeFieldMeta, ZoraThemeRecipeMetaRegistry } from './theme-recipe';
+
+export interface AuthoringSelectionItemState<TItem> {
+  readonly item: TItem;
+  readonly selected: boolean;
+  readonly disabled: boolean;
+  readonly select: () => void;
+}
+
+export interface AuthoringSelectionAdapterProps<TItem> {
+  readonly items: readonly TItem[];
+  readonly selectedItemId?: string;
+  readonly getItemId: (item: TItem) => string;
+  readonly onSelectionChange?: (item: TItem | null) => void;
+  readonly renderItem: (state: AuthoringSelectionItemState<TItem>) => React.ReactNode;
+  readonly disabled?: boolean;
+}
+
+export interface AuthoringPropertyControlState<TNode> {
+  readonly node: TNode;
+  readonly component: ZoraComponentMeta;
+  readonly name: string;
+  readonly schema: ZoraComponentPropSchema;
+  readonly value: ZoraComponentPropValue | undefined;
+  readonly disabled: boolean;
+  readonly required: boolean;
+  readonly onChange: (value: ZoraComponentPropValue | undefined) => void;
+}
+
+export interface AuthoringPropertyInspectorAdapterProps<TNode> {
+  readonly node: TNode | null;
+  readonly component: ZoraComponentMeta | null;
+  readonly getPropertyValue: (node: TNode, name: string) => ZoraComponentPropValue | undefined;
+  readonly onPropertyChange?: (
+    node: TNode,
+    name: string,
+    value: ZoraComponentPropValue | undefined,
+  ) => void;
+  readonly renderProperty: (state: AuthoringPropertyControlState<TNode>) => React.ReactNode;
+  readonly isPropertyDisabled?: (
+    node: TNode,
+    name: string,
+    schema: ZoraComponentPropSchema,
+  ) => boolean;
+  readonly isPropertyRequired?: (
+    node: TNode,
+    name: string,
+    schema: ZoraComponentPropSchema,
+  ) => boolean;
+  readonly disabled?: boolean;
+}
+
+export interface AuthoringBindingControlState<TNode, TBinding> {
+  readonly node: TNode;
+  readonly component: ZoraComponentMeta;
+  readonly name: string;
+  readonly label: string;
+  readonly description?: string;
+  readonly binding: TBinding | undefined;
+  readonly disabled: boolean;
+  readonly required: boolean;
+  readonly onChange: (binding: TBinding | undefined) => void;
+}
+
+export interface AuthoringBindingEditorAdapterProps<TNode, TBinding> {
+  readonly node: TNode | null;
+  readonly component: ZoraComponentMeta | null;
+  readonly getBinding: (node: TNode, name: string) => TBinding | undefined;
+  readonly onBindingChange?: (node: TNode, name: string, binding: TBinding | undefined) => void;
+  readonly renderBinding: (state: AuthoringBindingControlState<TNode, TBinding>) => React.ReactNode;
+  readonly isBindingDisabled?: (node: TNode, name: string) => boolean;
+  readonly isBindingRequired?: (node: TNode, name: string) => boolean;
+  readonly disabled?: boolean;
+}
+
+export interface ThemeRecipeFieldControlState<TTheme> {
+  readonly theme: TTheme;
+  readonly recipeName: string;
+  readonly fieldName: string;
+  readonly field: ZoraThemeRecipeFieldMeta;
+  readonly value: string | boolean | undefined;
+  readonly disabled: boolean;
+  readonly required: boolean;
+  readonly onChange: (value: string | boolean | undefined) => void;
+}
+
+export interface ThemeEditorAdapterProps<TTheme> {
+  readonly theme: TTheme | null;
+  readonly recipes?: ZoraThemeRecipeMetaRegistry;
+  readonly getRecipeFieldValue: (
+    theme: TTheme,
+    recipeName: string,
+    fieldName: string,
+  ) => string | boolean | undefined;
+  readonly onRecipeFieldChange?: (
+    theme: TTheme,
+    recipeName: string,
+    fieldName: string,
+    value: string | boolean | undefined,
+  ) => void;
+  readonly renderField: (state: ThemeRecipeFieldControlState<TTheme>) => React.ReactNode;
+  readonly isFieldDisabled?: (theme: TTheme, recipeName: string, fieldName: string) => boolean;
+  readonly isFieldRequired?: (theme: TTheme, recipeName: string, fieldName: string) => boolean;
+  readonly disabled?: boolean;
+}