@glissade/vite-plugin 0.2.0 → 0.4.0

package/README.md

@@ -0,0 +1,22 @@
+# @glissade/vite-plugin
+
+Dev-server middleware for the studio's persistence: `GET/POST /__glissade/sidecar?scene=…` reads and writes per-scene `*.edits.json` sidecars (editor-owned keyframes merged over the code baseline), and `GET/POST /__glissade/project` serves `glissade.project.json` (shared markers + render presets). Writes are path-confined to the project root.
+
+```sh
+npm i -D @glissade/vite-plugin
+```
+
+```ts
+// vite.config.ts
+import { glissade } from '@glissade/vite-plugin';
+export default { plugins: [glissade()] };
+```
+
+## Part of glissade
+
+*(glide & slide)* — programmatic motion graphics for TypeScript: realtime-first in any web page, deterministic headless video export from the same code, a visual studio over the same document. No generator functions.
+
+- [Repository & full README](https://github.com/tyevco/glissade)
+- [Getting started](https://github.com/tyevco/glissade/blob/main/docs/getting-started.md) · [Concepts](https://github.com/tyevco/glissade/blob/main/docs/concepts.md) · [Interactivity](https://github.com/tyevco/glissade/blob/main/docs/interactivity.md)
+
+Apache-2.0.

package/dist/index.d.ts

@@ -6,7 +6,22 @@ interface GlissadeSidecarOptions {
   /** Directory sidecar writes are confined to; defaults to the vite root. */
   root?: string;
 }
+/** glissade.project.json (§6.2 decided scope): shared markers + render presets. */
+interface ProjectDoc {
+  projectVersion: 1;
+  /** Project-wide markers, merged into every scene's ruler. */
+  markers?: Array<{
+    t: number;
+    name: string;
+  }>;
+  /** Named render settings the export UI offers (consumed by the export surface). */
+  renderPresets?: Record<string, {
+    fps?: number;
+    out?: string;
+    range?: [number, number];
+  }>;
+}
 declare function sidecarPathFor(scenePath: string): string;
 declare function glissade(options?: GlissadeSidecarOptions): Plugin;
 //#endregion
-export { GlissadeSidecarOptions, glissade, sidecarPathFor };
+export { GlissadeSidecarOptions, ProjectDoc, glissade, sidecarPathFor };

package/dist/index.js

@@ -1,12 +1,14 @@
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { isAbsolute, normalize, resolve, sep } from "node:path";
+import { isAbsolute, join, normalize, resolve, sep } from "node:path";
 import "vite";
 //#region src/index.ts
 /**
 * @glissade/vite-plugin (DESIGN.md §6.1): dev-server middleware persisting
 * studio sidecars. GET/POST /__glissade/sidecar?scene=<module-path> reads and
 * writes `<module>.edits.json` next to the scene module. Writes are confined
-* to *.edits.json paths inside the configured root.
+* to *.edits.json paths inside the configured root. GET/POST
+* /__glissade/project reads and writes glissade.project.json at the root —
+* the shared, code-reviewable project file (§6.2: markers + render presets).
 */
 function sidecarPathFor(scenePath) {
 	return scenePath.replace(/\.[jt]sx?$/, "") + ".edits.json";
@@ -22,6 +24,41 @@ function glissade(options = {}) {
 				if (abs !== root && !abs.startsWith(root + sep)) return null;
 				return sidecarPathFor(abs);
 			};
+			server.middlewares.use("/__glissade/project", (req, res) => {
+				const projectPath = join(root, "glissade.project.json");
+				if (req.method === "GET") {
+					res.setHeader("content-type", "application/json");
+					res.end(existsSync(projectPath) ? readFileSync(projectPath, "utf8") : "null");
+					return;
+				}
+				if (req.method === "POST") {
+					let body = "";
+					req.on("data", (chunk) => {
+						body += chunk.toString();
+					});
+					req.on("end", () => {
+						try {
+							const doc = JSON.parse(body);
+							if (doc === null || doc.projectVersion !== 1) {
+								res.statusCode = 422;
+								res.end(JSON.stringify({ error: "body must be a projectVersion 1 document" }));
+								return;
+							}
+							writeFileSync(projectPath, JSON.stringify(doc, null, 2) + "\n");
+							res.end(JSON.stringify({
+								ok: true,
+								path: projectPath
+							}));
+						} catch {
+							res.statusCode = 400;
+							res.end(JSON.stringify({ error: "invalid JSON body" }));
+						}
+					});
+					return;
+				}
+				res.statusCode = 405;
+				res.end();
+			});
 			server.middlewares.use("/__glissade/sidecar", (req, res) => {
 				const sidecarPath = resolveScene(new URL(req.url ?? "/", "http://localhost").searchParams.get("scene"));
 				if (!sidecarPath || !sidecarPath.endsWith(".edits.json")) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/vite-plugin",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "glissade dev-server integration: sidecar read/write endpoint for the studio (DESIGN.md §6.1).",
   "license": "Apache-2.0",
   "type": "module",
@@ -15,7 +15,7 @@
     "dist"
   ],
   "dependencies": {
-    "@glissade/core": "0.2.0"
+    "@glissade/core": "0.4.0"
   },
   "peerDependencies": {
     "vite": ">=5"