@elucim/core 0.2.0 → 0.3.0

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__/bezierCurve.test.d.ts

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

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

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

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export { Presentation, type PresentationProps, Slide, type SlideProps, usePresen
 export { useCurrentFrame } from './hooks/useCurrentFrame';
 export { interpolate, type InterpolateOptions } from './hooks/interpolate';
 export { useElucimContext, type ElucimContextValue } from './context';
+export { BezierCurve, type BezierCurveProps } from './primitives/BezierCurve';
 export { Circle, type CircleProps } from './primitives/Circle';
 export { Line, type LineProps } from './primitives/Line';
 export { Arrow, type ArrowProps } from './primitives/Arrow';

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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"}