@sverka/playground 0.2.11 → 0.2.13

package/dist/index.d.mts

@@ -144,5 +144,68 @@ export declare function encodeShareLink(run: ShareableRun, base?: string): strin
  *  default template. */
 export declare function decodeShareLink(hash: string): ShareableRun;
 //#endregion
-export type { Construct, Finding, FindingSource, PipelineResult, PlaygroundErrorCode, PlaygroundFinding, Severity, ShareableRun, Step, StepResult };
+//#region src/embed.d.ts
+interface MountRunnerOptions {
+  /** Initial editor source. Defaults to the playground template. */
+  readonly code?: string;
+  /** Render the source as a fixed listing instead of an editable field. */
+  readonly readonly?: boolean;
+  /** Run `code` immediately on mount. Defaults to false — embed code may
+   *  come from a share link or CMS, so mounting never executes it unless
+   *  the embedder opts in or the user clicks Run. */
+  readonly autoRun?: boolean;
+  /** Called once per completed run. */
+  readonly onRun?: (result: PipelineResult) => void;
+}
+interface MountedRunner {
+  /** Remove the runner's DOM and listeners. */
+  dispose(): void;
+}
+/**
+ * Mount a self-contained runner inside `el`. `dispose()` tears the mount
+ * down. With `autoRun: true` the runner executes `code` once on mount;
+ * otherwise it waits for the Run button — embeds never auto-execute code
+ * the embedder didn't explicitly allow.
+ */
+export declare function mountRunner(el: HTMLElement, opts?: MountRunnerOptions): MountedRunner;
+//#endregion
+//#region src/engine.d.ts
+/** Default template shown in the editor. */
+export declare const DEFAULT_CODE: string;
+/**
+ * Evaluate user code and return the Project.
+ *
+ * SECURITY: This uses `new Function()` to execute user-provided code.
+ * This is intentional — the playground is a local development tool where
+ * the user writes and runs their own pipeline code. The code runs in the
+ * browser's main page context (not a sandboxed iframe or worker) because
+ * the playground needs to support synchronous FunctionStep execution and
+ * direct access to the pipeline constructs. This is the same trust model
+ * as a local REPL or `node -e`.
+ */
+export declare function evaluateUserCode(code: string): Project;
+/**
+ * Run a pipeline with a timeout. If a step returns a never-resolving
+ * promise, the timeout ensures the UI recovers instead of staying
+ * stuck in "Running" state forever.
+ */
+export declare function runPipelineWithTimeout(project: Project, timeoutMs: number): Promise<Awaited<ReturnType<typeof runPipeline>>>;
+//#endregion
+//#region src/transpile.d.ts
+/**
+ * Transpile playground source into `sverka.config.ts`.
+ *
+ * Rewrites the `@sverka/playground` import to `@sverka/workflow` and each
+ * `new FunctionStep(scope, "id", { fn, dependencies })` into a ShellStep
+ * whose command echoes a placeholder — the function body has no shell
+ * equivalent.
+ * `dependencies` maps onto `dependsOn`. Aliased FunctionStep imports
+ * (`FunctionStep as Fn`) are followed too.
+ *
+ * Throws `PlaygroundError(TRANSPILE_FAILED)` naming the offending step when
+ * a FunctionStep cannot be parsed — a half-converted file is never emitted.
+ */
+export declare function toSverkaConfig(source: string): string;
+//#endregion
+export type { Construct, Finding, FindingSource, MountRunnerOptions, MountedRunner, PipelineResult, PlaygroundErrorCode, PlaygroundFinding, Severity, ShareableRun, Step, StepResult };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/pipeline.ts","../src/runner.ts","../src/share.ts"],"mappings":";;KAGY;;UAGK;EACf;EACA;EACA;EACA;EACA;;;UAIe;EACf;EACA;EACA;EACA,UAAU;EACV;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;EACR;;;;UAKe;EACf;EACA;EACA;EACA,UAAU;EACV;EACA;EACA;;;UAIe;EACf;EACA;EACA,UAAU;EACV;EACA;;;UAIe;EACf,OAAO;EACP,UAAU;EACV;EACA;;;;;uBCrDoB;WACX;WACA,OAAO;EAEJ,YAAA,OAAO,kBAAkB;;MAMjC;;;qBASO,gBAAgB;WAClB,WAAW;EAER,YAAA;;EAKZ,YAAY,UAAU;;;qBAMX,iBAAiB;WACnB,OAAO;WACP,SAAS;EAEN,YAAA,SAAS,SAAS;;EAM9B,QAAQ,MAAM;;EAKd,SAAS,OAAO;;;uBAMI,aAAa;WACxB;EAEG,YAAA,UAAU,UAAU,YAAY;;WAOnC,WAAW,QAAQ,uBAAuB;;;qBAIxC,qBAAqB;WACvB,UAAU,QAAQ,uBAAuB;EAGhD,YAAA,UAAU,UACV,YACA;IACE,UAAU,QAAQ,uBAAuB;IACzC;;EAOJ,WAAW,QAAQ,uBAAuB;;;qBAM/B;WACF,UAAU;WACV;WACA;IAAW;;WACX;EAGP,YAAA,UAAU,UACV,YACA;IAAW;MAAW;;IAAgB;;;;;;;;;;;;;wBCtBpB,YAAY,SAAS,UAAU,QAAQ;;;UC3E5C;WACN;WACA;WACA,oBAAoB;;KAGnB;qBAGC,wBAAwB;WAC1B,MAAM;EACH,YAAA,MAAM,qBAAqB;;;qBAQ5B;;;wBAkFG,gBAAgB,KAAK,cAAc;;;;wBAkCnC,gBAAgB,eAAe"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/pipeline.ts","../src/runner.ts","../src/share.ts","../src/embed.ts","../src/engine.ts","../src/transpile.ts"],"mappings":";;KAGY;;UAGK;EACf;EACA;EACA;EACA;EACA;;;UAIe;EACf;EACA;EACA;EACA,UAAU;EACV;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;EACR;;;;UAKe;EACf;EACA;EACA;EACA,UAAU;EACV;EACA;EACA;;;UAIe;EACf;EACA;EACA,UAAU;EACV;EACA;;;UAIe;EACf,OAAO;EACP,UAAU;EACV;EACA;;;;;uBCrDoB;WACX;WACA,OAAO;EAEJ,YAAA,OAAO,kBAAkB;;MAMjC;;;qBASO,gBAAgB;WAClB,WAAW;EAER,YAAA;;EAKZ,YAAY,UAAU;;;qBAMX,iBAAiB;WACnB,OAAO;WACP,SAAS;EAEN,YAAA,SAAS,SAAS;;EAM9B,QAAQ,MAAM;;EAKd,SAAS,OAAO;;;uBAMI,aAAa;WACxB;EAEG,YAAA,UAAU,UAAU,YAAY;;WAOnC,WAAW,QAAQ,uBAAuB;;;qBAIxC,qBAAqB;WACvB,UAAU,QAAQ,uBAAuB;EAGhD,YAAA,UAAU,UACV,YACA;IACE,UAAU,QAAQ,uBAAuB;IACzC;;EAOJ,WAAW,QAAQ,uBAAuB;;;qBAM/B;WACF,UAAU;WACV;WACA;IAAW;;WACX;EAGP,YAAA,UAAU,UACV,YACA;IAAW;MAAW;;IAAgB;;;;;;;;;;;;;wBCtBpB,YAAY,SAAS,UAAU,QAAQ;;;UC3E5C;WACN;WACA;WACA,oBAAoB;;KAGnB;qBAGC,wBAAwB;WAC1B,MAAM;EACH,YAAA,MAAM,qBAAqB;;;qBAQ5B;;;wBAkFG,gBAAgB,KAAK,cAAc;;;;wBAkCnC,gBAAgB,eAAe;;;UC/H9B;;WAEN;;WAEA;;;;WAIA;;WAEA,SAAS,QAAQ;;UAGX;;EAEf;;;;;;;;wBAkKc,YACd,IAAI,aACJ,OAAM,qBACL;;;;qBC9KU;;;;;;;;;;;;wBAmWG,iBAAiB,eAAe;;;;;;wBAqB1B,uBACpB,SAAS,SACT,oBACC,QAAQ,QAAQ,kBAAkB;;;;;;;;;;;;;;;;wBCqCrB,eAAe"}