@pinepaper.studio/mcp-server 1.6.23 → 1.6.24

package/dist/tools/stick-vocabulary.js.map

@@ -1 +1 @@
-{"version":3,"file":"stick-vocabulary.js","sourceRoot":"","sources":["../../src/tools/stick-vocabulary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,2CAA2C;AAC3C,MAAM,CAAC,MAAM,WAAW,GAAsB,MAAM,CAAC,MAAM,CAAC;IAC1D,MAAM;IACN,QAAQ;IACR,OAAO;IACP,OAAO;IACP,KAAK;IACL,QAAQ;IACR,OAAO;IACP,MAAM;IACN,QAAQ;CACT,CAAC,CAAC;AAEH,oEAAoE;AACpE,MAAM,CAAC,MAAM,WAAW,GAAsB,MAAM,CAAC,MAAM,CAAC;IAC1D,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,MAAM;IACN,OAAO;IACP,KAAK;IACL,OAAO;IACP,OAAO;IACP,KAAK;IACL,OAAO;IACP,SAAS;IACT,SAAS;IACT,OAAO;IACP,OAAO;IACP,OAAO;IACP,QAAQ;IACR,OAAO;IACP,KAAK;IACL,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,KAAK;IACL,WAAW;CACZ,CAAC,CAAC;AAEH,gDAAgD;AAChD,MAAM,CAAC,MAAM,eAAe,GAAsB,MAAM,CAAC,MAAM,CAAC;IAC9D,OAAO;IACP,OAAO;IACP,QAAQ;IACR,WAAW;IACX,SAAS;IACT,UAAU;IACV,OAAO;IACP,cAAc;IACd,cAAc;IACd,QAAQ;IACR,UAAU;IACV,SAAS;IACT,SAAS;IACT,OAAO;CACR,CAAC,CAAC;AAEH,wEAAwE;AACxE,MAAM,CAAC,MAAM,iBAAiB,GAAsB,MAAM,CAAC,MAAM,CAAC;IAChE,SAAS;IACT,SAAS;IACT,OAAO;IACP,OAAO;IACP,MAAM;IACN,KAAK;IACL,WAAW;IACX,SAAS;IACT,SAAS;IACT,UAAU;IACV,UAAU;IACV,OAAO;IACP,OAAO;IACP,QAAQ;IACR,aAAa;IACb,SAAS;IACT,UAAU;CACX,CAAC,CAAC;AAEH,+CAA+C;AAC/C,MAAM,CAAC,MAAM,WAAW,GAAsB,MAAM,CAAC,MAAM,CAAC;IAC1D,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;CACP,CAAC,CAAC"}
+{"version":3,"file":"stick-vocabulary.js","sourceRoot":"","sources":["../../src/tools/stick-vocabulary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,4CAA4C;AAC5C,MAAM,CAAC,MAAM,WAAW,GAAsB,MAAM,CAAC,MAAM,CAAC;IAC1D,MAAM;IACN,QAAQ;IACR,OAAO;IACP,OAAO;IACP,KAAK;IACL,QAAQ;IACR,OAAO;IACP,OAAO;IACP,MAAM;IACN,QAAQ;CACT,CAAC,CAAC;AAEH,oEAAoE;AACpE,MAAM,CAAC,MAAM,WAAW,GAAsB,MAAM,CAAC,MAAM,CAAC;IAC1D,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,MAAM;IACN,OAAO;IACP,KAAK;IACL,OAAO;IACP,OAAO;IACP,KAAK;IACL,OAAO;IACP,SAAS;IACT,SAAS;IACT,OAAO;IACP,OAAO;IACP,OAAO;IACP,QAAQ;IACR,OAAO;IACP,KAAK;IACL,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,KAAK;IACL,WAAW;CACZ,CAAC,CAAC;AAEH,gDAAgD;AAChD,MAAM,CAAC,MAAM,eAAe,GAAsB,MAAM,CAAC,MAAM,CAAC;IAC9D,OAAO;IACP,OAAO;IACP,QAAQ;IACR,WAAW;IACX,SAAS;IACT,UAAU;IACV,OAAO;IACP,cAAc;IACd,cAAc;IACd,QAAQ;IACR,UAAU;IACV,SAAS;IACT,SAAS;IACT,OAAO;CACR,CAAC,CAAC;AAEH,wEAAwE;AACxE,MAAM,CAAC,MAAM,iBAAiB,GAAsB,MAAM,CAAC,MAAM,CAAC;IAChE,SAAS;IACT,SAAS;IACT,OAAO;IACP,OAAO;IACP,MAAM;IACN,KAAK;IACL,WAAW;IACX,SAAS;IACT,SAAS;IACT,UAAU;IACV,UAAU;IACV,OAAO;IACP,OAAO;IACP,QAAQ;IACR,aAAa;IACb,SAAS;IACT,UAAU;CACX,CAAC,CAAC;AAEH,+CAA+C;AAC/C,MAAM,CAAC,MAAM,WAAW,GAAsB,MAAM,CAAC,MAAM,CAAC;IAC1D,MAAM;IACN,KAAK;IACL,KAAK;IACL,QAAQ;IACR,SAAS;IACT,KAAK;IACL,MAAM;CACP,CAAC,CAAC"}

package/dist/tools/timeline.d.ts

@@ -0,0 +1,136 @@
+/**
+ * A TIMELINE OP: animation written the way an agent already knows it from GSAP, compiled onto the engine's own
+ * keyframe tracks.
+ *
+ * It is a JSON shape, never code: nothing here is evaluated. The compiler is pure (no studio, no I/O) and runs on the
+ * server before anything is sent, so a tween it cannot honour is refused by name with the reason, before the canvas is
+ * touched. What it produces is the same thing a keyframe_animate op produces: one track per item, written with
+ * app.addAnimation, so a timeline call is exported, saved and edited exactly as hand-written keys are.
+ *
+ *   { "type": "timeline", "defaults": { "ease": "power2.out" }, "tweens": [
+ *       { "to": "bar-*", "from": { "scaleY": 0 }, "vars": { "scaleY": 1 }, "duration": 0.8, "at": 0.5, "stagger": 0.15 },
+ *       { "to": "ring", "vars": { "rotation": 480 }, "duration": 8, "ease": "none", "at": 0 } ] }
+ *
+ * SEMANTICS (GSAP's, where the engine can carry them):
+ * - to + vars (end values), from (start values), both = fromTo. A value missing on one side is the value the item has
+ *   at the tween's start: the end of the previous tween on that property, else the item's rest value, read in the studio.
+ * - x and y are OFFSETS from where the item was created, as GSAP's x/y are offsets from layout (x: 0 is home).
+ * - at: absolute seconds, "<" / ">" (start / end of the previous tween, optionally "<0.2", ">-0.1"), "+=0.2" / "-=0.2"
+ *   (from the timeline's end), a label, or "label+=0.2". Omitted: the timeline's end. delay adds to it.
+ * - stagger: seconds between targets, or { each | amount, from: start | end | center | edges | index }.
+ * - repeat / yoyo / repeatDelay: a repeat that never ends on an item with nothing else is the engine's loop; anything
+ *   else is expanded into keys (repeat -1 up to the timeline's duration).
+ * - ease: GSAP names mapped onto the engine's easing table; a name with no equivalent is refused, never made linear.
+ * - Every compiled track is as long as the timeline (its end, or `duration`), so no key can outrun its clip.
+ *
+ * KNOWN GAPS (the engine cannot carry them, so they are refused rather than approximated): a scale pivot left or right
+ * of centre, a percentage x/y, stagger from "random" or a grid, eased parameters (back(3), elastic(1.2, 0.4)),
+ * elastic/bounce inOut, steps(), callbacks, and two tweens on one property that overlap in time.
+ */
+/** What the batch knows about the items it creates, in create order: "$N" is creates[N]. */
+export interface TimelineCreateInfo {
+    name?: string;
+    anchor?: string;
+}
+/** A value the studio fills in when the track is written: the item's rest value of `$rest`, plus offsets. */
+export interface RestValue {
+    $rest: string;
+    add?: number;
+    /**
+     * Baseline pivot: +1 bottom, -1 top, 'anchor' = the item's own anchor (bottom-* / top-*), read in the studio.
+     * y = rest + add + pivot * (h / 2) * (restScaleY - s), with s the scale at this key (or restScaleY + sAdd).
+     */
+    pivot?: 1 | -1 | 'anchor';
+    s?: number;
+    sAdd?: number;
+}
+export type KeyValue = number | string | number[] | RestValue;
+export interface CompiledKeyframe {
+    time: number;
+    properties: Record<string, KeyValue>;
+    easing: string;
+}
+export interface CompiledTrack {
+    /** "$N" (an item this batch creates) or the ref as given, resolved by the studio (id, then name). */
+    target: string;
+    /** What the caller wrote. */
+    ref: string;
+    keyframes: CompiledKeyframe[];
+    duration: number;
+    loop: boolean;
+}
+export interface TweenReceipt {
+    tween: number;
+    compiledTo: 'track';
+    targets: Array<{
+        ref: string;
+        item: string;
+        start: number;
+        end: number | 'forever';
+    }>;
+    start: number;
+    /** Seconds, or 'forever' for repeat -1. */
+    end: number | 'forever';
+    ease: {
+        asked: string;
+        engine: string;
+    };
+    properties: Array<{
+        asked: string;
+        engine: string;
+        from: string;
+        to: string;
+    }>;
+    converted: string[];
+    dropped: string[];
+}
+export interface TimelinePlan {
+    tracks: CompiledTrack[];
+    tweens: TweenReceipt[];
+    /** The clip every non-looping track is given: the timeline's end, or its declared duration. */
+    duration: number;
+    notes: string[];
+}
+export interface TimelineError {
+    path: string;
+    message: string;
+}
+export type TimelineResult = {
+    ok: true;
+    plan: TimelinePlan;
+} | {
+    ok: false;
+    errors: TimelineError[];
+};
+/** GSAP's own default, used when neither the tween nor the timeline's defaults name one. */
+export declare const GSAP_DEFAULT_EASE = "power1.out";
+/** The names this op accepts, for the refusal message. */
+export declare const GSAP_EASE_NAMES: readonly ["none", "linear", "power0", ...string[], "elastic.in", "elastic.out", "bounce.in", "bounce.out"];
+/** A GSAP ease name → the engine's, or the reason it has none. Also takes the engine's own names. */
+export declare function mapGsapEase(name: string): {
+    engine: string;
+} | {
+    error: string;
+};
+export declare function compileTimeline(op: Record<string, unknown>, ctx?: {
+    creates: TimelineCreateInfo[];
+}): TimelineResult;
+/** What the batch creates, in create order, for name resolution and anchors. */
+export declare function batchCreatesBefore(operations: ReadonlyArray<Record<string, unknown>>, index: number): TimelineCreateInfo[];
+/**
+ * Compile every timeline op in a batch. Errors come back with batch paths (operations[i].tweens[j]…). Also refused: a
+ * timeline track and a keyframe_animate op on the same item in one batch, or two timelines on one item — each writes
+ * the item's whole track, so one would silently replace the other.
+ */
+export declare function compileBatchTimelines(operations: ReadonlyArray<Record<string, unknown>>): {
+    plans: Map<number, TimelinePlan>;
+    errors: TimelineError[];
+};
+/**
+ * The body of a batch op (a function body that returns the op's result) that writes a compiled timeline: one
+ * app.addAnimation per item, the same call keyframe_animate makes. Values the compiler could not know (an item's rest
+ * position, rotation, opacity, colour) are read from the item here, from its rest state when it has one.
+ * `refExpr` turns a "$N" target into the batch's runtime reference.
+ */
+export declare function emitTimelineOpBody(plan: TimelinePlan, refExpr: (target: string) => string): string;
+//# sourceMappingURL=timeline.d.ts.map

package/dist/tools/timeline.d.ts.map

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