@standardagents/code-web 0.14.3-canary.6cc75f → 0.14.4-branch.9e48e914.ee06ef

package/dist/plugins/host/transpile.js

@@ -0,0 +1,51 @@
+// The trusted transpile step, run in the viewer (docs/plugin-runtime.md,
+// "The browser runtime"): jco's transpiler, the same pinned version the
+// build uses, splits a plugin's verified component into its core modules,
+// and the viewer keeps only the one that exports the world. jco's generated
+// JavaScript for the component is discarded unread: the only glue that ever
+// runs is the viewer's own reference glue (world.js).
+//
+// The build runs the same function in Node on the sample plugins, so a
+// sample and an account package reach a Worker the same way.
+import { ACCOUNT_IMPORTS, selectMain } from './world.js'
+
+/** jco's `generate` options: sync instantiation, core modules as files. */
+export const GENERATE_OPTIONS = Object.freeze({
+  name: 'plugin',
+  noTypescript: true,
+  instantiation: { tag: 'sync' },
+  map: [],
+  noNodejsCompat: true,
+  base64Cutoff: 0,
+  tlaCompat: false,
+  validLiftingOptimization: false,
+  tracing: false,
+  noComponentErrorWrapping: true,
+})
+
+const WORLD_PACKAGE = 'standard:plugin/'
+const CORE_FILE = /\.core\d*\.wasm$/
+
+/**
+ * The plugin's world core module, from its component's bytes. `generate`
+ * is jco's (`js-component-bindgen-component.js`). Throws when jco refuses
+ * the component, when it imports an interface outside `standard:plugin`,
+ * or when no single core module exports the world.
+ */
+export async function extractMain(component, generate) {
+  let generated
+  try {
+    generated = generate(component instanceof Uint8Array ? component : new Uint8Array(component), GENERATE_OPTIONS)
+  } catch (error) {
+    throw new Error(`jco refused the component: ${error?.payload ?? error?.message ?? error}`)
+  }
+  const outside = generated.imports.filter(name => !name.startsWith(WORLD_PACKAGE))
+  if (outside.length) throw new Error(`the component imports outside the ui-plugin world: ${outside.join(', ')}`)
+  const cores = generated.files.filter(([name]) => CORE_FILE.test(name)).map(([, bytes]) => bytes)
+  const modules = await Promise.all(cores.map(bytes => WebAssembly.compile(bytes)))
+  const main = selectMain(modules)
+  return cores[modules.indexOf(main)]
+}
+
+/** The account-backed imports in the async form jco takes. */
+export const JSPI_IMPORTS = ACCOUNT_IMPORTS