@opencraw/cli 0.1.25 → 0.1.27

package/dist/index.esm.js

@@ -245,7 +245,8 @@ function parseArguments(argv, env = {}) {
         if (rest.length > 1) throw new Error('studio takes at most one folder');
         return {
           name: 'studio',
-          folder: rest[0]
+          folder: rest[0],
+          plugins: options.plugins
         };
       }
     default:
@@ -377,7 +378,7 @@ const PLUGIN_EXPORTS = ['hooks', 'accessPlugins', 'captchaSolvers'];
  * The module runs with the caller's privileges, like any code the caller
  * imports: point this only at a file you trust.
  *
- * @param path - A `.mjs` / `.js` / `.cjs` file.
+ * @param path - A `.mjs` / `.js` / `.cjs` file, or a `.ts` / `.mts` file on a Node that strips types (22.18+).
  * @param importModule - How to import it; `import()` unless a test says otherwise.
  * @returns The hooks and plugins.
  * @throws Error naming the file when it cannot be imported, provides nothing,
@@ -899,9 +900,11 @@ function loadErrorLines(error) {
  * @param folder - The recipe folder to open; `@opencraw/studio`'s own default (the current directory) when omitted.
  * @param terminal - Where output goes.
  * @param importStudio - How the module is loaded; the real dynamic `import()` by default, replaced in tests.
+ * @param pluginsFile - A hooks or plugins module (`--hooks`, issue #150), loaded here, on the command line's own authority, and handed to Studio: the server never loads code itself.
+ * @param load - How the module is read; `loadPlugins` unless a test says otherwise.
  * @returns The exit code: 0 once the server has stopped, 1 when `@opencraw/studio` is missing.
  */
-async function runStudio(folder, terminal, importStudio = () => import('@opencraw/studio')) {
+async function runStudio(folder, terminal, importStudio = () => import('@opencraw/studio'), pluginsFile, load = loadPlugins) {
   let studio;
   try {
     studio = await importStudio();
@@ -910,7 +913,13 @@ async function runStudio(folder, terminal, importStudio = () => import('@opencra
     terminal.err('the studio is not installed: run `npm install @opencraw/studio`, then try again');
     return 1;
   }
-  await studio.main(folder === undefined ? [] : [folder]);
+  const plugins = pluginsFile === undefined ? undefined : {
+    source: pluginsFile,
+    ...(await load(pluginsFile))
+  };
+  await studio.main(folder === undefined ? [] : [folder], {
+    plugins
+  });
   return 0;
 }
 function isModuleNotFound(error) {
@@ -1012,7 +1021,7 @@ async function main(argv, terminal) {
       }
     case 'studio':
       {
-        return runStudio(command.folder, terminal);
+        return runStudio(command.folder, terminal, undefined, command.plugins);
       }
   }
 }

package/dist/src/arguments/command.contract.d.ts

@@ -69,5 +69,7 @@ export type Command = {
     name: 'studio';
     /** The recipe folder to open; the current directory when not given. */
     folder?: string;
+    /** A hooks or plugins module to run recipes with (`--hooks`, `--plugins`, `OPENCRAW_HOOKS`, `OPENCRAW_PLUGINS`; issue #150). */
+    plugins?: string;
 };
 //# sourceMappingURL=command.contract.d.ts.map

package/dist/src/hooks-module/load-hooks.repository.d.ts

@@ -26,7 +26,7 @@ export interface PluginModule {
  * The module runs with the caller's privileges, like any code the caller
  * imports: point this only at a file you trust.
  *
- * @param path - A `.mjs` / `.js` / `.cjs` file.
+ * @param path - A `.mjs` / `.js` / `.cjs` file, or a `.ts` / `.mts` file on a Node that strips types (22.18+).
  * @param importModule - How to import it; `import()` unless a test says otherwise.
  * @returns The hooks and plugins.
  * @throws Error naming the file when it cannot be imported, provides nothing,

package/dist/src/studio/run-studio.use-case.d.ts

@@ -1,7 +1,13 @@
+import { loadPlugins } from '../hooks-module/index.js';
+import type { PluginModule } from '../hooks-module/index.js';
 import type { Terminal } from '../terminal/index.js';
 /** The one export the cli needs from `@opencraw/studio`. */
 export interface StudioModule {
-    main: (argv: readonly string[]) => Promise<void>;
+    main: (argv: readonly string[], options?: {
+        plugins?: PluginModule & {
+            source: string;
+        };
+    }) => Promise<void>;
 }
 /**
  * Runs `opencraw studio [folder]`: imports `@opencraw/studio` lazily and
@@ -16,7 +22,9 @@ export interface StudioModule {
  * @param folder - The recipe folder to open; `@opencraw/studio`'s own default (the current directory) when omitted.
  * @param terminal - Where output goes.
  * @param importStudio - How the module is loaded; the real dynamic `import()` by default, replaced in tests.
+ * @param pluginsFile - A hooks or plugins module (`--hooks`, issue #150), loaded here, on the command line's own authority, and handed to Studio: the server never loads code itself.
+ * @param load - How the module is read; `loadPlugins` unless a test says otherwise.
  * @returns The exit code: 0 once the server has stopped, 1 when `@opencraw/studio` is missing.
  */
-export declare function runStudio(folder: string | undefined, terminal: Terminal, importStudio?: () => Promise<StudioModule>): Promise<number>;
+export declare function runStudio(folder: string | undefined, terminal: Terminal, importStudio?: () => Promise<StudioModule>, pluginsFile?: string, load?: typeof loadPlugins): Promise<number>;
 //# sourceMappingURL=run-studio.use-case.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencraw/cli",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "type": "module",
   "main": "./dist/index.esm.js",
   "module": "./dist/index.esm.js",
@@ -24,12 +24,12 @@
     "!**/*.js.map"
   ],
   "dependencies": {
-    "@opencraw/core": "^0.1.25",
-    "@opencraw/probe": "^0.0.8",
+    "@opencraw/core": "^0.1.27",
+    "@opencraw/probe": "^0.0.10",
     "playwright": "^1.63.0"
   },
   "peerDependencies": {
-    "@opencraw/studio": "^0.0.14"
+    "@opencraw/studio": "^0.0.16"
   },
   "peerDependenciesMeta": {
     "@opencraw/studio": {