@hyperframes/studio-server 0.7.16 → 0.7.18

package/dist/index.d.ts

@@ -32,6 +32,45 @@ interface LintResult {
         fixHint?: string;
     }>;
 }
+interface StudioSelectionTextField {
+    key: string;
+    label: string;
+    value: string;
+    tagName: string;
+    source: "self" | "child" | "text-node";
+}
+interface StudioSelectionSnapshot {
+    schemaVersion: 1;
+    projectId: string;
+    compositionPath: string;
+    sourceFile: string;
+    currentTime: number;
+    target: {
+        id?: string | null;
+        hfId?: string;
+        selector?: string;
+        selectorIndex?: number;
+    };
+    label: string;
+    tagName: string;
+    boundingBox: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    textContent: string | null;
+    dataAttributes: Record<string, string>;
+    inlineStyles: Record<string, string>;
+    computedStyles: Record<string, string>;
+    textFields: StudioSelectionTextField[];
+    capabilities: Record<string, boolean | string | undefined>;
+    thumbnailUrl: string;
+}
+interface StudioSelectionResponse {
+    selection: StudioSelectionSnapshot | null;
+    updatedAt: string | null;
+}
 /**
  * Adapter interface — injected by each consumer to handle host-specific behavior.
  * The shared API module calls these methods; each host (vite dev, CLI embedded)
@@ -164,4 +203,4 @@ declare function getMimeType(path: string): string;
  */
 declare function buildSubCompositionHtml(projectDir: string, compPath: string, runtimeUrl: string, baseHref?: string): string | null;
 
-export { type LintResult, MIME_TYPES, type RenderJobState, type ResolvedProject, type StudioApiAdapter, buildSubCompositionHtml, createProjectSignature, createStudioApi, getMimeType, walkDir };
+export { type LintResult, MIME_TYPES, type RenderJobState, type ResolvedProject, type StudioApiAdapter, type StudioSelectionResponse, type StudioSelectionSnapshot, type StudioSelectionTextField, buildSubCompositionHtml, createProjectSignature, createStudioApi, getMimeType, walkDir };

package/dist/index.js

@@ -4114,6 +4114,104 @@ function registerRegistryRoutes(api, adapter) {
   });
 }
 
+// src/routes/selection.ts
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isFiniteNumber(value) {
+  return typeof value === "number" && Number.isFinite(value);
+}
+function isStringRecord(value) {
+  return isRecord2(value) && Object.values(value).every((v) => typeof v === "string");
+}
+function hasString(value, key) {
+  return typeof value[key] === "string";
+}
+function hasRequiredStrings(value, keys) {
+  return keys.every((key) => hasString(value, key));
+}
+function hasOptionalString(value, key) {
+  return value[key] === void 0 || typeof value[key] === "string";
+}
+function hasOptionalNullableString(value, key) {
+  return value[key] == null || typeof value[key] === "string";
+}
+function hasOptionalNumber(value, key) {
+  return value[key] === void 0 || isFiniteNumber(value[key]);
+}
+function isBoundingBox(value) {
+  return isRecord2(value) && ["x", "y", "width", "height"].every((key) => isFiniteNumber(value[key]));
+}
+function isTarget(value) {
+  if (!isRecord2(value)) return false;
+  return hasOptionalNullableString(value, "id") && hasOptionalString(value, "hfId") && hasOptionalString(value, "selector") && hasOptionalNumber(value, "selectorIndex");
+}
+function isTextField(value) {
+  return isRecord2(value) && hasRequiredStrings(value, ["key", "label", "value", "tagName"]) && ["self", "child", "text-node"].includes(value.source);
+}
+function isTextFields(value) {
+  return Array.isArray(value) && value.every(isTextField);
+}
+function isSelectionSnapshot(value) {
+  if (!isRecord2(value)) return false;
+  const checks = [
+    value.schemaVersion === 1 && hasRequiredStrings(value, [
+      "projectId",
+      "compositionPath",
+      "sourceFile",
+      "label",
+      "tagName",
+      "thumbnailUrl"
+    ]),
+    isFiniteNumber(value.currentTime),
+    isTarget(value.target),
+    isBoundingBox(value.boundingBox),
+    value.textContent === null || typeof value.textContent === "string",
+    isStringRecord(value.dataAttributes),
+    isStringRecord(value.inlineStyles),
+    isStringRecord(value.computedStyles),
+    isTextFields(value.textFields),
+    isRecord2(value.capabilities)
+  ];
+  return checks.every(Boolean);
+}
+function registerSelectionRoutes(api, adapter) {
+  const selections = /* @__PURE__ */ new Map();
+  api.get("/projects/:id/selection", async (c) => {
+    const project = await adapter.resolveProject(c.req.param("id"));
+    if (!project) return c.json({ error: "not found" }, 404);
+    const stored = selections.get(project.id);
+    return c.json({
+      selection: stored?.selection ?? null,
+      updatedAt: stored?.updatedAt ?? null
+    });
+  });
+  api.put("/projects/:id/selection", async (c) => {
+    const project = await adapter.resolveProject(c.req.param("id"));
+    if (!project) return c.json({ error: "not found" }, 404);
+    let body;
+    try {
+      body = await c.req.json();
+    } catch {
+      return c.json({ error: "invalid json" }, 400);
+    }
+    if (!isRecord2(body) || !("selection" in body)) {
+      return c.json({ error: "missing selection" }, 400);
+    }
+    if (body.selection === null) {
+      selections.delete(project.id);
+      return c.json({ ok: true, selection: null, updatedAt: null });
+    }
+    if (!isSelectionSnapshot(body.selection)) {
+      return c.json({ error: "invalid selection" }, 400);
+    }
+    const selection = { ...body.selection, projectId: project.id };
+    const updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    selections.set(project.id, { selection, updatedAt });
+    return c.json({ ok: true, selection, updatedAt });
+  });
+}
+
 // src/createStudioApi.ts
 function createStudioApi(adapter) {
   const api = new Hono();
@@ -4124,6 +4222,7 @@ function createStudioApi(adapter) {
   registerLintRoutes(api, adapter);
   registerRenderRoutes(api, adapter);
   registerThumbnailRoutes(api, adapter);
+  registerSelectionRoutes(api, adapter);
   registerWaveformRoutes(api, adapter);
   registerFontRoutes(api);
   registerRegistryRoutes(api, adapter);