{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "fx-gravity-stars",
  "type": "registry:component",
  "title": "Gravity stars",
  "description": "A decorative field of stars falling into a well",
  "author": "sudo-kw <https://github.com/sudo-kw>",
  "dependencies": [
    "@gpuix/native@0.11.0",
    "@gpuix/react@0.11.0",
    "effect@4.1.2"
  ],
  "registryDependencies": [
    "https://gpuixui.sudokw.com/gpuix-components.json",
    "https://gpuixui.sudokw.com/gpuix-motion.json",
    "https://gpuixui.sudokw.com/gpuix-tw.json"
  ],
  "files": [
    {
      "path": "packages/fx/src/gravity-stars.tsx",
      "target": "@ui/gpuixui/fx/gravity-stars.tsx",
      "type": "registry:component",
      "content": "/** @jsxImportSource @gpuix/react */\nimport type { EventPayload, MotionProps, Props } from \"@gpuix/react\";\nimport {\n  mergeStyles,\n  resolveStyle,\n  type StateStyle,\n} from \"@gpuix/react/floating\";\nimport type { MotionLevel } from \"../motion/timing.js\";\nimport { cn } from \"../tw/index.js\";\nimport * as Arr from \"effect/Array\";\nimport * as Option from \"effect/Option\";\nimport {\n  measuredBox,\n  send,\n  useLocalSlice,\n  useLocalStore,\n  fadeOnly,\n  useMotionPreference,\n  useSurfaceTiming,\n  recipeStyle,\n  countOf,\n  durationOf,\n  seedOf,\n  sizeRangeOf,\n  useTheme,\n} from \"../components/authoring.js\";\nimport {\n  gravityField,\n  gravityFallCapMs,\n  gravityFallFloor,\n  gravityFallMs,\n  gravityLifeOf,\n  gravityMaxSize,\n  gravityMinSize,\n  gravityPhases,\n  gravityRest,\n  gravityStars,\n  gravityStarsCap,\n  type GravityBox,\n  type GravityLife,\n  type GravityStar,\n} from \"./gravity-stars/logic.js\";\nimport { makeGravityStore, type GravityStore } from \"./gravity-stars/store.js\";\n\nexport interface GravityStarsState {\n  readonly count: number;\n  readonly reducedMotion: boolean;\n  readonly width: number;\n  readonly height: number;\n}\n\nexport interface GravityStarsProps extends Omit<Props, \"children\" | \"style\"> {\n  readonly count?: number;\n\n  readonly seed?: number;\n\n  readonly minSize?: number;\n\n  readonly maxSize?: number;\n\n  readonly color?: string;\n\n  readonly fallMs?: number;\n\n  readonly level?: MotionLevel;\n\n  readonly className?: string;\n\n  readonly style?: StateStyle<GravityStarsState>;\n}\n\ninterface StarProps {\n  readonly spec: GravityStar;\n  readonly ink: string;\n  readonly radius: number;\n  readonly still: boolean;\n  readonly store: GravityStore;\n}\n\nconst Star = ({ spec, ink, radius, still, store }: StarProps) => {\n  const life: GravityLife = useLocalSlice(store.local, (state) =>\n    gravityLifeOf(state.lives, spec.key),\n  );\n  const phases = gravityPhases(spec);\n  const rest = gravityRest(spec);\n  const phase = life.landing ? phases.plunge : phases.approach;\n  const motion: MotionProps = {\n    initial: life.landing ? false : { left: spec.x, top: spec.y, opacity: 0 },\n    animate: { left: phase.left, top: phase.top, opacity: phase.opacity },\n    transition: {\n      duration: phase.durationMs / 1000,\n      ...(life.landing ? {} : { delay: phases.approach.delayMs / 1000 }),\n\n      ease: \"easeIn\",\n    },\n  };\n\n  return (\n    <div\n      key={life.lap}\n      testId={`gravity-star-${spec.key}`}\n      {...(still\n        ? {}\n        : {\n            motion,\n            onMotionComplete: () => send(store.advance(spec.key)),\n          })}\n      style={{\n        position: \"absolute\",\n        left: still ? rest.left : spec.x,\n        top: still ? rest.top : spec.y,\n        width: spec.size,\n        height: spec.size,\n        borderRadius: radius,\n        backgroundColor: ink,\n        opacity: still ? rest.opacity : 0,\n\n        pointerEvents: \"none\",\n      }}\n    />\n  );\n};\n\nexport const GravityStars = ({\n  count,\n  seed,\n  minSize,\n  maxSize,\n  color,\n  fallMs,\n  level = \"slow\",\n  className,\n  style,\n  ...rest\n}: GravityStarsProps) => {\n  const theme = useTheme();\n  const preference = useMotionPreference();\n  const timing = useSurfaceTiming(level);\n  const fieldCount = countOf(\n    Option.fromNullishOr(count),\n    gravityStars,\n    gravityStarsCap,\n  );\n  const sizes = sizeRangeOf(\n    Option.fromNullishOr(minSize),\n    Option.fromNullishOr(maxSize),\n    gravityMinSize,\n    gravityMaxSize,\n  );\n  const layoutSeed = seedOf(Option.fromNullishOr(seed));\n  const fall = durationOf(\n    Option.fromNullishOr(fallMs),\n    gravityFallMs,\n    gravityFallFloor,\n    gravityFallCapMs,\n  );\n  const ink = color ?? theme.colors.primary;\n  const still = preference === \"reduced\";\n  const store = useLocalStore(makeGravityStore);\n\n  const box = useLocalSlice(store.local, (current) => current.box);\n\n  const noteBox = (event: EventPayload): void => {\n    send(store.measure(measuredBox(event)));\n  };\n\n  const measured: GravityBox = Option.getOrElse(box, () => ({\n    width: 0,\n    height: 0,\n  }));\n  const specs: ReadonlyArray<GravityStar> =\n    measured.width > 0 && measured.height > 0\n      ? gravityField({\n          width: measured.width,\n          height: measured.height,\n          count: fieldCount,\n          seed: layoutSeed,\n          minSize: sizes.min,\n          maxSize: sizes.max,\n          fallMs: fall,\n        })\n      : [];\n\n  const state: GravityStarsState = {\n    count: Arr.length(specs),\n    reducedMotion: still,\n    width: measured.width,\n    height: measured.height,\n  };\n\n  return (\n    <div\n      {...rest}\n      onLayout={noteBox}\n      motion={{ ...fadeOnly, transition: timing.enter }}\n      style={mergeStyles(\n        mergeStyles(recipeStyle(cn(className), theme), {\n          position: \"relative\",\n          overflow: \"hidden\",\n\n          pointerEvents: \"none\",\n        }),\n        resolveStyle(style, state),\n      )}\n    >\n      {Arr.map(specs, (spec) => (\n        <Star\n          key={spec.key}\n          spec={spec}\n          ink={ink}\n          radius={theme.radius.full}\n          still={still}\n          store={store}\n        />\n      ))}\n    </div>\n  );\n};\n\nexport const gravityStarsMeta = {\n  name: \"Gravity stars\",\n  tier: 5,\n  status: \"done\",\n  gpuixSupport: \"partial\",\n  limitations: [\n    \"a star falls in two straight legs of inset geometry: the runtime has no transform (upstream issue #102) and no paths, so it cannot orbit, curve or trail\",\n    \"the acceleration is the runtime's easeIn curve, not a simulated force, and a star's speed is fixed when the field is laid out\",\n    \"a landed star is re-keyed onto the box's edge as a fresh star; both ends of the journey are invisible, so the restart is not visible\",\n    \"the field measures its own box, so the caller must bound it; before the first layout it paints nothing\",\n    \"the field publishes no accessibility node and takes no pointer input: name the content it sits behind, never the field\",\n    \"a size change re-draws the field from the same seed, which restarts every fall (a tween cannot be resumed at an arbitrary progress)\",\n    \"the well is seeded inside the middle 30–70% of the box and cannot follow a pointer, because decoration cannot take the presses a pointer handler would need\",\n  ],\n  docs: \"docs/gravity-stars.mdx\",\n  example: \"examples/gravity-stars.example.tsx\",\n  testFile: \"src/behaviour/gravity-stars.test.tsx\",\n} as const;\n"
    },
    {
      "path": "packages/fx/src/gravity-stars/logic.ts",
      "target": "@ui/gpuixui/fx/gravity-stars/logic.ts",
      "type": "registry:lib",
      "content": "import * as Arr from \"effect/Array\";\nimport * as HashMap from \"effect/HashMap\";\nimport * as Option from \"effect/Option\";\nimport { paintable, seededUnit, tenth } from \"../../components/authoring.js\";\n\nexport const gravityStars = 36;\n\nexport const gravityStarsCap = 160;\n\nexport const gravityMinSize = 1;\nexport const gravityMaxSize = 3;\n\nexport const gravityFallMs = 3_000;\n\nexport const gravityFallFloor = 600;\n\nexport const gravityFallCapMs = 20_000;\n\nconst approachShare = 0.6;\n\nconst centreFloorShare = 0.3;\nconst centreCeilingShare = 0.7;\n\nconst angleJitterShare = 0.3;\n\nconst delayShare = 0.8;\n\nconst fallFloorShare = 0.5;\nconst fallCeilingShare = 1.4;\nconst nearFallShare = 0.6;\nconst farFallShare = 1.2;\n\nconst peakFloor = 0.35;\nconst peakCeiling = 0.85;\n\nexport interface GravityBox {\n  readonly width: number;\n  readonly height: number;\n}\n\nexport interface GravityFieldInput extends GravityBox {\n  readonly count: number;\n  readonly seed: number;\n  readonly minSize: number;\n  readonly maxSize: number;\n  readonly fallMs: number;\n}\n\nexport interface GravityCentre {\n  readonly x: number;\n  readonly y: number;\n}\n\nexport interface GravityStar {\n  readonly key: string;\n  readonly size: number;\n\n  readonly x: number;\n  readonly y: number;\n\n  readonly midX: number;\n  readonly midY: number;\n\n  readonly endX: number;\n  readonly endY: number;\n\n  readonly peak: number;\n\n  readonly durationMs: number;\n\n  readonly delayMs: number;\n}\n\nexport interface GravityPhases {\n  readonly approach: {\n    readonly left: number;\n    readonly top: number;\n    readonly opacity: number;\n    readonly durationMs: number;\n    readonly delayMs: number;\n  };\n  readonly plunge: {\n    readonly left: number;\n    readonly top: number;\n    readonly opacity: number;\n    readonly durationMs: number;\n  };\n}\n\nexport const gravityCentreOf = (\n  box: GravityBox,\n  seed: number,\n): GravityCentre => ({\n  x: tenth(\n    box.width *\n      (centreFloorShare +\n        seededUnit(seed, 0, 9) * (centreCeilingShare - centreFloorShare)),\n  ),\n  y: tenth(\n    box.height *\n      (centreFloorShare +\n        seededUnit(seed, 0, 10) * (centreCeilingShare - centreFloorShare)),\n  ),\n});\n\nconst rimDistance = (\n  centre: GravityCentre,\n  box: GravityBox,\n  angle: number,\n): number => {\n  const dx = Math.cos(angle);\n  const dy = Math.sin(angle);\n  const alongX =\n    dx > 0 ? (box.width - centre.x) / dx : dx < 0 ? -centre.x / dx : Infinity;\n  const alongY =\n    dy > 0 ? (box.height - centre.y) / dy : dy < 0 ? -centre.y / dy : Infinity;\n  return Math.min(alongX, alongY);\n};\n\nconst clamp = (value: number, low: number, high: number): number =>\n  Math.min(Math.max(value, low), high);\n\nconst fallFactor = (distance: number, farthest: number): number =>\n  paintable(farthest)\n    ? nearFallShare + (farFallShare - nearFallShare) * (distance / farthest)\n    : farFallShare;\n\nexport const gravityField = (\n  input: GravityFieldInput,\n): ReadonlyArray<GravityStar> => {\n  if (!paintable(input.width) || !paintable(input.height)) return [];\n  if (input.count <= 0) return [];\n\n  const centre = gravityCentreOf(input, input.seed);\n  const slice = (Math.PI * 2) / input.count;\n  const farthest = Arr.reduce(\n    Arr.range(0, input.count - 1),\n    0,\n    (widest, index) =>\n      Math.max(\n        widest,\n        rimDistance(\n          centre,\n          input,\n          index * slice +\n            (seededUnit(input.seed, index, 1) - 0.5) * slice * angleJitterShare,\n        ),\n      ),\n  );\n\n  return Arr.map(Arr.range(0, input.count - 1), (index) => {\n    const angle =\n      index * slice +\n      (seededUnit(input.seed, index, 1) - 0.5) * slice * angleJitterShare;\n    const distance = rimDistance(centre, input, angle);\n    const size = Math.round(\n      input.minSize +\n        seededUnit(input.seed, index, 2) * (input.maxSize - input.minSize),\n    );\n    const startX = tenth(\n      clamp(\n        centre.x + Math.cos(angle) * distance - size / 2,\n        0,\n        Math.max(0, input.width - size),\n      ),\n    );\n    const startY = tenth(\n      clamp(\n        centre.y + Math.sin(angle) * distance - size / 2,\n        0,\n        Math.max(0, input.height - size),\n      ),\n    );\n    const endX = tenth(centre.x - size / 2);\n    const endY = tenth(centre.y - size / 2);\n    const speed = clamp(\n      fallFactor(distance, farthest) *\n        (0.9 + seededUnit(input.seed, index, 3) * 0.2),\n      fallFloorShare,\n      fallCeilingShare,\n    );\n\n    return {\n      key: String(index),\n      size,\n      x: startX,\n      y: startY,\n      midX: tenth(startX + (endX - startX) * approachShare),\n      midY: tenth(startY + (endY - startY) * approachShare),\n      endX,\n      endY,\n      peak: tenth(\n        peakFloor +\n          seededUnit(input.seed, index, 4) * (peakCeiling - peakFloor),\n      ),\n      durationMs: Math.round(input.fallMs * speed),\n      delayMs: Math.round(\n        seededUnit(input.seed, index, 5) * delayShare * input.fallMs,\n      ),\n    };\n  });\n};\n\nexport const gravityPhases = (star: GravityStar): GravityPhases => ({\n  approach: {\n    left: star.midX,\n    top: star.midY,\n    opacity: star.peak,\n    durationMs: Math.round(star.durationMs * approachShare),\n    delayMs: star.delayMs,\n  },\n  plunge: {\n    left: star.endX,\n    top: star.endY,\n    opacity: 0,\n    durationMs: Math.round(star.durationMs * (1 - approachShare)),\n  },\n});\n\nexport const gravityRest = (\n  star: GravityStar,\n): {\n  readonly left: number;\n  readonly top: number;\n  readonly opacity: number;\n} => ({\n  left: star.midX,\n  top: star.midY,\n  opacity: star.peak,\n});\n\nexport interface GravityLife {\n  readonly lap: number;\n\n  readonly landing: boolean;\n}\n\nexport const gravityBorn: GravityLife = { lap: 0, landing: false };\n\nexport const gravityLifeOf = (\n  lives: HashMap.HashMap<string, GravityLife>,\n  key: string,\n): GravityLife => Option.getOrElse(HashMap.get(lives, key), () => gravityBorn);\n\nexport const gravityAdvanced = (life: GravityLife): GravityLife =>\n  life.landing\n    ? { lap: life.lap + 1, landing: false }\n    : { lap: life.lap, landing: true };\n\nexport const gravitySameBox = (\n  a: Option.Option<GravityBox>,\n  b: Option.Option<GravityBox>,\n): boolean =>\n  Option.match(a, {\n    onNone: () => Option.isNone(b),\n    onSome: (held) =>\n      Option.exists(\n        b,\n        (next) => held.width === next.width && held.height === next.height,\n      ),\n  });\n"
    },
    {
      "path": "packages/fx/src/gravity-stars/store.ts",
      "target": "@ui/gpuixui/fx/gravity-stars/store.ts",
      "type": "registry:lib",
      "content": "import { Effect } from \"effect\";\nimport * as HashMap from \"effect/HashMap\";\nimport * as Option from \"effect/Option\";\nimport * as SubscriptionRef from \"effect/SubscriptionRef\";\nimport {\n  type MeasuredBox,\n  makeLocalState,\n  type LocalState,\n} from \"../../components/authoring.js\";\nimport {\n  gravityAdvanced,\n  gravityLifeOf,\n  gravitySameBox,\n  type GravityBox,\n  type GravityLife,\n} from \"./logic.js\";\n\nexport interface GravityStoreState {\n  readonly box: Option.Option<GravityBox>;\n\n  readonly lives: HashMap.HashMap<string, GravityLife>;\n}\n\nexport interface GravityStore {\n  readonly local: LocalState<GravityStoreState>;\n\n  readonly measure: (box: Option.Option<MeasuredBox>) => Effect.Effect<void>;\n\n  readonly advance: (key: string) => Effect.Effect<void>;\n}\n\nexport const makeGravityStore: Effect.Effect<GravityStore> = Effect.gen(\n  function* () {\n    const local = yield* makeLocalState<GravityStoreState>({\n      box: Option.none(),\n      lives: HashMap.empty(),\n    });\n\n    const measure = Effect.fnUntraced(function* (\n      box: Option.Option<MeasuredBox>,\n    ) {\n      const current = yield* SubscriptionRef.get(local.state);\n      const next = Option.map(box, (measured) => ({\n        width: measured.width,\n        height: measured.height,\n      }));\n      if (gravitySameBox(current.box, next)) return;\n      yield* local.write({ ...current, box: next });\n    });\n\n    const advance = Effect.fnUntraced(function* (key: string) {\n      const current = yield* SubscriptionRef.get(local.state);\n      yield* local.write({\n        ...current,\n        lives: HashMap.set(\n          current.lives,\n          key,\n          gravityAdvanced(gravityLifeOf(current.lives, key)),\n        ),\n      });\n    });\n\n    return { local, measure, advance };\n  },\n);\n"
    }
  ],
  "docs": "[Gravity stars](https://gpuixui.sudokw.com/effects/gravity-stars) — These are GPUix native components: the files render through GPUix's reconciler against `@gpuix/react`, not the DOM, and need the per-platform `@gpuix/native` binding. The CLI installs the `@gpuixui/*` runtime the components import as registry items, so the copied tree resolves on its own; wrap it in `ThemeProvider` before it renders.",
  "meta": {
    "url": "/effects/gravity-stars",
    "kind": "component",
    "runtime": "gpuix",
    "registry": "gpuixui"
  }
}