Press n or j to go to the next uncovered block, b, p or k for the previous block.
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 | 1x 1x 1x 1x 1x 1x 15x 15x 1x 31x 31x 31x 31x 1x 1x 78x 78x 1x 19x 18x 18x 1x | import { isMutableRef, type MutableRef } from '@anchorlib/core';
import type { Bindable } from './types.js';
/**
* A reference that binds a value to a property of an object or another reference.
* Used for creating two-way data binding between components.
*
* @template S - The source object or reference type
* @template V - The value type
*/
export class BindingRef<S, V> {
public get value(): V {
return (this.source as Record<string, unknown>)[this.key as never] as V;
}
public set value(value: V) {
(this.source as Record<string, unknown>)[this.key as never] = value;
}
/**
* Creates a new binding reference.
*
* @param source - The source object or reference to bind to
* @param key - The property key to bind to (default: 'value')
* @param type - The value type (optional)
*/
constructor(
public source: S,
public key: keyof S | string = 'value',
public type?: V
) {}
}
/**
* Type guard to check if a value is a BindingRef.
*
* @template S - The source object or reference type
* @template V - The value type
* @param value - The value to check
* @returns True if the value is a BindingRef, false otherwise
*/
export function isBinding<S, V>(value: unknown): value is BindingRef<S, V> {
return value instanceof BindingRef;
}
/**
* Creates two-way data binding to MutableRef source.
*
* @template T - The MutableRef type
* @param source - The MutableRef source to bind to
* @returns The value type of the MutableRef
*/
export function bind<T extends MutableRef<unknown>>(source: T): Bindable<T['value']>;
/**
* Creates two-way data binding to object property.
*
* @template T - The Record type
* @template K - The key type
* @param source - The Record source to bind to
* @param key - The property key to bind to
* @returns The value type at the specified key
*/
export function bind<T, K extends keyof T>(source: T, key: K): Bindable<T[K]>;
/**
* Creates a binding reference for two-way data binding.
*
* @template T - The source type
* @param source - The source object or reference to bind to
* @param key - The property key to bind to (optional)
* @returns A BindingRef instance
*/
export function bind<T>(source: T, key?: keyof T) {
if (isMutableRef(source)) return source;
return new BindingRef(source, key);
}
/**
* Alias for the bind function.
*
* @see {@link bind}
*/
export const $bind = bind;
|