@xpert-ai/plugin-motion 0.1.0

package/assets/upstream/recipes/web/toggle-spring/recipe.motion.yaml

@@ -0,0 +1,58 @@
+spec_version: 1
+id: toggle-spring
+name: Toggle Spring
+description: A switch whose knob springs across on toggle — a tactile, satisfying state change.
+
+# legacy aliases (kept for CLI / back-compat)
+surfaces: [web, interaction]
+category: feedback-delight
+tech: [css, js]
+
+# 五维分类（建库标准）
+canvas:  [web, app]
+target:  [button]
+intent:  feedback-delight
+runtime: [css, js]
+export:  [skill, motion-json, html]
+
+dependencies: []
+tags: [toggle, switch, spring, feedback, micro-interaction, state]
+
+intent_keywords:
+  - toggle switch
+  - springy switch
+  - satisfying toggle
+  - 开关动效
+  - 弹簧切换
+best_for:
+  - On/off switches in settings and forms
+  - Any binary state the user flips themselves
+avoid_when:
+  - Conveying loading/progress (use a spinner/skeleton, not a toggle)
+  - Overshoot so strong it feels gimmicky — keep the spring subtle
+restraint:
+  max_per_view: 6
+  notes: Many switches can coexist (settings lists). Trigger on user intent only; keep the spring gentle.
+
+motion:
+  duration_ms: 420
+  easing: spring
+  reduced_motion: shorten
+  gpu_safe: true
+
+entry: preview.html
+implementations:
+  - tech: css+js
+    files: [toggle-spring.css, toggle-spring.js]
+    usage: |
+      Markup a switch as <button class="ms-toggle" data-toggle><span class="knob"></span></button>.
+      Clicking flips .on; the knob springs across. reduced-motion shortens to a quick linear slide.
+
+license:
+  spdx: Apache-2.0
+  upstream: null
+  attribution_required: false
+author:
+  name: nexu.io
+  url: "https://github.com/nexu-io"
+version: 0.1.0

package/assets/upstream/recipes/web/toggle-spring/toggle-spring.css

@@ -0,0 +1,32 @@
+/* toggle-spring.css — motion-anything recipe · category: feedback-delight · target: button
+ * A switch whose knob springs across on toggle. Transform only (GPU-safe).
+ * reduced-motion: quick linear slide, no overshoot. */
+
+.ms-toggle {
+  display: inline-flex;
+  align-items: center;
+  width: 52px;
+  height: 30px;
+  border-radius: 999px;
+  background: #d8d6cf;
+  border: 0;
+  padding: 3px;
+  cursor: pointer;
+  transition: background 0.25s cubic-bezier(0.16, 1, 0.3, 1);
+}
+.ms-toggle .knob {
+  width: 24px;
+  height: 24px;
+  border-radius: 50%;
+  background: #fff;
+  box-shadow: 0 1px 4px rgba(0, 0, 0, 0.2);
+  transform: translateX(0);
+  transition: transform 0.42s cubic-bezier(0.34, 1.56, 0.64, 1); /* spring overshoot */
+  will-change: transform;
+}
+.ms-toggle.on { background: #8b7cf6; }
+.ms-toggle.on .knob { transform: translateX(22px); }
+
+@media (prefers-reduced-motion: reduce) {
+  .ms-toggle .knob { transition: transform 0.15s linear; }
+}

package/assets/upstream/recipes/web/toggle-spring/toggle-spring.js

@@ -0,0 +1,20 @@
+/* toggle-spring.js — motion-anything recipe · category: feedback-delight
+ *
+ * Click any [data-toggle] to flip its .on state; the knob springs across (CSS handles the spring).
+ * Reflects state via aria-pressed for accessibility.
+ *
+ * Usage:  <button class="ms-toggle" data-toggle aria-pressed="false"><span class="knob"></span></button>
+ */
+(function () {
+  'use strict';
+  function init() {
+    document.querySelectorAll('[data-toggle]').forEach(function (btn) {
+      btn.addEventListener('click', function () {
+        var on = btn.classList.toggle('on');
+        btn.setAttribute('aria-pressed', on ? 'true' : 'false');
+      });
+    });
+  }
+  if (document.readyState !== 'loading') init();
+  else document.addEventListener('DOMContentLoaded', init);
+})();

package/assets/upstream/recipes/web/true-focus/SKILL.md

@@ -0,0 +1,11 @@
+---
+name: true-focus
+description: |
+  Words sit softly blurred; one snaps into focus at a time — leads the eye across a short phrase. One per view; short phrases. Under prefers-reduced-motion all words stay sharp.
+triggers: ["true focus","blur focus text","聚焦文字","逐词聚焦"]
+od: { mode: prototype, surface: web, platform: desktop, category: animation-motion, preview: { type: html }, design_system: { requires: false } }
+---
+# true-focus
+Words blur except the focused one. Dependency-free, reduced-motion safe.
+## How to apply
+Copy css+js; add class `tf` to a heading. Auto-splits by word.

package/assets/upstream/recipes/web/true-focus/preview.html

@@ -0,0 +1,3 @@
+<!doctype html><html lang="en"><head><meta charset="utf-8"/><meta name="viewport" content="width=device-width,initial-scale=1"/><title>true-focus · recipe</title><link rel="stylesheet" href="true-focus.css"/>
+<style>:root{color-scheme:dark}body{margin:0;min-height:100vh;display:grid;place-items:center;gap:20px;text-align:center;font-family:ui-sans-serif,system-ui,sans-serif;background:radial-gradient(120% 120% at 50% 0%,#1b1c24,#0b0b12);color:#e7e8ee}.badge{font-size:12px;letter-spacing:.1em;text-transform:uppercase;color:#8b7cf6}.hint{font-size:13px;color:#7c7f8c;max-width:360px}h1{margin:0}</style></head>
+<body><div class="badge">motion-anything · text-kinetic</div><h1 class="tf" style="font-size:38px;font-weight:800">design with real intent</h1><p class="hint">Dependency-free · respects prefers-reduced-motion.</p><script src="true-focus.js"></script></body></html>

package/assets/upstream/recipes/web/true-focus/recipe.motion.yaml

@@ -0,0 +1,25 @@
+spec_version: 1
+id: true-focus
+name: True Focus
+description: Words sit softly blurred; one snaps into focus at a time — draws the eye across a phrase.
+surfaces: [web, interaction]
+canvas: [web]
+target: [text]
+intent: text-kinetic
+runtime: [css,js]
+export: [skill, motion-json, html]
+category: text-kinetic
+tech: [css,js]
+dependencies: []
+tags: [focus,blur,text,attention,cycle]
+intent_keywords: [true focus, blur focus text, 聚焦文字, 逐词聚焦]
+best_for: ["A short phrase you want read word-by-word"]
+avoid_when: ["Long text; when everything must be sharp"]
+restraint: { max_per_view: 1, notes: "Use sparingly; tasteful. Plain/static under reduced-motion." }
+motion: { duration_ms: 600, easing: ease-out, reduced_motion: graceful, gpu_safe: true }
+entry: preview.html
+implementations:
+  - { tech: css,js, files: [true-focus.css,true-focus.js], usage: "See preview.html; add the class." }
+license: { spdx: Apache-2.0, upstream: null, attribution_required: false }
+author: { name: nexu.io, url: "https://github.com/nexu-io" }
+version: 0.1.0

package/assets/upstream/recipes/web/true-focus/true-focus.css

@@ -0,0 +1,5 @@
+/* true-focus.css — text-kinetic · words blurred except the focused one. filter only. */
+.tf { display:inline-flex; gap:.4em; flex-wrap:wrap; }
+.tf > .tf-w { filter: blur(5px); opacity:.6; transition: filter .5s ease, opacity .5s ease; }
+.tf > .tf-w.on { filter: blur(0); opacity:1; }
+@media (prefers-reduced-motion: reduce){ .tf > .tf-w{ filter:none; opacity:1 } }

package/assets/upstream/recipes/web/true-focus/true-focus.js

@@ -0,0 +1,10 @@
+/* true-focus.js — text-kinetic · cycles focus across words. Reduced-motion → all sharp, no cycling. */
+(function(g){ 'use strict';
+  function red(){ return g.matchMedia && g.matchMedia('(prefers-reduced-motion: reduce)').matches; }
+  function attach(el){ if(el.__tf) return; el.__tf=1; var words=(el.textContent).trim().split(/\s+/); el.textContent='';
+    var spans=words.map(function(w){ var s=document.createElement('span'); s.className='tf-w'; s.textContent=w; el.appendChild(s); return s; });
+    if(red()){ spans.forEach(function(s){ s.classList.add('on'); }); return; }
+    var i=0; spans[0].classList.add('on'); setInterval(function(){ spans[i].classList.remove('on'); i=(i+1)%spans.length; spans[i].classList.add('on'); }, 1100); }
+  function init(){ var els=document.querySelectorAll('.tf'); for(var i=0;i<els.length;i++) attach(els[i]); }
+  if(document.readyState!=='loading') init(); else document.addEventListener('DOMContentLoaded', init);
+})(window);

package/assets/upstream/recipes/web/waves/SKILL.md

@@ -0,0 +1,12 @@
+---
+name: waves
+description: |
+  A perlin-warped line field with a pointer wake — organic flowing lines. A marketing-grade hero backdrop. One per view; scrim behind text.
+  Renders a static frame under prefers-reduced-motion.
+triggers: ["waves","animated background","动态背景"]
+od: { mode: prototype, surface: web, platform: desktop, category: animation-motion, preview: { type: html }, design_system: { requires: false } }
+---
+# waves
+A perlin-warped line field with a pointer wake — organic flowing lines.
+## How to apply
+Copy `waves.js`; add `<div class="waves" style="position:absolute;inset:0"></div>` behind content.

package/assets/upstream/recipes/web/waves/preview.html

@@ -0,0 +1,3 @@
+<!doctype html><html lang="en"><head><meta charset="utf-8"/><meta name="viewport" content="width=device-width,initial-scale=1"/><title>waves · recipe</title>
+<style>:root{color-scheme:dark}html,body{margin:0;height:100vh;overflow:hidden;background:#f3efe6}.waves{position:absolute;inset:0}.cap{position:absolute;left:0;right:0;bottom:22px;text-align:center;font:12px ui-sans-serif,system-ui,sans-serif;letter-spacing:.1em;text-transform:uppercase;color:rgba(0,0,0,.45);z-index:2}</style></head>
+<body><div class="waves"></div><div class="cap">motion-anything · ambient · waves</div><script src="waves.js"></script></body></html>

package/assets/upstream/recipes/web/waves/recipe.motion.yaml

@@ -0,0 +1,25 @@
+spec_version: 1
+id: waves
+name: Waves
+description: A perlin-warped line field with a pointer wake — organic flowing lines.
+surfaces: [web, interaction]
+canvas: [web]
+target: [background, section]
+intent: ambient
+runtime: [js]
+export: [skill, motion-json, html]
+category: ambient
+tech: [js]
+dependencies: []
+tags: [background, hero, ambient, waves]
+intent_keywords: [waves, animated background, 动态背景]
+best_for: ["A full-bleed hero/section background"]
+avoid_when: ["Behind dense text without a scrim", "Multiple animated backgrounds at once"]
+restraint: { max_per_view: 1, notes: "One animated background per view; scrim behind text. Static frame under reduced-motion." }
+motion: { duration_ms: 0, easing: linear, reduced_motion: static, gpu_safe: true }
+entry: preview.html
+implementations:
+  - { tech: js, files: [waves.js], usage: "Copy the file(s); add a full-bleed <div class=\"waves\"></div>." }
+license: { spdx: Apache-2.0, upstream: null, attribution_required: false }
+author: { name: nexu.io, url: "https://github.com/nexu-io" }
+version: 0.1.0

package/assets/upstream/recipes/web/waves/waves.js

@@ -0,0 +1,126 @@
+/* waves.js — motion-anything recipe · ambient · faithful canvas 2D port (dependency-free).
+ * A field of vertical lines warped by 2D perlin noise; the pointer drags nearby points with a
+ * friction/tension spring wake. Direct port of the react-bits component (its perlin impl is
+ * self-contained). Real defaults from source; line color via data-line-color (default black —
+ * designed for light backgrounds). */
+(function(g){ 'use strict';
+  var DEF = { lineColor:'black', waveSpeedX:0.0125, waveSpeedY:0.005, waveAmpX:32, waveAmpY:16,
+    xGap:10, yGap:32, friction:0.925, tension:0.005, maxCursorMove:100 };
+  function reduced(){ return g.matchMedia && g.matchMedia('(prefers-reduced-motion: reduce)').matches; }
+  function Grad(x,y){ this.x=x; this.y=y; }
+  Grad.prototype.dot2 = function(x,y){ return this.x*x + this.y*y; };
+  function Noise(seed){
+    this.grad3 = [new Grad(1,1),new Grad(-1,1),new Grad(1,-1),new Grad(-1,-1),
+      new Grad(1,0),new Grad(-1,0),new Grad(1,0),new Grad(-1,0),
+      new Grad(0,1),new Grad(0,-1),new Grad(0,1),new Grad(0,-1)];
+    this.p = [151,160,137,91,90,15,131,13,201,95,96,53,194,233,7,225,140,36,103,30,69,142,8,99,37,240,
+      21,10,23,190,6,148,247,120,234,75,0,26,197,62,94,252,219,203,117,35,11,32,57,177,33,88,
+      237,149,56,87,174,20,125,136,171,168,68,175,74,165,71,134,139,48,27,166,77,146,158,231,83,
+      111,229,122,60,211,133,230,220,105,92,41,55,46,245,40,244,102,143,54,65,25,63,161,1,216,
+      80,73,209,76,132,187,208,89,18,169,200,196,135,130,116,188,159,86,164,100,109,198,173,186,
+      3,64,52,217,226,250,124,123,5,202,38,147,118,126,255,82,85,212,207,206,59,227,47,16,58,
+      17,182,189,28,42,223,183,170,213,119,248,152,2,44,154,163,70,221,153,101,155,167,43,172,9,
+      129,22,39,253,19,98,108,110,79,113,224,232,178,185,112,104,218,246,97,228,251,34,242,193,
+      238,210,144,12,191,179,162,241,81,51,145,235,249,14,239,107,49,192,214,31,181,199,106,157,
+      184,84,204,176,115,121,50,45,127,4,150,254,138,236,205,93,222,114,67,29,24,72,243,141,128,
+      195,78,66,215,61,156,180];
+    this.perm = new Array(512); this.gradP = new Array(512); this.seed(seed||0);
+  }
+  Noise.prototype.seed = function(seed){
+    if(seed > 0 && seed < 1) seed *= 65536;
+    seed = Math.floor(seed); if(seed < 256) seed |= seed << 8;
+    for(var i=0;i<256;i++){ var v = (i & 1) ? this.p[i] ^ (seed & 255) : this.p[i] ^ ((seed>>8) & 255);
+      this.perm[i] = this.perm[i+256] = v; this.gradP[i] = this.gradP[i+256] = this.grad3[v % 12]; }
+  };
+  Noise.prototype.fade = function(t){ return t*t*t*(t*(t*6-15)+10); };
+  Noise.prototype.lerp = function(a,b,t){ return (1-t)*a + t*b; };
+  Noise.prototype.perlin2 = function(x,y){
+    var X = Math.floor(x), Y = Math.floor(y); x -= X; y -= Y; X &= 255; Y &= 255;
+    var n00 = this.gradP[X + this.perm[Y]].dot2(x, y);
+    var n01 = this.gradP[X + this.perm[Y+1]].dot2(x, y-1);
+    var n10 = this.gradP[X+1 + this.perm[Y]].dot2(x-1, y);
+    var n11 = this.gradP[X+1 + this.perm[Y+1]].dot2(x-1, y-1);
+    var u = this.fade(x);
+    return this.lerp(this.lerp(n00, n10, u), this.lerp(n01, n11, u), this.fade(y));
+  };
+  function start(el){
+    if(el.__ma) return; el.__ma = 1;
+    var lineColor = el.getAttribute('data-line-color') || DEF.lineColor;
+    var canvas = document.createElement('canvas');
+    canvas.style.cssText = 'width:100%;height:100%;display:block';
+    el.appendChild(canvas);
+    var ctx = canvas.getContext('2d');
+    var noise = new Noise(Math.random());
+    var lines = [], W=0, H=0;
+    var mouse = { x:-10, y:0, lx:0, ly:0, sx:0, sy:0, v:0, vs:0, a:0, set:false };
+    function setSize(){ var r = el.getBoundingClientRect(); W = r.width; H = r.height;
+      canvas.width = W; canvas.height = H; }
+    function setLines(){
+      lines = [];
+      var oW = W + 200, oH = H + 30;
+      var totalLines = Math.ceil(oW / DEF.xGap), totalPoints = Math.ceil(oH / DEF.yGap);
+      var xStart = (W - DEF.xGap*totalLines)/2, yStart = (H - DEF.yGap*totalPoints)/2;
+      for(var i=0;i<=totalLines;i++){ var pts = [];
+        for(var j=0;j<=totalPoints;j++)
+          pts.push({ x:xStart + DEF.xGap*i, y:yStart + DEF.yGap*j, wx:0, wy:0, cx:0, cy:0, cvx:0, cvy:0 });
+        lines.push(pts);
+      }
+    }
+    function movePoints(time){
+      for(var i=0;i<lines.length;i++){ var pts = lines[i];
+        for(var j=0;j<pts.length;j++){ var p = pts[j];
+          var move = noise.perlin2((p.x + time*DEF.waveSpeedX)*0.002, (p.y + time*DEF.waveSpeedY)*0.0015)*12;
+          p.wx = Math.cos(move)*DEF.waveAmpX; p.wy = Math.sin(move)*DEF.waveAmpY;
+          var dx = p.x - mouse.sx, dy = p.y - mouse.sy;
+          var dist = Math.hypot(dx, dy), l = Math.max(175, mouse.vs);
+          if(dist < l){ var s = 1 - dist/l; var f = Math.cos(dist*0.001)*s;
+            p.cvx += Math.cos(mouse.a)*f*l*mouse.vs*0.00065;
+            p.cvy += Math.sin(mouse.a)*f*l*mouse.vs*0.00065; }
+          p.cvx += (0 - p.cx)*DEF.tension; p.cvy += (0 - p.cy)*DEF.tension;
+          p.cvx *= DEF.friction; p.cvy *= DEF.friction;
+          p.cx += p.cvx*2; p.cy += p.cvy*2;
+          p.cx = Math.min(DEF.maxCursorMove, Math.max(-DEF.maxCursorMove, p.cx));
+          p.cy = Math.min(DEF.maxCursorMove, Math.max(-DEF.maxCursorMove, p.cy));
+        }
+      }
+    }
+    function moved(p, withCursor){
+      var x = p.x + p.wx + (withCursor ? p.cx : 0), y = p.y + p.wy + (withCursor ? p.cy : 0);
+      return { x: Math.round(x*10)/10, y: Math.round(y*10)/10 };
+    }
+    function drawLines(){
+      ctx.clearRect(0, 0, W, H);
+      ctx.beginPath(); ctx.strokeStyle = lineColor;
+      for(var i=0;i<lines.length;i++){ var pts = lines[i];
+        var p1 = moved(pts[0], false); ctx.moveTo(p1.x, p1.y);
+        for(var j=0;j<pts.length;j++){ var isLast = j === pts.length-1;
+          p1 = moved(pts[j], !isLast);
+          var p2 = moved(pts[j+1] || pts[pts.length-1], !isLast);
+          ctx.lineTo(p1.x, p1.y);
+          if(isLast) ctx.moveTo(p2.x, p2.y);
+        }
+      }
+      ctx.stroke();
+    }
+    function updateMouse(x, y){ var r = el.getBoundingClientRect();
+      mouse.x = x - r.left; mouse.y = y - r.top;
+      if(!mouse.set){ mouse.sx = mouse.x; mouse.sy = mouse.y; mouse.lx = mouse.x; mouse.ly = mouse.y; mouse.set = true; } }
+    el.addEventListener('mousemove', function(e){ updateMouse(e.clientX, e.clientY); }, { passive:true });
+    el.addEventListener('touchmove', function(e){ var t = e.touches[0]; updateMouse(t.clientX, t.clientY); }, { passive:true });
+    g.addEventListener('resize', function(){ setSize(); setLines(); });
+    setSize(); setLines();
+    var red = reduced();
+    function tick(t){
+      mouse.sx += (mouse.x - mouse.sx)*0.1; mouse.sy += (mouse.y - mouse.sy)*0.1;
+      var d = Math.hypot(mouse.x - mouse.lx, mouse.y - mouse.ly);
+      mouse.vs += (d - mouse.vs)*0.1; mouse.vs = Math.min(100, mouse.vs);
+      mouse.a = Math.atan2(mouse.y - mouse.ly, mouse.x - mouse.lx);
+      mouse.lx = mouse.x; mouse.ly = mouse.y;
+      movePoints(t); drawLines();
+      if(!red) requestAnimationFrame(tick);
+    }
+    requestAnimationFrame(tick);
+  }
+  function init(){ var els=document.querySelectorAll('.waves'); for(var i=0;i<els.length;i++) start(els[i]); }
+  if(document.readyState!=='loading') init(); else document.addEventListener('DOMContentLoaded', init);
+})(window);

package/dist/assets/upstream/ATTRIBUTION.md

@@ -0,0 +1,42 @@
+# ATTRIBUTION.md — third-party sources & credits
+
+motion-anything is Apache-2.0 (see [LICENSE](LICENSE)). Portions of the library and tooling
+build on the work of others. This file records every external source, its license, and how
+it is used. If you believe something is misattributed, please open an issue.
+
+## Motion effects
+
+- **react-bits** (<https://reactbits.dev>) — 35 recipes in `recipes/web/` are faithful,
+  dependency-free ports of react-bits effects (original GLSL shaders and effect logic,
+  re-hosted on our zero-dependency runners; the React wrappers are fully rewritten).
+  The source components are vendored under `recipes/imported/` for reference and future ports.
+  **Used and redistributed with the author's permission.** The remaining `rb-*` entries in the
+  library are reference cards that link back to reactbits.dev.
+- **Open Design** (<https://github.com/nexu-io/open-design>, Apache-2.0) — sibling project in
+  the nexu.io family. Shared here: agent engine icons (`app/agent-icons/`), design-system
+  brand packs, video/HTML template collections, and the ACP runtime integration patterns
+  (`docs/new-agent-runtime-acp.md`, `apps/daemon/src/acp.ts`).
+
+## Vendored libraries (in `app/video/vendor/`)
+
+- **mp4-muxer** — MIT. In-browser MP4 muxing for the WebCodecs export pipeline.
+- **gifenc** © Matt DesLauriers — MIT. GIF encoding for the animated-GIF export.
+
+## Bundled skills (in `skills/`)
+
+- **web-clone** — MIT, vendored with LICENSE + ATTRIBUTION in its folder.
+- **gsap skill** — GreenSock, MIT-licensed skill content, vendored with LICENSE in its folder.
+- Other companion skills (text-to-lottie, web-shader-extractor, Web-to-Design-md, Toolcraft)
+  are **not** vendored — the router defers to them if the user installs them; see
+  [INTEGRATIONS.md](INTEGRATIONS.md).
+
+## Reference cards
+
+Library entries marked `ref` (with a "Get from …" link) are pointers to upstream libraries and
+demos (GSAP, Motion.dev, Anime.js, LottieFiles, Rive, ShaderGradient, three.js ecosystem, …).
+They embed no upstream code — each card links to the original source and license.
+
+## Icons & fonts
+
+- **reicon** icon set — bundled per its upstream license (see `app/data/` provenance notes).
+- System font stacks only; no bundled fonts.

package/dist/assets/upstream/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative
+          Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 nexu.io
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.