beam-alpha 0.1.0

package/dist/runtime/core.d.ts

@@ -0,0 +1,43 @@
+/** Public types for `@blueprint/dev/runtime` — see types/index.d.ts's note. */
+
+export type ParamValue = number | string | boolean | [number, number] | [number, number, number, number]
+
+export interface DeclareOptions {
+  label?: string
+  /** Panel section; defaults from the name (`orbit.speed` → "Orbit"). */
+  group?: string
+  min?: number
+  max?: number
+  step?: number
+  unit?: 'ms' | 's' | 'px' | 'rem' | 'em' | '%' | 'vh' | 'vw' | 'vmin' | 'vmax' | 'ch' | 'ex' | 'pt' | 'pc' | 'cm' | 'mm' | 'in' | 'fr' | 'deg' | 'rad' | 'turn'
+  /** Enum choices; their presence renders a segmented/select control. */
+  options?: string[]
+  /**
+   * Only where the fallback alone can't say which control this is: a string
+   * may be a `color`, a `font` family, or plain `text`; a 2-array is a
+   * `vector2` unless declared a `spring`; a 4-array is a `bezier` unless
+   * declared a `box`.
+   */
+  kind?: 'color' | 'text' | 'font' | 'spring' | 'vector2' | 'box'
+}
+
+/**
+ * Declare a tunable and get its reader. Reading is total: with Blueprint
+ * absent, attached-but-untouched, or holding before/after, the answer is the
+ * page's own `fallback`. In production builds this resolves to an inert
+ * passthrough.
+ */
+export declare function declareParam<T extends ParamValue>(
+  name: string,
+  fallback: T,
+  options?: DeclareOptions
+): () => T
+
+/** One read of a declared parameter's current value. */
+export declare function readParam<T extends ParamValue>(name: string, fallback: T): T
+
+/** Register a declaration without reading. Idempotent per shape. */
+export declare function register(name: string, fallback: ParamValue, options?: DeclareOptions): void
+
+/** Run `fn` whenever Blueprint pushes values; returns an unsubscribe. */
+export declare function onParams(fn: () => void): () => void

package/dist/runtime/core.js

@@ -0,0 +1,36 @@
+// runtime/core.ts
+function declareParam(name, fallback, options) {
+  register(name, fallback, options);
+  return () => readParam(name, fallback);
+}
+function readParam(name, fallback) {
+  if (typeof window === "undefined") return fallback;
+  const params = window.__bpParams;
+  return params ? params.get(name, fallback) : fallback;
+}
+function register(name, fallback, options) {
+  if (typeof window === "undefined") return;
+  const reg = window.__bpDecl ??= { params: {}, rev: 0 };
+  const entry = { name, fallback, ...options };
+  const previous = reg.params[name];
+  if (previous && JSON.stringify(previous) === JSON.stringify(entry)) return;
+  reg.params[name] = entry;
+  reg.rev++;
+  try {
+    window.dispatchEvent(new CustomEvent("bp:declare", { detail: { name } }));
+  } catch {
+  }
+}
+function onParams(fn) {
+  if (typeof window === "undefined") return () => {
+  };
+  const handler = () => fn();
+  window.addEventListener("bp:params", handler);
+  return () => window.removeEventListener("bp:params", handler);
+}
+export {
+  declareParam,
+  onParams,
+  readParam,
+  register
+};

package/dist/runtime/core.prod.js

@@ -0,0 +1,19 @@
+// runtime/core.prod.ts
+function declareParam(_name, fallback, _options) {
+  return () => fallback;
+}
+function readParam(_name, fallback) {
+  return fallback;
+}
+function register(_name, _fallback, _options) {
+}
+function onParams(_fn) {
+  return () => {
+  };
+}
+export {
+  declareParam,
+  onParams,
+  readParam,
+  register
+};

package/dist/runtime/react.d.ts

@@ -0,0 +1,16 @@
+/** Public types for `@blueprint/dev/react` — see types/index.d.ts's note. */
+import type { DeclareOptions, ParamValue } from './core'
+
+export type { DeclareOptions, ParamValue }
+export { declareParam, readParam } from './core'
+
+/**
+ * Declare a tunable and subscribe: the component re-renders when Blueprint
+ * pushes a value. In production builds this resolves to a passthrough that
+ * returns `fallback` and doesn't import React.
+ */
+export declare function useParam<T extends ParamValue>(
+  name: string,
+  fallback: T,
+  options?: DeclareOptions
+): T

package/dist/runtime/react.js

@@ -0,0 +1,48 @@
+// runtime/react.ts
+import { useSyncExternalStore } from "react";
+
+// runtime/core.ts
+function declareParam(name, fallback, options) {
+  register(name, fallback, options);
+  return () => readParam(name, fallback);
+}
+function readParam(name, fallback) {
+  if (typeof window === "undefined") return fallback;
+  const params = window.__bpParams;
+  return params ? params.get(name, fallback) : fallback;
+}
+function register(name, fallback, options) {
+  if (typeof window === "undefined") return;
+  const reg = window.__bpDecl ??= { params: {}, rev: 0 };
+  const entry = { name, fallback, ...options };
+  const previous = reg.params[name];
+  if (previous && JSON.stringify(previous) === JSON.stringify(entry)) return;
+  reg.params[name] = entry;
+  reg.rev++;
+  try {
+    window.dispatchEvent(new CustomEvent("bp:declare", { detail: { name } }));
+  } catch {
+  }
+}
+function onParams(fn) {
+  if (typeof window === "undefined") return () => {
+  };
+  const handler = () => fn();
+  window.addEventListener("bp:params", handler);
+  return () => window.removeEventListener("bp:params", handler);
+}
+
+// runtime/react.ts
+function useParam(name, fallback, options) {
+  register(name, fallback, options);
+  return useSyncExternalStore(
+    onParams,
+    () => readParam(name, fallback),
+    () => fallback
+  );
+}
+export {
+  declareParam,
+  readParam,
+  useParam
+};

package/dist/runtime/react.prod.js

@@ -0,0 +1,17 @@
+// runtime/core.prod.ts
+function declareParam(_name, fallback, _options) {
+  return () => fallback;
+}
+function readParam(_name, fallback) {
+  return fallback;
+}
+
+// runtime/react.prod.ts
+function useParam(_name, fallback, _options) {
+  return fallback;
+}
+export {
+  declareParam,
+  readParam,
+  useParam
+};

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "beam-alpha",
+  "version": "0.1.0",
+  "description": "Blueprint in your own dev server: add the Vite plugin or the Next.js host, open /__blueprint.",
+  "license": "PolyForm-Shield-1.0.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cronjob4/beam.git",
+    "directory": "packages/dev"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "blueprint": "./bin/blueprint.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./next": {
+      "types": "./dist/next.d.ts",
+      "default": "./dist/next.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/core.d.ts",
+      "development": "./dist/runtime/core.js",
+      "default": "./dist/runtime/core.prod.js"
+    },
+    "./react": {
+      "types": "./dist/runtime/react.d.ts",
+      "development": "./dist/runtime/react.js",
+      "default": "./dist/runtime/react.prod.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md"
+  ],
+  "dependencies": {
+    "@babel/parser": "^7.28.0",
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "magic-string": "^0.30.17",
+    "postcss": "^8.5.0",
+    "postcss-selector-parser": "^7.1.0",
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "next": ">=16",
+    "react": ">=18",
+    "vite": ">=5"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "vite": {
+      "optional": true
+    }
+  }
+}