@yahoo/uds-create-sidecar 3.0.0

package/dist/registry.d.ts

@@ -0,0 +1,36 @@
+//#region src/registry.d.ts
+type UDSCreateSidecarModules = Readonly<{
+  '@json-render/react': unknown;
+  react: unknown;
+  'react/jsx-runtime': unknown;
+  'react-native': unknown;
+} & Record<string, unknown>>;
+interface UDSCreateSidecarRegistryOptions {
+  /** A human-readable app name shown by Create when this host connects. */
+  readonly hostName: string;
+  /** Optional app version shown alongside the connected host name. */
+  readonly hostVersion?: string;
+  /** Statically imported modules that downloaded preview bundles may resolve. */
+  readonly modules: UDSCreateSidecarModules;
+  /** Exact installed versions keyed by package root, not module subpath. */
+  readonly packageVersions: Readonly<Record<string, string>>;
+}
+interface UDSCreateSidecarRegistry {
+  readonly hostName: string;
+  readonly hostVersion?: string;
+  readonly modules: UDSCreateSidecarModules;
+  readonly packageVersions: Readonly<Record<string, string>>;
+}
+/**
+ * Define the complete module boundary available to downloaded Create previews.
+ * Every module must have an exact installed package version so the connected
+ * host can advertise its real capabilities before any bundle is evaluated.
+ */
+declare function createUDSCreateSidecarRegistry({
+  hostName,
+  hostVersion,
+  modules,
+  packageVersions
+}: UDSCreateSidecarRegistryOptions): UDSCreateSidecarRegistry;
+//#endregion
+export { UDSCreateSidecarModules, UDSCreateSidecarRegistry, UDSCreateSidecarRegistryOptions, createUDSCreateSidecarRegistry };

package/dist/registry.js

@@ -0,0 +1,38 @@
+//#region src/registry.ts
+const REQUIRED_MODULES = [
+	"@json-render/react",
+	"react",
+	"react/jsx-runtime",
+	"react-native"
+];
+/**
+* Define the complete module boundary available to downloaded Create previews.
+* Every module must have an exact installed package version so the connected
+* host can advertise its real capabilities before any bundle is evaluated.
+*/
+function createUDSCreateSidecarRegistry({ hostName, hostVersion, modules, packageVersions }) {
+	if (hostName.trim() === "") throw new Error("The Sidecar registry requires a hostName.");
+	for (const required of REQUIRED_MODULES) if (!(required in modules)) throw new Error(`The Sidecar registry must expose ${required}.`);
+	const versions = {};
+	for (const specifier of Object.keys(modules)) {
+		const name = packageRoot(specifier);
+		const version = packageVersions[name];
+		if (!version || !isExactVersion(version)) throw new Error(`The Sidecar registry exposes ${name} without an exact installed version.`);
+		versions[name] = version;
+	}
+	return Object.freeze({
+		hostName,
+		...hostVersion ? { hostVersion } : {},
+		modules: Object.freeze({ ...modules }),
+		packageVersions: Object.freeze(versions)
+	});
+}
+function isExactVersion(version) {
+	return /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(version);
+}
+function packageRoot(moduleName) {
+	const parts = moduleName.split("/");
+	return moduleName.startsWith("@") ? parts.slice(0, 2).join("/") : parts[0] ?? moduleName;
+}
+//#endregion
+export { createUDSCreateSidecarRegistry };

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@yahoo/uds-create-sidecar",
+  "version": "3.0.0",
+  "type": "module",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./registry": {
+      "types": "./dist/registry.d.ts",
+      "default": "./dist/registry.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "clean": "internal-cli tools clean",
+    "dev": "tsdown --watch --no-clean",
+    "fix": "internal-cli tools fix",
+    "lint": "internal-cli tools lint",
+    "test": "bun run build && bun test src/",
+    "typecheck": "tsc -b"
+  },
+  "dependencies": {
+    "@noble/hashes": "2.2.0"
+  },
+  "peerDependencies": {
+    "@json-render/react": ">=0.19.0",
+    "expo": "^57.0.0",
+    "react": "^19.0.0",
+    "react-native": ">=0.86.0",
+    "react-native-safe-area-context": ">=5.0.0"
+  },
+  "devDependencies": {
+    "@hocuspocus/provider": "^3.4.4",
+    "@types/bun": "^1.3.14",
+    "@types/react": "19.2.14",
+    "esbuild": "^0.27.4",
+    "expo": "~57.0.18",
+    "react": "19.2.3",
+    "react-native": "0.86.3",
+    "react-native-safe-area-context": "5.7.0",
+    "tsdown": "^0.21.0",
+    "typescript": "~6.0.3",
+    "yjs": "^13.6.29"
+  },
+  "udsSchemaVersion": 20260910212453
+}