@elucim/core 0.1.3 → 0.2.1

package/README.md

@@ -20,19 +20,24 @@ pnpm add @elucim/core
 ## Quick Start
 
 ```tsx
-import { Player, FadeIn, Circle, Text } from '@elucim/core';
+import { Player, FadeIn, Circle, Text, Group, Transform } from '@elucim/core';
 
 function MyAnimation() {
   return (
     <Player width={800} height={600} fps={30} durationInFrames={90} autoPlay loop>
-      <FadeIn duration={20}>
-        <Circle cx={400} cy={280} r={80} stroke="#6c5ce7" strokeWidth={3} fill="none" />
-      </FadeIn>
-      <FadeIn duration={20}>
-        <Text x={400} y={290} fill="#e0e0e0" fontSize={24} textAnchor="middle">
-          Hello Elucim
-        </Text>
-      </FadeIn>
+      <Group translate={[400, 280]}>
+        <Transform rotate={{ from: 0, to: 360 }} duration={90}>
+          <FadeIn duration={20}>
+            <Circle cx={0} cy={0} r={80} stroke="#6c5ce7" strokeWidth={3} fill="none" />
+            <Circle cx={60} cy={0} r={12} fill="#6c5ce7" />
+          </FadeIn>
+        </Transform>
+        <FadeIn duration={20}>
+          <Text x={0} y={10} fill="#e0e0e0" fontSize={24} textAnchor="middle">
+            Hello Elucim
+          </Text>
+        </FadeIn>
+      </Group>
     </Player>
   );
 }
@@ -58,6 +63,22 @@ function MyAnimation() {
 | `Arrow` | Line with arrowhead |
 | `Polygon` | Arbitrary polygon from point arrays |
 | `Text` | SVG text element |
+| `Image` | Embed images (PNG, JPEG, SVG, WebP, GIF) with `borderRadius`, `clipShape`, and transform support |
+| `Group` | Composable container that applies shared transforms, animations, and z-index sorting to children |
+
+### 🔄 Transforms & Composition
+
+All primitives support universal spatial transform props:
+
+| Prop | Description |
+|------|-------------|
+| `rotation` | Rotate element (degrees) |
+| `rotationOrigin` | `[cx, cy]` center of rotation |
+| `scale` | Uniform scale factor |
+| `translate` | `[dx, dy]` offset |
+| `zIndex` | Stacking order (higher renders on top) |
+
+These compose with animations — use static `rotation={45}` for a fixed rotation, or wrap in `<Transform rotate={{from:0, to:360}}>` for animated rotation.
 
 ### 📊 Math Visualizations
 

package/dist/__tests__/group.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=group.test.d.ts.map

package/dist/__tests__/group.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/group.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/image.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=image.test.d.ts.map

package/dist/__tests__/image.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/image.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/transform.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transform.test.d.ts.map

package/dist/__tests__/transform.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/transform.test.ts"],"names":[],"mappings":""}

package/dist/components/Scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Scene.d.ts","sourceRoot":"","sources":["../../src/components/Scene.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAIxE,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,EACpB,KAAY,EACZ,MAAa,EACb,GAAQ,EACR,gBAAgB,EAChB,UAA2C,EAC3C,QAAQ,EACR,QAAgB,EAChB,KAAK,EAAE,eAAe,EACtB,SAAS,EACT,KAAK,GACN,EAAE,UAAU,2CAgFZ"}
+{"version":3,"file":"Scene.d.ts","sourceRoot":"","sources":["../../src/components/Scene.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAKxE,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,EACpB,KAAY,EACZ,MAAa,EACb,GAAQ,EACR,gBAAgB,EAChB,UAA2C,EAC3C,QAAQ,EACR,QAAgB,EAChB,KAAK,EAAE,eAAe,EACtB,SAAS,EACT,KAAK,GACN,EAAE,UAAU,2CAgFZ"}

package/dist/index.d.ts

@@ -19,7 +19,10 @@ export { Matrix, type MatrixProps } from './primitives/Matrix';
 export { Graph, type GraphProps, type GraphNode, type GraphEdge } from './primitives/Graph';
 export { LaTeX, type LaTeXProps } from './primitives/LaTeX';
 export { BarChart, type BarChartProps, type BarDef } from './primitives/BarChart';
+export { Image, type ImageProps } from './primitives/Image';
+export { Group, type GroupProps } from './primitives/Group';
 export { useAnimation, type AnimationProps } from './primitives/animation';
+export { buildTransform, withTransform, sortByZIndex, type SpatialProps, type BaseElementProps } from './primitives/transform';
 export { type EasingFunction, linear, easeInQuad, easeOutQuad, easeInOutQuad, easeInCubic, easeOutCubic, easeInOutCubic, easeInQuart, easeOutQuart, easeInOutQuart, easeInSine, easeOutSine, easeInOutSine, easeInExpo, easeOutExpo, easeInOutExpo, easeInBack, easeOutBack, easeOutElastic, easeOutBounce, spring, cubicBezier, } from './easing';
 export { FadeIn, type FadeInProps, FadeOut, type FadeOutProps } from './animations/Fade';
 export { Draw, type DrawProps, Write, type WriteProps } from './animations/DrawWrite';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}