camox 0.0.0 → 0.1.2-alpha.2

package/dist/features/vite/routeGeneration.js

@@ -0,0 +1,194 @@
+import { writeIfChanged } from "./utils.js";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { relative, resolve } from "node:path";
+//#region src/features/vite/routeGeneration.ts
+var HEADER = `/* ============================================================================
+ * AUTO-GENERATED BY CAMOX — DO NOT EDIT
+ *
+ * This file is managed by the Camox Vite plugin and should stay gitignored.
+ * Any manual edits will be automatically reverted by the dev server.
+ * ============================================================================ */
+
+`;
+function generateCamoxLayout(convexUrl, managementUrl) {
+	return HEADER + `import { Outlet, createFileRoute } from "@tanstack/react-router";
+import { CamoxProvider } from "camox/CamoxProvider";
+import { camoxApp } from "@/camox/app";
+
+export const Route = createFileRoute("/_camox")({
+  component: CamoxPathlessLayout,
+});
+
+function CamoxPathlessLayout() {
+  return (
+    <CamoxProvider camoxApp={camoxApp} convexUrl="${convexUrl}" managementUrl="${managementUrl}">
+      <Outlet />
+    </CamoxProvider>
+  );
+}
+`;
+}
+function generatePageRoute(convexUrl) {
+	return HEADER + `import { createFileRoute } from "@tanstack/react-router";
+import {
+  createMarkdownMiddleware,
+  createPageLoader,
+  createPageHead,
+  PageRouteComponent,
+} from "camox/_internal/pageRoute";
+import { camoxApp } from "@/camox/app";
+
+const markdownMiddleware = createMarkdownMiddleware("${convexUrl}");
+const loader = createPageLoader("${convexUrl}");
+const head = createPageHead(camoxApp);
+
+export const Route = createFileRoute("/_camox/$")({
+  server: {
+    middleware: [markdownMiddleware],
+  },
+  component: App,
+  loader,
+  head,
+});
+
+function App() {
+  const { page } = Route.useLoaderData();
+  return <PageRouteComponent page={page} />;
+}
+`;
+}
+function generateOgRoute() {
+	return HEADER + `import { createFileRoute } from "@tanstack/react-router";
+import { createOgHandler } from "camox/_internal/ogRoute";
+import { camoxApp } from "@/camox/app";
+
+export const Route = createFileRoute("/_camox/og")({
+  server: {
+    handlers: createOgHandler(camoxApp),
+  },
+});
+`;
+}
+function generateCmxRedirect() {
+	return HEADER + `import { createFileRoute, redirect } from "@tanstack/react-router";
+
+export const Route = createFileRoute("/_camox/cmx")({
+  component: RouteComponent,
+  loader: () => {
+    throw redirect({ to: "/cmx-studio" });
+  },
+});
+
+function RouteComponent() {
+  return null;
+}
+`;
+}
+function generateCmxStudio() {
+	return HEADER + `import { Outlet, createFileRoute } from "@tanstack/react-router";
+import { CamoxStudio } from "camox/CamoxStudio";
+
+export const Route = createFileRoute("/_camox/cmx-studio")({
+  component: RouteComponent,
+  notFoundComponent: () => <div>Studio page not found</div>,
+});
+
+function RouteComponent() {
+  return (
+    <CamoxStudio>
+      <Outlet />
+    </CamoxStudio>
+  );
+}
+`;
+}
+function generateCmxStudioCatchAll() {
+	return HEADER + `import { Outlet, createFileRoute } from "@tanstack/react-router";
+import { CamoxStudio } from "camox/CamoxStudio";
+
+export const Route = createFileRoute("/_camox/cmx-studio/$")({
+  component: RouteComponent,
+  notFoundComponent: () => <div>Studio page not found</div>,
+});
+
+function RouteComponent() {
+  return (
+    <CamoxStudio>
+      <Outlet />
+    </CamoxStudio>
+  );
+}
+`;
+}
+function generateCmxStudioContent() {
+	return HEADER + `import { createFileRoute } from "@tanstack/react-router";
+import { CamoxContent } from "camox/CamoxContent";
+
+export const Route = createFileRoute("/_camox/cmx-studio/content")({
+  component: RouteComponent,
+});
+
+function RouteComponent() {
+  return <CamoxContent />;
+}
+`;
+}
+function getRouteFileEntries(routesDir, convexUrl, managementUrl) {
+	const camoxDir = resolve(routesDir, "_camox");
+	return [
+		{
+			path: resolve(routesDir, "_camox.tsx"),
+			content: generateCamoxLayout(convexUrl, managementUrl)
+		},
+		{
+			path: resolve(camoxDir, "$.tsx"),
+			content: generatePageRoute(convexUrl)
+		},
+		{
+			path: resolve(camoxDir, "og.tsx"),
+			content: generateOgRoute()
+		},
+		{
+			path: resolve(camoxDir, "cmx.tsx"),
+			content: generateCmxRedirect()
+		},
+		{
+			path: resolve(camoxDir, "cmx-studio.tsx"),
+			content: generateCmxStudio()
+		},
+		{
+			path: resolve(camoxDir, "cmx-studio.$.tsx"),
+			content: generateCmxStudioCatchAll()
+		},
+		{
+			path: resolve(camoxDir, "cmx-studio.content.tsx"),
+			content: generateCmxStudioContent()
+		}
+	];
+}
+function generateRouteFiles(routesDir, convexUrl, managementUrl) {
+	mkdirSync(resolve(routesDir, "_camox"), { recursive: true });
+	for (const entry of getRouteFileEntries(routesDir, convexUrl, managementUrl)) writeIfChanged(entry.path, entry.content);
+}
+function watchRouteFiles(server, routesDir, convexUrl, managementUrl) {
+	const entries = getRouteFileEntries(routesDir, convexUrl, managementUrl);
+	const expectedByPath = new Map(entries.map((e) => [e.path, e.content]));
+	server.watcher.on("change", (changedPath) => {
+		const expected = expectedByPath.get(changedPath);
+		if (!expected) return;
+		if (readFileSync(changedPath, "utf-8") !== expected) {
+			const rel = relative(server.config.root, changedPath);
+			server.config.logger.warn(`Camox route file "${rel}" was modified — reverting to generated version.`, { timestamp: true });
+			writeFileSync(changedPath, expected, "utf-8");
+		}
+	});
+	server.watcher.on("unlink", (deletedPath) => {
+		const expected = expectedByPath.get(deletedPath);
+		if (!expected) return;
+		const rel = relative(server.config.root, deletedPath);
+		server.config.logger.warn(`Camox route file "${rel}" was deleted — recreating.`, { timestamp: true });
+		writeFileSync(deletedPath, expected, "utf-8");
+	});
+}
+//#endregion
+export { generateRouteFiles, watchRouteFiles };

package/dist/features/vite/skillGeneration.d.ts

@@ -0,0 +1,4 @@
+import { ViteDevServer } from 'vite';
+export declare function generateSkillFiles(appRoot: string): void;
+export declare function watchSkillFiles(server: ViteDevServer, appRoot: string): void;
+//# sourceMappingURL=skillGeneration.d.ts.map

package/dist/features/vite/skillGeneration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillGeneration.d.ts","sourceRoot":"","sources":["../../../src/features/vite/skillGeneration.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AA8B1C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,QAUjD;AA6BD,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,QA6BrE"}

package/dist/features/vite/skillGeneration.js

@@ -0,0 +1,69 @@
+import { writeIfChanged } from "./utils.js";
+import { lstatSync, mkdirSync, readFileSync, readdirSync, readlinkSync, symlinkSync, writeFileSync } from "node:fs";
+import { dirname, join, relative, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+//#region src/features/vite/skillGeneration.ts
+var HEADER = `<!-- AUTO-GENERATED BY CAMOX — DO NOT EDIT
+This file is managed by the Camox Vite plugin.
+Any manual edits will be automatically reverted by the dev server. -->
+
+`;
+var sdkRoot = resolve(dirname(fileURLToPath(import.meta.url)), "../../..");
+function getSkillNames() {
+	const skillsDir = resolve(sdkRoot, "skills");
+	return readdirSync(skillsDir).filter((name) => lstatSync(resolve(skillsDir, name)).isDirectory());
+}
+function generateSkillContent(skillName) {
+	return HEADER + readFileSync(resolve(sdkRoot, `skills/${skillName}/SKILL.md`), "utf-8");
+}
+function getSkillFileEntries(appRoot) {
+	return getSkillNames().map((name) => ({
+		path: resolve(appRoot, `.agents/skills/${name}/SKILL.md`),
+		content: generateSkillContent(name)
+	}));
+}
+function generateSkillFiles(appRoot) {
+	for (const name of getSkillNames()) mkdirSync(resolve(appRoot, `.agents/skills/${name}`), { recursive: true });
+	for (const entry of getSkillFileEntries(appRoot)) writeIfChanged(entry.path, entry.content);
+	ensureClaudeSkillSymlinks(appRoot);
+}
+/**
+* For each skill directory in `.agents/skills/`, ensure a corresponding
+* symlink exists in `.claude/skills/` pointing to it via a relative path.
+*/
+function ensureClaudeSkillSymlinks(appRoot) {
+	const agentsSkillsDir = resolve(appRoot, ".agents/skills");
+	const claudeSkillsDir = resolve(appRoot, ".claude/skills");
+	mkdirSync(claudeSkillsDir, { recursive: true });
+	for (const name of readdirSync(agentsSkillsDir)) {
+		if (!lstatSync(join(agentsSkillsDir, name)).isDirectory()) continue;
+		const symlinkPath = join(claudeSkillsDir, name);
+		const targetRelative = join("../../.agents/skills", name);
+		try {
+			if (readlinkSync(symlinkPath) === targetRelative) continue;
+		} catch {}
+		symlinkSync(targetRelative, symlinkPath);
+	}
+}
+function watchSkillFiles(server, appRoot) {
+	const entries = getSkillFileEntries(appRoot);
+	const expectedByPath = new Map(entries.map((e) => [e.path, e.content]));
+	server.watcher.on("change", (changedPath) => {
+		const expected = expectedByPath.get(changedPath);
+		if (!expected) return;
+		if (readFileSync(changedPath, "utf-8") !== expected) {
+			const rel = relative(server.config.root, changedPath);
+			server.config.logger.warn(`Camox skill file "${rel}" was modified — reverting to generated version.`, { timestamp: true });
+			writeFileSync(changedPath, expected, "utf-8");
+		}
+	});
+	server.watcher.on("unlink", (deletedPath) => {
+		const expected = expectedByPath.get(deletedPath);
+		if (!expected) return;
+		const rel = relative(server.config.root, deletedPath);
+		server.config.logger.warn(`Camox skill file "${rel}" was deleted — recreating.`, { timestamp: true });
+		writeFileSync(deletedPath, expected, "utf-8");
+	});
+}
+//#endregion
+export { generateSkillFiles, watchSkillFiles };

package/dist/features/vite/utils.d.ts

@@ -0,0 +1,2 @@
+export declare function writeIfChanged(filePath: string, content: string): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/features/vite/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/features/vite/utils.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,QAM/D"}

package/dist/features/vite/utils.js

@@ -0,0 +1,10 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+//#region src/features/vite/utils.ts
+function writeIfChanged(filePath, content) {
+	if (existsSync(filePath)) {
+		if (readFileSync(filePath, "utf-8") === content) return;
+	}
+	writeFileSync(filePath, content, "utf-8");
+}
+//#endregion
+export { writeIfChanged };

package/dist/features/vite/vite.d.ts

@@ -0,0 +1,18 @@
+import { Plugin } from 'vite';
+import { DefinitionsSyncOptions } from './definitionsSync';
+export interface CamoxPluginOptions {
+    /** Stable, human-readable slug identifying this project (e.g. "prestigious-impala-84") */
+    projectSlug: string;
+    /** Disable the generation of boilerplate code when creating a blank file in the blocks directory (default: false) */
+    disableBlockBoilerplateGeneration?: boolean;
+    /** Disable automatic definitions sync on server start (default: false) */
+    disableDefinitionsSync?: boolean;
+    /** Options for definitions sync */
+    definitionsSync?: DefinitionsSyncOptions;
+    /** URL of the Camox management web app, used for authentication redirects */
+    managementUrl?: string;
+    /** Disable PostHog analytics collection (default: false) */
+    disableAnalytics?: boolean;
+}
+export declare function camox(options: CamoxPluginOptions): Plugin;
+//# sourceMappingURL=vite.d.ts.map

package/dist/features/vite/vite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../../../src/features/vite/vite.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAC;AAclD,OAAO,EAAmB,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAOjF,MAAM,WAAW,kBAAkB;IACjC,0FAA0F;IAC1F,WAAW,EAAE,MAAM,CAAC;IACpB,qHAAqH;IACrH,iCAAiC,CAAC,EAAE,OAAO,CAAC;IAC5C,0EAA0E;IAC1E,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,mCAAmC;IACnC,eAAe,CAAC,EAAE,sBAAsB,CAAC;IACzC,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CA8EzD"}

package/dist/features/vite/vite.js

@@ -0,0 +1,77 @@
+import { generateAppFile, watchAppFile } from "./appGeneration.js";
+import { watchNewBlockFiles } from "./blockBoilerplate.js";
+import { LOCAL_CONVEX_URL, startConvexDev, stopConvexDev } from "./convexSync.js";
+import { syncDefinitions } from "./definitionsSync.js";
+import { generateRouteFiles, watchRouteFiles } from "./routeGeneration.js";
+import { generateSkillFiles, watchSkillFiles } from "./skillGeneration.js";
+import { readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+//#region src/features/vite/vite.ts
+var sdkRoot = resolve(dirname(fileURLToPath(import.meta.url)), "../../..");
+var VIRTUAL_STUDIO_CSS = "virtual:camox-studio-css";
+var RESOLVED_VIRTUAL_STUDIO_CSS = "\0" + VIRTUAL_STUDIO_CSS;
+/** Default management backend URL (production Camox web app) */
+var DEFAULT_MANAGEMENT_URL = "https://camox.ai";
+function camox(options) {
+	const convexUrl = LOCAL_CONVEX_URL;
+	const managementUrl = options.managementUrl ?? DEFAULT_MANAGEMENT_URL;
+	let isBuild = false;
+	return {
+		name: "camox",
+		resolveId(id) {
+			if (id === VIRTUAL_STUDIO_CSS) return RESOLVED_VIRTUAL_STUDIO_CSS;
+		},
+		load(id) {
+			if (id !== RESOLVED_VIRTUAL_STUDIO_CSS) return;
+			const cssPath = resolve(sdkRoot, "dist/studio.css");
+			if (isBuild) {
+				const css = readFileSync(cssPath, "utf-8");
+				return `export default import.meta.ROLLUP_FILE_URL_${this.emitFile({
+					type: "asset",
+					name: "studio.css",
+					source: css
+				})};`;
+			}
+			return `export default "/@fs/${cssPath}";`;
+		},
+		config(_config, env) {
+			isBuild = env.command === "build";
+			return { define: {
+				...env.command === "serve" && {
+					"import.meta.env.VITE_CONVEX_URL": JSON.stringify(convexUrl),
+					"import.meta.env.VITE_CONVEX_SITE_URL": JSON.stringify("http://127.0.0.1:3211")
+				},
+				__CAMOX_ANALYTICS_DISABLED__: JSON.stringify(!!options.disableAnalytics)
+			} };
+		},
+		configResolved(config) {
+			const routesDir = resolve(config.root, "src/routes");
+			generateAppFile(config.root);
+			generateRouteFiles(routesDir, convexUrl, managementUrl);
+			generateSkillFiles(config.root);
+			const message = config.command === "serve" ? `Running Camox app (NODE_ENV: ${process.env.NODE_ENV})` : `Building Camox app (NODE_ENV: ${process.env.NODE_ENV})`;
+			config.logger.info(message, { timestamp: true });
+		},
+		configureServer(server) {
+			const routesDir = resolve(server.config.root, "src/routes");
+			watchAppFile(server, server.config.root);
+			watchRouteFiles(server, routesDir, convexUrl, managementUrl);
+			watchSkillFiles(server, server.config.root);
+			if (!options.disableBlockBoilerplateGeneration) watchNewBlockFiles(server);
+			server.httpServer?.once("listening", async () => {
+				await startConvexDev(server);
+				if (!options.disableDefinitionsSync) syncDefinitions(server, {
+					...options.definitionsSync,
+					projectSlug: options.projectSlug,
+					convexUrl
+				});
+			});
+		},
+		buildEnd() {
+			stopConvexDev();
+		}
+	};
+}
+//#endregion
+export { camox };

package/dist/hooks/use-file-upload.d.ts

@@ -0,0 +1,22 @@
+export interface UploadItem {
+    id: string;
+    filename: string;
+    progress: number;
+    status: "uploading" | "committing" | "complete" | "error";
+    error?: string;
+}
+interface UseFileUploadOptions {
+    onFileCommitted?: (result: {
+        fileId: string;
+        url: string;
+        filename: string;
+        mimeType: string;
+    }) => void;
+}
+export declare function useFileUpload(options?: UseFileUploadOptions): {
+    uploads: UploadItem[];
+    uploadFiles: (files: FileList) => void;
+    clearAll: () => void;
+};
+export {};
+//# sourceMappingURL=use-file-upload.d.ts.map

package/dist/hooks/use-file-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-file-upload.d.ts","sourceRoot":"","sources":["../../src/hooks/use-file-upload.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,GAAG,YAAY,GAAG,UAAU,GAAG,OAAO,CAAC;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,oBAAoB;IAC5B,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,KAAK,IAAI,CAAC;CACZ;AAED,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB;;yBA+EhD,QAAQ;;EAgCnB"}

package/dist/hooks/use-marquee-selection.d.ts

@@ -0,0 +1,17 @@
+interface Rect {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+export declare function useMarqueeSelection(containerRef: React.RefObject<HTMLElement | null>, onSelectionChange: (ids: Set<string>) => void): {
+    selectionRect: Rect | null;
+    didDragRef: import('react').RefObject<boolean>;
+    handlers: {
+        onPointerDown: (e: React.PointerEvent) => void;
+        onPointerMove: (e: React.PointerEvent) => void;
+        onPointerUp: (e: React.PointerEvent) => void;
+    };
+};
+export {};
+//# sourceMappingURL=use-marquee-selection.d.ts.map

package/dist/hooks/use-marquee-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-marquee-selection.d.ts","sourceRoot":"","sources":["../../src/hooks/use-marquee-selection.ts"],"names":[],"mappings":"AAOA,UAAU,IAAI;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EACjD,iBAAiB,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI;;;;2BA8DvC,KAAK,CAAC,YAAY;2BAiBlB,KAAK,CAAC,YAAY;yBAyBY,KAAK,CAAC,YAAY;;EAcvD"}

package/dist/lib/analytics-client.d.ts

@@ -0,0 +1,3 @@
+/** Client-side tracking for CMS actions. Events route through t.camox.ai reverse proxy. */
+export declare function trackClientEvent(event: string, properties: Record<string, unknown>): void;
+//# sourceMappingURL=analytics-client.d.ts.map

package/dist/lib/analytics-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-client.d.ts","sourceRoot":"","sources":["../../src/lib/analytics-client.ts"],"names":[],"mappings":"AAiCA,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAGlF"}

package/dist/lib/analytics.d.ts

@@ -0,0 +1,3 @@
+/** Server-side tracking for page views (used in pageRoute.tsx) */
+export declare function trackEvent(event: string, properties: Record<string, unknown>): Promise<void>;
+//# sourceMappingURL=analytics.d.ts.map

package/dist/lib/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/lib/analytics.ts"],"names":[],"mappings":"AAmBA,kEAAkE;AAClE,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,iBAKlF"}

package/dist/lib/analytics.js

@@ -0,0 +1,24 @@
+//#region src/lib/analytics.ts
+var POSTHOG_API_KEY = "phc_DV6H1bUHFvtNFfhyiq9skEQMniuyxs3HLx06TajB6Fw";
+var client = null;
+async function getClient() {
+	if (__CAMOX_ANALYTICS_DISABLED__) return null;
+	if (!client) {
+		const { PostHog } = await import("posthog-node");
+		client = new PostHog(POSTHOG_API_KEY, { host: "https://us.i.posthog.com" });
+	}
+	return client;
+}
+/** Server-side tracking for page views (used in pageRoute.tsx) */
+async function trackEvent(event, properties) {
+	const posthog = await getClient();
+	if (!posthog) return;
+	const distinctId = properties.projectId ?? "unknown";
+	posthog.capture({
+		distinctId,
+		event,
+		properties
+	});
+}
+//#endregion
+export { trackEvent };