@dnyantra/dtly 0.0.0-stage → 0.2.0

package/dist/studio-app/index.html

@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>DT.ly Studio</title>
+    <link rel="icon" href="data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 32 32%22%3E%3Crect width=%2232%22 height=%2232%22 rx=%227%22 fill=%22%23e8692a%22/%3E%3Cpath d=%22M11 9l13 7-13 7z%22 fill=%22white%22/%3E%3C/svg%3E" />
+    <link rel="stylesheet" href="/app/app.css" />
+    <script>window.DTLY = __DTLY_CONFIG__;</script>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/app/app.js"></script>
+  </body>
+</html>

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION = "0.2.0";
+export declare const BRAND = "DT.ly \u2014 from the creator of CustomerPro.in";

package/dist/version.js

@@ -0,0 +1,3 @@
+export const VERSION = '0.2.0';
+export const BRAND = 'DT.ly — from the creator of CustomerPro.in';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAC/B,MAAM,CAAC,MAAM,KAAK,GAAG,4CAA4C,CAAC"}

package/fonts/OFL-Baloo2.txt

@@ -0,0 +1,93 @@
+Copyright 2019 The Baloo 2 Project Authors (https://github.com/EkType/Baloo2)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/fonts/OFL-Mukta.txt

@@ -0,0 +1,93 @@
+Copyright (c) 2014, Girish Dalvi, Ek Type. All rights reserved.
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/package.json

@@ -1,6 +1,86 @@
 {
   "name": "@dnyantra/dtly",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "DT.ly — After Effects-style motion graphics as JSON, rendered to MP4, with an MCP server for AI agents. From the creator of CustomerPro.in.",
+  "keywords": [
+    "motion-graphics",
+    "video",
+    "after-effects",
+    "kinetic-typography",
+    "animation",
+    "mcp",
+    "ffmpeg",
+    "canvas",
+    "devanagari",
+    "claude"
+  ],
+  "homepage": "https://github.com/dnyantra/dtly#readme",
+  "bugs": {
+    "url": "https://github.com/dnyantra/dtly/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dnyantra/dtly.git"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "From the creator of CustomerPro.in",
+    "url": "https://customerpro.in"
+  },
+  "type": "module",
+  "bin": {
+    "dtly": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "default": "./dist/node.js"
+    },
+    "./mcp": {
+      "types": "./dist/mcp/index.d.ts",
+      "default": "./dist/mcp/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "fonts",
+    "plugin/skills",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && chmod +x dist/cli.js && node scripts/build-studio.mjs",
+    "prepare": "npm run build",
+    "typecheck": "tsc -p . && tsc -p tsconfig.app.json",
+    "dev": "tsx src/cli.ts",
+    "mcp": "tsx src/cli.ts mcp",
+    "test": "npm run typecheck && tsx test/smoke.ts",
+    "prepublishOnly": "npm test && npm run build",
+    "test:studio": "tsx test/studio.e2e.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.32.1",
+    "skia-canvas": "^4.0.0",
+    "zod": "^4.6.7"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.5",
+    "esbuild": "^0.28.2",
+    "preact": "^11.0.2",
+    "puppeteer-core": "^24.43.1",
+    "tsx": "^4.23.15",
+    "typescript": "^7.0.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/plugin/skills/dtly/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: dtly
+description: Make motion graphics and videos with DT.ly — After Effects-style compositions, layers, keyframes, text animators, kinetic typography, openers, slideshows and transitions — through the dtly MCP tools. Use when asked to create or edit a promo, ad, reel, opener, title sequence, lyric/kinetic text video, slideshow or lower third, or to change timing, easing or animation of an existing DT.ly project.
+---
+
+# DT.ly motion design
+
+DT.ly is a layer-and-keyframe motion engine, modelled on After Effects. A project is a JSON
+file; you edit it only through the `dtly` MCP tools, then look at rendered frames to check it.
+
+## Workflow
+
+1. **Plan the beats first.** Write a shot list with times before touching tools: what is on
+   screen, for how long, and what moves. Reading time ≈ 0.4 s per word + 0.5 s, minimum 0.8 s.
+2. `project_create` (default 1080x1920, 30 fps). Scenes that are edited as a unit → `comp_add`
+   and drop them in as `precomp` layers.
+3. Build bottom-up: background (video/image/solid) → graphics → text → audio.
+   `layer_add` uses index 0 = top, so add the background with a high `index` or first.
+4. Reach for presets (`preset_list`) for anything standard, then refine with
+   `keyframe_set` / `keyframe_ease` / `layer_update`.
+5. **Always look.** `render_sheet` across the key moments (entrances mid-way, holds, exits),
+   fix, look again. `render_frame` at scale 0.4 for detail. `project_validate` before export.
+6. `render_video` only when the sheet looks right.
+
+**Working with a human:** call `studio_open` early so they can watch the project in DT.ly Studio
+(browser preview + timeline). Your edits appear there live, and they can drag keyframes, trim layers
+or retype text themselves — those edits save to the same file, so call `project_describe` again
+before your next change whenever they say they adjusted something.
+
+## The model (AE vocabulary)
+
+| After Effects | DT.ly |
+|---|---|
+| Composition / precomp | `comps[]`, layer `type: "precomp"` |
+| Layer in/out point | `inPoint` / `outPoint` (comp seconds) |
+| Transform | `transform.anchor/position/scale(%)/rotation(°)/opacity(%)/skew` |
+| Stopwatch keyframes | any property as `{keyframes:[{t,v,ease}]}`; `ease` shapes the segment *leaving* that key |
+| Easy Ease / graph editor | `easyEase`, `easeIn`, `easeOut`, `cubicOut`, `expoIn/Out/InOut`, `backOut`, bezier `[x1,y1,x2,y2]`, `{spring:{stiffness,damping}}`, `hold` |
+| wiggle() | `{keyframes:[…], wiggle:{freq, amp, seed}}` |
+| Parenting / null | `parent: layerId`, `type: "null"` (transform only, not opacity) |
+| Masks | `masks: [{shape: rect|ellipse|path, rect:[x,y,w,h] (animatable), inverted}]` in layer space |
+| Track matte | `matte: {layer, mode: alpha|alphaInverted}`; the matte layer is not drawn on its own |
+| Trim Paths | shape `trim: {start, end}` in % — draw-on lines, rings, underlines |
+| Text Animator + range selector | `animators: [{unit: grapheme|word|line, stagger, duration, delay, order, ease, from:{opacity,x,y,scale,rotation,blur,tracking,color}, clip, mode:"out"}]` |
+| Effects | `effects: blur, dropShadow, glow, fill, brightness, saturate, contrast` |
+| Motion blur switch | `motionBlur: {samples, shutter}` |
+| Blending modes | `blendMode: multiply|screen|overlay|add|…` |
+
+Layer-space origins: solids/images/videos/precomps use their top-left with the anchor at the
+centre by default; shapes are centred on the origin; text is anchored at its alignment point,
+vertically centred on the block. Position defaults to comp centre.
+
+## Motion design rules of thumb
+
+- **Ease everything.** Entrances: `cubicOut`/`expoOut` (fast in, gentle settle). Exits: `easeIn`/`expoIn`.
+  Moves between two rests: `easyEase` or `expoInOut`. Linear only for constant drift (Ken Burns, rotation loops).
+- **Timing.** UI-style moves 0.3–0.6 s; titles 0.6–1.2 s; nothing important shorter than 0.25 s.
+  Stagger: graphemes 0.02–0.05 s, words 0.06–0.15 s, lines 0.1–0.2 s.
+- **Overshoot sparingly** (`backOut`, springs): one bouncy element per beat, the rest calm.
+- **Overlap actions.** Start the next element before the previous one settles (≈ 30–50 % overlap); it reads as one gesture.
+- **Hierarchy.** One hero element per moment. Size contrast ≥ 1.6× between title and support text.
+- **Legibility.** Text on footage needs a plate (`box`), a `dropShadow`, or a darkened background
+  (`brightness` 40–60 %). Keep text inside the safe area: for 9:16 keep important content
+  between y ≈ 250 and y ≈ 1600 and x 60–1020 (UI covers the edges on Reels/Shorts).
+- **Hold.** Let finished text sit still long enough to read before the next thing moves.
+- **Kinetic typography.** Vary scale and colour for emphasis words; alternate entrance directions;
+  cut on the beat of the music (markers help: `comp_update` with `markers`).
+
+## Indian scripts (Devanagari, etc.)
+
+- Shaping is correct at any unit; per-grapheme animation keeps conjuncts (क्ष, श्र, र्ह) intact.
+- Prefer `word` units for Marathi/Hindi body text — readers parse whole words; keep `grapheme`
+  effects for short display words.
+- Avoid large `tracking` on Devanagari: it breaks the visual headline (शिरोरेखा) between letters.
+- Bundled fonts: `Baloo 2` (display, default) and `Mukta` (text). Register others in `project.fonts`.
+
+## Presets
+
+`preset_list` is the source of truth. Highlights:
+- `text.*` — fadeUp, popIn, slam, blurIn, maskedLines, cascade, trackingIn, centerOut, typewriter, colorSweep, exits (`fadeOutDown`, `blurOut`, `maskedLinesOut`).
+- `kinetic.sequence` — phrase-by-phrase kinetic typography with emphasis words.
+- `opener.logoReveal`, `opener.bars` — brand openers.
+- `slides.slideshow` — sliders from images/clips with Ken Burns, captions and transitions.
+- `transition.between` — push, crossfade, zoom, wipe, whip (motion-blurred), slideUp between two overlapping layers.
+- `element.lowerThird`, `element.highlightWord`.
+
+Presets only write ordinary layers and keyframes, so everything they make stays editable.
+
+## Checks before you call it done
+
+- `project_validate` returns no problems.
+- A `render_sheet` across the whole timeline shows nothing clipped, overlapping or unreadable,
+  and every entrance has finished before the viewer needs to read it.
+- Audio: music under voice ≈ 0.15–0.25 volume; fade the end (`fadeOut`) so it doesn't cut.