Function useAsterDataBinding

ui/src/composables/useAsterDataBinding.ts:73–148

(
  options: UseAsterDataBindingOptions = {},
)

 * ```
 */
export function useAsterDataBinding(
  options: UseAsterDataBindingOptions = {},
): UseAsterDataBindingReturn {
  const { propertyValue, defaultValue = null, debounceMs = 0 } = options;

  // Try to inject context from AsterSurface
  const context = inject<DataBindingContext | null>(DATA_BINDING_CONTEXT_KEY, null);

  // Determine if this is a path reference
  const isPath = propertyValue ? isPathReference(propertyValue) : false;
  const path = isPath && propertyValue ? (propertyValue as { path: string }).path : null;

  // Debounce timer
  let debounceTimer: ReturnType<typeof setTimeout> | null = null;

  // Computed value that resolves the property
  const value = computed<DataValue | undefined>(() => {
    if (!propertyValue) {
      return defaultValue ?? undefined;
    }

    // Literal values
    if ('literalString' in propertyValue) {
      return propertyValue.literalString;
    }
    if ('literalNumber' in propertyValue) {
      return propertyValue.literalNumber;
    }
    if ('literalBoolean' in propertyValue) {
      return propertyValue.literalBoolean;
    }

    // Path reference - get from data model
    if ('path' in propertyValue && context?.dataModel.value) {
      const result = getData(context.dataModel.value, propertyValue.path);
      return result ?? defaultValue ?? undefined;
    }

    return defaultValue ?? undefined;
  });

  /**
   * Update the value in the data model
   */
  function updateValue(newValue: DataValue): void {
    if (!isPath || !path || !context) {
      return;
    }

    const doUpdate = () => {
      if (context.processor.value) {
        context.processor.value.setData(context.surfaceId, path, newValue);
      }
      else if (context.dataModel.value) {
        setData(context.dataModel.value, path, newValue);
      }
    };