@coppsary/motionly 1.0.2 → 1.1.1

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.
Files changed (11) hide show
  1. package/README.md +28 -81
  2. package/bin/ffmpeg-export.js +263 -0
  3. package/bin/motionly.js +90 -27
  4. package/dist/assets/{main-CrcFUwRU.js → main-Bhr-QmYm.js} +2 -2
  5. package/dist/assets/main-Bhr-QmYm.js.map +1 -0
  6. package/dist/index.html +1 -1
  7. package/package.json +1 -1
  8. package/templates/motionly-skill/SKILL.md +23 -1
  9. package/templates/project/AGENTS.md +21 -1
  10. package/templates/project/README.md +10 -2
  11. package/dist/assets/main-CrcFUwRU.js.map +0 -1
package/dist/index.html CHANGED
@@ -5,7 +5,7 @@
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1" />
6
6
  <link rel="icon" href="/logo.svg" />
7
7
  <title>Motionly</title>
8
- <script type="module" crossorigin src="/assets/main-CrcFUwRU.js"></script>
8
+ <script type="module" crossorigin src="/assets/main-Bhr-QmYm.js"></script>
9
9
  <link rel="stylesheet" crossorigin href="/assets/main-BWhvHbtr.css">
10
10
  </head>
11
11
  <body>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@coppsary/motionly",
3
- "version": "1.0.2",
3
+ "version": "1.1.1",
4
4
  "license": "Apache-2.0",
5
5
  "type": "module",
6
6
  "bin": {
package/templates/motionly-skill/SKILL.md CHANGED
@@ -7,6 +7,28 @@ description: Create, edit, validate, and preview editable Motionly .motion anima
7
7
 
8
8
  Motionly is a visual motion-graphics editor. Its editable source is `project.motion`; normal users refine it in the editor rather than hand-writing it. Keep generated source readable and load it through Motionly's parser and renderer.
9
9
 
10
+ ## Deep reference library
11
+
12
+ This skill ships a full reference library beside this file at `references/`. This
13
+ SKILL.md is only the quick contract — **before any non-trivial `.motion` work,
14
+ open `references/llms.txt` and load the focused skills it lists**, then follow
15
+ `references/AGENTS.md` for routing by intent:
16
+
17
+ - `references/skills/motion-dsl/SKILL.md` — canvas, imports, elements, tracks, clips, audio, animations, keyframes, validation (load this first for any authoring or repair)
18
+ - `references/skills/svg/SKILL.md` — logos, icons, diagrams, vector artwork, drawSVG, fill/stroke, local zoom/pan
19
+ - `references/skills/animation/SKILL.md` and `references/skills/easing/SKILL.md` — choreography, presets, keyframes, timing
20
+ - `references/skills/camera/SKILL.md` — global camera vs. local artwork focus
21
+ - `references/skills/composition/SKILL.md` — hierarchy, spacing, color, brand, scene review
22
+ - `references/skills/typography/SKILL.md` — titles, captions, kinetic type, narration timing
23
+ - `references/skills/transitions/SKILL.md` — scene changes, wipes, crossfades, continuity
24
+ - `references/skills/timeline/SKILL.md` — tracks, clips, trim, retime, overlap, audio placement
25
+ - `references/skills/assets/SKILL.md` — PNG/JPEG, SVG, GIF, MP4, WebM, MOV, Lottie, codecs
26
+ - `references/skills/rendering/SKILL.md` — preview, scrub, export, inspection, limitations
27
+ - `references/skills/templates/SKILL.md` — product launch, logo reveal, diagram, social-stat storyboards
28
+
29
+ Load only the topics the current task needs. The library is authoritative when it
30
+ is more detailed than the summary below.
31
+
10
32
  ## Project and asset workflow
11
33
 
12
34
  - Read `AGENTS.md`, `project.motion`, and relevant files in `assets/` before editing.
@@ -99,7 +121,7 @@ Prefer `power3.out`. Useful text presets: `keynoteText`, `wordReveal`, `charReve
99
121
  From the project folder:
100
122
 
101
123
  ```bash
102
- npx motionly dev
124
+ npx @coppsary/motionly dev
103
125
  ```
104
126
 
105
127
  This loads `project.motion` and `assets/`, opens the editor, and saves changes back to `project.motion`. Verify the canvas size, FPS, exact duration, imports, readable holds, transitions, final frame, and save/reload behavior before finishing.
package/templates/project/AGENTS.md CHANGED
@@ -4,6 +4,26 @@ Keep Motionly simple and visual.
4
4
 
5
5
  Read the installed `motionly` skill before creating or substantially editing `project.motion`.
6
6
 
7
+ ## Agent Skill
8
+
9
+ Installing the skill placed it at `.<agent>/skills/motionly/SKILL.md` (Codex uses
10
+ `.agents/`, plus `.claude/`, `.gemini/`, `.opencode/`, or `.kiro/`). That file is the
11
+ quick contract; a full reference library sits beside it under `references/` (`llms.txt`
12
+ index plus focused skills: `motion-dsl`, `svg`, `animation`, `easing`, `camera`, `composition`,
13
+ `typography`, `transitions`, `timeline`, `assets`, `rendering`, `templates`).
14
+
15
+ Before writing or repairing `.motion` beyond a trivial edit:
16
+
17
+ 1. Read this file and `project.motion`.
18
+ 2. Open the skill `SKILL.md`, then `references/llms.txt`, and load
19
+ `references/skills/motion-dsl/SKILL.md` plus only the other reference skills the
20
+ task needs.
21
+ 3. Treat the reference library and Motionly's parser/renderer as authoritative over
22
+ the short summary below.
23
+
24
+ If the skill was not installed, run `npx @coppsary/motionly skills add` to add it (with its
25
+ reference library) for your agent.
26
+
7
27
  ## Product Rule
8
28
 
9
29
  Motionly is a motion graphics editor around `.motion`. The user edits visually; `.motion` is the saved source format underneath.
@@ -15,7 +35,7 @@ Do not make users hand-write `.motion` for normal animation creation.
15
35
  - `project.motion` is the editable animation source.
16
36
  - Keep local media in `assets/` and reference it by filename, such as `./assets/logo.svg`.
17
37
  - Preserve asset aspect ratios by setting only `width` or `height`.
18
- - Run `npx motionly dev` to load, validate, preview, and visually refine the project.
38
+ - Run `npx @coppsary/motionly dev` to load, validate, preview, and visually refine the project.
19
39
 
20
40
  ## `.motion` Syntax
21
41
 
package/templates/project/README.md CHANGED
@@ -5,7 +5,7 @@ This is a local Motionly project.
5
5
  Motionly starts the project automatically after `init`. To reopen it later:
6
6
 
7
7
  ```bash
8
- npx motionly dev
8
+ npx @coppsary/motionly dev
9
9
  ```
10
10
 
11
11
  Motionly opens `project.motion`, resolves media from `assets/` by filename, and saves visual edits back to the project file. Put images, SVG, video, and audio in `assets/`, then import them from `project.motion`, for example:
@@ -14,4 +14,12 @@ Motionly opens `project.motion`, resolves media from `assets/` by filename, and
14
14
  import "./assets/logo.svg" as logo
15
15
  ```
16
16
 
17
- The browser-only Motionly editor remains available with `npx motionly`.
17
+ The browser-only Motionly editor remains available with `npx @coppsary/motionly`.
18
+
19
+ ## Create with an agent
20
+
21
+ The installed skill is available as `/motionly`. Start your prompt with it so the agent loads the Motionly authoring workflow and references:
22
+
23
+ ```text
24
+ /motionly Inspect the assets in this project, storyboard the animation, and create or refine project.motion.
25
+ ```