@use-worker/query-loader 0.1.0-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andrew Ingram
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,14 @@
+# @use-worker/query-loader
+
+Shared loader for `@use-worker/webpack` and `@use-worker/turbopack`. Applications
+install their selected integration and let its configuration helper select this
+loader. There is no umbrella `use-worker` package.
+
+The root exports the absolute `loader` path. `/loader` exports the CommonJS
+loader. It selects application, Worker-entry and whole-module implementation
+views by resource query, using core and standalone Oxc. It does not depend on
+Webpack, Next.js, Vite, SWC, or either host configuration package.
+
+Hosts own module resolution, Worker bundling and update propagation. The loader
+passes ordinary source through unchanged and emits static browser Worker URL
+expressions for marked source. Composed source maps remain unfinished.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,63 @@
+# Third-party notices
+
+Parts of the scope analysis and function-hoisting approach in
+`src/compiler/closure-scope.ts` and `src/compiler/hoist.ts` are adapted from the official Vite
+React Server Components transform:
+
+https://github.com/vitejs/vite-plugin-react/tree/11ad0af/packages/plugin-rsc/src/transforms
+
+Vite is distributed under the following license:
+
+> MIT License
+>
+> Copyright (c) 2019-present, Yuxi (Evan) You and Vite contributors
+>
+> Permission is hereby granted, free of charge, to any person obtaining a copy
+> of this software and associated documentation files (the "Software"), to deal
+> in the Software without restriction, including without limitation the rights
+> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+> copies of the Software, and to permit persons to whom the Software is
+> furnished to do so, subject to the following conditions:
+>
+> The above copyright notice and this permission notice shall be included in all
+> copies or substantial portions of the Software.
+>
+> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+> SOFTWARE.
+
+The directive typo-detection algorithm in `src/compiler/transform.ts` and capture-path
+coalescing in `src/compiler/hoist.ts` are adapted from the Next.js Server Actions
+transform:
+
+https://github.com/vercel/next.js/blob/090f1b72753b2d0094235d27d46ffa0da5fc7d35/crates/next-custom-transforms/src/transforms/server_actions.rs#L3231-L3285
+
+https://github.com/vercel/next.js/blob/090f1b72753b2d0094235d27d46ffa0da5fc7d35/crates/next-custom-transforms/src/transforms/server_actions.rs#L2920-L2966
+
+Next.js is distributed under the following license:
+
+> The MIT License (MIT)
+>
+> Copyright (c) 2025 Vercel, Inc.
+>
+> Permission is hereby granted, free of charge, to any person obtaining a copy
+> of this software and associated documentation files (the "Software"), to deal
+> in the Software without restriction, including without limitation the rights
+> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+> copies of the Software, and to permit persons to whom the Software is
+> furnished to do so, subject to the following conditions:
+>
+> The above copyright notice and this permission notice shall be included in all
+> copies or substantial portions of the Software.
+>
+> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+> SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1 @@
+export declare const loader: string;

package/dist/index.js

@@ -0,0 +1,2 @@
+import { fileURLToPath } from "node:url";
+export const loader = fileURLToPath(new URL("./loader.cjs", import.meta.url));

package/dist/loader.cjs

@@ -0,0 +1,26 @@
+"use strict";
+module.exports = function workerLoader(source, inputMap) {
+    const done = this.async();
+    const query = new URLSearchParams(this.resourceQuery);
+    const options = this.getOptions();
+    const poolSize = options.poolSize ?? 1;
+    const target = options.target ?? "browser";
+    if (target !== "browser" && target !== "node") {
+        done(new TypeError("target must be browser or node"));
+        return;
+    }
+    const hmr = options.hmr ?? "webpack";
+    if (hmr !== "webpack" && hmr !== "turbopack") {
+        done(new TypeError("hmr must be webpack or turbopack"));
+        return;
+    }
+    if (!Number.isInteger(poolSize) || poolSize < 1) {
+        done(new TypeError("poolSize must be a positive integer"));
+        return;
+    }
+    import("./transform.js").then(({ transform }) => {
+        const result = transform({ code: source, sourceId: this.resourcePath, query, poolSize, hmr, target, otel: options.otel, instrumentation: options.instrumentation, workerSetup: options.workerSetup, rootContext: this.rootContext,
+            inputMap: typeof inputMap === "string" ? inputMap : inputMap ? JSON.stringify(inputMap) : undefined });
+        done(null, result.code, result.map ? JSON.parse(result.map) : undefined);
+    }).catch(error => done(error instanceof Error ? error : new Error(String(error))));
+};

package/dist/loader.d.cts

@@ -0,0 +1,16 @@
+interface LoaderContext {
+    rootContext: string;
+    resourcePath: string;
+    resourceQuery: string;
+    getOptions(): {
+        otel?: boolean | "forward";
+        instrumentation?: string;
+        workerSetup?: string;
+        poolSize?: number;
+        target?: "browser" | "node";
+        hmr?: "webpack" | "turbopack";
+    };
+    async(): (error: Error | null, code?: string, map?: unknown) => void;
+}
+export = workerLoader;
+declare function workerLoader(this: LoaderContext, source: string, inputMap?: string | object): void;

package/dist/transform.d.ts

@@ -0,0 +1,13 @@
+export declare function transform({ code, sourceId, query, poolSize, hmr, target, inputMap, otel, workerSetup, instrumentation, rootContext }: {
+    otel?: boolean | "forward";
+    instrumentation?: string;
+    workerSetup?: string;
+    rootContext?: string;
+    code: string;
+    inputMap?: string;
+    sourceId: string;
+    query: URLSearchParams;
+    poolSize: number;
+    target: "browser" | "node";
+    hmr: "webpack" | "turbopack";
+}): import("@use-worker/compiler-estree").GeneratedModule;

package/dist/transform.js

@@ -0,0 +1,31 @@
+import { basename, dirname, relative, resolve } from "node:path";
+import { compileSource, createModuleWorkerEntry, mayContainWorkerDirective } from "@use-worker/oxc";
+export function transform({ code, sourceId, query, poolSize, hmr, target, inputMap, otel, workerSetup, instrumentation, rootContext }) {
+    if (!mayContainWorkerDirective(code) && !query.has("use-worker-entry") && !query.has("use-worker-implementation"))
+        return { code, map: inputMap ?? null };
+    const ownPath = `./${basename(sourceId)}`;
+    const linkage = {
+        instrumentation: instrumentation ? "./" + relative(dirname(sourceId), resolve(rootContext ?? process.cwd(), instrumentation)).replaceAll("\\", "/") : undefined,
+        otel, workerSetup: workerSetup ? "./" + relative(dirname(sourceId), resolve(rootContext ?? process.cwd(), workerSetup)).replaceAll("\\", "/") : undefined,
+        client: "@use-worker/core/internal/client-runtime",
+        worker: target === "node" ? "@use-worker/core/internal/node-worker" : "@use-worker/core/internal/worker-runtime",
+        hmr,
+    };
+    const result = compileSource({
+        code, sourceId, linkage, poolSize, inputMap, transformInline: true,
+        moduleImplementation: query.has("use-worker-implementation"),
+    });
+    const compilation = result.compilation;
+    if (!compilation)
+        return { code: result.code, map: result.map };
+    if (compilation.kind === "implementation")
+        return compilation.main;
+    if (query.has("use-worker-entry")) {
+        return compilation.kind === "inline" ? { code: compilation.workerCode, map: compilation.workerMap } :
+            { code: createModuleWorkerEntry(`${ownPath}?use-worker-implementation`, linkage.worker, linkage), map: null };
+    }
+    const specifier = `${ownPath}?use-worker-entry`;
+    return compilation.renderMain(target === "node"
+        ? { kind: "node", specifier, adapter: "@use-worker/core/internal/node-client" }
+        : { kind: "browser", specifier });
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@use-worker/query-loader",
+  "version": "0.1.0-beta.0",
+  "type": "module",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "THIRD_PARTY_NOTICES.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./loader": "./dist/loader.cjs"
+  },
+  "dependencies": {
+    "@use-worker/oxc": "0.1.0-beta.0",
+    "@use-worker/core": "0.1.0-beta.0"
+  },
+  "description": "Shared query-aware source loader for use-worker bundler integrations.",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-package.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}