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

package/src/MotionConfig.tsx

@@ -0,0 +1,136 @@
+'use client'
+// REQ-API-035 / REQ-WEB-022: motion/react owns web configuration inheritance and transition
+// behavior. This adapter retains Native Motion's named aliases and validates only its own wrapper
+// props; it never substitutes native transition semantics for the pin.
+
+import type { Transition as CoreTransition } from '@unrulysystems/native-motion-core'
+import {
+  MotionConfig as PinMotionConfig,
+  type MotionConfigProps as PinMotionConfigProps,
+} from 'motion/react'
+import { createContext, createElement, useContext, type ReactNode } from 'react'
+import { MotionWebRejectionError } from './errors'
+import { ambientMode } from './mode'
+import type { NormalizeOptions } from './normalize'
+import { mapWebTransitionAliases, type WebTransition } from './webTransition'
+
+/** Retained compatibility seam; web hosts no longer consume a parallel validation context. */
+export interface MotionConfigValidationValue {
+  readonly transition: undefined
+}
+
+const DEFAULT_VALIDATION: MotionConfigValidationValue = Object.freeze({ transition: undefined })
+export const MotionConfigValidationContext = createContext(DEFAULT_VALIDATION)
+export function useMotionConfigValidation(): MotionConfigValidationValue {
+  return useContext(MotionConfigValidationContext)
+}
+
+export type ReducedMotionConfig = 'always' | 'never' | 'user'
+export type MotionConfigTransition =
+  | NonNullable<PinMotionConfigProps['transition']>
+  | (CoreTransition & { readonly inherit?: boolean })
+
+export interface MotionConfigProps {
+  readonly children?: ReactNode
+  readonly transition?: MotionConfigTransition | undefined
+  readonly reducedMotion?: ReducedMotionConfig | undefined
+  readonly nonce?: string | undefined
+  readonly isStatic?: boolean | undefined
+  readonly skipAnimations?: boolean | undefined
+  readonly transformPagePoint?: PinMotionConfigProps['transformPagePoint']
+}
+
+const MOTION_CONFIG_OWNER = '<MotionConfig>'
+const REDUCED_MOTION_VALUES = new Set(['always', 'never', 'user'])
+
+function refuse(options: NormalizeOptions, message: string): void {
+  const error = new MotionWebRejectionError(message)
+  if (options.mode === 'development') throw error
+  options.report(error)
+}
+
+function mapTransition(
+  transition: MotionConfigTransition | undefined,
+  options: NormalizeOptions,
+): WebTransition | undefined {
+  if (transition === undefined) return undefined
+  try {
+    return mapWebTransitionAliases(transition as WebTransition, MOTION_CONFIG_OWNER)
+  } catch (error) {
+    if (!(error instanceof MotionWebRejectionError)) throw error
+    if (options.mode === 'development') throw error
+    options.report(error)
+    return undefined
+  }
+}
+
+function gateEnum<T extends string>(
+  name: string,
+  value: unknown,
+  accepted: ReadonlySet<string>,
+  options: NormalizeOptions,
+): T | undefined {
+  if (value === undefined) return undefined
+  if (typeof value === 'string' && accepted.has(value)) return value as T
+  refuse(options, `${MOTION_CONFIG_OWNER}: invalid ${name}; the wrapper requires a pinned value`)
+  return undefined
+}
+
+function gateBoolean(name: string, value: unknown, options: NormalizeOptions): boolean | undefined {
+  if (value === undefined) return undefined
+  if (typeof value === 'boolean') return value
+  refuse(options, `${MOTION_CONFIG_OWNER}: invalid ${name}; expected a boolean`)
+  return undefined
+}
+
+export function createMotionConfig(options: NormalizeOptions) {
+  return function MotionConfig({
+    children,
+    transition,
+    reducedMotion,
+    nonce,
+    isStatic,
+    skipAnimations,
+    transformPagePoint,
+    ...rest
+  }: MotionConfigProps) {
+    for (const [key, value] of Object.entries(rest)) {
+      if (value !== undefined)
+        refuse(options, `${MOTION_CONFIG_OWNER}: unsupported wrapper prop '${key}'`)
+    }
+    const mappedTransition = mapTransition(transition, options)
+    const mappedReduced = gateEnum<ReducedMotionConfig>(
+      'reducedMotion',
+      reducedMotion,
+      REDUCED_MOTION_VALUES,
+      options,
+    )
+    const mappedStatic = gateBoolean('isStatic', isStatic, options)
+    const mappedSkip = gateBoolean('skipAnimations', skipAnimations, options)
+    if (nonce !== undefined && typeof nonce !== 'string')
+      refuse(options, `${MOTION_CONFIG_OWNER}: invalid nonce; expected a string`)
+    if (transformPagePoint !== undefined && typeof transformPagePoint !== 'function')
+      refuse(options, `${MOTION_CONFIG_OWNER}: invalid transformPagePoint; expected a function`)
+
+    const forwarded: PinMotionConfigProps = {
+      ...(mappedTransition === undefined
+        ? {}
+        : { transition: mappedTransition as NonNullable<PinMotionConfigProps['transition']> }),
+      ...(mappedReduced === undefined ? {} : { reducedMotion: mappedReduced }),
+      ...(mappedStatic === undefined ? {} : { isStatic: mappedStatic }),
+      ...(mappedSkip === undefined ? {} : { skipAnimations: mappedSkip }),
+      ...(typeof nonce === 'string' ? { nonce } : {}),
+      ...(typeof transformPagePoint === 'function' ? { transformPagePoint } : {}),
+    }
+    return createElement(PinMotionConfig, forwarded, children)
+  }
+}
+
+function consoleReporter(error: Error): void {
+  console.error(error)
+}
+
+export const MotionConfig = createMotionConfig({
+  mode: ambientMode(),
+  report: consoleReporter,
+})

package/src/MotionLengthLayoutProvider.tsx

@@ -0,0 +1,18 @@
+'use client'
+// Web entry counterpart of native MotionLengthLayoutProvider (REQ-VALUETYPE-013 namespace parity).
+// Pin motion/react measure-resolves %/auto/calc itself — this provider is a no-op passthrough so
+// dual-entry product code can share the same composition without branching.
+
+import type { ReactNode } from 'react'
+import type { LengthLayoutContext } from '@unrulysystems/native-motion-core'
+
+export interface MotionLengthLayoutProviderProps {
+  readonly value: LengthLayoutContext
+  readonly children: ReactNode
+}
+
+export function MotionLengthLayoutProvider({
+  children,
+}: MotionLengthLayoutProviderProps): ReactNode {
+  return children
+}

package/src/MotionRoot.tsx

@@ -0,0 +1,13 @@
+// REQ-API-022 web counterpart (FLAG 5a, specs/SPEC-GESTURE.md) — MotionRoot on
+// the web engine: the root primitive exists on BOTH entries (one-import universal surface, entry
+// value-key parity), but the web engine needs no gesture root — motion/react's recognizers bind
+// per element. Children render unchanged; no wrapper element, no style knob (a web-ignored style
+// would be an accepted-but-ignored prop, REQ-API-016 — the native entry matches).
+
+export interface MotionRootProps {
+  readonly children?: React.ReactNode
+}
+
+export function MotionRoot({ children }: MotionRootProps) {
+  return <>{children}</>
+}