@ankhorage/zora 27.0.3 → 27.1.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 27.1.1
+
+### Patch Changes
+
+- 4eab6f3: Update dependencies: `@ankhorage/contracts`, `@ankhorage/runtime`, `@ankhorage/surface`.
+
+## 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.1](././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.1",
   "description": "Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.",
   "homepage": "https://github.com/ankhorage/zora#readme",
   "bugs": {
@@ -43,12 +43,12 @@
   "dependencies": {
     "@ankhorage/capability": "^0.2.2",
     "@ankhorage/color-theory": "^0.3.2",
-    "@ankhorage/contracts": "^26.8.0",
+    "@ankhorage/contracts": "^26.10.0",
     "@ankhorage/game": "^0.1.3",
     "@ankhorage/grid-view": "^0.5.0",
     "@ankhorage/reader": "^0.1.2",
-    "@ankhorage/runtime": "^5.3.6",
-    "@ankhorage/surface": "^9.5.0",
+    "@ankhorage/runtime": "^5.4.0",
+    "@ankhorage/surface": "^9.5.3",
     "@ankhorage/utility": "^1.10.0",
     "expo-document-picker": "~57.0.3",
     "expo-image-picker": "~57.0.20"
@@ -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/accordion/adapters/inbound/AccordionItem.test.tsx

@@ -39,9 +39,9 @@ test('leaves native trigger accessibility owned by the published Surface primiti
   ]);
 
   expect(zoraSource).not.toContain('accessibilityState');
-  expect(surfaceTrigger).toContain('accessibilityRole="button"');
-  expect(surfaceTrigger).toContain(
-    'accessibilityState={{ disabled: resolvedDisabled, expanded: item.open }}',
+  expect(surfaceTrigger).toMatch(/\baccessibilityRole\s*:\s*["']button["']/u);
+  expect(surfaceTrigger).toMatch(
+    /\baccessibilityState\s*:\s*\{\s*disabled\s*:\s*resolvedDisabled\s*,\s*expanded\s*:\s*item\.open\s*\}/u,
   );
 });
 

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>
+  );
+}