@unrulysystems/native-motion-core 0.1.0-alpha.0

package/dist/component/validate.d.cts

@@ -0,0 +1,37 @@
+import type { HostCapabilities } from "../subset/resolve.cjs";
+export interface ValidateTargetOptions {
+    readonly componentId?: string;
+}
+export declare class InvalidTargetError extends Error {
+    readonly key: string;
+    readonly value: unknown;
+    readonly componentId: string | undefined;
+    constructor(componentId: string | undefined, key: string, value: unknown, reason: string, cause?: unknown);
+}
+export declare function targetShapeRefusal(target: unknown, opts?: ValidateTargetOptions): InvalidTargetError | null;
+export declare function assertTargetShape(target: unknown, opts?: ValidateTargetOptions): asserts target is Readonly<Record<string, unknown>>;
+export declare function validateTargetRefusal(target: Readonly<Record<string, unknown>>, host: HostCapabilities, opts?: ValidateTargetOptions): InvalidTargetError | null;
+export declare function validateTarget(target: Readonly<Record<string, unknown>>, host: HostCapabilities, opts?: ValidateTargetOptions): void;
+export declare function validateTargetSnapshot(target: Readonly<Record<string, unknown>>, host: HostCapabilities, opts?: ValidateTargetOptions): {
+    readonly refusal: InvalidTargetError | null;
+    readonly target: Record<string, unknown> | null;
+};
+export declare class InvalidTransitionError extends Error {
+    readonly key: string;
+    readonly value: unknown;
+    readonly componentId: string | undefined;
+    constructor(componentId: string | undefined, key: string, value: unknown, reason: string);
+}
+/**
+ * Eagerly validate a transition config (REQ-API-001 vocabulary, G-INV-8 fail-loud). The runtime
+ * authority the compile-time Transition type cannot be: it accepts an untyped input (a
+ * dynamically-shaped gesture-state member, a JS caller) and rejects, with a typed error, any shape
+ * that is not a plain object of known, well-typed transition options. `undefined` is valid absence.
+ */
+export declare function validateTransitionRefusal(transition: unknown, opts?: ValidateTargetOptions): InvalidTransitionError | null;
+/**
+ * Shape-only preflight for transition snapshot boundaries. This must run before a null-prototype
+ * snapshot can normalize a Date, class instance, or inherited-only record into an empty object.
+ */
+export declare function transitionShapeRefusal(transition: unknown, opts?: ValidateTargetOptions): InvalidTransitionError | null;
+export declare function validateTransition(transition: unknown, opts?: ValidateTargetOptions): void;

package/dist/component/validate.d.ts

@@ -0,0 +1,37 @@
+import type { HostCapabilities } from "../subset/resolve.js";
+export interface ValidateTargetOptions {
+    readonly componentId?: string;
+}
+export declare class InvalidTargetError extends Error {
+    readonly key: string;
+    readonly value: unknown;
+    readonly componentId: string | undefined;
+    constructor(componentId: string | undefined, key: string, value: unknown, reason: string, cause?: unknown);
+}
+export declare function targetShapeRefusal(target: unknown, opts?: ValidateTargetOptions): InvalidTargetError | null;
+export declare function assertTargetShape(target: unknown, opts?: ValidateTargetOptions): asserts target is Readonly<Record<string, unknown>>;
+export declare function validateTargetRefusal(target: Readonly<Record<string, unknown>>, host: HostCapabilities, opts?: ValidateTargetOptions): InvalidTargetError | null;
+export declare function validateTarget(target: Readonly<Record<string, unknown>>, host: HostCapabilities, opts?: ValidateTargetOptions): void;
+export declare function validateTargetSnapshot(target: Readonly<Record<string, unknown>>, host: HostCapabilities, opts?: ValidateTargetOptions): {
+    readonly refusal: InvalidTargetError | null;
+    readonly target: Record<string, unknown> | null;
+};
+export declare class InvalidTransitionError extends Error {
+    readonly key: string;
+    readonly value: unknown;
+    readonly componentId: string | undefined;
+    constructor(componentId: string | undefined, key: string, value: unknown, reason: string);
+}
+/**
+ * Eagerly validate a transition config (REQ-API-001 vocabulary, G-INV-8 fail-loud). The runtime
+ * authority the compile-time Transition type cannot be: it accepts an untyped input (a
+ * dynamically-shaped gesture-state member, a JS caller) and rejects, with a typed error, any shape
+ * that is not a plain object of known, well-typed transition options. `undefined` is valid absence.
+ */
+export declare function validateTransitionRefusal(transition: unknown, opts?: ValidateTargetOptions): InvalidTransitionError | null;
+/**
+ * Shape-only preflight for transition snapshot boundaries. This must run before a null-prototype
+ * snapshot can normalize a Date, class instance, or inherited-only record into an empty object.
+ */
+export declare function transitionShapeRefusal(transition: unknown, opts?: ValidateTargetOptions): InvalidTransitionError | null;
+export declare function validateTransition(transition: unknown, opts?: ValidateTargetOptions): void;