@brass-build/client 0.3.0 → 0.4.0

package/src/wasm-runtime.ts

@@ -0,0 +1,21 @@
+// The node half of the WASM runtime seam. Node resolves each WASM-shipping
+// dependency to its own node build, which readies its module as it is
+// imported, so there is nothing to await and `ensureWasmReady` is the same
+// call answering immediately.
+//
+// This is the half every importer names, so a build that applies no
+// substitution at all (tsc, a node-targeting esbuild, the test runner) is
+// already correct, and the browser half's `import.meta.url` asset resolution
+// never reaches a bundler targeting node. `package.json`'s `browser` map
+// swaps in the browser half for a bundler building this package for one, and
+// `ensureWasmReady` exists so a caller awaits readiness the same way whichever
+// half it got.
+
+export * from 'loro-crdt';
+
+/** Resolve once every WASM module this package needs is ready to run. Already
+ *  true here: a node build readies its module during import, so the callers
+ *  that await it on the browser half wait for nothing on this one. */
+export function ensureWasmReady(): Promise<void> {
+  return Promise.resolve();
+}

package/dist/vite.d.ts

@@ -1,31 +0,0 @@
-interface ViteAliasEntry {
-    find: string | RegExp;
-    replacement: string;
-}
-interface ViteBuildOptions {
-    target?: string | string[] | false;
-}
-interface ViteUserConfig {
-    build?: ViteBuildOptions;
-    environments?: {
-        client?: {
-            build?: ViteBuildOptions;
-        };
-    };
-    resolve?: {
-        alias?: Record<string, string> | readonly ViteAliasEntry[];
-    };
-    optimizeDeps?: {
-        exclude?: string[];
-        esbuildOptions?: {
-            target?: string | string[];
-        };
-    };
-}
-interface VitePlugin {
-    name: string;
-    config(config: ViteUserConfig): Promise<ViteUserConfig>;
-}
-export declare function brassVite(): VitePlugin;
-export {};
-//# sourceMappingURL=vite.d.ts.map

package/dist/vite.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AA+CA,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,gBAAgB;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC;CACpC;AAED,UAAU,cAAc;IACtB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAGzB,YAAY,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,gBAAgB,CAAA;SAAE,CAAA;KAAE,CAAC;IACzD,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,cAAc,EAAE,CAAC;KAC5D,CAAC;IACF,YAAY,CAAC,EAAE;QACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,cAAc,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;SAAE,CAAC;KACjD,CAAC;CACH;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACzD;AAoGD,wBAAgB,SAAS,IAAI,UAAU,CAwCtC"}

package/dist/vite.js

@@ -1,161 +0,0 @@
-// Vite plugin encapsulating the bundler config the SDK's WASM runtime
-// needs, so users never name the underlying WASM dep in their own
-// `vite.config.ts`.
-//
-// Vite's dep-prebundling targets older browsers by default and fails on the
-// WASM dep's top-level await (`Top-level await is not available in the
-// configured target environment for loro-crdt/bundler/loro_wasm.js`). The
-// plugin excludes the dep from prebundling (leaving it for the build-time
-// WASM loaders) and bumps the prebundle target to es2022.
-//
-// `vite-plugin-wasm` remains the caller's responsibility: it must land before
-// `brassVite()` in the plugin list.
-// Every WASM-shipping dep the SDK pulls in, and the entry that loads it
-// asynchronously. Add an entry rather than replacing the list: a consumer who
-// has two installed during a migration window needs both handled, and this is
-// the one place any of them is named, so an app's own config never is.
-//
-// A default browser entry fetches its module with a SYNCHRONOUS
-// XMLHttpRequest while it evaluates, so an app freezes its main thread for the
-// whole download before it paints, whether or not anyone opens a document, and
-// the freeze grows with the reader's latency rather than with the app. An
-// `asyncEntry` hands the same module to the bundler's own asset pipeline,
-// which loads it asynchronously and leaves the main thread free. Selecting one
-// emits a top-level await, so it is reachable only on a build target that
-// accepts one, and the synchronous entry is what keeps every other target
-// building.
-const WASM_DEPS = [
-    { specifier: 'loro-crdt', asyncEntry: 'loro-crdt/bundler' },
-];
-// A specifier matched whole. A string `find` matches by prefix, which would
-// also catch the async entry the alias points AT and resolve it to itself.
-const wholeSpecifier = (specifier) => new RegExp(`^${specifier.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}$`);
-// Vite 8 prebundles with rolldown, which handles top-level await on its own
-// and deprecates `optimizeDeps.esbuildOptions`. Setting it there does nothing
-// except print a deprecation warning naming this plugin, on every `vite dev`
-// and every `vite build` a consumer runs. Read from the running Vite rather
-// than from the consumer's manifest, and treat an unreadable version as an
-// older Vite, where the target bump is what makes the WASM dep load at all.
-//
-// The specifier is held in a variable so `tsc` does not resolve it. Vite is
-// neither a dependency nor a peer dependency here (the config shapes above are
-// declared for the same reason), so a literal specifier fails the build
-// wherever Vite is absent, which includes `npm install` in this package
-// itself. At runtime the import reaches the Vite running the build.
-const VITE_PACKAGE = 'vite';
-async function viteMajor() {
-    try {
-        const { version } = (await import(VITE_PACKAGE));
-        const major = Number.parseInt(version ?? '', 10);
-        return Number.isFinite(major) ? major : null;
-    }
-    catch {
-        return null;
-    }
-}
-// Browser versions that first shipped top-level await, by the engine names
-// esbuild accepts in a target string. A target naming an engine absent here is
-// read as unsupported.
-const TOP_LEVEL_AWAIT_SINCE = {
-    chrome: 89,
-    edge: 89,
-    firefox: 89,
-    safari: 15,
-    ios: 15,
-    opera: 75,
-    node: 14.8,
-    es: 2022,
-    hermes: Number.POSITIVE_INFINITY,
-    ie: Number.POSITIVE_INFINITY,
-};
-// Vite's own named targets. `modules` (the Vite 5 / 6 default) resolves to
-// browsers predating top-level await; `baseline-widely-available` (the Vite 7 /
-// 8 default) resolves to ones that carry it.
-const NAMED_TARGET_SUPPORT = {
-    esnext: true,
-    'baseline-widely-available': true,
-    modules: false,
-};
-function targetSupportsTopLevelAwait(target) {
-    const t = target.trim().toLowerCase();
-    const named = NAMED_TARGET_SUPPORT[t];
-    if (named !== undefined)
-        return named;
-    const parsed = /^([a-z]+)([\d.]+)$/.exec(t);
-    if (!parsed)
-        return false;
-    const since = TOP_LEVEL_AWAIT_SINCE[parsed[1]];
-    if (since === undefined)
-        return false;
-    const version = Number.parseFloat(parsed[2]);
-    return Number.isFinite(version) && version >= since;
-}
-// Whether the build this plugin is configuring can carry a top-level await.
-// An unreadable or unrecognised target answers `false`, so the worst a wrong
-// reading costs is the synchronous entry a consumer already has.
-function buildAcceptsTopLevelAwait(config, major) {
-    const target = config.environments?.client?.build?.target ?? config.build?.target;
-    // No explicit target: the answer is Vite's own default, which carries
-    // top-level await from Vite 7 (`baseline-widely-available`) and not before
-    // (`modules`).
-    if (target === undefined)
-        return major !== null && major >= 7;
-    if (target === false)
-        return false;
-    const targets = Array.isArray(target) ? target : [target];
-    return targets.length > 0 && targets.every(targetSupportsTopLevelAwait);
-}
-// A consumer who already resolves the WASM dep themselves owns that decision,
-// so the plugin adds nothing that would take it over.
-function aliasesWasmDep(config) {
-    const alias = config.resolve?.alias;
-    if (!alias)
-        return false;
-    const specifiers = WASM_DEPS.map((dep) => dep.specifier);
-    if (Array.isArray(alias)) {
-        return alias.some((entry) => specifiers.some((specifier) => typeof entry.find === 'string'
-            ? entry.find === specifier
-            : entry.find.test(specifier)));
-    }
-    return Object.keys(alias).some((key) => specifiers.includes(key));
-}
-export function brassVite() {
-    return {
-        name: 'brass-build:vite',
-        async config(config) {
-            const major = await viteMajor();
-            const useAsyncEntry = buildAcceptsTopLevelAwait(config, major) && !aliasesWasmDep(config);
-            const existingExclude = config.optimizeDeps?.exclude ?? [];
-            const exclude = Array.from(new Set([
-                ...existingExclude,
-                ...WASM_DEPS.map((dep) => dep.specifier),
-                ...(useAsyncEntry ? WASM_DEPS.map((dep) => dep.asyncEntry) : []),
-            ]));
-            const resolve = useAsyncEntry
-                ? {
-                    resolve: {
-                        alias: WASM_DEPS.map((dep) => ({
-                            find: wholeSpecifier(dep.specifier),
-                            replacement: dep.asyncEntry,
-                        })),
-                    },
-                }
-                : {};
-            if (major !== null && major >= 8) {
-                return { ...resolve, optimizeDeps: { exclude } };
-            }
-            const existingTarget = config.optimizeDeps?.esbuildOptions?.target;
-            // Don't downgrade if a consumer has already pinned a newer
-            // target; only raise from the Vite default (which lacks TLA).
-            const target = existingTarget ?? 'es2022';
-            return {
-                ...resolve,
-                optimizeDeps: {
-                    exclude,
-                    esbuildOptions: { target },
-                },
-            };
-        },
-    };
-}
-//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"vite.js","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"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"}

package/src/vite.ts

@@ -1,214 +0,0 @@
-// Vite plugin encapsulating the bundler config the SDK's WASM runtime
-// needs, so users never name the underlying WASM dep in their own
-// `vite.config.ts`.
-//
-// Vite's dep-prebundling targets older browsers by default and fails on the
-// WASM dep's top-level await (`Top-level await is not available in the
-// configured target environment for loro-crdt/bundler/loro_wasm.js`). The
-// plugin excludes the dep from prebundling (leaving it for the build-time
-// WASM loaders) and bumps the prebundle target to es2022.
-//
-// `vite-plugin-wasm` remains the caller's responsibility: it must land before
-// `brassVite()` in the plugin list.
-
-// Every WASM-shipping dep the SDK pulls in, and the entry that loads it
-// asynchronously. Add an entry rather than replacing the list: a consumer who
-// has two installed during a migration window needs both handled, and this is
-// the one place any of them is named, so an app's own config never is.
-//
-// A default browser entry fetches its module with a SYNCHRONOUS
-// XMLHttpRequest while it evaluates, so an app freezes its main thread for the
-// whole download before it paints, whether or not anyone opens a document, and
-// the freeze grows with the reader's latency rather than with the app. An
-// `asyncEntry` hands the same module to the bundler's own asset pipeline,
-// which loads it asynchronously and leaves the main thread free. Selecting one
-// emits a top-level await, so it is reachable only on a build target that
-// accepts one, and the synchronous entry is what keeps every other target
-// building.
-const WASM_DEPS: readonly { specifier: string; asyncEntry: string }[] = [
-  { specifier: 'loro-crdt', asyncEntry: 'loro-crdt/bundler' },
-];
-
-// A specifier matched whole. A string `find` matches by prefix, which would
-// also catch the async entry the alias points AT and resolve it to itself.
-const wholeSpecifier = (specifier: string): RegExp =>
-  new RegExp(`^${specifier.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}$`);
-
-// The shape this plugin reads and returns, declared here rather than imported
-// so the SDK does not depend on Vite to describe its own plugin.
-//
-// Each field has to be at least as WIDE as Vite's own, because Vite passes its
-// `UserConfig` into the `config` hook and a hook declared over a narrower
-// config is not assignable to Vite's `Plugin`. `target` is the one that bites:
-// esbuild types it `string | string[]`, so declaring it `string` makes
-// `plugins: [brassVite()]` fail to type-check in a consumer's own
-// `vite.config.ts` (verified against Vite 5, 6 and 7; Vite 8 narrowed its own
-// type and hid it). The plugin only ever passes the value through, so the
-// wider type costs nothing here.
-interface ViteAliasEntry {
-  find: string | RegExp;
-  replacement: string;
-}
-
-interface ViteBuildOptions {
-  target?: string | string[] | false;
-}
-
-interface ViteUserConfig {
-  build?: ViteBuildOptions;
-  // Vite 8 lets a consumer set the browser build's target per environment, and
-  // that value, not the top-level one, is what the client bundle is built to.
-  environments?: { client?: { build?: ViteBuildOptions } };
-  resolve?: {
-    alias?: Record<string, string> | readonly ViteAliasEntry[];
-  };
-  optimizeDeps?: {
-    exclude?: string[];
-    esbuildOptions?: { target?: string | string[] };
-  };
-}
-
-interface VitePlugin {
-  name: string;
-  config(config: ViteUserConfig): Promise<ViteUserConfig>;
-}
-
-// Vite 8 prebundles with rolldown, which handles top-level await on its own
-// and deprecates `optimizeDeps.esbuildOptions`. Setting it there does nothing
-// except print a deprecation warning naming this plugin, on every `vite dev`
-// and every `vite build` a consumer runs. Read from the running Vite rather
-// than from the consumer's manifest, and treat an unreadable version as an
-// older Vite, where the target bump is what makes the WASM dep load at all.
-//
-// The specifier is held in a variable so `tsc` does not resolve it. Vite is
-// neither a dependency nor a peer dependency here (the config shapes above are
-// declared for the same reason), so a literal specifier fails the build
-// wherever Vite is absent, which includes `npm install` in this package
-// itself. At runtime the import reaches the Vite running the build.
-const VITE_PACKAGE = 'vite';
-
-async function viteMajor(): Promise<number | null> {
-  try {
-    const { version } = (await import(VITE_PACKAGE)) as { version?: string };
-    const major = Number.parseInt(version ?? '', 10);
-    return Number.isFinite(major) ? major : null;
-  } catch {
-    return null;
-  }
-}
-
-// Browser versions that first shipped top-level await, by the engine names
-// esbuild accepts in a target string. A target naming an engine absent here is
-// read as unsupported.
-const TOP_LEVEL_AWAIT_SINCE: Readonly<Record<string, number>> = {
-  chrome: 89,
-  edge: 89,
-  firefox: 89,
-  safari: 15,
-  ios: 15,
-  opera: 75,
-  node: 14.8,
-  es: 2022,
-  hermes: Number.POSITIVE_INFINITY,
-  ie: Number.POSITIVE_INFINITY,
-};
-
-// Vite's own named targets. `modules` (the Vite 5 / 6 default) resolves to
-// browsers predating top-level await; `baseline-widely-available` (the Vite 7 /
-// 8 default) resolves to ones that carry it.
-const NAMED_TARGET_SUPPORT: Readonly<Record<string, boolean>> = {
-  esnext: true,
-  'baseline-widely-available': true,
-  modules: false,
-};
-
-function targetSupportsTopLevelAwait(target: string): boolean {
-  const t = target.trim().toLowerCase();
-  const named = NAMED_TARGET_SUPPORT[t];
-  if (named !== undefined) return named;
-  const parsed = /^([a-z]+)([\d.]+)$/.exec(t);
-  if (!parsed) return false;
-  const since = TOP_LEVEL_AWAIT_SINCE[parsed[1] as string];
-  if (since === undefined) return false;
-  const version = Number.parseFloat(parsed[2] as string);
-  return Number.isFinite(version) && version >= since;
-}
-
-// Whether the build this plugin is configuring can carry a top-level await.
-// An unreadable or unrecognised target answers `false`, so the worst a wrong
-// reading costs is the synchronous entry a consumer already has.
-function buildAcceptsTopLevelAwait(
-  config: ViteUserConfig,
-  major: number | null,
-): boolean {
-  const target = config.environments?.client?.build?.target ?? config.build?.target;
-  // No explicit target: the answer is Vite's own default, which carries
-  // top-level await from Vite 7 (`baseline-widely-available`) and not before
-  // (`modules`).
-  if (target === undefined) return major !== null && major >= 7;
-  if (target === false) return false;
-  const targets = Array.isArray(target) ? target : [target];
-  return targets.length > 0 && targets.every(targetSupportsTopLevelAwait);
-}
-
-// A consumer who already resolves the WASM dep themselves owns that decision,
-// so the plugin adds nothing that would take it over.
-function aliasesWasmDep(config: ViteUserConfig): boolean {
-  const alias = config.resolve?.alias;
-  if (!alias) return false;
-  const specifiers = WASM_DEPS.map((dep) => dep.specifier);
-  if (Array.isArray(alias)) {
-    return alias.some((entry) =>
-      specifiers.some((specifier) =>
-        typeof entry.find === 'string'
-          ? entry.find === specifier
-          : entry.find.test(specifier),
-      ),
-    );
-  }
-  return Object.keys(alias as Record<string, string>).some((key) =>
-    specifiers.includes(key),
-  );
-}
-
-export function brassVite(): VitePlugin {
-  return {
-    name: 'brass-build:vite',
-    async config(config) {
-      const major = await viteMajor();
-      const useAsyncEntry = buildAcceptsTopLevelAwait(config, major) && !aliasesWasmDep(config);
-      const existingExclude = config.optimizeDeps?.exclude ?? [];
-      const exclude = Array.from(
-        new Set([
-          ...existingExclude,
-          ...WASM_DEPS.map((dep) => dep.specifier),
-          ...(useAsyncEntry ? WASM_DEPS.map((dep) => dep.asyncEntry) : []),
-        ]),
-      );
-      const resolve = useAsyncEntry
-        ? {
-            resolve: {
-              alias: WASM_DEPS.map((dep) => ({
-                find: wholeSpecifier(dep.specifier),
-                replacement: dep.asyncEntry,
-              })) as ViteAliasEntry[],
-            },
-          }
-        : {};
-      if (major !== null && major >= 8) {
-        return { ...resolve, optimizeDeps: { exclude } };
-      }
-      const existingTarget = config.optimizeDeps?.esbuildOptions?.target;
-      // Don't downgrade if a consumer has already pinned a newer
-      // target; only raise from the Vite default (which lacks TLA).
-      const target = existingTarget ?? 'es2022';
-      return {
-        ...resolve,
-        optimizeDeps: {
-          exclude,
-          esbuildOptions: { target },
-        },
-      };
-    },
-  };
-}