@mysten-incubation/devstack 0.0.0

package/LICENSE

@@ -0,0 +1,189 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for describing the origin of the Work and
+      reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may accept and charge a
+      fee for, or grant additional or different rights or obligations
+      consistent with this License. However, in accepting such obligations,
+      You may act only on Your own behalf and on Your sole responsibility,
+      not on behalf of any other Contributor, and only if You agree to
+      indemnify, defend, and hold each Contributor harmless for any
+      liability incurred by, or claims asserted against, such Contributor
+      by reason of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 Mysten Labs, Inc.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,94 @@
+# @mysten-incubation/devstack
+
+Devstack composes a local Sui development environment from one TypeScript config. It can boot Sui,
+fund accounts, publish Move packages, run the dev wallet, start app servers, wire services such as
+Walrus, Seal, and DeepBook, and generate typed files for app and test code.
+
+This package is still prototype-stage inside the monorepo and is not published to npm yet. The
+current docs live at <https://ts-sdks-incubation.vercel.app/devstack>.
+
+## Quick Start
+
+Create a `devstack.config.ts` in your app:
+
+```ts
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import {
+	account,
+	defineDevstack,
+	HOST_SERVICE_PORT_TOKEN,
+	hostService,
+	localPackage,
+	sui,
+	wallet,
+} from '@mysten-incubation/devstack';
+
+const HERE = dirname(fileURLToPath(import.meta.url));
+const DEV_PORT = 5173;
+
+const localnet = sui();
+const publisher = account('publisher');
+const alice = account('alice');
+
+const hello = localPackage('hello', {
+	sourcePath: resolve(HERE, 'move/hello'),
+	publisher,
+});
+
+const devWallet = wallet({
+	accounts: [publisher, alice],
+});
+
+const app = hostService({
+	name: 'app',
+	script: `pnpm exec vite --host 127.0.0.1 --strictPort --port ${HOST_SERVICE_PORT_TOKEN}`,
+	cwd: HERE,
+	port: DEV_PORT,
+	ready: { kind: 'http' },
+	after: [hello, devWallet] as const,
+});
+
+export default defineDevstack({
+	members: [localnet, app],
+	stackName: 'main',
+	codegen: { outputDir: 'src/generated' },
+});
+```
+
+Run the stack during development:
+
+```bash
+pnpm devstack up
+```
+
+Reconcile from another shell, CI, or before typechecking, building, or tests:
+
+```bash
+pnpm devstack apply
+```
+
+If `pnpm devstack up` is already live for this stack, `apply` asks that supervisor to reconcile and
+waits for completion. Without a live supervisor, it runs one-shot setup and exits.
+
+Generated files are written under `src/generated` by default. Runtime state, manifests, snapshots,
+and logs stay under `.devstack/`.
+
+## Package Surface
+
+- Root API: stack composition, built-in factories, plugin-author helpers, and public types.
+- CLI: `devstack up`, `apply`, `status`, `doctor`, `config`, `schema --json`, `snapshot`, `prune`,
+  and `wipe`.
+- Build integrations: `@mysten-incubation/devstack/vitest`, `/playwright`, and `/runtime`.
+
+App code should consume generated files and the runtime manifest. It should not import devstack
+engine internals directly.
+
+## Docs
+
+- [Quickstart](https://ts-sdks-incubation.vercel.app/devstack/quickstart)
+- [Local development](https://ts-sdks-incubation.vercel.app/devstack/features/local-dev)
+- [Vitest integration](https://ts-sdks-incubation.vercel.app/devstack/features/testing-vitest)
+- [Playwright integration](https://ts-sdks-incubation.vercel.app/devstack/features/testing-playwright)
+- [Services](https://ts-sdks-incubation.vercel.app/devstack/features/services)

package/dist/_virtual/_rolldown/runtime.mjs

@@ -0,0 +1,13 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+export { __exportAll };

package/dist/api/define-capabilities.d.mts

@@ -0,0 +1,25 @@
+import { CodegenableDecl } from "../contracts/codegenable.mjs";
+import { ProjectionDecl } from "../contracts/projection.mjs";
+import { RoutableDecl } from "../contracts/routable.mjs";
+import { SnapshotableDecl } from "../contracts/snapshotable.mjs";
+import { StrategyContributorDecl } from "../contracts/strategy-contributor.mjs";
+import { CapabilityDecl, CapabilityKind, CapabilityPayloadFor, ExactCapabilityPayload } from "../contracts/capability-decl.mjs";
+import { CapabilitySink, ContributionKind, HarvestContext } from "../substrate/runtime/capability-sinks/service.mjs";
+import { Effect, Scope } from "effect";
+
+//#region src/api/define-capabilities.d.ts
+declare const capability: <const Kind extends string, const Data extends CapabilityPayloadFor<Kind>>(kind: Kind, data: Data & ExactCapabilityPayload<Kind, Data>) => CapabilityDecl<Kind> & Readonly<Data>;
+declare const defineCapability: <const Kind extends string>(kind: Kind) => <const Data extends CapabilityPayloadFor<Kind>>(data: Data & ExactCapabilityPayload<Kind, Data>) => CapabilityDecl<Kind> & Readonly<Data>;
+declare const codegenable: <const Emitter extends string>(decl: Omit<CodegenableDecl<Emitter>, "kind">) => CodegenableDecl<Emitter>;
+declare const snapshotable: (decl: Omit<SnapshotableDecl, "kind">) => SnapshotableDecl;
+declare const routable: (decl: Omit<RoutableDecl, "kind">) => RoutableDecl;
+declare const projection: (decl: Omit<ProjectionDecl, "kind">) => ProjectionDecl;
+declare const strategyContributor: <const Key extends string, Strategy>(decl: Omit<StrategyContributorDecl<Key, Strategy>, "kind">) => StrategyContributorDecl<Key, Strategy>;
+declare const capabilitySink: <const Kind extends ContributionKind, Decl extends (Kind extends CapabilityKind ? Extract<CapabilityDecl, {
+  readonly kind: Kind;
+}> : Readonly<{
+  readonly kind: Kind;
+} & object>)>(kind: Kind, accept: (decl: Decl, ctx: HarvestContext) => Effect.Effect<void, never, Scope.Scope>) => CapabilitySink<Kind, Decl>;
+//#endregion
+export { capability, capabilitySink, codegenable, defineCapability, projection, routable, snapshotable, strategyContributor };
+//# sourceMappingURL=define-capabilities.d.mts.map

package/dist/api/define-capabilities.mjs

@@ -0,0 +1,19 @@
+//#region src/api/define-capabilities.ts
+const capability = (kind, data) => ({
+	...data,
+	kind
+});
+const defineCapability = (kind) => (data) => capability(kind, data);
+const codegenable = (decl) => capability("codegenable", decl);
+const snapshotable = (decl) => capability("snapshotable", decl);
+const routable = (decl) => capability("routable", decl);
+const projection = (decl) => capability("projection", decl);
+const strategyContributor = (decl) => capability("strategy-contributor", decl);
+const capabilitySink = (kind, accept) => ({
+	kind,
+	accept
+});
+//#endregion
+export { capability, capabilitySink, codegenable, defineCapability, projection, routable, snapshotable, strategyContributor };
+
+//# sourceMappingURL=define-capabilities.mjs.map

package/dist/api/define-capabilities.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-capabilities.mjs","names":[],"sources":["../../src/api/define-capabilities.ts"],"sourcesContent":["// Typed capability helpers. Plugin authors return plain capability\n// arrays from `definePlugin({ capabilities })`; these helpers add the\n// discriminant while preserving narrow payload types.\n\nimport type {\n\tCapabilityDecl,\n\tCapabilityKind,\n\tCapabilityPayloadFor,\n\tExactCapabilityPayload,\n} from '../contracts/capability-decl.ts';\nimport type { CodegenableDecl } from '../contracts/codegenable.ts';\nimport type { ProjectionDecl } from '../contracts/projection.ts';\nimport type { RoutableDecl } from '../contracts/routable.ts';\nimport type { SnapshotableDecl } from '../contracts/snapshotable.ts';\nimport type { StrategyContributorDecl } from '../contracts/strategy-contributor.ts';\nimport type {\n\tCapabilitySink,\n\tContributionKind,\n\tHarvestContext,\n} from '../substrate/runtime/capability-sinks/service.ts';\nimport type { Effect, Scope } from 'effect';\n\nexport const capability = <\n\tconst Kind extends string,\n\tconst Data extends CapabilityPayloadFor<Kind>,\n>(\n\tkind: Kind,\n\tdata: Data & ExactCapabilityPayload<Kind, Data>,\n): CapabilityDecl<Kind> & Readonly<Data> =>\n\t({\n\t\t...data,\n\t\tkind,\n\t}) as CapabilityDecl<Kind> & Readonly<Data>;\n\nexport const defineCapability =\n\t<const Kind extends string>(kind: Kind) =>\n\t<const Data extends CapabilityPayloadFor<Kind>>(\n\t\tdata: Data & ExactCapabilityPayload<Kind, Data>,\n\t) =>\n\t\tcapability<Kind, Data>(kind, data);\n\nexport const codegenable = <const Emitter extends string>(\n\tdecl: Omit<CodegenableDecl<Emitter>, 'kind'>,\n): CodegenableDecl<Emitter> => capability('codegenable', decl);\n\nexport const snapshotable = (decl: Omit<SnapshotableDecl, 'kind'>): SnapshotableDecl =>\n\tcapability('snapshotable', decl);\n\nexport const routable = (decl: Omit<RoutableDecl, 'kind'>): RoutableDecl =>\n\tcapability('routable', decl) as RoutableDecl;\n\nexport const projection = (decl: Omit<ProjectionDecl, 'kind'>): ProjectionDecl =>\n\tcapability('projection', decl);\n\nexport const strategyContributor = <const Key extends string, Strategy>(\n\tdecl: Omit<StrategyContributorDecl<Key, Strategy>, 'kind'>,\n): StrategyContributorDecl<Key, Strategy> => capability('strategy-contributor', decl);\n\nexport const capabilitySink = <\n\tconst Kind extends ContributionKind,\n\tDecl extends Kind extends CapabilityKind\n\t\t? Extract<CapabilityDecl, { readonly kind: Kind }>\n\t\t: Readonly<{ readonly kind: Kind } & object>,\n>(\n\tkind: Kind,\n\taccept: (decl: Decl, ctx: HarvestContext) => Effect.Effect<void, never, Scope.Scope>,\n): CapabilitySink<Kind, Decl> => ({ kind, accept });\n"],"mappings":";AAsBA,MAAa,cAIZ,MACA,UAEC;CACA,GAAG;CACH;CACA;AAEF,MAAa,oBACgB,UAE3B,SAEA,WAAuB,MAAM,KAAK;AAEpC,MAAa,eACZ,SAC8B,WAAW,eAAe,KAAK;AAE9D,MAAa,gBAAgB,SAC5B,WAAW,gBAAgB,KAAK;AAEjC,MAAa,YAAY,SACxB,WAAW,YAAY,KAAK;AAE7B,MAAa,cAAc,SAC1B,WAAW,cAAc,KAAK;AAE/B,MAAa,uBACZ,SAC4C,WAAW,wBAAwB,KAAK;AAErF,MAAa,kBAMZ,MACA,YACiC;CAAE;CAAM;CAAQ"}

package/dist/api/define-devstack-with.d.mts

@@ -0,0 +1,41 @@
+import { AnyPlugin, MissingProviders, __MissingProvidersError } from "../substrate/plugin.mjs";
+import { NetworkConfig, NetworkMode } from "../substrate/network.mjs";
+import { DevstackOptions } from "../substrate/options.mjs";
+import { ComposedMembers, Stack } from "./define-devstack.mjs";
+
+//#region src/api/define-devstack-with.d.ts
+/**
+ * Build context handed to the callback. The `network` field carries
+ * the resolved-narrow `NetworkConfig`; mode-narrowed factories that
+ * take `(network)` recover the discriminator at the type level.
+ */
+interface BuildCtx<Mode extends NetworkMode> {
+  readonly network: NetworkConfig<Mode>;
+}
+/** Options bag for the callback form. `network` MUST be present so the
+ *  callback's `BuildCtx` is typed. */
+interface DevstackOptionsWith<Mode extends NetworkMode> extends DevstackOptions {
+  readonly network: NetworkConfig<Mode>;
+}
+/** Validation gate. Mirrors the flat-form rule: resolves to the
+ *  caller's `Members` tuple on a clean check, branded error
+ *  otherwise.
+ *
+ *  Validation runs against the recursively expanded tuple
+ *  (`ComposedMembers<Members>`) so plugin-valued dependencies are
+ *  included before missing-provider checks. Bare resource dependencies
+ *  still require an explicit provider in the returned member tuple. */
+type ValidateBuild<Members> = Members extends ReadonlyArray<AnyPlugin> ? ComposedMembers<Members> extends infer M ? M extends ReadonlyArray<unknown> ? [MissingProviders<M>] extends [never] ? Members : __MissingProvidersError<MissingProviders<M>> : never : never : never;
+/**
+ * Callback-form devstack composer. The first arg is the options bag
+ * (including the mode-narrow `network`); the second is a builder that
+ * receives a `BuildCtx<Mode>` and returns the member tuple.
+ *
+ * The `Mode` generic is inferred from `options.network.mode`; the
+ * callback's `BuildCtx` carries it, and plugin factories that accept
+ * the narrowed network see the matching branch only.
+ */
+declare function defineDevstackWith<Mode extends NetworkMode, Members extends ReadonlyArray<AnyPlugin>>(options: DevstackOptionsWith<Mode>, build: (ctx: BuildCtx<Mode>) => ValidateBuild<Members>): Stack<ComposedMembers<Members>>;
+//#endregion
+export { BuildCtx, DevstackOptionsWith, defineDevstackWith };
+//# sourceMappingURL=define-devstack-with.d.mts.map

package/dist/api/define-devstack-with.mjs

@@ -0,0 +1,24 @@
+import { isPlugin } from "../substrate/plugin.mjs";
+import { defineDevstack } from "./define-devstack.mjs";
+//#region src/api/define-devstack-with.ts
+/**
+* Callback-form devstack composer. The first arg is the options bag
+* (including the mode-narrow `network`); the second is a builder that
+* receives a `BuildCtx<Mode>` and returns the member tuple.
+*
+* The `Mode` generic is inferred from `options.network.mode`; the
+* callback's `BuildCtx` carries it, and plugin factories that accept
+* the narrowed network see the matching branch only.
+*/
+function defineDevstackWith(options, build) {
+	const rawMembers = build({ network: options.network });
+	for (const m of rawMembers) if (!isPlugin(m)) throw new Error("defineDevstackWith: builder returned a value that is not a plugin member (missing plugin brand). Did you forget to wrap it with definePlugin?");
+	return defineDevstack({
+		...options,
+		members: rawMembers
+	});
+}
+//#endregion
+export { defineDevstackWith };
+
+//# sourceMappingURL=define-devstack-with.mjs.map

package/dist/api/define-devstack-with.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-devstack-with.mjs","names":[],"sources":["../../src/api/define-devstack-with.ts"],"sourcesContent":["// `defineDevstackWith` — callback form.\n//\n// Architecture § Programmable API: the canonical surface when one or\n// more plugin factories need mode-narrowing. The callback receives a\n// `BuildCtx` whose `network` is the resolved-narrow `NetworkConfig`;\n// plugin-author factories that take `(network)` recover the mode\n// discriminator structurally, and the compiler refuses illegal-mode\n// factory access at the call site.\n\nimport { isPlugin, type AnyPlugin } from '../substrate/plugin.ts';\nimport type { DevstackOptions } from '../substrate/options.ts';\nimport type { NetworkConfig, NetworkMode } from '../substrate/network.ts';\nimport type { __MissingProvidersError, MissingProviders } from '../substrate/plugin.ts';\nimport { defineDevstack, type ComposedMembers, type Stack } from './define-devstack.ts';\n\n// --- Callback context ---------------------------------------------------\n\n/**\n * Build context handed to the callback. The `network` field carries\n * the resolved-narrow `NetworkConfig`; mode-narrowed factories that\n * take `(network)` recover the discriminator at the type level.\n */\nexport interface BuildCtx<Mode extends NetworkMode> {\n\treadonly network: NetworkConfig<Mode>;\n}\n\n/** Options bag for the callback form. `network` MUST be present so the\n *  callback's `BuildCtx` is typed. */\nexport interface DevstackOptionsWith<Mode extends NetworkMode> extends DevstackOptions {\n\treadonly network: NetworkConfig<Mode>;\n}\n\n/** Validation gate. Mirrors the flat-form rule: resolves to the\n *  caller's `Members` tuple on a clean check, branded error\n *  otherwise.\n *\n *  Validation runs against the recursively expanded tuple\n *  (`ComposedMembers<Members>`) so plugin-valued dependencies are\n *  included before missing-provider checks. Bare resource dependencies\n *  still require an explicit provider in the returned member tuple. */\ntype ValidateBuild<Members> =\n\tMembers extends ReadonlyArray<AnyPlugin>\n\t\t? ComposedMembers<Members> extends infer M\n\t\t\t? M extends ReadonlyArray<unknown>\n\t\t\t\t? [MissingProviders<M>] extends [never]\n\t\t\t\t\t? Members\n\t\t\t\t\t: __MissingProvidersError<MissingProviders<M>>\n\t\t\t\t: never\n\t\t\t: never\n\t\t: never;\n\n// --- Public surface -----------------------------------------------------\n\n/**\n * Callback-form devstack composer. The first arg is the options bag\n * (including the mode-narrow `network`); the second is a builder that\n * receives a `BuildCtx<Mode>` and returns the member tuple.\n *\n * The `Mode` generic is inferred from `options.network.mode`; the\n * callback's `BuildCtx` carries it, and plugin factories that accept\n * the narrowed network see the matching branch only.\n */\nexport function defineDevstackWith<\n\tMode extends NetworkMode,\n\tMembers extends ReadonlyArray<AnyPlugin>,\n>(\n\toptions: DevstackOptionsWith<Mode>,\n\tbuild: (ctx: BuildCtx<Mode>) => ValidateBuild<Members>,\n): Stack<ComposedMembers<Members>> {\n\tconst rawMembers = build({ network: options.network }) as ReadonlyArray<AnyPlugin>;\n\n\t// Defensive runtime check: every element returned by the builder\n\t// must be a plugin resource. Type system enforces this, but a\n\t// runtime check guards against `as unknown as AnyPlugin` casts.\n\tfor (const m of rawMembers) {\n\t\tif (!isPlugin(m)) {\n\t\t\tthrow new Error(\n\t\t\t\t'defineDevstackWith: builder returned a value that is not a plugin member ' +\n\t\t\t\t\t'(missing plugin brand). Did you forget to wrap it with definePlugin?',\n\t\t\t);\n\t\t}\n\t}\n\n\treturn defineDevstack({ ...options, members: rawMembers }) as unknown as Stack<\n\t\tComposedMembers<Members>\n\t>;\n}\n"],"mappings":";;;;;;;;;;;;AA8DA,SAAgB,mBAIf,SACA,OACkC;CAClC,MAAM,aAAa,MAAM,EAAE,SAAS,QAAQ,SAAS,CAAC;AAKtD,MAAK,MAAM,KAAK,WACf,KAAI,CAAC,SAAS,EAAE,CACf,OAAM,IAAI,MACT,gJAEA;AAIH,QAAO,eAAe;EAAE,GAAG;EAAS,SAAS;EAAY,CAAC"}

package/dist/api/define-devstack.d.mts

@@ -0,0 +1,62 @@
+import { AnyPlugin, MissingProviders, __MissingProvidersError } from "../substrate/plugin.mjs";
+import { DevstackOptions } from "../substrate/options.mjs";
+
+//#region src/api/define-devstack.d.ts
+type PluginDependencyMembers<Member> = Member extends {
+  readonly dependsOn: ReadonlyArray<infer Dependency>;
+} ? Dependency extends AnyPlugin ? Dependency : never : never;
+type ReachableMember<Member, Seen extends string = never> = Member extends {
+  readonly id: infer Id extends string;
+} ? Id extends Seen ? never : Member | ReachableMember<PluginDependencyMembers<Member>, Seen | Id> : never;
+type DependencyClosure<Members extends ReadonlyArray<AnyPlugin>> = ReadonlyArray<Members[number] extends infer Member ? ReachableMember<Member> : never>;
+type ComposedMembers<Members extends ReadonlyArray<AnyPlugin>> = DependencyClosure<Members>;
+interface DevstackConfig<Members extends ReadonlyArray<AnyPlugin>> extends DevstackOptions {
+  readonly members: Members;
+}
+/**
+ * The compile-time stack handle. Carries:
+ *  - the plugin tuple (narrow),
+ *  - the union of resource ids it provides,
+ *  - an opaque marker the orchestrator boot path consumes.
+ *
+ * The runtime value is a struct; orchestrators consume it through
+ * the supervisor entry point.
+ */
+interface Stack<Members extends ReadonlyArray<AnyPlugin> = ReadonlyArray<AnyPlugin>> {
+  readonly _tag: 'Stack';
+  readonly options: DevstackOptions;
+  /** Phantom — preserves the union of provided ids for downstream
+   *  introspection. Covariant per the phantom-variance rule. */
+  readonly _providedIds?: () => { [K in keyof Members]: Members[K]['id'] }[number];
+}
+/** Validation gate. Resolves to `unknown` when every check passes
+ *  (assignable to any `Args`); to a branded structured error
+ *  otherwise (not assignable, surfacing the field name in the IDE).
+ *  UNCONSTRAINED Members — every helper sidesteps constraint widening
+ *  via an internal `Members extends ReadonlyArray<unknown> ? ... : never`
+ *  shape (Phase-3 finding).
+ *
+ *  IMPORTANT: validation runs against the recursively expanded member
+ *  tuple (`ComposedMembers<Members>`). Bare resource dependencies must
+ *  have an explicit provider in the stack; plugin-valued dependencies
+ *  are pulled in by the closure first. */
+type ValidateArgs<Members> = Members extends ReadonlyArray<AnyPlugin> ? ComposedMembers<Members> extends infer M ? M extends ReadonlyArray<unknown> ? [MissingProviders<M>] extends [never] ? unknown : __MissingProvidersError<MissingProviders<M>> : never : never : never;
+/**
+ * Object-form devstack composer.
+ *
+ * Compile-time checks performed:
+ *   - missing-provider: every dependency id has a matching plugin id
+ *     somewhere in the plugin set.
+ *
+ * Validation surfaces at the PARAMETER (not the return type) — the
+ * generic `Args` is constrained against a branded error type whose
+ * field name names the missing piece (type-prototype finding #6,
+ * architecture open question #11). Failed validation makes the
+ * config type un-assignable, surfacing as the standard
+ * "not assignable to parameter of type" diagnostic with the branded
+ * error field visible in the IDE.
+ */
+declare function defineDevstack<const Members extends ReadonlyArray<AnyPlugin>>(config: DevstackConfig<Members> & ValidateArgs<Members>): Stack<ComposedMembers<Members>>;
+//#endregion
+export { ComposedMembers, Stack, defineDevstack };
+//# sourceMappingURL=define-devstack.d.mts.map

package/dist/api/define-devstack.mjs

@@ -0,0 +1,108 @@
+import { isPlugin, pluginDependencyRefs } from "../substrate/plugin.mjs";
+import { WALLET_EXPAND_ACCOUNTS_ALL } from "../plugins/wallet/index.mjs";
+//#region src/api/define-devstack.ts
+const STACK_ENGINE = Symbol.for("@mysten-incubation/devstack.stack.engine");
+const ACCOUNT_RESOURCE_PREFIX = "account/";
+const readStackEngine = (stack) => {
+	const engine = stack[STACK_ENGINE];
+	if (engine === void 0) throw new Error("Invalid devstack Stack handle: missing internal engine stack");
+	return engine;
+};
+/**
+* Object-form devstack composer.
+*
+* Compile-time checks performed:
+*   - missing-provider: every dependency id has a matching plugin id
+*     somewhere in the plugin set.
+*
+* Validation surfaces at the PARAMETER (not the return type) — the
+* generic `Args` is constrained against a branded error type whose
+* field name names the missing piece (type-prototype finding #6,
+* architecture open question #11). Failed validation makes the
+* config type un-assignable, surfacing as the standard
+* "not assignable to parameter of type" diagnostic with the branded
+* error field visible in the IDE.
+*/
+function defineDevstack(config) {
+	const members = expandPluginDependencies(expandWalletAccountsAll(expandPluginDependencies(config.members)));
+	const { members: _members, ...options } = config;
+	const engine = {
+		_tag: "Stack",
+		members,
+		options
+	};
+	const stack = {
+		_tag: "Stack",
+		options
+	};
+	Object.defineProperty(stack, STACK_ENGINE, {
+		value: engine,
+		enumerable: false,
+		configurable: false,
+		writable: false
+	});
+	return stack;
+}
+const expandPluginDependencies = (members) => {
+	const expanded = [];
+	const seen = /* @__PURE__ */ new Map();
+	const accountNameByCaseFold = /* @__PURE__ */ new Map();
+	const visiting = /* @__PURE__ */ new Set();
+	const visit = (member) => {
+		const id = member.id;
+		const previous = seen.get(id);
+		if (previous === member) return;
+		if (previous !== void 0) {
+			if (isExpandedWalletAlias(previous, member)) return;
+			throw new Error(`Duplicate devstack provider for ${id}`);
+		}
+		const accountName = accountNameFromResourceId(id);
+		if (accountName !== null) {
+			const caseFoldedName = accountName.toLowerCase();
+			const previousAccountName = accountNameByCaseFold.get(caseFoldedName);
+			if (previousAccountName !== void 0 && previousAccountName !== accountName) throw new Error(`Duplicate devstack account name '${accountName}' differs only by casing from '${previousAccountName}'`);
+			accountNameByCaseFold.set(caseFoldedName, accountName);
+		}
+		if (visiting.has(id)) throw new Error(`Circular devstack dependency through ${id}`);
+		visiting.add(id);
+		if (isPlugin(member)) {
+			for (const dependency of pluginDependencyRefs(member)) if (isPlugin(dependency)) visit(dependency);
+		}
+		visiting.delete(id);
+		seen.set(id, member);
+		expanded.push(member);
+	};
+	for (const member of members) visit(member);
+	return expanded;
+};
+const isExpandedWalletAlias = (a, b) => a.id === b.id && (readExpandHook(a) !== void 0 || readExpandHook(b) !== void 0);
+const accountNameFromResourceId = (id) => {
+	if (!id.startsWith(ACCOUNT_RESOURCE_PREFIX)) return null;
+	return id.slice(8);
+};
+function readExpandHook(m) {
+	const slot = m[WALLET_EXPAND_ACCOUNTS_ALL];
+	return typeof slot === "function" ? slot : void 0;
+}
+/** Expand any `wallet({ accounts: 'all' })` placeholder plugin into a
+*  real wallet plugin whose dependencies include every account plugin.
+*  Returns the input array verbatim when no expansion is
+*  needed (zero allocation on the common explicit-tuple path). */
+function expandWalletAccountsAll(members) {
+	let needsExpansion = false;
+	for (const m of members) if (readExpandHook(m) !== void 0) {
+		needsExpansion = true;
+		break;
+	}
+	if (!needsExpansion) return members;
+	const accountMembers = [];
+	for (const m of members) if (m.id.startsWith(ACCOUNT_RESOURCE_PREFIX)) accountMembers.push(m);
+	return members.map((m) => {
+		const expand = readExpandHook(m);
+		return expand === void 0 ? m : expand(accountMembers);
+	});
+}
+//#endregion
+export { defineDevstack, readStackEngine };
+
+//# sourceMappingURL=define-devstack.mjs.map

package/dist/api/define-devstack.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-devstack.mjs","names":[],"sources":["../../src/api/define-devstack.ts"],"sourcesContent":["// `defineDevstack` — object-form stack composer.\n//\n// Listed members are entrypoints. Plugin-valued dependencies are\n// expanded recursively before the engine sees the plugin list.\n\nimport {\n\ttype __MissingProvidersError,\n\ttype AnyPlugin,\n\ttype MissingProviders,\n\tpluginDependencyRefs,\n} from '../substrate/plugin.ts';\nimport type { DevstackOptions } from '../substrate/options.ts';\nimport {\n\tWALLET_EXPAND_ACCOUNTS_ALL,\n\ttype WalletExpandAccountsAllExpander,\n} from '../plugins/wallet/index.ts';\nimport type { WalletAccountMember } from '../plugins/wallet/index.ts';\nimport { isPlugin, type AnyResourceRef } from './define-plugin.ts';\n\n// --- Type-level helpers -------------------------------------------------\n\nconst STACK_ENGINE = Symbol.for('@mysten-incubation/devstack.stack.engine');\n\ntype PluginDependencyMembers<Member> = Member extends {\n\treadonly dependsOn: ReadonlyArray<infer Dependency>;\n}\n\t? Dependency extends AnyPlugin\n\t\t? Dependency\n\t\t: never\n\t: never;\n\ntype ReachableMember<Member, Seen extends string = never> = Member extends {\n\treadonly id: infer Id extends string;\n}\n\t? Id extends Seen\n\t\t? never\n\t\t: Member | ReachableMember<PluginDependencyMembers<Member>, Seen | Id>\n\t: never;\n\nexport type DependencyClosure<Members extends ReadonlyArray<AnyPlugin>> = ReadonlyArray<\n\tMembers[number] extends infer Member ? ReachableMember<Member> : never\n>;\n\nexport type ComposedMembers<Members extends ReadonlyArray<AnyPlugin>> = DependencyClosure<Members>;\n\nexport interface DevstackConfig<Members extends ReadonlyArray<AnyPlugin>> extends DevstackOptions {\n\treadonly members: Members;\n}\n\nconst ACCOUNT_RESOURCE_PREFIX = 'account/';\n\n// --- Stack handle -------------------------------------------------------\n\n/**\n * The compile-time stack handle. Carries:\n *  - the plugin tuple (narrow),\n *  - the union of resource ids it provides,\n *  - an opaque marker the orchestrator boot path consumes.\n *\n * The runtime value is a struct; orchestrators consume it through\n * the supervisor entry point.\n */\nexport interface Stack<Members extends ReadonlyArray<AnyPlugin> = ReadonlyArray<AnyPlugin>> {\n\treadonly _tag: 'Stack';\n\treadonly options: DevstackOptions;\n\t/** Phantom — preserves the union of provided ids for downstream\n\t *  introspection. Covariant per the phantom-variance rule. */\n\treadonly _providedIds?: () => {\n\t\t[K in keyof Members]: Members[K]['id'];\n\t}[number];\n}\n\nexport interface StackEngine<Members extends ReadonlyArray<AnyPlugin> = ReadonlyArray<AnyPlugin>> {\n\treadonly _tag: 'Stack';\n\treadonly members: Members;\n\treadonly options: DevstackOptions;\n}\n\nexport const readStackEngine = <Members extends ReadonlyArray<AnyPlugin>>(\n\tstack: Stack<Members>,\n): StackEngine<Members> => {\n\tconst engine = (stack as unknown as Readonly<Record<symbol, StackEngine<Members> | undefined>>)[\n\t\tSTACK_ENGINE\n\t];\n\tif (engine === undefined) {\n\t\tthrow new Error('Invalid devstack Stack handle: missing internal engine stack');\n\t}\n\treturn engine;\n};\n\n// --- Diagnostic gating --------------------------------------------------\n//\n// If `MissingProviders` is non-empty, the call signature surfaces a\n// branded structured error so the IDE diagnostic names the missing\n// piece.\n\n/** Validation gate. Resolves to `unknown` when every check passes\n *  (assignable to any `Args`); to a branded structured error\n *  otherwise (not assignable, surfacing the field name in the IDE).\n *  UNCONSTRAINED Members — every helper sidesteps constraint widening\n *  via an internal `Members extends ReadonlyArray<unknown> ? ... : never`\n *  shape (Phase-3 finding).\n *\n *  IMPORTANT: validation runs against the recursively expanded member\n *  tuple (`ComposedMembers<Members>`). Bare resource dependencies must\n *  have an explicit provider in the stack; plugin-valued dependencies\n *  are pulled in by the closure first. */\nexport type ValidateArgs<Members> =\n\tMembers extends ReadonlyArray<AnyPlugin>\n\t\t? ComposedMembers<Members> extends infer M\n\t\t\t? M extends ReadonlyArray<unknown>\n\t\t\t\t? [MissingProviders<M>] extends [never]\n\t\t\t\t\t? unknown\n\t\t\t\t\t: __MissingProvidersError<MissingProviders<M>>\n\t\t\t\t: never\n\t\t\t: never\n\t\t: never;\n\n// --- Public surface -----------------------------------------------------\n\n/**\n * Object-form devstack composer.\n *\n * Compile-time checks performed:\n *   - missing-provider: every dependency id has a matching plugin id\n *     somewhere in the plugin set.\n *\n * Validation surfaces at the PARAMETER (not the return type) — the\n * generic `Args` is constrained against a branded error type whose\n * field name names the missing piece (type-prototype finding #6,\n * architecture open question #11). Failed validation makes the\n * config type un-assignable, surfacing as the standard\n * \"not assignable to parameter of type\" diagnostic with the branded\n * error field visible in the IDE.\n */\nexport function defineDevstack<const Members extends ReadonlyArray<AnyPlugin>>(\n\tconfig: DevstackConfig<Members> & ValidateArgs<Members>,\n): Stack<ComposedMembers<Members>> {\n\tconst roots = expandPluginDependencies(config.members);\n\tconst expandedWallet = expandWalletAccountsAll(roots);\n\tconst members = expandPluginDependencies(expandedWallet);\n\tconst { members: _members, ...options } = config;\n\tvoid _members;\n\n\tconst engine: StackEngine<ReadonlyArray<AnyPlugin>> = {\n\t\t_tag: 'Stack',\n\t\tmembers,\n\t\toptions,\n\t};\n\tconst stack: Stack<ReadonlyArray<AnyPlugin>> = {\n\t\t_tag: 'Stack',\n\t\toptions,\n\t};\n\tObject.defineProperty(stack, STACK_ENGINE, {\n\t\tvalue: engine,\n\t\tenumerable: false,\n\t\tconfigurable: false,\n\t\twritable: false,\n\t});\n\n\treturn stack as unknown as Stack<ComposedMembers<Members>>;\n}\n\nexport const expandPluginDependencies = (\n\tmembers: ReadonlyArray<AnyPlugin>,\n): ReadonlyArray<AnyPlugin> => {\n\tconst expanded: AnyPlugin[] = [];\n\tconst seen = new Map<string, AnyPlugin>();\n\tconst accountNameByCaseFold = new Map<string, string>();\n\tconst visiting = new Set<string>();\n\n\tconst visit = (member: AnyPlugin) => {\n\t\tconst id = member.id;\n\t\tconst previous = seen.get(id);\n\t\tif (previous === member) {\n\t\t\treturn;\n\t\t}\n\t\tif (previous !== undefined) {\n\t\t\tif (isExpandedWalletAlias(previous, member)) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tthrow new Error(`Duplicate devstack provider for ${id}`);\n\t\t}\n\t\tconst accountName = accountNameFromResourceId(id);\n\t\tif (accountName !== null) {\n\t\t\tconst caseFoldedName = accountName.toLowerCase();\n\t\t\tconst previousAccountName = accountNameByCaseFold.get(caseFoldedName);\n\t\t\tif (previousAccountName !== undefined && previousAccountName !== accountName) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Duplicate devstack account name '${accountName}' differs only by casing from '${previousAccountName}'`,\n\t\t\t\t);\n\t\t\t}\n\t\t\taccountNameByCaseFold.set(caseFoldedName, accountName);\n\t\t}\n\t\tif (visiting.has(id)) {\n\t\t\tthrow new Error(`Circular devstack dependency through ${id}`);\n\t\t}\n\n\t\tvisiting.add(id);\n\t\tif (isPlugin(member)) {\n\t\t\tfor (const dependency of pluginDependencyRefs(member) as readonly AnyResourceRef[]) {\n\t\t\t\tif (isPlugin(dependency)) {\n\t\t\t\t\tvisit(dependency);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tvisiting.delete(id);\n\t\tseen.set(id, member);\n\t\texpanded.push(member);\n\t};\n\n\tfor (const member of members) {\n\t\tvisit(member);\n\t}\n\n\treturn expanded;\n};\n\nconst isExpandedWalletAlias = (a: AnyPlugin, b: AnyPlugin): boolean =>\n\ta.id === b.id && (readExpandHook(a) !== undefined || readExpandHook(b) !== undefined);\n\nconst accountNameFromResourceId = (id: string): string | null => {\n\tif (!id.startsWith(ACCOUNT_RESOURCE_PREFIX)) return null;\n\treturn id.slice(ACCOUNT_RESOURCE_PREFIX.length);\n};\n\n// --- wallet `accounts: 'all'` expansion (D6, api-surface-design.md §4) --\n//\n// The wallet factory returns a placeholder member with a symbol-keyed\n// expander hook when the user passes `accounts: 'all'`. The composer\n// is the only place that knows the FULL stack member tuple at compose\n// time, so the expansion runs here before the runtime member array is\n// handed to the supervisor.\n//\n// Without expansion, the wallet's dependencies would stay `[suiResource]` and\n// the supervisor's topological scheduler would race account funding\n// against `signTransaction`.\n\nfunction readExpandHook(m: AnyPlugin): WalletExpandAccountsAllExpander | undefined {\n\tconst slot = (m as unknown as Record<symbol, unknown>)[WALLET_EXPAND_ACCOUNTS_ALL];\n\treturn typeof slot === 'function' ? (slot as WalletExpandAccountsAllExpander) : undefined;\n}\n\n/** Expand any `wallet({ accounts: 'all' })` placeholder plugin into a\n *  real wallet plugin whose dependencies include every account plugin.\n *  Returns the input array verbatim when no expansion is\n *  needed (zero allocation on the common explicit-tuple path). */\nexport function expandWalletAccountsAll(\n\tmembers: ReadonlyArray<AnyPlugin>,\n): ReadonlyArray<AnyPlugin> {\n\tlet needsExpansion = false;\n\tfor (const m of members) {\n\t\tif (readExpandHook(m) !== undefined) {\n\t\t\tneedsExpansion = true;\n\t\t\tbreak;\n\t\t}\n\t}\n\tif (!needsExpansion) return members;\n\n\tconst accountMembers: Array<WalletAccountMember> = [];\n\tfor (const m of members) {\n\t\tif (m.id.startsWith(ACCOUNT_RESOURCE_PREFIX)) {\n\t\t\taccountMembers.push(m as unknown as WalletAccountMember);\n\t\t}\n\t}\n\n\treturn members.map((m) => {\n\t\tconst expand = readExpandHook(m);\n\t\treturn expand === undefined ? m : expand(accountMembers);\n\t});\n}\n"],"mappings":";;;AAqBA,MAAM,eAAe,OAAO,IAAI,2CAA2C;AA4B3E,MAAM,0BAA0B;AA6BhC,MAAa,mBACZ,UAC0B;CAC1B,MAAM,SAAU,MACf;AAED,KAAI,WAAW,KAAA,EACd,OAAM,IAAI,MAAM,+DAA+D;AAEhF,QAAO;;;;;;;;;;;;;;;;;AAgDR,SAAgB,eACf,QACkC;CAGlC,MAAM,UAAU,yBADO,wBADT,yBAAyB,OAAO,QACM,CACG,CAAC;CACxD,MAAM,EAAE,SAAS,UAAU,GAAG,YAAY;CAG1C,MAAM,SAAgD;EACrD,MAAM;EACN;EACA;EACA;CACD,MAAM,QAAyC;EAC9C,MAAM;EACN;EACA;AACD,QAAO,eAAe,OAAO,cAAc;EAC1C,OAAO;EACP,YAAY;EACZ,cAAc;EACd,UAAU;EACV,CAAC;AAEF,QAAO;;AAGR,MAAa,4BACZ,YAC8B;CAC9B,MAAM,WAAwB,EAAE;CAChC,MAAM,uBAAO,IAAI,KAAwB;CACzC,MAAM,wCAAwB,IAAI,KAAqB;CACvD,MAAM,2BAAW,IAAI,KAAa;CAElC,MAAM,SAAS,WAAsB;EACpC,MAAM,KAAK,OAAO;EAClB,MAAM,WAAW,KAAK,IAAI,GAAG;AAC7B,MAAI,aAAa,OAChB;AAED,MAAI,aAAa,KAAA,GAAW;AAC3B,OAAI,sBAAsB,UAAU,OAAO,CAC1C;AAED,SAAM,IAAI,MAAM,mCAAmC,KAAK;;EAEzD,MAAM,cAAc,0BAA0B,GAAG;AACjD,MAAI,gBAAgB,MAAM;GACzB,MAAM,iBAAiB,YAAY,aAAa;GAChD,MAAM,sBAAsB,sBAAsB,IAAI,eAAe;AACrE,OAAI,wBAAwB,KAAA,KAAa,wBAAwB,YAChE,OAAM,IAAI,MACT,oCAAoC,YAAY,iCAAiC,oBAAoB,GACrG;AAEF,yBAAsB,IAAI,gBAAgB,YAAY;;AAEvD,MAAI,SAAS,IAAI,GAAG,CACnB,OAAM,IAAI,MAAM,wCAAwC,KAAK;AAG9D,WAAS,IAAI,GAAG;AAChB,MAAI,SAAS,OAAO;QACd,MAAM,cAAc,qBAAqB,OAAO,CACpD,KAAI,SAAS,WAAW,CACvB,OAAM,WAAW;;AAIpB,WAAS,OAAO,GAAG;AACnB,OAAK,IAAI,IAAI,OAAO;AACpB,WAAS,KAAK,OAAO;;AAGtB,MAAK,MAAM,UAAU,QACpB,OAAM,OAAO;AAGd,QAAO;;AAGR,MAAM,yBAAyB,GAAc,MAC5C,EAAE,OAAO,EAAE,OAAO,eAAe,EAAE,KAAK,KAAA,KAAa,eAAe,EAAE,KAAK,KAAA;AAE5E,MAAM,6BAA6B,OAA8B;AAChE,KAAI,CAAC,GAAG,WAAW,wBAAwB,CAAE,QAAO;AACpD,QAAO,GAAG,MAAM,EAA+B;;AAehD,SAAS,eAAe,GAA2D;CAClF,MAAM,OAAQ,EAAyC;AACvD,QAAO,OAAO,SAAS,aAAc,OAA2C,KAAA;;;;;;AAOjF,SAAgB,wBACf,SAC2B;CAC3B,IAAI,iBAAiB;AACrB,MAAK,MAAM,KAAK,QACf,KAAI,eAAe,EAAE,KAAK,KAAA,GAAW;AACpC,mBAAiB;AACjB;;AAGF,KAAI,CAAC,eAAgB,QAAO;CAE5B,MAAM,iBAA6C,EAAE;AACrD,MAAK,MAAM,KAAK,QACf,KAAI,EAAE,GAAG,WAAW,wBAAwB,CAC3C,gBAAe,KAAK,EAAoC;AAI1D,QAAO,QAAQ,KAAK,MAAM;EACzB,MAAM,SAAS,eAAe,EAAE;AAChC,SAAO,WAAW,KAAA,IAAY,IAAI,OAAO,eAAe;GACvD"}

package/dist/api/define-plugin.d.mts

@@ -0,0 +1 @@
+import { AnyPlugin, AnyResourceRef, CapabilitiesFactory, CapabilitySource, DependencyInput, DependencyList, Plugin, PluginErrorContribution, PluginSpec, ResolvedDependencies, ResolvedDependencyList, ResolvedDependencyObject, ResourceIdOf, ResourceRef, ResourceValueOf, WatchDecl, defineId, definePlugin, resource } from "../substrate/plugin.mjs";