anim-3d-obj 2.0.1 → 2.0.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,10 +1,3 @@
1
- # anim-3d-obj
2
-
3
- A lightweight React component for rendering and animating 3D-like objects using only HTML & CSS.
4
- No WebGL or heavy 3D libraries required.
5
-
6
- ---
7
-
8
1
  # React Typescript Cuboid Builder
9
2
 
10
3
  This project allows a user to create Cuboids of any size simply by entering a set of parameters.
@@ -32,7 +25,6 @@ The program does the leg work with regard to calculating translationZ depth and
32
25
  - `noAnim`: no animation place holder
33
26
 
34
27
  `X-AXIS Animations`
35
-
36
28
  - `X360`: rotate 360 degrees on the x-axis: [demo](https://codesandbox.io/s/anim-3d-obj-x360-7kiuhw)
37
29
  - `wobX`: wobble on x-axis (degreesHi <-> degreesLow): [demo](https://codesandbox.io/s/anim-3d-obj-wobx-ldwek7)
38
30
  - `fwdx018`: spin object on x-axis from 0 degrees to 180 degrees: [demo](https://codesandbox.io/s/anim-3d-obj-fwd180-v90xyu)
@@ -43,7 +35,6 @@ The program does the leg work with regard to calculating translationZ depth and
43
35
  - `fwdx2736`: spin object on x-axis from 270 degrees to 360 degrees: [demo](https://codesandbox.io/s/anim-3d-obj-fwdx2736-e6c6wg)
44
36
 
45
37
  `Y-AXIS Animations`
46
-
47
38
  - `Y360`: rotate 360 degrees on the y-axis: [demo](https://codesandbox.io/s/anim-3d-obj-y360-16lzeb)
48
39
  - `wobY`: wobble on y-axis (degreesHi <-> degreesLow): [demo](https://codesandbox.io/s/anim-3d-obj-woby-tkoxms)
49
40
  - `fwdy018`: spin object on y-axis from 0 degrees to 180 degrees: [demo](https://codesandbox.io/s/anim-3d-obj-fwdy180-qpqhtq)
@@ -53,8 +44,8 @@ The program does the leg work with regard to calculating translationZ depth and
53
44
  - `fwdy1827`: spin object on y-axis from 180 degrees to 270 degrees: [demo](https://codesandbox.io/s/anim-3d-obj-fwdy1827-osskgx)
54
45
  - `fwdy2736`: spin object on y-axis from 270 degrees to 360 degrees: [demo](https://codesandbox.io/s/anim-3d-obj-fwdy2736-rnbs2q)
55
46
 
56
- ## Config
57
47
 
48
+ ## Config
58
49
  ### Animations:
59
50
 
60
51
  Animations are optional. Either or both of `anim1` or `anim2` can be applied to the component. Animations are applied to 2 wrapping divs respectively.
@@ -75,122 +66,42 @@ const anim1 = {
75
66
  ```
76
67
 
77
68
  ### Faces:
78
-
79
69
  This is an array of objects containing the face used for a given component
80
-
81
70
  ```javascript
82
- export interface FaceType {
83
- name?: string; // front,back,left,right,top,top_rear,top_front,bottom,bottom_rear,bottom_front
84
- css?: string | undefined;
85
- body?: any; // can be JSX Component | string | number
86
- }
87
-
88
- const faces: FaceType[] = [
89
- {
90
- name: "back",
91
- body: "BACK",
92
- css: `background:rgba(22,22,22,.5)`,
93
- },
94
- {
95
- name: "right",
96
- body: "RIGHT",
97
- css: `background:rgba(220,220,220,.5);
71
+ export interface FaceType {
72
+ name?: string; // front,back,left,right,top,top_rear,top_front,bottom,bottom_rear,bottom_front
73
+ css?: string | undefined;
74
+ body?: any; // can be JSX Component | string | number
75
+ }
76
+
77
+ const faces: FaceType[] = [
78
+ {
79
+ name: "back",
80
+ body: "BACK",
81
+ css: `background:rgba(22,22,22,.5)`,
82
+ },
83
+ {
84
+ name: "right",
85
+ body: "RIGHT",
86
+ css: `background:rgba(220,220,220,.5);
98
87
  border:1px solid #ddd`,
99
- },
100
- ];
88
+ },
89
+ ];
101
90
  ```
102
91
 
103
92
  ### Global (face):
104
-
105
- 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.
106
-
93
+ 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.
107
94
  ```javascript
108
- interface GlobalType {
109
- css?: string;
110
- body?: string;
111
- }
112
- const global: GlobalType = {
113
- body: "BODY FOR FACE WHICH DOES NOT CONTAIN BODY",
114
- css: "color:red",
115
- };
95
+ interface GlobalType {
96
+ css?: string;
97
+ body?: string;
98
+ }
99
+ const global: GlobalType = {
100
+ body: "BODY FOR FACE WHICH DOES NOT CONTAIN BODY",
101
+ css: 'color:red'
102
+ };
116
103
  ```
117
104
 
118
105
  ![all sides](https://github.com/mdnelles/anim-3d-obj-npm-publisher/blob/4a9769a6386a3b5425ede9a04b346d5461051ae0/ang1.png?raw=true)
119
106
 
120
- - https://www.npmjs.com/package/anim-3d-obj
121
-
122
- ---
123
-
124
- ## Features
125
-
126
- - 🎨 Pure CSS-based 3D object rendering
127
- - ⚡ Zero dependencies (other than React)
128
- - 🛠 Fully customizable width, height, depth, and colors
129
- - 🌀 Built-in animation support
130
- - 🌍 SSR-safe (works with Next.js, Remix, etc.)
131
-
132
- ---
133
-
134
- ## Peer requirements
135
-
136
- React 18+. Works in Vite, CRA, Next.js (SSR-safe), Remix, etc.
137
-
138
- ---
139
-
140
- ## Installation
141
-
142
- ```bash
143
- npm install anim-3d-obj
144
- # or
145
- yarn add anim-3d-obj
146
- # or
147
- pnpm add anim-3d-obj
148
-
149
- import React from "react";
150
- import { Obj } from "anim-3d-obj";
151
- ```
152
-
153
- ## Full Example
154
-
155
- ```bash
156
- function App() {
157
- const global = {
158
- css: "border: 1px solid #00f; color:#00f; backface-visibility: visible; text-align:center; line-height: 120px; font-size: 14px;",
159
- body: "height: 120px; width: 120px;",
160
- };
161
-
162
- return (
163
- <Obj
164
- depth="120px"
165
- height="120px"
166
- width="120px"
167
- perspective="800px"
168
- rotation="x 1s linear infinite"
169
- global={global}
170
- >
171
- Hello 3D
172
- </Obj>
173
- );
174
- }
175
-
176
- export default App;
177
- ```
178
-
179
- # Props
180
-
181
- The `<Obj />` component accepts the following props:
182
-
183
- | Prop | Type | Default | Description |
184
- | ----------- | ------ | --------- | ------------------------------------------------------------------------------ |
185
- | width | string | "100px" | Width of the object. |
186
- | height | string | "100px" | Height of the object. |
187
- | depth | string | "100px" | Depth of the object (3rd dimension). |
188
- | perspective | string | "600px" | Perspective distance for 3D rendering. |
189
- | rotation | string | undefined | CSS animation shorthand for rotating the object (e.g. "x 1s linear infinite"). |
190
- | global | object | {} | Global styles for all faces (css for shared CSS, body for dimensions). |
191
-
192
- ## Tips
193
-
194
- - You can pass any React children inside `<Obj> ... </Obj>` to render content on the front face.
195
- - Combine with CSS variables or Tailwind utilities for theming.
196
- - Works with server-side rendering (SSR) — no window dependency.
107
+ - https://www.npmjs.com/package/anim-3d-obj
package/package.json CHANGED
@@ -1,46 +1,50 @@
1
1
  {
2
2
  "name": "anim-3d-obj",
3
- "version": "2.0.1",
4
- "description": "Configurable 3D object with animated rotations and face content",
5
- "license": "MIT",
6
- "author": "mdnelles",
7
- "sideEffects": [
8
- "dist/**/*.css",
9
- "src/styles/obj.css"
10
- ],
11
- "module": "dist/esm/index.js",
12
- "main": "dist/cjs/index.cjs",
13
- "types": "dist/esm/index.d.ts",
14
- "exports": {
15
- ".": {
16
- "import": "./dist/esm/index.js",
17
- "require": "./dist/cjs/index.cjs",
18
- "types": "./dist/esm/index.d.ts"
19
- },
20
- "./components/Obj": {
21
- "import": "./dist/esm/components/Obj.js",
22
- "require": "./dist/cjs/components/Obj.cjs",
23
- "types": "./dist/esm/components/Obj.d.ts"
24
- },
25
- "./dist/cjs/components/Obj": "./dist/cjs/components/Obj.cjs"
3
+ "version": "2.0.9",
4
+ "repository": {
5
+ "type": "git",
6
+ "url": "https://github.com/mdnelles/anim-3d-obj-npm-publisher.git"
26
7
  },
8
+ "homepage": "https://mdnelles.github.io/a3o-playground/",
9
+ "description": "React library for creating 3D objects quickly. Also these objects can be animated",
10
+ "mainOLD": "dist/cjs/index.js",
11
+ "main": "dist/cjs/components/Obj.js",
12
+ "module": "dist/esm/components/Obj.js",
27
13
  "files": [
28
14
  "dist"
29
15
  ],
30
16
  "scripts": {
31
- "build": "tsup",
32
- "clean": "rm -rf dist",
33
- "dev": "tsup --watch",
34
- "prepublishOnly": "npm run clean && npm run build"
17
+ "build": "rm -rf dist/ && prettier --write src/ && npm run build:esm && npm run build:cjs",
18
+ "build:esm": "tsc",
19
+ "build:cjs": "tsc --module CommonJS --outDir dist/cjs"
20
+ },
21
+ "author": "mdnelles",
22
+ "license": "MIT",
23
+ "devDependencies": {
24
+ "@types/node": "^18.11.9",
25
+ "@types/react": "^18.0.25",
26
+ "@types/react-dom": "^18.0.8",
27
+ "@types/styled-components": "^5.1.26",
28
+ "prettier": "^3.0.0",
29
+ "react": "^18.2.0",
30
+ "react-dom": "^18.2.0",
31
+ "typescript": "^4.8.4"
35
32
  },
36
33
  "peerDependencies": {
37
- "react": ">=17 || >=18",
38
- "react-dom": ">=17 || >=18"
34
+ "react": "^18.2.0",
35
+ "react-dom": "^18.2.0"
39
36
  },
40
- "devDependencies": {
41
- "@types/react": "^18.3.3",
42
- "@types/react-dom": "^18.3.0",
43
- "tsup": "^8.5.0",
44
- "typescript": "^5.9.2"
45
- }
37
+ "dependencies": {
38
+ "styled-components": "^5.3.6"
39
+ },
40
+ "keywords": [
41
+ "React",
42
+ "CSS",
43
+ "style",
44
+ "animation",
45
+ "cube",
46
+ "cuboid",
47
+ "3d",
48
+ "webGL"
49
+ ]
46
50
  }
@@ -1,50 +0,0 @@
1
- import React, { CSSProperties, ReactNode } from 'react';
2
-
3
- type AnimationDirection = "normal" | "reverse" | "alternate" | "alternate-reverse";
4
- type AnimationFill = "none" | "forwards" | "backwards" | "both";
5
- type AnimationPlayState = "running" | "paused";
6
- type TimingFn = "linear" | "ease" | "ease-in" | "ease-out" | "ease-in-out" | string;
7
- type BuiltInAnimName = "Y360" | "X360" | "Z360" | "rockY" | "rockX";
8
- type AnimationConfig = {
9
- name: BuiltInAnimName | string;
10
- degreesHi?: number;
11
- degreesLow?: number;
12
- duration?: number;
13
- delay?: number;
14
- iterationCount?: number | "infinite";
15
- direction?: AnimationDirection;
16
- timing?: TimingFn;
17
- fillMode?: AnimationFill;
18
- animationPlayState?: AnimationPlayState;
19
- };
20
- type FaceName = "front" | "back" | "left" | "right" | "top" | "bottom" | "top_rear" | "top_front" | "bottom_rear" | "bottom_front";
21
- type FaceDef = {
22
- name: FaceName | string;
23
- css?: string;
24
- style?: CSSProperties;
25
- body?: ReactNode | string;
26
- className?: string;
27
- };
28
- type GlobalDef = {
29
- css?: string;
30
- style?: CSSProperties;
31
- body?: ReactNode | string;
32
- };
33
- type ObjProps = {
34
- width?: number;
35
- height?: number;
36
- depth?: number;
37
- perspective?: number;
38
- perspectiveOrigin?: string;
39
- faces?: FaceDef[];
40
- global?: GlobalDef;
41
- anim1?: AnimationConfig;
42
- anim2?: AnimationConfig;
43
- showCenterDiv?: boolean;
44
- className?: string;
45
- style?: CSSProperties;
46
- };
47
-
48
- declare const Obj: React.FC<ObjProps>;
49
-
50
- 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 };
@@ -1,50 +0,0 @@
1
- import React, { CSSProperties, ReactNode } from 'react';
2
-
3
- type AnimationDirection = "normal" | "reverse" | "alternate" | "alternate-reverse";
4
- type AnimationFill = "none" | "forwards" | "backwards" | "both";
5
- type AnimationPlayState = "running" | "paused";
6
- type TimingFn = "linear" | "ease" | "ease-in" | "ease-out" | "ease-in-out" | string;
7
- type BuiltInAnimName = "Y360" | "X360" | "Z360" | "rockY" | "rockX";
8
- type AnimationConfig = {
9
- name: BuiltInAnimName | string;
10
- degreesHi?: number;
11
- degreesLow?: number;
12
- duration?: number;
13
- delay?: number;
14
- iterationCount?: number | "infinite";
15
- direction?: AnimationDirection;
16
- timing?: TimingFn;
17
- fillMode?: AnimationFill;
18
- animationPlayState?: AnimationPlayState;
19
- };
20
- type FaceName = "front" | "back" | "left" | "right" | "top" | "bottom" | "top_rear" | "top_front" | "bottom_rear" | "bottom_front";
21
- type FaceDef = {
22
- name: FaceName | string;
23
- css?: string;
24
- style?: CSSProperties;
25
- body?: ReactNode | string;
26
- className?: string;
27
- };
28
- type GlobalDef = {
29
- css?: string;
30
- style?: CSSProperties;
31
- body?: ReactNode | string;
32
- };
33
- type ObjProps = {
34
- width?: number;
35
- height?: number;
36
- depth?: number;
37
- perspective?: number;
38
- perspectiveOrigin?: string;
39
- faces?: FaceDef[];
40
- global?: GlobalDef;
41
- anim1?: AnimationConfig;
42
- anim2?: AnimationConfig;
43
- showCenterDiv?: boolean;
44
- className?: string;
45
- style?: CSSProperties;
46
- };
47
-
48
- declare const Obj: React.FC<ObjProps>;
49
-
50
- 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 };
@@ -1,231 +0,0 @@
1
- "use strict";
2
- var __defProp = Object.defineProperty;
3
- var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
- var __getOwnPropNames = Object.getOwnPropertyNames;
5
- var __hasOwnProp = Object.prototype.hasOwnProperty;
6
- var __export = (target, all) => {
7
- for (var name in all)
8
- __defProp(target, name, { get: all[name], enumerable: true });
9
- };
10
- var __copyProps = (to, from, except, desc) => {
11
- if (from && typeof from === "object" || typeof from === "function") {
12
- for (let key of __getOwnPropNames(from))
13
- if (!__hasOwnProp.call(to, key) && key !== except)
14
- __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
- }
16
- return to;
17
- };
18
- var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
-
20
- // src/components/Obj.tsx
21
- var Obj_exports = {};
22
- __export(Obj_exports, {
23
- Obj: () => Obj,
24
- default: () => Obj_default
25
- });
26
- module.exports = __toCommonJS(Obj_exports);
27
- var import_react = require("react");
28
-
29
- // src/keyframes.ts
30
- function ensureStyleTag() {
31
- let tag = document.getElementById(
32
- "anim3d-keyframes"
33
- );
34
- if (!tag) {
35
- tag = document.createElement("style");
36
- tag.id = "anim3d-keyframes";
37
- document.head.appendChild(tag);
38
- }
39
- return tag;
40
- }
41
- function inject(css) {
42
- if (typeof document === "undefined") return;
43
- const tag = ensureStyleTag();
44
- tag.appendChild(document.createTextNode(css));
45
- }
46
- function builtInKeyframes(name, cfg) {
47
- const hi = cfg.degreesHi ?? 15;
48
- const lo = cfg.degreesLow ?? -15;
49
- switch (name) {
50
- case "Y360":
51
- return `@keyframes Y360 { from { transform: rotateY(0deg) } to { transform: rotateY(360deg) } }`;
52
- case "X360":
53
- return `@keyframes X360 { from { transform: rotateX(0deg) } to { transform: rotateX(360deg) } }`;
54
- case "Z360":
55
- return `@keyframes Z360 { from { transform: rotateZ(0deg) } to { transform: rotateZ(360deg) } }`;
56
- case "rockY":
57
- return `@keyframes rockY { 0%{ transform: rotateY(${lo}deg) } 50%{ transform: rotateY(${hi}deg) } 100%{ transform: rotateY(${lo}deg) } }`;
58
- case "rockX":
59
- return `@keyframes rockX { 0%{ transform: rotateX(${lo}deg) } 50%{ transform: rotateX(${hi}deg) } 100%{ transform: rotateX(${lo}deg) } }`;
60
- default:
61
- return "";
62
- }
63
- }
64
- function resolveAnimation(cfg) {
65
- if (!cfg) return null;
66
- const name = cfg.name;
67
- const builtIn = builtInKeyframes(name, cfg);
68
- if (builtIn) {
69
- const marker = `/*kf-${name}*/`;
70
- if (typeof document !== "undefined") {
71
- const tag = ensureStyleTag();
72
- if (!tag.innerHTML.includes(marker)) {
73
- inject(`${builtIn}
74
- ${marker}`);
75
- }
76
- }
77
- return name;
78
- }
79
- return name;
80
- }
81
- function toAnimationShorthand(cfg) {
82
- const name = resolveAnimation(cfg);
83
- if (!cfg || !name) return null;
84
- const dur = (cfg.duration ?? 10) + "s";
85
- const delay = (cfg.delay ?? 0) + "s";
86
- const iter = cfg.iterationCount ?? "infinite";
87
- const dir = cfg.direction ?? "normal";
88
- const timing = cfg.timing ?? "linear";
89
- const fill = cfg.fillMode ?? "forwards";
90
- const play = cfg.animationPlayState ?? "running";
91
- return `${name} ${dur} ${timing} ${delay} ${iter} ${dir} ${fill} ${play}`;
92
- }
93
-
94
- // src/components/Obj.tsx
95
- var import_obj = require("../obj-PY72GEW6.css");
96
- var import_jsx_runtime = require("react/jsx-runtime");
97
- function faceTransform(name, w, h, d) {
98
- const z = d / 2;
99
- switch (name) {
100
- case "front":
101
- return `translate3d(-50%, -50%, ${z}px)`;
102
- case "back":
103
- return `translate3d(-50%, -50%, ${-z}px) rotateY(180deg)`;
104
- case "left":
105
- return `translate3d(-50%, -50%, 0) rotateY(-90deg) translateZ(${w / 2}px)`;
106
- case "right":
107
- return `translate3d(-50%, -50%, 0) rotateY(90deg) translateZ(${w / 2}px)`;
108
- case "top":
109
- return `translate3d(-50%, -50%, 0) rotateX(90deg) translateZ(${h / 2}px)`;
110
- case "bottom":
111
- return `translate3d(-50%, -50%, 0) rotateX(-90deg) translateZ(${h / 2}px)`;
112
- // legacy/extra – position near top/bottom, front/back edges
113
- case "top_front":
114
- return `translate3d(-50%, -50%, ${z / 2}px) rotateX(75deg)`;
115
- case "top_rear":
116
- return `translate3d(-50%, -50%, ${-z / 2}px) rotateX(105deg)`;
117
- case "bottom_front":
118
- return `translate3d(-50%, -50%, ${z / 2}px) rotateX(-75deg)`;
119
- case "bottom_rear":
120
- return `translate3d(-50%, -50%, ${-z / 2}px) rotateX(-105deg)`;
121
- default:
122
- return `translate3d(-50%, -50%, ${z}px)`;
123
- }
124
- }
125
- function mergeStyles(inlineCSS, style) {
126
- const out = { ...style ?? {} };
127
- if (inlineCSS) {
128
- inlineCSS.split(";").map((s) => s.trim()).filter(Boolean).forEach((rule) => {
129
- const [k, v] = rule.split(":");
130
- if (!k || !v) return;
131
- const key = k.trim().replace(/-([a-z])/g, (_, c) => c.toUpperCase());
132
- out[key] = v.trim();
133
- });
134
- }
135
- return out;
136
- }
137
- function Face({
138
- w,
139
- h,
140
- d,
141
- face,
142
- global
143
- }) {
144
- const base = (0, import_react.useMemo)(
145
- () => mergeStyles(global?.css, global?.style),
146
- [global]
147
- );
148
- const merged = (0, import_react.useMemo)(
149
- () => ({ ...base, ...mergeStyles(face.css, face.style) }),
150
- [base, face.css, face.style]
151
- );
152
- const content = face.body ?? global?.body ?? null;
153
- return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
154
- "div",
155
- {
156
- className: `anim3d-face ${face.className ?? ""}`,
157
- style: {
158
- transform: faceTransform(face.name, w, h, d),
159
- ...merged
160
- },
161
- "data-face": face.name,
162
- children: typeof content === "string" ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children: content }) : content
163
- }
164
- );
165
- }
166
- var Obj = ({
167
- width = 160,
168
- height = 160,
169
- depth = 150,
170
- perspective = 500,
171
- perspectiveOrigin = "50% 50%",
172
- faces = [
173
- { name: "front", body: "FRONT" },
174
- { name: "back", body: "BACK" },
175
- { name: "left", body: "LEFT" },
176
- { name: "right", body: "RIGHT" },
177
- { name: "top", body: "TOP" },
178
- { name: "bottom", body: "BOTTOM" }
179
- ],
180
- global,
181
- anim1,
182
- anim2,
183
- showCenterDiv = false,
184
- className,
185
- style
186
- }) => {
187
- const resolvedAnim1 = toAnimationShorthand(anim1);
188
- const resolvedAnim2 = toAnimationShorthand(anim2);
189
- const animation = [resolvedAnim1, resolvedAnim2].filter(Boolean).join(", ");
190
- const stageStyle = {
191
- perspective: `${perspective}px`,
192
- perspectiveOrigin
193
- };
194
- const wrapperStyle = {
195
- // consumed by CSS var
196
- // eslint-disable-next-line @typescript-eslint/ban-ts-comment
197
- // @ts-ignore
198
- "--obj-w": `${width}px`,
199
- "--obj-h": `${height}px`,
200
- width,
201
- height,
202
- "animation": animation || void 0
203
- };
204
- return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
205
- "div",
206
- {
207
- className: `anim3d-stage ${className ?? ""}`,
208
- style: { ...stageStyle, ...style },
209
- children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "anim3d-wrapper", style: wrapperStyle, children: [
210
- showCenterDiv && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "anim3d-center" }),
211
- faces.map((f, i) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
212
- Face,
213
- {
214
- w: width,
215
- h: height,
216
- d: depth,
217
- face: f,
218
- global
219
- },
220
- `${f.name}-${i}`
221
- ))
222
- ] })
223
- }
224
- );
225
- };
226
- var Obj_default = Obj;
227
- // Annotate the CommonJS export names for ESM import in node:
228
- 0 && (module.exports = {
229
- Obj
230
- });
231
- //# sourceMappingURL=Obj.js.map
@@ -1 +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":[]}