anim-3d-obj 1.2.10 → 2.0.1

package/README.md

@@ -1,16 +1,23 @@
+# anim-3d-obj
+
+A lightweight React component for rendering and animating 3D-like objects using only HTML & CSS.  
+No WebGL or heavy 3D libraries required.
+
+---
+
 # React Typescript Cuboid Builder
 
 This project allows a user to create Cuboids of any size simply by entering a set of parameters.  
 The program does the leg work with regard to calculating translationZ depth and config on the fly.
 
 ## Examples
--  [Obj Skeleton](https://codesandbox.io/s/anim-3d-obj-skeleton-5dlk70)
+
 -  [6 sided Cuboid - animate X360 Y360](https://codesandbox.io/s/anim-3d-obj-all-sides-simple-bf67yg-tzr2v6)
 -  [3 sided Object - animate y-axis](https://codesandbox.io/s/anim-3d-obj-3-sides-wobble-y-axis-wglkms)
 -  [Double box spin](https://codesandbox.io/s/react-anim-3d-double-box-spin-vbdhg2)
 -  [Floating Ribbon](https://codesandbox.io/s/cocky-butterfly-ygwkps)
 -  [Parallel divs animated x and y axis in tandem](https://codesandbox.io/s/anim-3d-obj-2-sides-simple-4057y7)
-
+-  [Obj Skeleton](https://codesandbox.io/s/anim-3d-obj-skeleton-5dlk70)
 
 `** ANIMATIONS`
 
@@ -25,6 +32,7 @@ The program does the leg work with regard to calculating translationZ depth and
 -  `noAnim`: no animation place holder
 
 `X-AXIS Animations`
+
 -  `X360`: rotate 360 degrees on the x-axis: [demo](https://codesandbox.io/s/anim-3d-obj-x360-7kiuhw)
 -  `wobX`: wobble on x-axis (degreesHi <-> degreesLow): [demo](https://codesandbox.io/s/anim-3d-obj-wobx-ldwek7)
 -  `fwdx018`: spin object on x-axis from 0 degrees to 180 degrees: [demo](https://codesandbox.io/s/anim-3d-obj-fwd180-v90xyu)
@@ -35,6 +43,7 @@ The program does the leg work with regard to calculating translationZ depth and
 -  `fwdx2736`: spin object on x-axis from 270 degrees to 360 degrees: [demo](https://codesandbox.io/s/anim-3d-obj-fwdx2736-e6c6wg)
 
 `Y-AXIS Animations`
+
 -  `Y360`: rotate 360 degrees on the y-axis: [demo](https://codesandbox.io/s/anim-3d-obj-y360-16lzeb)
 -  `wobY`: wobble on y-axis (degreesHi <-> degreesLow): [demo](https://codesandbox.io/s/anim-3d-obj-woby-tkoxms)
 -  `fwdy018`: spin object on y-axis from 0 degrees to 180 degrees: [demo](https://codesandbox.io/s/anim-3d-obj-fwdy180-qpqhtq)
@@ -44,8 +53,8 @@ The program does the leg work with regard to calculating translationZ depth and
 -  `fwdy1827`: spin object on y-axis from 180 degrees to 270 degrees: [demo](https://codesandbox.io/s/anim-3d-obj-fwdy1827-osskgx)
 -  `fwdy2736`: spin object on y-axis from 270 degrees to 360 degrees: [demo](https://codesandbox.io/s/anim-3d-obj-fwdy2736-rnbs2q)
 
-
 ## Config
+
 ### Animations:
 
 Animations are optional. Either or both of `anim1` or `anim2` can be applied to the component. Animations are applied to 2 wrapping divs respectively.
@@ -66,42 +75,122 @@ const anim1 = {
 ```
 
 ### Faces:
+
 This is an array of objects containing the face used for a given component
+
 ```javascript
-   export interface FaceType {
-      name?: string; // front,back,left,right,top,top_rear,top_front,bottom,bottom_rear,bottom_front
-      css?: string | undefined;
-      body?: any; // can be JSX Component | string | number
-   }
-
-   const faces: FaceType[] = [
-      {
-         name: "back",
-         body: "BACK",
-         css: `background:rgba(22,22,22,.5)`,
-      },
-      {
-         name: "right",
-         body: "RIGHT",
-         css: `background:rgba(220,220,220,.5); 
+export interface FaceType {
+   name?: string; // front,back,left,right,top,top_rear,top_front,bottom,bottom_rear,bottom_front
+   css?: string | undefined;
+   body?: any; // can be JSX Component | string | number
+}
+
+const faces: FaceType[] = [
+   {
+      name: "back",
+      body: "BACK",
+      css: `background:rgba(22,22,22,.5)`,
+   },
+   {
+      name: "right",
+      body: "RIGHT",
+      css: `background:rgba(220,220,220,.5); 
                border:1px solid #ddd`,
-      },
-   ];
+   },
+];
 ```
 
 ### Global (face):
-If the name parameter in the faces array is indicated (ie: "front") but `css` and / or `body` are not.  The `global default`(below) will satisfy those parameters.
+
+If the name parameter in the faces array is indicated (ie: "front") but `css` and / or `body` are not. The `global default`(below) will satisfy those parameters.
+
 ```javascript
-   interface GlobalType {
-      css?: string;
-      body?: string;
-   }
-   const global: GlobalType = {
-      body: "BODY FOR FACE WHICH DOES NOT CONTAIN BODY",
-      css: 'color:red'
-   };
+interface GlobalType {
+   css?: string;
+   body?: string;
+}
+const global: GlobalType = {
+   body: "BODY FOR FACE WHICH DOES NOT CONTAIN BODY",
+   css: "color:red",
+};
 ```
 
 ![all sides](https://github.com/mdnelles/anim-3d-obj-npm-publisher/blob/4a9769a6386a3b5425ede9a04b346d5461051ae0/ang1.png?raw=true)
 
- - https://www.npmjs.com/package/anim-3d-obj
+-  https://www.npmjs.com/package/anim-3d-obj
+
+---
+
+## Features
+
+-  🎨 Pure CSS-based 3D object rendering
+-  ⚡ Zero dependencies (other than React)
+-  🛠 Fully customizable width, height, depth, and colors
+-  🌀 Built-in animation support
+-  🌍 SSR-safe (works with Next.js, Remix, etc.)
+
+---
+
+## Peer requirements
+
+React 18+. Works in Vite, CRA, Next.js (SSR-safe), Remix, etc.
+
+---
+
+## Installation
+
+```bash
+npm install anim-3d-obj
+# or
+yarn add anim-3d-obj
+# or
+pnpm add anim-3d-obj
+
+import React from "react";
+import { Obj } from "anim-3d-obj";
+```
+
+## Full Example
+
+```bash
+function App() {
+  const global = {
+    css: "border: 1px solid #00f; color:#00f; backface-visibility: visible; text-align:center; line-height: 120px; font-size: 14px;",
+    body: "height: 120px; width: 120px;",
+  };
+
+  return (
+    <Obj
+      depth="120px"
+      height="120px"
+      width="120px"
+      perspective="800px"
+      rotation="x 1s linear infinite"
+      global={global}
+    >
+      Hello 3D
+    </Obj>
+  );
+}
+
+export default App;
+```
+
+# Props
+
+The `<Obj />` component accepts the following props:
+
+| Prop        | Type   | Default   | Description                                                                    |
+| ----------- | ------ | --------- | ------------------------------------------------------------------------------ |
+| width       | string | "100px"   | Width of the object.                                                           |
+| height      | string | "100px"   | Height of the object.                                                          |
+| depth       | string | "100px"   | Depth of the object (3rd dimension).                                           |
+| perspective | string | "600px"   | Perspective distance for 3D rendering.                                         |
+| rotation    | string | undefined | CSS animation shorthand for rotating the object (e.g. "x 1s linear infinite"). |
+| global      | object | {}        | Global styles for all faces (css for shared CSS, body for dimensions).         |
+
+## Tips
+
+-  You can pass any React children inside `<Obj> ... </Obj>` to render content on the front face.
+-  Combine with CSS variables or Tailwind utilities for theming.
+-  Works with server-side rendering (SSR) — no window dependency.

package/dist/components/Obj.d.mts

@@ -0,0 +1,50 @@
+import React, { CSSProperties, ReactNode } from 'react';
+
+type AnimationDirection = "normal" | "reverse" | "alternate" | "alternate-reverse";
+type AnimationFill = "none" | "forwards" | "backwards" | "both";
+type AnimationPlayState = "running" | "paused";
+type TimingFn = "linear" | "ease" | "ease-in" | "ease-out" | "ease-in-out" | string;
+type BuiltInAnimName = "Y360" | "X360" | "Z360" | "rockY" | "rockX";
+type AnimationConfig = {
+    name: BuiltInAnimName | string;
+    degreesHi?: number;
+    degreesLow?: number;
+    duration?: number;
+    delay?: number;
+    iterationCount?: number | "infinite";
+    direction?: AnimationDirection;
+    timing?: TimingFn;
+    fillMode?: AnimationFill;
+    animationPlayState?: AnimationPlayState;
+};
+type FaceName = "front" | "back" | "left" | "right" | "top" | "bottom" | "top_rear" | "top_front" | "bottom_rear" | "bottom_front";
+type FaceDef = {
+    name: FaceName | string;
+    css?: string;
+    style?: CSSProperties;
+    body?: ReactNode | string;
+    className?: string;
+};
+type GlobalDef = {
+    css?: string;
+    style?: CSSProperties;
+    body?: ReactNode | string;
+};
+type ObjProps = {
+    width?: number;
+    height?: number;
+    depth?: number;
+    perspective?: number;
+    perspectiveOrigin?: string;
+    faces?: FaceDef[];
+    global?: GlobalDef;
+    anim1?: AnimationConfig;
+    anim2?: AnimationConfig;
+    showCenterDiv?: boolean;
+    className?: string;
+    style?: CSSProperties;
+};
+
+declare const Obj: React.FC<ObjProps>;
+
+export { type AnimationConfig as A, type BuiltInAnimName as B, type FaceDef as F, type GlobalDef as G, type ObjProps as O, Obj, type FaceName as a, Obj as default };

package/dist/components/Obj.d.ts

@@ -0,0 +1,50 @@
+import React, { CSSProperties, ReactNode } from 'react';
+
+type AnimationDirection = "normal" | "reverse" | "alternate" | "alternate-reverse";
+type AnimationFill = "none" | "forwards" | "backwards" | "both";
+type AnimationPlayState = "running" | "paused";
+type TimingFn = "linear" | "ease" | "ease-in" | "ease-out" | "ease-in-out" | string;
+type BuiltInAnimName = "Y360" | "X360" | "Z360" | "rockY" | "rockX";
+type AnimationConfig = {
+    name: BuiltInAnimName | string;
+    degreesHi?: number;
+    degreesLow?: number;
+    duration?: number;
+    delay?: number;
+    iterationCount?: number | "infinite";
+    direction?: AnimationDirection;
+    timing?: TimingFn;
+    fillMode?: AnimationFill;
+    animationPlayState?: AnimationPlayState;
+};
+type FaceName = "front" | "back" | "left" | "right" | "top" | "bottom" | "top_rear" | "top_front" | "bottom_rear" | "bottom_front";
+type FaceDef = {
+    name: FaceName | string;
+    css?: string;
+    style?: CSSProperties;
+    body?: ReactNode | string;
+    className?: string;
+};
+type GlobalDef = {
+    css?: string;
+    style?: CSSProperties;
+    body?: ReactNode | string;
+};
+type ObjProps = {
+    width?: number;
+    height?: number;
+    depth?: number;
+    perspective?: number;
+    perspectiveOrigin?: string;
+    faces?: FaceDef[];
+    global?: GlobalDef;
+    anim1?: AnimationConfig;
+    anim2?: AnimationConfig;
+    showCenterDiv?: boolean;
+    className?: string;
+    style?: CSSProperties;
+};
+
+declare const Obj: React.FC<ObjProps>;
+
+export { type AnimationConfig as A, type BuiltInAnimName as B, type FaceDef as F, type GlobalDef as G, type ObjProps as O, Obj, type FaceName as a, Obj as default };

package/dist/components/Obj.js

@@ -0,0 +1,231 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/Obj.tsx
+var Obj_exports = {};
+__export(Obj_exports, {
+  Obj: () => Obj,
+  default: () => Obj_default
+});
+module.exports = __toCommonJS(Obj_exports);
+var import_react = require("react");
+
+// src/keyframes.ts
+function ensureStyleTag() {
+  let tag = document.getElementById(
+    "anim3d-keyframes"
+  );
+  if (!tag) {
+    tag = document.createElement("style");
+    tag.id = "anim3d-keyframes";
+    document.head.appendChild(tag);
+  }
+  return tag;
+}
+function inject(css) {
+  if (typeof document === "undefined") return;
+  const tag = ensureStyleTag();
+  tag.appendChild(document.createTextNode(css));
+}
+function builtInKeyframes(name, cfg) {
+  const hi = cfg.degreesHi ?? 15;
+  const lo = cfg.degreesLow ?? -15;
+  switch (name) {
+    case "Y360":
+      return `@keyframes Y360 { from { transform: rotateY(0deg) } to { transform: rotateY(360deg) } }`;
+    case "X360":
+      return `@keyframes X360 { from { transform: rotateX(0deg) } to { transform: rotateX(360deg) } }`;
+    case "Z360":
+      return `@keyframes Z360 { from { transform: rotateZ(0deg) } to { transform: rotateZ(360deg) } }`;
+    case "rockY":
+      return `@keyframes rockY { 0%{ transform: rotateY(${lo}deg) } 50%{ transform: rotateY(${hi}deg) } 100%{ transform: rotateY(${lo}deg) } }`;
+    case "rockX":
+      return `@keyframes rockX { 0%{ transform: rotateX(${lo}deg) } 50%{ transform: rotateX(${hi}deg) } 100%{ transform: rotateX(${lo}deg) } }`;
+    default:
+      return "";
+  }
+}
+function resolveAnimation(cfg) {
+  if (!cfg) return null;
+  const name = cfg.name;
+  const builtIn = builtInKeyframes(name, cfg);
+  if (builtIn) {
+    const marker = `/*kf-${name}*/`;
+    if (typeof document !== "undefined") {
+      const tag = ensureStyleTag();
+      if (!tag.innerHTML.includes(marker)) {
+        inject(`${builtIn}
+${marker}`);
+      }
+    }
+    return name;
+  }
+  return name;
+}
+function toAnimationShorthand(cfg) {
+  const name = resolveAnimation(cfg);
+  if (!cfg || !name) return null;
+  const dur = (cfg.duration ?? 10) + "s";
+  const delay = (cfg.delay ?? 0) + "s";
+  const iter = cfg.iterationCount ?? "infinite";
+  const dir = cfg.direction ?? "normal";
+  const timing = cfg.timing ?? "linear";
+  const fill = cfg.fillMode ?? "forwards";
+  const play = cfg.animationPlayState ?? "running";
+  return `${name} ${dur} ${timing} ${delay} ${iter} ${dir} ${fill} ${play}`;
+}
+
+// src/components/Obj.tsx
+var import_obj = require("../obj-PY72GEW6.css");
+var import_jsx_runtime = require("react/jsx-runtime");
+function faceTransform(name, w, h, d) {
+  const z = d / 2;
+  switch (name) {
+    case "front":
+      return `translate3d(-50%, -50%, ${z}px)`;
+    case "back":
+      return `translate3d(-50%, -50%, ${-z}px) rotateY(180deg)`;
+    case "left":
+      return `translate3d(-50%, -50%, 0) rotateY(-90deg) translateZ(${w / 2}px)`;
+    case "right":
+      return `translate3d(-50%, -50%, 0) rotateY(90deg) translateZ(${w / 2}px)`;
+    case "top":
+      return `translate3d(-50%, -50%, 0) rotateX(90deg) translateZ(${h / 2}px)`;
+    case "bottom":
+      return `translate3d(-50%, -50%, 0) rotateX(-90deg) translateZ(${h / 2}px)`;
+    // legacy/extra – position near top/bottom, front/back edges
+    case "top_front":
+      return `translate3d(-50%, -50%, ${z / 2}px) rotateX(75deg)`;
+    case "top_rear":
+      return `translate3d(-50%, -50%, ${-z / 2}px) rotateX(105deg)`;
+    case "bottom_front":
+      return `translate3d(-50%, -50%, ${z / 2}px) rotateX(-75deg)`;
+    case "bottom_rear":
+      return `translate3d(-50%, -50%, ${-z / 2}px) rotateX(-105deg)`;
+    default:
+      return `translate3d(-50%, -50%, ${z}px)`;
+  }
+}
+function mergeStyles(inlineCSS, style) {
+  const out = { ...style ?? {} };
+  if (inlineCSS) {
+    inlineCSS.split(";").map((s) => s.trim()).filter(Boolean).forEach((rule) => {
+      const [k, v] = rule.split(":");
+      if (!k || !v) return;
+      const key = k.trim().replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+      out[key] = v.trim();
+    });
+  }
+  return out;
+}
+function Face({
+  w,
+  h,
+  d,
+  face,
+  global
+}) {
+  const base = (0, import_react.useMemo)(
+    () => mergeStyles(global?.css, global?.style),
+    [global]
+  );
+  const merged = (0, import_react.useMemo)(
+    () => ({ ...base, ...mergeStyles(face.css, face.style) }),
+    [base, face.css, face.style]
+  );
+  const content = face.body ?? global?.body ?? null;
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    "div",
+    {
+      className: `anim3d-face ${face.className ?? ""}`,
+      style: {
+        transform: faceTransform(face.name, w, h, d),
+        ...merged
+      },
+      "data-face": face.name,
+      children: typeof content === "string" ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children: content }) : content
+    }
+  );
+}
+var Obj = ({
+  width = 160,
+  height = 160,
+  depth = 150,
+  perspective = 500,
+  perspectiveOrigin = "50% 50%",
+  faces = [
+    { name: "front", body: "FRONT" },
+    { name: "back", body: "BACK" },
+    { name: "left", body: "LEFT" },
+    { name: "right", body: "RIGHT" },
+    { name: "top", body: "TOP" },
+    { name: "bottom", body: "BOTTOM" }
+  ],
+  global,
+  anim1,
+  anim2,
+  showCenterDiv = false,
+  className,
+  style
+}) => {
+  const resolvedAnim1 = toAnimationShorthand(anim1);
+  const resolvedAnim2 = toAnimationShorthand(anim2);
+  const animation = [resolvedAnim1, resolvedAnim2].filter(Boolean).join(", ");
+  const stageStyle = {
+    perspective: `${perspective}px`,
+    perspectiveOrigin
+  };
+  const wrapperStyle = {
+    // consumed by CSS var
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    "--obj-w": `${width}px`,
+    "--obj-h": `${height}px`,
+    width,
+    height,
+    "animation": animation || void 0
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    "div",
+    {
+      className: `anim3d-stage ${className ?? ""}`,
+      style: { ...stageStyle, ...style },
+      children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "anim3d-wrapper", style: wrapperStyle, children: [
+        showCenterDiv && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "anim3d-center" }),
+        faces.map((f, i) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+          Face,
+          {
+            w: width,
+            h: height,
+            d: depth,
+            face: f,
+            global
+          },
+          `${f.name}-${i}`
+        ))
+      ] })
+    }
+  );
+};
+var Obj_default = Obj;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Obj
+});
+//# sourceMappingURL=Obj.js.map

package/dist/components/Obj.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/Obj.tsx","../../src/keyframes.ts"],"sourcesContent":["import React, { useMemo } from \"react\";\nimport type { CSSProperties, ReactNode } from \"react\";\nimport { FaceDef, GlobalDef, ObjProps, FaceName } from \"../types\";\nimport { toAnimationShorthand } from \"../keyframes\";\nimport \"../styles/obj.css\";\n\n/** Map face name -> transform so it sits on a rectangular prism */\nfunction faceTransform(name: string, w: number, h: number, d: number): string {\n   const z = d / 2;\n   switch (name as FaceName) {\n      case \"front\":\n         return `translate3d(-50%, -50%, ${z}px)`;\n      case \"back\":\n         return `translate3d(-50%, -50%, ${-z}px) rotateY(180deg)`;\n      case \"left\":\n         return `translate3d(-50%, -50%, 0) rotateY(-90deg) translateZ(${\n            w / 2\n         }px)`;\n      case \"right\":\n         return `translate3d(-50%, -50%, 0) rotateY(90deg) translateZ(${\n            w / 2\n         }px)`;\n      case \"top\":\n         return `translate3d(-50%, -50%, 0) rotateX(90deg) translateZ(${\n            h / 2\n         }px)`;\n      case \"bottom\":\n         return `translate3d(-50%, -50%, 0) rotateX(-90deg) translateZ(${\n            h / 2\n         }px)`;\n      // legacy/extra – position near top/bottom, front/back edges\n      case \"top_front\":\n         return `translate3d(-50%, -50%, ${z / 2}px) rotateX(75deg)`;\n      case \"top_rear\":\n         return `translate3d(-50%, -50%, ${-z / 2}px) rotateX(105deg)`;\n      case \"bottom_front\":\n         return `translate3d(-50%, -50%, ${z / 2}px) rotateX(-75deg)`;\n      case \"bottom_rear\":\n         return `translate3d(-50%, -50%, ${-z / 2}px) rotateX(-105deg)`;\n      default:\n         return `translate3d(-50%, -50%, ${z}px)`;\n   }\n}\n\n/** Merge legacy CSS string + style object */\nfunction mergeStyles(inlineCSS?: string, style?: CSSProperties): CSSProperties {\n   const out: CSSProperties = { ...(style ?? {}) };\n   if (inlineCSS) {\n      // naive parser: split by ;, then key:value\n      inlineCSS\n         .split(\";\")\n         .map((s) => s.trim())\n         .filter(Boolean)\n         .forEach((rule) => {\n            const [k, v] = rule.split(\":\");\n            if (!k || !v) return;\n            const key = k\n               .trim()\n               .replace(/-([a-z])/g, (_, c) => c.toUpperCase());\n            (out as any)[key] = v.trim();\n         });\n   }\n   return out;\n}\n\nfunction Face({\n   w,\n   h,\n   d,\n   face,\n   global,\n}: {\n   w: number;\n   h: number;\n   d: number;\n   face: FaceDef;\n   global?: GlobalDef;\n}) {\n   const base = useMemo(\n      () => mergeStyles(global?.css, global?.style),\n      [global]\n   );\n   const merged = useMemo(\n      () => ({ ...base, ...mergeStyles(face.css, face.style) }),\n      [base, face.css, face.style]\n   );\n\n   const content: ReactNode = face.body ?? global?.body ?? null;\n\n   return (\n      <div\n         className={`anim3d-face ${face.className ?? \"\"}`}\n         style={{\n            transform: faceTransform(face.name, w, h, d),\n            ...merged,\n         }}\n         data-face={face.name}\n      >\n         {typeof content === \"string\" ? <span>{content}</span> : content}\n      </div>\n   );\n}\n\nconst Obj: React.FC<ObjProps> = ({\n   width = 160,\n   height = 160,\n   depth = 150,\n   perspective = 500,\n   perspectiveOrigin = \"50% 50%\",\n   faces = [\n      { name: \"front\", body: \"FRONT\" },\n      { name: \"back\", body: \"BACK\" },\n      { name: \"left\", body: \"LEFT\" },\n      { name: \"right\", body: \"RIGHT\" },\n      { name: \"top\", body: \"TOP\" },\n      { name: \"bottom\", body: \"BOTTOM\" },\n   ],\n   global,\n   anim1,\n   anim2,\n   showCenterDiv = false,\n   className,\n   style,\n}) => {\n   const resolvedAnim1 = toAnimationShorthand(anim1);\n   const resolvedAnim2 = toAnimationShorthand(anim2);\n   const animation = [resolvedAnim1, resolvedAnim2].filter(Boolean).join(\", \");\n\n   const stageStyle: CSSProperties = {\n      perspective: `${perspective}px`,\n      perspectiveOrigin,\n   };\n\n   const wrapperStyle: CSSProperties = {\n      // consumed by CSS var\n      // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n      // @ts-ignore\n      \"--obj-w\": `${width}px`,\n      \"--obj-h\": `${height}px`,\n      width,\n      height,\n      \"animation\": animation || undefined,\n   };\n\n   return (\n      <div\n         className={`anim3d-stage ${className ?? \"\"}`}\n         style={{ ...stageStyle, ...style }}\n      >\n         <div className='anim3d-wrapper' style={wrapperStyle as any}>\n            {showCenterDiv && <div className='anim3d-center' />}\n            {faces.map((f, i) => (\n               <Face\n                  key={`${f.name}-${i}`}\n                  w={width}\n                  h={height}\n                  d={depth}\n                  face={f}\n                  global={global}\n               />\n            ))}\n         </div>\n      </div>\n   );\n};\n\nexport default Obj;\nexport { Obj };\n","import type { AnimationConfig } from \"./types\";\n\nlet counter = 0;\nconst uid = () => (++counter).toString(36);\n\n/** Create (or reuse) a <style> tag for dynamic keyframes */\nfunction ensureStyleTag(): HTMLStyleElement {\n   let tag = document.getElementById(\n      \"anim3d-keyframes\"\n   ) as HTMLStyleElement | null;\n   if (!tag) {\n      tag = document.createElement(\"style\");\n      tag.id = \"anim3d-keyframes\";\n      document.head.appendChild(tag);\n   }\n   return tag;\n}\n\nfunction inject(css: string) {\n   if (typeof document === \"undefined\") return; // SSR\n   const tag = ensureStyleTag();\n   tag.appendChild(document.createTextNode(css));\n}\n\n/** Keyframes text for built-ins */\nfunction builtInKeyframes(name: string, cfg: AnimationConfig) {\n   const hi = cfg.degreesHi ?? 15;\n   const lo = cfg.degreesLow ?? -15;\n   switch (name) {\n      case \"Y360\":\n         return `@keyframes Y360 { from { transform: rotateY(0deg) } to { transform: rotateY(360deg) } }`;\n      case \"X360\":\n         return `@keyframes X360 { from { transform: rotateX(0deg) } to { transform: rotateX(360deg) } }`;\n      case \"Z360\":\n         return `@keyframes Z360 { from { transform: rotateZ(0deg) } to { transform: rotateZ(360deg) } }`;\n      case \"rockY\":\n         return `@keyframes rockY { 0%{ transform: rotateY(${lo}deg) } 50%{ transform: rotateY(${hi}deg) } 100%{ transform: rotateY(${lo}deg) } }`;\n      case \"rockX\":\n         return `@keyframes rockX { 0%{ transform: rotateX(${lo}deg) } 50%{ transform: rotateX(${hi}deg) } 100%{ transform: rotateX(${lo}deg) } }`;\n      default:\n         // Custom names: let authors supply their own @keyframes in global CSS with that name.\n         return \"\";\n   }\n}\n\n/** Returns a concrete animation-name and ensures keyframes exist (for built-ins) */\nexport function resolveAnimation(cfg?: AnimationConfig): string | null {\n   if (!cfg) return null;\n   const name = cfg.name;\n   const builtIn = builtInKeyframes(name, cfg);\n   if (builtIn) {\n      // Ensure single injection per built-in name\n      const marker = `/*kf-${name}*/`;\n      if (typeof document !== \"undefined\") {\n         const tag = ensureStyleTag();\n         if (!tag.innerHTML.includes(marker)) {\n            inject(`${builtIn}\\n${marker}`);\n         }\n      }\n      return name; // use built-in name as animation-name\n   }\n   // custom: use author-provided @keyframes by name\n   return name;\n}\n\n/** Build the full CSS animation shorthand from a config and resolved name */\nexport function toAnimationShorthand(cfg?: AnimationConfig): string | null {\n   const name = resolveAnimation(cfg);\n   if (!cfg || !name) return null;\n   const dur = (cfg.duration ?? 10) + \"s\";\n   const delay = (cfg.delay ?? 0) + \"s\";\n   const iter = cfg.iterationCount ?? \"infinite\";\n   const dir = cfg.direction ?? \"normal\";\n   const timing = cfg.timing ?? \"linear\";\n   const fill = cfg.fillMode ?? \"forwards\";\n   const play = cfg.animationPlayState ?? \"running\";\n   // name duration timing delay iteration-count direction fill-mode play-state\n   return `${name} ${dur} ${timing} ${delay} ${iter} ${dir} ${fill} ${play}`;\n}\n"],"mappings":"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","names":[]}