spaday-collab 0.1.0__py3-none-any.whl

spaday_collab/__init__.py

@@ -0,0 +1,20 @@
+from pathlib import Path
+
+from spaday import ComponentPackage, Token
+
+from .components import SpadayPointers
+
+__version__ = "0.1.0"
+Pointers = SpadayPointers
+package = ComponentPackage(
+    name="collab",
+    assets_dir=Path(__file__).parent / "extension",
+    assets=(("css", "css/index.css"), ("js", "cdn/index.js")),
+    components=(SpadayPointers,),
+)
+TOKENS = {
+    "spa_collab_accent": Token("--spa-collab-accent", "default pointer color", fallback="--spa-accent"),
+    "spa_collab_label_text": Token("--spa-collab-label-text", "pointer label text", fallback="--spa-text"),
+    "spa_collab_z_index": Token("--spa-collab-z-index", "pointer overlay stacking order"),
+}
+__all__ = ["TOKENS", "Pointers", "SpadayPointers", "package"]

spaday_collab/components.cem.json

@@ -0,0 +1,35 @@
+{
+  "schemaVersion": "1.0.0",
+  "modules": [
+    {
+      "path": "src/ts/index.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "name": "Pointers",
+          "customElement": true,
+          "tagName": "spaday-pointers",
+          "summary": "Optional shared pointers and hover outlines.",
+          "attributes": [
+            {
+              "name": "peers",
+              "type": {
+                "text": "unknown"
+              },
+              "description": "Array of {peer, pointer: {target, x, y} | null, label?, color?}. Coordinates are normalized to a target. Labels are plain text."
+            }
+          ],
+          "events": [
+            {
+              "name": "pointer-change",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "detail.pointer is {target, x, y} or null. Emitted for local mouse/pen movement or withdrawal."
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

spaday_collab/components.py

@@ -0,0 +1,47 @@
+# Generated by spaday.cem from components.cem.json — do not edit by hand.
+from __future__ import annotations
+
+from typing import Any
+
+from spaday.catalog import ComponentSchema, PropertySchema
+from spaday.component import Child, Component
+
+__all__ = ["SpadayPointers"]
+
+
+class SpadayPointers(Component):
+    """Optional shared pointers and hover outlines."""
+
+    tag = "spaday-pointers"
+    schema = ComponentSchema(
+        tag="spaday-pointers",
+        class_name="SpadayPointers",
+        summary="Optional shared pointers and hover outlines.",
+        props=(
+            PropertySchema(
+                name="peers",
+                kind="json",
+                choices=(),
+                default=None,
+                description="Array of {peer, pointer: {target, x, y} | null, label?, color?}. Coordinates are normalized to a target. Labels are plain text.",
+            ),
+        ),
+        events=("pointer-change",),
+        slots=(),
+    )
+
+    def __init__(
+        self,
+        *children: Child,
+        key: str | None = None,
+        peers: Any = None,
+        **props: Any,
+    ) -> None:
+        super().__init__(
+            *children,
+            key=key,
+            props={
+                "peers": peers,
+            },
+            **props,
+        )

spaday_collab/example.py

@@ -0,0 +1,94 @@
+"""Shared pointers and a shared note over one managed transports connection."""
+
+import asyncio
+from contextlib import asynccontextmanager, suppress
+
+from pydantic import BaseModel
+from spaday import Awareness, SetField, Wire, element, event_value, field, obj
+from spaday.backends.starlette import PageSpec, build_site
+from starlette.applications import Starlette
+from starlette.routing import WebSocketRoute
+from transports import WRITE, Hub, autosync, ws_endpoint
+
+from spaday_collab import Pointers, package
+from spaday_collab.gallery import STYLE
+
+
+class Document(BaseModel):
+    note: str = "Edit this note from either browser."
+
+
+def page(user):
+    return element(
+        "main",
+        element("h1", "Shared pointers"),
+        element("nav", element("a", "Alice", href="/"), element("a", "Bob", href="/bob")),
+        element("p", f"Signed in as {user}. Open the other link in another browser to see their pointer."),
+        element("p", "Names and colors are example settings. Both users can edit; URL names are not authentication."),
+        element(
+            "label",
+            "Shared note",
+            element("textarea", **{"data-collab-target": "note", "aria-label": "Shared note"}).bind("value", "document.note", mode="two-way"),
+        ),
+        element("section", element("h2", "Review"), element("p", "Hover here to point out this section."), **{"data-collab-target": "review"}),
+        element("p", "Connected: ", element("output").bind("textContent", "document.connected")),
+        Pointers()
+        .bind("peers", "pointers")
+        .on(
+            "pointer-change",
+            SetField(
+                "activity",
+                obj(
+                    {
+                        "pointer": event_value("pointer"),
+                        "label": field("name"),
+                        "color": field("color"),
+                    }
+                ),
+            ),
+        ),
+    )
+
+
+def create_app(*, codec="json"):
+    hub = Hub(key=lambda connection: connection.query_params.get("user", "alice"))
+    model = hub.share(Document())
+    for user in ("alice", "bob"):
+        hub.subscribe(user, model, WRITE)
+
+    @asynccontextmanager
+    async def lifespan(_app):
+        task = asyncio.create_task(autosync(hub))
+        try:
+            yield
+        finally:
+            task.cancel()
+            with suppress(asyncio.CancelledError):
+                await task
+
+    pages = {
+        path: PageSpec(
+            lambda user=user: page(user),
+            packages=[package],
+            title="Shared pointers",
+            styles=[STYLE],
+            store={"name": user.title(), "color": color, "pointers": []},
+            scripts=["/components/collab/cdn/example.js"],
+            wire=Wire(
+                f"/ws?user={user}",
+                model=model,
+                namespace="document",
+                codec=codec,
+                reconnect=True,
+                awareness={"pointers": Awareness(local="activity", peers="remote_activity")},
+            ),
+        )
+        for path, user, color in (("/", "alice", "#f4a261"), ("/bob", "bob", "#90c2ff"))
+    }
+    return Starlette(routes=build_site(pages, routes=[WebSocketRoute("/ws", ws_endpoint(hub))]).all(), lifespan=lifespan)
+
+
+if __name__ == "__main__":
+    import uvicorn
+
+    uvicorn.run(create_app(), host="127.0.0.1", port=8044)

spaday_collab/extension/cdn/example.js

@@ -0,0 +1,2 @@
+document.addEventListener("spaday:wire-client",({detail:{namespace:r,store:e}})=>{if(r!=="document")return;let n=()=>e.set("pointers",(e.get("remote_activity")??[]).map(({peer:i,state:t})=>({peer:i,pointer:t?.pointer,label:t?.label,color:t?.color}))),o=e.subscribe("remote_activity",n);n(),window.addEventListener("pagehide",i=>{i.persisted||o()})});
+//# sourceMappingURL=example.js.map

spaday_collab/extension/cdn/example.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../examples/example.js"],
+  "sourcesContent": ["// Application mapping from scoped awareness to the optional pointer UI.\ndocument.addEventListener(\n  \"spaday:wire-client\",\n  ({ detail: { namespace, store } }) => {\n    if (namespace !== \"document\") return;\n    const render = () =>\n      store.set(\n        \"pointers\",\n        (store.get(\"remote_activity\") ?? []).map(({ peer, state }) => ({\n          peer,\n          pointer: state?.pointer,\n          label: state?.label,\n          color: state?.color,\n        })),\n      );\n    const stop = store.subscribe(\"remote_activity\", render);\n    render();\n    window.addEventListener(\"pagehide\", (event) => {\n      if (!event.persisted) stop();\n    });\n  },\n);\n"],
+  "mappings": "AACA,SAAS,iBACP,qBACA,CAAC,CAAE,OAAQ,CAAE,UAAAA,EAAW,MAAAC,CAAM,CAAE,IAAM,CACpC,GAAID,IAAc,WAAY,OAC9B,IAAME,EAAS,IACbD,EAAM,IACJ,YACCA,EAAM,IAAI,iBAAiB,GAAK,CAAC,GAAG,IAAI,CAAC,CAAE,KAAAE,EAAM,MAAAC,CAAM,KAAO,CAC7D,KAAAD,EACA,QAASC,GAAO,QAChB,MAAOA,GAAO,MACd,MAAOA,GAAO,KAChB,EAAE,CACJ,EACIC,EAAOJ,EAAM,UAAU,kBAAmBC,CAAM,EACtDA,EAAO,EACP,OAAO,iBAAiB,WAAaI,GAAU,CACxCA,EAAM,WAAWD,EAAK,CAC7B,CAAC,CACH,CACF",
+  "names": ["namespace", "store", "render", "peer", "state", "stop", "event"]
+}

spaday_collab/extension/cdn/index.js

@@ -0,0 +1,11 @@
+function _(r){if(!r||typeof r!="object")return!1;let e=r;return typeof e.target=="string"&&e.target.length>0&&typeof e.x=="number"&&Number.isFinite(e.x)&&e.x>=0&&e.x<=1&&typeof e.y=="number"&&Number.isFinite(e.y)&&e.y>=0&&e.y<=1}function O(r,e){let n=document.elementFromPoint(r,e);for(;n?.shadowRoot;){let o=n.shadowRoot.elementFromPoint(r,e);if(!o||o===n)break;n=o}return n}function L(r,e){for(;e;){if(r===e||r.contains(e))return!0;let n=e.getRootNode();e=n instanceof ShadowRoot?n.host:null}return!1}function z(r){let e=r.getBoundingClientRect(),n=Math.max(0,e.left),o=Math.max(0,e.top),c=Math.min(innerWidth,e.right),d=Math.min(innerHeight,e.bottom),i=r;for(;i;){let h=i.getRootNode();if(i=i.parentElement??(h instanceof ShadowRoot?h.host:null),!i)break;let l=getComputedStyle(i),a=i.getBoundingClientRect();l.overflowX!=="visible"&&(n=Math.max(n,a.left+i.clientLeft),c=Math.min(c,a.left+i.clientLeft+i.clientWidth)),l.overflowY!=="visible"&&(o=Math.max(o,a.top+i.clientTop),d=Math.min(d,a.top+i.clientTop+i.clientHeight))}let u=new DOMRect(n,o,Math.max(0,c-n),Math.max(0,d-o));return{bounds:e,visibleBounds:u,hit(h,l){let a=O(h,l);return L(r,a)}}}function S(r=document){let e=()=>Array.from(r.querySelectorAll("[data-collab-target]"));return{hitTest(n,o){let c=O(n,o);return e().reverse().find(d=>L(d,c))?.getAttribute("data-collab-target")??null},resolve(n){let o=e().find(c=>c.getAttribute("data-collab-target")===n);return o?z(o):void 0},roots:()=>[r instanceof Document?r.body:r]}}function C(r,e,n){let o=null,c,d=[],i="",u,h=0,l=!0,a=new Set,f=()=>{clearTimeout(u),u=void 0,o&&(o=null,e(null))},x=()=>{if(h=0,!l)return;T();let t=d.flatMap(({peer:m,pointer:p})=>{if(!_(p))return[];let w=r.resolve(p.target);if(!w)return[];let{bounds:g}=w,y=w.visibleBounds??g,E=g.left+g.width*p.x,P=g.top+g.height*p.y;return g.width<=0||g.height<=0||y.width<=0||y.height<=0||E<y.left||E>y.right||P<y.top||P>y.bottom||!w.hit(E,P)?[]:[{peer:m,x:E,y:P,bounds:y}]}),s=JSON.stringify(t);s!==i&&(i=s,n(t))},v=()=>{l&&!h&&(h=requestAnimationFrame(x))},b=()=>{if(o&&c){let t=r.resolve(o.target);(!t||!t.hit(c.x,c.y)||Math.abs(t.bounds.left+t.bounds.width*o.x-c.x)>.5||Math.abs(t.bounds.top+t.bounds.height*o.y-c.y)>.5)&&f()}v()},R=new MutationObserver(b),M=new ResizeObserver(b);function T(){let t=new Set(r.roots?.()??[document.body]);if(!(t.size===a.size&&[...t].every(s=>a.has(s)))){R.disconnect(),M.disconnect();for(let s of a)s.removeEventListener("scroll",b,!0);a.clear();for(let s of t)a.add(s),s.addEventListener("scroll",b,!0),R.observe(s,{childList:!0,subtree:!0,attributes:!0}),M.observe(s instanceof ShadowRoot?s.host:s)}}let N=t=>{if(t.pointerType==="touch")return;c={x:t.clientX,y:t.clientY};let s=r.hitTest(t.clientX,t.clientY),m=s===null?void 0:r.resolve(s);if(!s||!m||!m.bounds.width||!m.bounds.height||!m.hit(t.clientX,t.clientY)){f();return}let p=m.bounds;o={target:s,x:Math.max(0,Math.min(1,(t.clientX-p.left)/p.width)),y:Math.max(0,Math.min(1,(t.clientY-p.top)/p.height))},u||(u=setTimeout(()=>{u=void 0,l&&e(o)},40))},j=()=>{document.hidden?f():v()},A=[[document,"pointermove",N],[document.documentElement,"pointerleave",f],[document,"scroll",b,!0],[document,"viewport-change",b],[document,"visibilitychange",j],[window,"resize",b],[window,"blur",f],[window,"pagehide",f],[window,"pageshow",b]];return A.forEach(([t,s,m,p])=>t.addEventListener(s,m,p)),T(),{current:()=>o,render(t){l&&(d=t,i="",v())},refresh:b,disconnect(){if(l){l=!1,f(),cancelAnimationFrame(h),R.disconnect(),M.disconnect();for(let t of a)t.removeEventListener("scroll",b,!0);A.forEach(([t,s,m,p])=>t.removeEventListener(s,m,p)),n([])}}}}var k=class extends HTMLElement{_peers=[];_adapter=S();tracker;layer;constructor(){super();let e=this.attachShadow({mode:"open"});e.innerHTML=`<style>
+      :host { display:contents; }
+      .layer { position:fixed; inset:0; z-index:var(--spa-collab-z-index,1000); pointer-events:none; overflow:hidden; }
+      .cursor,.hover { position:absolute; pointer-events:none; }
+      .hover { box-sizing:border-box; border:2px solid var(--peer-color); border-radius:3px; opacity:.65; }
+      .cursor { color:var(--spa-collab-label-text,var(--spa-text,#101820)); font:12px system-ui; display:flex; align-items:flex-start; gap:2px; }
+      .arrow { width:14px; height:20px; background:var(--peer-color); clip-path:polygon(0 0,100% 65%,55% 68%,40% 100%); }
+      .label { margin-top:16px; padding:2px 6px; border-radius:3px; background:var(--peer-color); }
+      .label:empty { display:none; }
+    </style>`,this.layer=document.createElement("div"),this.layer.className="layer",this.layer.setAttribute("aria-hidden","true"),e.append(this.layer)}get peers(){return this._peers}set peers(e){this._peers=Array.isArray(e)?e.filter(n=>n&&typeof n.peer=="string"):[],this.tracker?.render(this._peers)}get adapter(){return this._adapter}set adapter(e){this.tracker?.disconnect(),this.tracker=void 0,this._adapter=e,this.isConnected&&this.start()}connectedCallback(){for(let e of["peers","adapter"])if(Object.prototype.hasOwnProperty.call(this,e)){let n=this[e];delete this[e],Object.assign(this,{[e]:n})}this.tracker||this.start()}disconnectedCallback(){this.tracker?.disconnect(),this.tracker=void 0}start(){this.tracker=C(this._adapter,e=>this.dispatchEvent(new CustomEvent("pointer-change",{detail:{pointer:e},bubbles:!0,composed:!0})),e=>this.draw(e)),this.tracker.render(this._peers)}draw(e){this.layer.replaceChildren(...e.map(({peer:n,x:o,y:c,bounds:d})=>{let i=this._peers.find(v=>v.peer===n),u=document.createElement("div");u.dataset.peer=n;let h=typeof i.color=="string"&&CSS.supports("color",i.color)?i.color:"var(--spa-collab-accent,var(--spa-accent,#90c2ff))";u.style.setProperty("--peer-color",h);let l=document.createElement("div");l.className="hover",l.part.add("hover"),Object.assign(l.style,{left:`${d.left}px`,top:`${d.top}px`,width:`${d.width}px`,height:`${d.height}px`});let a=document.createElement("div");a.className="cursor",a.part.add("cursor"),Object.assign(a.style,{left:`${o}px`,top:`${c}px`});let f=document.createElement("span");f.className="arrow";let x=document.createElement("span");return x.className="label",x.part.add("label"),x.textContent=typeof i.label=="string"?i.label:"",a.append(f,x),u.append(l,a),u}))}};customElements.get("spaday-pointers")||customElements.define("spaday-pointers",k);export{k as SpadayPointers,C as connectPointers,S as domTargets,z as elementGeometry,_ as isPointer};
+//# sourceMappingURL=index.js.map

spaday_collab/extension/cdn/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/ts/pointers.ts", "../../src/ts/index.ts"],
+  "sourcesContent": ["export interface Pointer {\n  target: string;\n  x: number;\n  y: number;\n}\nexport interface Geometry {\n  bounds: DOMRectReadOnly;\n  visibleBounds?: DOMRectReadOnly;\n  hit: (x: number, y: number) => boolean;\n}\nexport interface PointerAdapter {\n  hitTest(x: number, y: number): string | null;\n  resolve(target: string): Geometry | undefined;\n  roots?(): (Element | ShadowRoot)[];\n}\nexport interface RemotePointer {\n  peer: string;\n  pointer?: unknown;\n}\nexport interface ProjectedPointer {\n  peer: string;\n  x: number;\n  y: number;\n  bounds: DOMRectReadOnly;\n}\nexport function isPointer(value: unknown): value is Pointer {\n  if (!value || typeof value !== \"object\") return false;\n  const p = value as Pointer;\n  return (\n    typeof p.target === \"string\" &&\n    p.target.length > 0 &&\n    typeof p.x === \"number\" &&\n    Number.isFinite(p.x) &&\n    p.x >= 0 &&\n    p.x <= 1 &&\n    typeof p.y === \"number\" &&\n    Number.isFinite(p.y) &&\n    p.y >= 0 &&\n    p.y <= 1\n  );\n}\nfunction hitElement(x: number, y: number): Element | null {\n  let hit = document.elementFromPoint(x, y);\n  while (hit?.shadowRoot) {\n    const inner = hit.shadowRoot.elementFromPoint(x, y);\n    if (!inner || inner === hit) break;\n    hit = inner;\n  }\n  return hit;\n}\nfunction containsComposed(element: Element, hit: Element | null): boolean {\n  while (hit) {\n    if (element === hit || element.contains(hit)) return true;\n    const root = hit.getRootNode();\n    hit = root instanceof ShadowRoot ? root.host : null;\n  }\n  return false;\n}\nexport function elementGeometry(element: Element): Geometry {\n  const bounds = element.getBoundingClientRect();\n  let left = Math.max(0, bounds.left),\n    top = Math.max(0, bounds.top);\n  let right = Math.min(innerWidth, bounds.right),\n    bottom = Math.min(innerHeight, bounds.bottom);\n  let ancestor: Element | null = element;\n  while (ancestor) {\n    const root = ancestor.getRootNode();\n    ancestor =\n      ancestor.parentElement ?? (root instanceof ShadowRoot ? root.host : null);\n    if (!ancestor) break;\n    const style = getComputedStyle(ancestor),\n      clip = ancestor.getBoundingClientRect();\n    if (style.overflowX !== \"visible\") {\n      left = Math.max(left, clip.left + ancestor.clientLeft);\n      right = Math.min(\n        right,\n        clip.left + ancestor.clientLeft + ancestor.clientWidth,\n      );\n    }\n    if (style.overflowY !== \"visible\") {\n      top = Math.max(top, clip.top + ancestor.clientTop);\n      bottom = Math.min(\n        bottom,\n        clip.top + ancestor.clientTop + ancestor.clientHeight,\n      );\n    }\n  }\n  const visibleBounds = new DOMRect(\n    left,\n    top,\n    Math.max(0, right - left),\n    Math.max(0, bottom - top),\n  );\n  return {\n    bounds,\n    visibleBounds,\n    hit(x, y) {\n      const hit = hitElement(x, y);\n      return containsComposed(element, hit);\n    },\n  };\n}\n/** Stable IDs for ordinary HTML. Use a custom adapter for virtualized targets. */\nexport function domTargets(root: ParentNode = document): PointerAdapter {\n  const targets = () =>\n    Array.from(root.querySelectorAll(\"[data-collab-target]\"));\n  return {\n    hitTest(x, y) {\n      const hit = hitElement(x, y);\n      return (\n        targets()\n          .reverse()\n          .find((el) => containsComposed(el, hit))\n          ?.getAttribute(\"data-collab-target\") ?? null\n      );\n    },\n    resolve(id) {\n      const element = targets().find(\n        (el) => el.getAttribute(\"data-collab-target\") === id,\n      );\n      return element ? elementGeometry(element) : undefined;\n    },\n    roots: () => [\n      root instanceof Document ? root.body : (root as Element | ShadowRoot),\n    ],\n  };\n}\n/** Track relative pointers without choosing a transport, user identity, or renderer. */\nexport function connectPointers(\n  adapter: PointerAdapter,\n  changed: (pointer: Pointer | null) => void,\n  draw: (pointers: ProjectedPointer[]) => void,\n) {\n  let pointer: Pointer | null = null;\n  let position: { x: number; y: number } | undefined;\n  let peers: RemotePointer[] = [];\n  let last = \"\";\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  let frame = 0,\n    active = true;\n  const roots = new Set<Element | ShadowRoot>();\n  const clear = () => {\n    clearTimeout(timer);\n    timer = undefined;\n    if (pointer) {\n      pointer = null;\n      changed(null);\n    }\n  };\n  const render = () => {\n    frame = 0;\n    if (!active) return;\n    observe();\n    const projected = peers.flatMap(({ peer, pointer: p }) => {\n      if (!isPointer(p)) return [];\n      const target = adapter.resolve(p.target);\n      if (!target) return [];\n      const { bounds } = target,\n        box = target.visibleBounds ?? bounds;\n      const x = bounds.left + bounds.width * p.x,\n        y = bounds.top + bounds.height * p.y;\n      if (\n        bounds.width <= 0 ||\n        bounds.height <= 0 ||\n        box.width <= 0 ||\n        box.height <= 0 ||\n        x < box.left ||\n        x > box.right ||\n        y < box.top ||\n        y > box.bottom ||\n        !target.hit(x, y)\n      )\n        return [];\n      return [{ peer, x, y, bounds: box }];\n    });\n    const encoded = JSON.stringify(projected);\n    if (encoded !== last) {\n      last = encoded;\n      draw(projected);\n    }\n  };\n  const schedule = () => {\n    if (active && !frame) frame = requestAnimationFrame(render);\n  };\n  const refresh = () => {\n    if (pointer && position) {\n      const target = adapter.resolve(pointer.target);\n      if (\n        !target ||\n        !target.hit(position.x, position.y) ||\n        Math.abs(\n          target.bounds.left + target.bounds.width * pointer.x - position.x,\n        ) > 0.5 ||\n        Math.abs(\n          target.bounds.top + target.bounds.height * pointer.y - position.y,\n        ) > 0.5\n      )\n        clear();\n    }\n    schedule();\n  };\n  const observer = new MutationObserver(refresh);\n  const resize = new ResizeObserver(refresh);\n  function observe() {\n    const next = new Set(adapter.roots?.() ?? [document.body]);\n    if (next.size === roots.size && [...next].every((root) => roots.has(root)))\n      return;\n    observer.disconnect();\n    resize.disconnect();\n    for (const root of roots) root.removeEventListener(\"scroll\", refresh, true);\n    roots.clear();\n    for (const root of next) {\n      roots.add(root);\n      root.addEventListener(\"scroll\", refresh, true);\n      observer.observe(root, {\n        childList: true,\n        subtree: true,\n        attributes: true,\n      });\n      resize.observe(root instanceof ShadowRoot ? root.host : root);\n    }\n  }\n  const move = (event: PointerEvent) => {\n    if (event.pointerType === \"touch\") return;\n    position = { x: event.clientX, y: event.clientY };\n    const target = adapter.hitTest(event.clientX, event.clientY);\n    const geometry = target === null ? undefined : adapter.resolve(target);\n    if (\n      !target ||\n      !geometry ||\n      !geometry.bounds.width ||\n      !geometry.bounds.height ||\n      !geometry.hit(event.clientX, event.clientY)\n    ) {\n      clear();\n      return;\n    }\n    const rect = geometry.bounds;\n    pointer = {\n      target,\n      x: Math.max(0, Math.min(1, (event.clientX - rect.left) / rect.width)),\n      y: Math.max(0, Math.min(1, (event.clientY - rect.top) / rect.height)),\n    };\n    if (!timer)\n      timer = setTimeout(() => {\n        timer = undefined;\n        if (active) changed(pointer);\n      }, 40);\n  };\n  const visibility = () => {\n    if (document.hidden) clear();\n    else schedule();\n  };\n  const events: [EventTarget, string, EventListener, boolean?][] = [\n    [document, \"pointermove\", move as EventListener],\n    [document.documentElement, \"pointerleave\", clear],\n    [document, \"scroll\", refresh, true],\n    [document, \"viewport-change\", refresh],\n    [document, \"visibilitychange\", visibility],\n    [window, \"resize\", refresh],\n    [window, \"blur\", clear],\n    [window, \"pagehide\", clear],\n    [window, \"pageshow\", refresh],\n  ];\n  events.forEach(([target, type, listener, capture]) =>\n    target.addEventListener(type, listener, capture),\n  );\n  observe();\n  return {\n    current: () => pointer,\n    render(values: RemotePointer[]) {\n      if (active) {\n        peers = values;\n        last = \"\";\n        schedule();\n      }\n    },\n    refresh,\n    disconnect() {\n      if (!active) return;\n      active = false;\n      clear();\n      cancelAnimationFrame(frame);\n      observer.disconnect();\n      resize.disconnect();\n      for (const root of roots)\n        root.removeEventListener(\"scroll\", refresh, true);\n      events.forEach(([target, type, listener, capture]) =>\n        target.removeEventListener(type, listener, capture),\n      );\n      draw([]);\n    },\n  };\n}\n", "import {\n  connectPointers,\n  domTargets,\n  type PointerAdapter,\n  type ProjectedPointer,\n} from \"./pointers.js\";\nexport * from \"./pointers.js\";\nexport interface Peer {\n  peer: string;\n  pointer?: unknown;\n  label?: string;\n  color?: string;\n}\n/** Optional pointer presentation. Names and colors are supplied by the application. */\nexport class SpadayPointers extends HTMLElement {\n  private _peers: Peer[] = [];\n  private _adapter: PointerAdapter = domTargets();\n  private tracker?: ReturnType<typeof connectPointers>;\n  private layer: HTMLDivElement;\n  constructor() {\n    super();\n    const root = this.attachShadow({ mode: \"open\" });\n    root.innerHTML = `<style>\n      :host { display:contents; }\n      .layer { position:fixed; inset:0; z-index:var(--spa-collab-z-index,1000); pointer-events:none; overflow:hidden; }\n      .cursor,.hover { position:absolute; pointer-events:none; }\n      .hover { box-sizing:border-box; border:2px solid var(--peer-color); border-radius:3px; opacity:.65; }\n      .cursor { color:var(--spa-collab-label-text,var(--spa-text,#101820)); font:12px system-ui; display:flex; align-items:flex-start; gap:2px; }\n      .arrow { width:14px; height:20px; background:var(--peer-color); clip-path:polygon(0 0,100% 65%,55% 68%,40% 100%); }\n      .label { margin-top:16px; padding:2px 6px; border-radius:3px; background:var(--peer-color); }\n      .label:empty { display:none; }\n    </style>`;\n    this.layer = document.createElement(\"div\");\n    this.layer.className = \"layer\";\n    this.layer.setAttribute(\"aria-hidden\", \"true\");\n    root.append(this.layer);\n  }\n  get peers() {\n    return this._peers;\n  }\n  set peers(value: Peer[]) {\n    this._peers = Array.isArray(value)\n      ? value.filter((p) => p && typeof p.peer === \"string\")\n      : [];\n    this.tracker?.render(this._peers);\n  }\n  get adapter() {\n    return this._adapter;\n  }\n  set adapter(value: PointerAdapter) {\n    this.tracker?.disconnect();\n    this.tracker = undefined;\n    this._adapter = value;\n    if (this.isConnected) this.start();\n  }\n  connectedCallback() {\n    for (const prop of [\"peers\", \"adapter\"] as const) {\n      if (Object.prototype.hasOwnProperty.call(this, prop)) {\n        const value = this[prop];\n        delete (this as unknown as Record<string, unknown>)[prop];\n        Object.assign(this, { [prop]: value });\n      }\n    }\n    if (!this.tracker) this.start();\n  }\n  disconnectedCallback() {\n    this.tracker?.disconnect();\n    this.tracker = undefined;\n  }\n  private start() {\n    this.tracker = connectPointers(\n      this._adapter,\n      (pointer) =>\n        this.dispatchEvent(\n          new CustomEvent(\"pointer-change\", {\n            detail: { pointer },\n            bubbles: true,\n            composed: true,\n          }),\n        ),\n      (pointers) => this.draw(pointers),\n    );\n    this.tracker.render(this._peers);\n  }\n  private draw(pointers: ProjectedPointer[]) {\n    this.layer.replaceChildren(\n      ...pointers.map(({ peer, x, y, bounds }) => {\n        const entry = this._peers.find((p) => p.peer === peer)!;\n        const group = document.createElement(\"div\");\n        group.dataset.peer = peer;\n        const color =\n          typeof entry.color === \"string\" && CSS.supports(\"color\", entry.color)\n            ? entry.color\n            : \"var(--spa-collab-accent,var(--spa-accent,#90c2ff))\";\n        group.style.setProperty(\"--peer-color\", color);\n        const hover = document.createElement(\"div\");\n        hover.className = \"hover\";\n        hover.part.add(\"hover\");\n        Object.assign(hover.style, {\n          left: `${bounds.left}px`,\n          top: `${bounds.top}px`,\n          width: `${bounds.width}px`,\n          height: `${bounds.height}px`,\n        });\n        const cursor = document.createElement(\"div\");\n        cursor.className = \"cursor\";\n        cursor.part.add(\"cursor\");\n        Object.assign(cursor.style, { left: `${x}px`, top: `${y}px` });\n        const arrow = document.createElement(\"span\");\n        arrow.className = \"arrow\";\n        const label = document.createElement(\"span\");\n        label.className = \"label\";\n        label.part.add(\"label\");\n        label.textContent = typeof entry.label === \"string\" ? entry.label : \"\";\n        cursor.append(arrow, label);\n        group.append(hover, cursor);\n        return group;\n      }),\n    );\n  }\n}\nif (!customElements.get(\"spaday-pointers\"))\n  customElements.define(\"spaday-pointers\", SpadayPointers);\n"],
+  "mappings": "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",
+  "names": ["isPointer", "value", "p", "hitElement", "x", "y", "hit", "inner", "containsComposed", "element", "root", "elementGeometry", "bounds", "left", "top", "right", "bottom", "ancestor", "style", "clip", "visibleBounds", "domTargets", "targets", "el", "id", "connectPointers", "adapter", "changed", "draw", "pointer", "position", "peers", "last", "timer", "frame", "active", "roots", "clear", "render", "observe", "projected", "peer", "target", "box", "encoded", "schedule", "refresh", "observer", "resize", "next", "move", "event", "geometry", "rect", "visibility", "events", "type", "listener", "capture", "values", "SpadayPointers", "domTargets", "root", "value", "p", "prop", "connectPointers", "pointer", "pointers", "peer", "x", "y", "bounds", "entry", "group", "color", "hover", "cursor", "arrow", "label"]
+}

spaday_collab/extension/css/index.css

@@ -0,0 +1 @@
+:root{--spa-collab-accent:var(--spa-accent,#90c2ff)}

spaday_collab/extension/index.html

@@ -0,0 +1,4 @@
+<!doctype html>
+<html lang="en"><head><meta charset="utf-8"><title>Pointer tests</title></head>
+<body><main><div data-collab-target="first" style="margin:40px;width:300px;height:200px;background:#aec">Target</div></main>
+<spaday-pointers></spaday-pointers><script type="module" src="./cdn/index.js"></script></body></html>

spaday_collab/gallery.py

@@ -0,0 +1,49 @@
+"""Single-browser component preview, including supplied sample pointers."""
+
+from spaday import SetField, element, event_value
+
+from spaday_collab import Pointers
+
+STYLE = """
+:root { color-scheme: dark; --spa-text: #101820; --spa-accent: #90c2ff; }
+body { margin:0; background:#101820; color:#e4ebef; font:16px/1.5 system-ui; }
+main { max-width:56rem; margin:auto; padding:2rem; }
+a { color:#90c2ff; } nav { display:flex; gap:1rem; }
+section { background:#192630; border:1px solid #344854; border-radius:.5rem; padding:1rem; margin:2rem 0; min-height:8rem; }
+label { display:block; margin-top:2rem; }
+textarea { box-sizing:border-box; display:block; width:100%; min-height:8rem; font:inherit; padding:1rem; margin-top:.5rem; }
+pre { white-space:pre-wrap; }
+"""
+
+
+def gallery():
+    return element(
+        "main",
+        element("h1", "Shared pointer gallery"),
+        element(
+            "p", "Sample remote pointers show labels, colors, and hover outlines. Move your pointer over either panel to inspect local coordinates."
+        ),
+        element(
+            "p",
+            "This preview runs Python in Pyodide. For two real users, run python -m spaday_collab.example and open Alice and Bob in separate browsers.",
+        ),
+        element(
+            "section",
+            element("h2", "First target"),
+            element("p", "Stable target IDs align pointers across different window sizes."),
+            **{"data-collab-target": "first"},
+        ),
+        element(
+            "section",
+            element("h2", "Second target"),
+            element("p", "Labels and colors belong to the application."),
+            **{"data-collab-target": "second"},
+        ),
+        element("pre", id="pointer").bind("textContent", "pointer", codec="json"),
+        Pointers(
+            peers=[
+                {"peer": "sample-a", "pointer": {"target": "first", "x": 0.7, "y": 0.5}, "label": "Alice (sample)", "color": "#f4a261"},
+                {"peer": "sample-b", "pointer": {"target": "second", "x": 0.6, "y": 0.6}, "label": "Bob (sample)", "color": "#90c2ff"},
+            ]
+        ).on("pointer-change", SetField("pointer", event_value("pointer"))),
+    )

spaday_collab/tests/test_all.py

@@ -0,0 +1,50 @@
+import ast
+from pathlib import Path
+
+from spaday import SetField, event_value, generate
+from spaday.bootstrap import bootstrap
+from starlette.testclient import TestClient
+
+from spaday_collab import TOKENS, Pointers, SpadayPointers, package
+from spaday_collab.example import create_app
+from spaday_collab.gallery import gallery
+
+ROOT = Path(__file__).parents[1]
+
+
+def test_pointer_state_serializes():
+    pointer = {"target": "note", "x": 0.25, "y": 0.5}
+    component = Pointers(peers=[{"peer": "a", "pointer": pointer, "label": "Alice"}])
+    component.on("pointer-change", SetField("pointer", event_value("pointer")))
+    node = component.to_node()
+    assert Pointers is SpadayPointers
+    assert node["tag"] == "spaday-pointers"
+    assert node["props"]["peers"]["List"][0]["Map"]["pointer"]["Map"]["target"] == {"Str": "note"}
+    assert "pointer-change" in str(node)
+
+
+def test_generated_component_is_current():
+    assert ast.dump(ast.parse(generate(str(ROOT / "components.cem.json")))) == ast.dump(ast.parse((ROOT / "components.py").read_text()))
+
+
+def test_assets_and_tokens():
+    html = bootstrap(packages=[package])
+    assert "/components/collab/cdn/index.js" in html
+    assert "/components/collab/css/index.css" in html
+    for _, path in package.assets:
+        assert (package.assets_dir / path).is_file()
+    source = (ROOT.parent / "js/src/ts/index.ts").read_text()
+    assert all(token.property in source for token in TOKENS.values())
+    assert package.catalog[0].tag == "spaday-pointers"
+
+
+def test_real_components_in_gallery():
+    assert "spaday-pointers" in str(gallery().to_node())
+
+
+def test_example_pages_and_assets():
+    with TestClient(create_app()) as client:
+        for path in ("/", "/bob", "/components/collab/cdn/index.js", "/components/collab/cdn/example.js"):
+            response = client.get(path)
+            assert response.status_code == 200
+        assert "remote_activity" in client.get("/").text

spaday_collab-0.1.0.dist-info/METADATA

@@ -0,0 +1,113 @@
+Metadata-Version: 2.5
+Name: spaday-collab
+Version: 0.1.0
+Summary: Shared pointers and presence for spaday
+Project-URL: Repository, https://github.com/1kbgz/spaday-collab
+Project-URL: Homepage, https://github.com/1kbgz/spaday-collab
+Author-email: 1kbgz <dev@1kbgz.com>
+License: Apache-2.0
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: >=3.11
+Requires-Dist: spaday<1.0,>=0.14.2
+Provides-Extra: develop
+Requires-Dist: build; extra == 'develop'
+Requires-Dist: bump-my-version; extra == 'develop'
+Requires-Dist: check-dist; extra == 'develop'
+Requires-Dist: codespell; extra == 'develop'
+Requires-Dist: hatch-js; extra == 'develop'
+Requires-Dist: hatchling; extra == 'develop'
+Requires-Dist: httpx; extra == 'develop'
+Requires-Dist: mdformat; extra == 'develop'
+Requires-Dist: mdformat-myst; extra == 'develop'
+Requires-Dist: mdformat-tables>=1; extra == 'develop'
+Requires-Dist: pydantic>=2; extra == 'develop'
+Requires-Dist: pytest; extra == 'develop'
+Requires-Dist: pytest-cov; extra == 'develop'
+Requires-Dist: ruff; extra == 'develop'
+Requires-Dist: starlette; extra == 'develop'
+Requires-Dist: transports<0.13,>=0.12.3; extra == 'develop'
+Requires-Dist: twine; extra == 'develop'
+Requires-Dist: ty; extra == 'develop'
+Requires-Dist: uv; extra == 'develop'
+Requires-Dist: uvicorn; extra == 'develop'
+Requires-Dist: websockets; extra == 'develop'
+Requires-Dist: wheel; extra == 'develop'
+Provides-Extra: examples
+Requires-Dist: pydantic>=2; extra == 'examples'
+Requires-Dist: starlette; extra == 'examples'
+Requires-Dist: transports<0.13,>=0.12.3; extra == 'examples'
+Requires-Dist: uvicorn; extra == 'examples'
+Requires-Dist: websockets; extra == 'examples'
+Description-Content-Type: text/markdown
+
+<a href="https://github.com/1kbgz/spaday-collab">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://github.com/1kbgz/spaday-collab/raw/main/docs/img/logo-dark.webp?raw=true">
+    <img alt="spaday-collab logo, shared pointers inside a browser window" src="https://github.com/1kbgz/spaday-collab/raw/main/docs/img/logo-light.webp?raw=true" width="1200">
+  </picture>
+</a>
+
+[![Build Status](https://github.com/1kbgz/spaday-collab/actions/workflows/build.yaml/badge.svg)](https://github.com/1kbgz/spaday-collab/actions/workflows/build.yaml)
+[![PyPI](https://img.shields.io/pypi/v/spaday-collab.svg)](https://pypi.org/project/spaday-collab/)
+[![License](https://img.shields.io/github/license/1kbgz/spaday-collab)](LICENSE)
+
+Optional shared pointers and hover outlines for [spaday](https://github.com/1kbgz/spaday). Use ordinary HTML targets or supply geometry from a virtualized component.
+
+## Install
+
+```bash
+pip install "spaday-collab[examples]"
+```
+
+## Usage
+
+```python
+from spaday import SetField, element, event_value
+from spaday_collab import Pointers
+
+page = element(
+    "main",
+    element("section", "Review this section", **{"data-collab-target": "review"}),
+    Pointers()
+    .bind("peers", "remote_pointers")
+    .on("pointer-change", SetField("local_pointer", event_value("pointer"))),
+)
+```
+
+A pointer is `{target, x, y}` with coordinates between zero and one. Remote entries are `{peer, pointer, label?, color?}`. The application maps scoped awareness into this list and chooses labels and colors. The included example uses Spaday's `Wire.awareness` and one transports connection for both shared data and pointers.
+
+The browser module also exports `connectPointers`, `domTargets`, and `elementGeometry`. These work without the `Pointers` renderer or a transports connection.
+
+## Documentation
+
+- [Tutorial](https://1kbgz.github.io/spaday-collab/docs/src/tutorial.html): run two users against a shared note.
+- [How-to guides](https://1kbgz.github.io/spaday-collab/docs/src/how-to.html): connect awareness, adapt geometry, and replace the display.
+- [Reference](https://1kbgz.github.io/spaday-collab/docs/src/reference.html): Python component, browser API, and tokens.
+- [Explanation](https://1kbgz.github.io/spaday-collab/docs/src/explanation.html): ownership and lifecycle boundaries.
+
+## Browser Examples
+
+[Open the Pyodide gallery](https://1kbgz.github.io/spaday-collab/lite/). Python creates real `Pointers` components with explicitly labeled sample peers. This single-browser preview has no shared server; use the local example for real collaboration.
+
+## Run the examples locally
+
+```bash
+pip install "spaday-collab[examples]"
+python -m spaday_collab.example
+```
+
+Open http://127.0.0.1:8044/ and http://127.0.0.1:8044/bob in separate browsers. Move over the note or review section to see pointers, then edit the shared note. Demo identities are selected by URL; production applications must authenticate users and assign permissions on the server.
+
+From a checkout, run `make develop`, `make build`, and `make test`. `make pyodide-example` builds `dist/lite`; `make test-pyodide-example` checks that preview in Chromium.
+
+> [!NOTE]
+> This library was generated using [copier](https://copier.readthedocs.io/en/stable/) from the [Base Python Project Template repository](https://github.com/python-project-templates/base).

spaday_collab-0.1.0.dist-info/RECORD

@@ -0,0 +1,17 @@
+spaday_collab/__init__.py,sha256=3c8Cr7yKzvl-D7uq5xKx-oyI752fSm1M3w_V1vLMxGk,735
+spaday_collab/components.cem.json,sha256=UqNHxOj01VxBun9uG3iII5qvYey2uC4p7hly4-CkmCI,985
+spaday_collab/components.py,sha256=Y5Ol3asOli0yAdmRkHMuGB0N9NwAQzyLVTivKNSNRzA,1281
+spaday_collab/example.py,sha256=Qfrr3M8DS2an6iNXQelwZXn93fEm4qqfYg2wuSF-QBs,3356
+spaday_collab/gallery.py,sha256=ojlzFtQ7v-VwQOuAYcSPnd8x8ERKTYoAo0gCNNswnSQ,2181
+spaday_collab/extension/index.html,sha256=rHpTL13lx8jaeGRkSXYbuY_x_uqNJl-7DFzEeq0nvAk,323
+spaday_collab/extension/cdn/example.js,sha256=BxJKDIVNEy7GmCZ3tUwhJQBYNXcGEMchzjDcgRvCl7Q,387
+spaday_collab/extension/cdn/example.js.map,sha256=jJV3Z6pKJffzT-qjU6U_OwmMg_K9X1KTZ6gOPmBZD9Q,1282
+spaday_collab/extension/cdn/index.js,sha256=1Zn4bUmdTjYRRhd-efH2bBMk40SG4eL1P4Y5ByJU_Ok,6460
+spaday_collab/extension/cdn/index.js.map,sha256=PO7K3dJmqG57fK3xRwbsXJdEw97ReRDBWiT6ljI9p9I,22017
+spaday_collab/extension/css/index.css,sha256=TXsYnutLGn07CarK4t98VZDbevl8zJFotGZSAs9dm-g,52
+spaday_collab/tests/test_all.py,sha256=ke-IcEf1OJnjOE3v6-z6K5rDQQEL6TiyzLwW9vp6cCs,1943
+spaday_collab-0.1.0.dist-info/METADATA,sha256=bRVWhHwR-WfD284-haDnotsVN8mSQE8UHcwbOq2KOvg,5537
+spaday_collab-0.1.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+spaday_collab-0.1.0.dist-info/entry_points.txt,sha256=pWfLoVMeA0CV84f-in-5zERv4Y4_j5Ep13dY8CGgTsA,59
+spaday_collab-0.1.0.dist-info/licenses/LICENSE,sha256=RcPqVYf2JyhlV4FlBQud0104R3fT1_-7XbT-vp4eLyE,11335
+spaday_collab-0.1.0.dist-info/RECORD,,

spaday_collab-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

spaday_collab-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[spaday.component_packages]
+collab = spaday_collab:package

spaday_collab-0.1.0.dist-info/licenses/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 2025 1kbgz
+
+   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.