@equinor/fusion-framework-cli-plugin-mock-server 0.1.0-next.1

package/CHANGELOG.md

@@ -0,0 +1,37 @@
+# @equinor/fusion-framework-cli-plugin-mock-server
+
+## 0.1.0-next.1
+
+### Minor Changes
+
+- 09a9bcc: Add a CLI plugin for running the standalone OpenAPI mock server through `ffc mock-server`.
+  
+  The command layers bundled presets and local executable mock modules, reads `mockServer` defaults
+  from `dev-server.config.ts`, and accepts command-line host, port, and seed overrides. The standalone
+  server resolves only predefined and local mocks; it never fetches remote service discovery.
+  
+  Installing the plugin augments `DevServerOptions` with typed `mockServer` settings for the module
+  directory, host, port, and deterministic seed without coupling the base dev-server package to the
+  optional plugin.
+  
+  ```ts
+  // fusion-cli.config.ts
+  import { defineFusionCli } from '@equinor/fusion-framework-cli';
+  import mockServerPlugin from '@equinor/fusion-framework-cli-plugin-mock-server';
+  
+  export default defineFusionCli(() => ({
+    plugins: [mockServerPlugin()],
+  }));
+  ```
+  
+  ```sh
+  ffc mock-server ./mocks --port 4010
+  ```
+
+### Patch Changes
+
+- Updated dependencies [09a9bcc]
+- Updated dependencies [09a9bcc]
+- Updated dependencies [09a9bcc]
+  - @equinor/fusion-framework-dev-server@2.1.0-next.2
+  - @equinor/fusion-openapi-mock-server@0.1.0-next.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Equinor
+
+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,142 @@
+# @equinor/fusion-framework-cli-plugin-mock-server
+
+Optional Fusion Framework CLI plugin for running local OpenAPI-backed services with
+`ffc mock-server`. Use it when development or browser tests need deterministic APIs, an
+unavailable backend, or a service that has not entered Fusion service discovery yet.
+
+> [!IMPORTANT]
+> The command runs a standalone foreground HTTP server. It never fetches remote service discovery
+> and never starts automatically with `ffc app dev`.
+
+## Quick start
+
+Install the plugin:
+
+```sh
+pnpm add -D @equinor/fusion-framework-cli-plugin-mock-server
+```
+
+Create one executable module per service:
+
+```text
+mocks/
+  inventory.mock.ts
+  inventory.openapi.json
+```
+
+```typescript
+import schema from './inventory.openapi.json' with { type: 'json' };
+import { defineService } from '@equinor/fusion-openapi-mock-server/discovery';
+
+export default defineService({
+  key: 'inventory',
+  serviceDiscovery: 'new',
+  schema,
+  components: {
+    InventoryItem: { name: () => 'Local item' },
+  },
+});
+```
+
+This file is the service mock. Do not duplicate the service in `dev-server.config.ts` with
+`api.routes` or `api.processServices`; those low-level hooks are not required for the normal mock
+workflow.
+
+`'new'` models a pre-production service and rejects collisions if the key becomes registered. See
+[Choose a discovery mode](../../dev-server/docs/mocking.md#choose-a-discovery-mode) for existing
+services, pre-production services, and direct-only app endpoints.
+
+Start the server manually:
+
+```sh
+ffc mock-server
+```
+
+Installing the package makes the command available through the Fusion CLI. If the plugin is not
+installed, `ffc mock-server` prints an installation hint. Explicit `mockServerPlugin()`
+registration remains useful when `fusion-cli.config.ts` supplies command defaults.
+
+## Connect an application
+
+Keep the mock server running, then choose one app-development mode in another terminal:
+
+```sh
+# Keep real discovery and overlay selected local definitions
+ffc app dev
+
+# Use only bundled presets and local mock definitions
+ffc app dev --mock http://localhost:4010
+```
+
+The standalone server uses only configured presets and local modules. `--mock` therefore gives an
+isolated environment with no remote discovery dependency.
+
+> [!WARNING]
+> `ffc app dev --mock` does not fall back to real service discovery. Include every service the app
+> needs through a preset or local mock module.
+
+See [Develop with mock services](../../dev-server/docs/mocking.md) for discovery modes,
+direct-only endpoints, and the difference between normal and isolated development.
+
+## Configure defaults
+
+The plugin augments `DevServerOptions` with a typed `mockServer` section. Import its types in
+`dev-server.config.ts` so TypeScript loads the augmentation:
+
+```typescript
+import type {} from '@equinor/fusion-framework-cli-plugin-mock-server';
+import { defineDevServerConfig } from '@equinor/fusion-framework-cli';
+
+export default defineDevServerConfig(() => ({
+  mockServer: {
+    path: 'mocks',
+    host: 'localhost',
+    port: 4010,
+    seed: 42,
+  },
+}));
+```
+
+Command-line arguments override config defaults. `path` is relative to the project root.
+
+> [!TIP]
+> Put shared team defaults in `dev-server.config.ts`; reserve command-line flags for temporary
+> local or CI overrides.
+
+Register the plugin explicitly when command defaults belong in `fusion-cli.config.ts`:
+
+```typescript
+import { defineFusionCli } from '@equinor/fusion-framework-cli';
+import mockServerPlugin from '@equinor/fusion-framework-cli-plugin-mock-server';
+
+export default defineFusionCli(() => ({
+  plugins: [mockServerPlugin({ preset: ['fusion'], port: 4010 })],
+}));
+```
+
+## Command reference
+
+```text
+ffc mock-server [dirs...] [options]
+```
+
+| Argument or option | Behavior |
+| --- | --- |
+| `[dirs...]` | Directories of `<name>.mock.ts` modules in ascending precedence. Later definitions are resolved by service key and discovery mode. |
+| `--preset <name>` | Bundled preset layered before local directories. Repeatable; defaults to `fusion`. The first explicit flag replaces the default. |
+| `--port <port>` | Listening port. Uses config, then plugin defaults, then `4010`. |
+| `--host <host>` | Bind hostname. Uses config, then plugin defaults, then `localhost`. |
+| `--seed <seed>` | Deterministic seed for generated OpenAPI responses. Without a seed, generated values are random. |
+
+The process shuts down on `SIGINT` and `SIGTERM`. Let Playwright `webServer`, `concurrently`, or a
+developer terminal own it instead of starting an unowned background process.
+
+## Related documentation
+
+- [OpenAPI mock-server getting started](../../utils/openapi-mock-server/docs/getting-started.md)
+- [Testing with Playwright](../../utils/openapi-mock-server/docs/testing-with-playwright.md)
+- [Mock API and Playwright cookbook](../../../cookbooks/app-react-mock-playwright/README.md)
+
+## License
+
+ISC

package/dist/esm/__tests__/create-mock-server-command.test.js

@@ -0,0 +1,95 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+const mocks = vi.hoisted(() => ({
+    close: vi.fn().mockResolvedValue(undefined),
+    createMockServer: vi.fn(),
+    discoverServices: vi.fn(),
+    loadMockServerConfig: vi.fn(),
+    start: vi.fn(),
+    use: vi.fn(),
+}));
+vi.mock('@equinor/fusion-openapi-mock-server', () => ({
+    createMockServer: mocks.createMockServer,
+}));
+vi.mock('@equinor/fusion-openapi-mock-server/discovery', () => ({
+    discoverServices: mocks.discoverServices,
+}));
+vi.mock('../load-mock-server-config.js', () => ({
+    loadMockServerConfig: mocks.loadMockServerConfig,
+}));
+import { createMockServerCommand } from '../create-mock-server-command.js';
+describe('createMockServerCommand', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.spyOn(process, 'on').mockReturnValue(process);
+        mocks.createMockServer.mockReturnValue({
+            close: mocks.close,
+            start: mocks.start,
+            use: mocks.use,
+        });
+        mocks.discoverServices.mockResolvedValue([]);
+        mocks.start.mockResolvedValue({ url: 'http://localhost:4010' });
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('uses project config before plugin defaults', async () => {
+        mocks.loadMockServerConfig.mockResolvedValue({
+            path: 'config-mocks',
+            port: 4010,
+            host: '127.0.0.1',
+            seed: 42,
+        });
+        const command = createMockServerCommand({
+            path: 'plugin-mocks',
+            port: 4020,
+            host: 'localhost',
+            seed: 7,
+        });
+        await command.parseAsync(['node', 'test']);
+        expect(mocks.discoverServices).toHaveBeenCalledWith('config-mocks');
+        expect(mocks.createMockServer).toHaveBeenCalledWith({ seed: 42 });
+        expect(mocks.start).toHaveBeenCalledWith({ port: 4010, host: '127.0.0.1' });
+    });
+    it('uses explicit arguments and flags before project config', async () => {
+        mocks.loadMockServerConfig.mockResolvedValue({
+            path: 'config-mocks',
+            port: 4010,
+            host: '127.0.0.1',
+            seed: 42,
+        });
+        const command = createMockServerCommand();
+        await command.parseAsync([
+            'node',
+            'test',
+            'cli-mocks',
+            '--port=5000',
+            '--host=0.0.0.0',
+            '--seed=99',
+        ]);
+        expect(mocks.discoverServices).toHaveBeenCalledWith('cli-mocks');
+        expect(mocks.createMockServer).toHaveBeenCalledWith({ seed: 99 });
+        expect(mocks.start).toHaveBeenCalledWith({ port: 5000, host: '0.0.0.0' });
+    });
+    it('uses plugin defaults before built-in conventions', async () => {
+        mocks.loadMockServerConfig.mockResolvedValue({});
+        const command = createMockServerCommand({
+            path: 'plugin-mocks',
+            port: 4020,
+            host: '127.0.0.1',
+            seed: 7,
+        });
+        await command.parseAsync(['node', 'test']);
+        expect(mocks.discoverServices).toHaveBeenCalledWith('plugin-mocks');
+        expect(mocks.createMockServer).toHaveBeenCalledWith({ seed: 7 });
+        expect(mocks.start).toHaveBeenCalledWith({ port: 4020, host: '127.0.0.1' });
+    });
+    it('uses built-in conventions when no other values are provided', async () => {
+        mocks.loadMockServerConfig.mockResolvedValue({});
+        const command = createMockServerCommand();
+        await command.parseAsync(['node', 'test']);
+        expect(mocks.discoverServices).toHaveBeenCalledWith('mocks');
+        expect(mocks.createMockServer).toHaveBeenCalledWith({ seed: undefined });
+        expect(mocks.start).toHaveBeenCalledWith({ port: 4010, host: 'localhost' });
+    });
+});
+//# sourceMappingURL=create-mock-server-command.test.js.map

package/dist/esm/__tests__/create-mock-server-command.test.js.map

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

package/dist/esm/__tests__/index.test.js

@@ -0,0 +1,66 @@
+import { Command } from 'commander';
+import { describe, expect, it } from 'vitest';
+import mockServerPlugin from '../index.js';
+describe('mockServerPlugin', () => {
+    it('augments DevServerOptions with mock-server configuration', () => {
+        const config = {
+            api: { serviceDiscoveryUrl: 'https://discovery.example.com' },
+            mockServer: { path: 'api-mocks', port: 4010, seed: 42 },
+        };
+        expect(config.mockServer).toEqual({ path: 'api-mocks', port: 4010, seed: 42 });
+    });
+    it('registers a top-level "mock-server" command', () => {
+        const program = new Command();
+        mockServerPlugin()(program);
+        // every registered command's name, to check "mock-server" is among them
+        expect(program.commands.map((command) => command.name())).toContain('mock-server');
+    });
+    it('applies every --preset before any positional directory', () => {
+        const program = new Command();
+        mockServerPlugin()(program);
+        // locate the command this plugin registered, by name
+        const mockServerCommand = program.commands.find((command) => command.name() === 'mock-server');
+        // parse() invokes the command's action; capture what it would pass to createMockServer via the parsed options
+        const parsed = mockServerCommand?.parseOptions([
+            '--preset=fusion',
+            '--preset=extra',
+            './mocks',
+            './overrides',
+        ]);
+        expect(parsed?.operands).toEqual(['./mocks', './overrides']);
+        expect(mockServerCommand?.opts().preset).toEqual(['fusion', 'extra']);
+    });
+    it('defaults to the "fusion" preset when --preset is omitted', () => {
+        const program = new Command();
+        mockServerPlugin()(program);
+        // locate the command this plugin registered, by name
+        const mockServerCommand = program.commands.find((command) => command.name() === 'mock-server');
+        mockServerCommand?.parseOptions(['./mocks']);
+        expect(mockServerCommand?.opts().preset).toEqual(['fusion']);
+    });
+    it('replaces the default preset instead of appending to it, on the first explicit --preset', () => {
+        const program = new Command();
+        mockServerPlugin()(program);
+        // locate the command this plugin registered, by name
+        const mockServerCommand = program.commands.find((command) => command.name() === 'mock-server');
+        mockServerCommand?.parseOptions(['--preset=other', './mocks']);
+        expect(mockServerCommand?.opts().preset).toEqual(['other']);
+    });
+    it('applies caller-provided preset defaults during option parsing', () => {
+        const program = new Command();
+        mockServerPlugin({ preset: ['other'], port: 4010, host: '0.0.0.0' })(program);
+        // locate the command this plugin registered, by name
+        const mockServerCommand = program.commands.find((command) => command.name() === 'mock-server');
+        mockServerCommand?.parseOptions([]);
+        expect(mockServerCommand?.opts()).toEqual({ preset: ['other'] });
+    });
+    it('lets an explicit flag override a caller-provided default', () => {
+        const program = new Command();
+        mockServerPlugin({ preset: ['other'], port: 4010 })(program);
+        // locate the command this plugin registered, by name
+        const mockServerCommand = program.commands.find((command) => command.name() === 'mock-server');
+        mockServerCommand?.parseOptions(['--port=5000']);
+        expect(mockServerCommand?.opts().port).toBe(5000);
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/esm/__tests__/index.test.js.map

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

package/dist/esm/create-mock-server-command.js

@@ -0,0 +1,77 @@
+import { createCommand, createOption } from 'commander';
+import { createMockServer } from '@equinor/fusion-openapi-mock-server';
+import { discoverServices } from '@equinor/fusion-openapi-mock-server/discovery';
+import { loadMockServerConfig } from './load-mock-server-config.js';
+/**
+ * Builds the `ffc mock-server` command definition.
+ *
+ * Serves every service discovered from one or more directories of `<name>.mock.ts`
+ * modules (plus any bundled presets) over HTTP, using
+ * `@equinor/fusion-openapi-mock-server`'s `createMockServer`. Presets and
+ * directories are both layered in ascending precedence — a later `--preset`
+ * or directory replaces an earlier one's services by key — with every
+ * `--preset` applied before every positional directory, regardless of their
+ * order on the command line.
+ *
+ * Defaults to the bundled `fusion` preset when `--preset` isn't given at
+ * all — a Fusion app's default framework modules resolve several
+ * service-discovery keys eagerly at startup and fail hard without them. The
+ * first explicit `--preset` fully replaces that default rather than
+ * appending to it; repeat the flag (`--preset=fusion --preset=other`) to
+ * combine it with something else. Pass {@link defaults} to change any of
+ * these built-in defaults (e.g. a fixed port for a specific app).
+ *
+ * Keeps the server running in the foreground until `SIGINT`/`SIGTERM`, so it
+ * dies with whatever started it (e.g. Playwright's `webServer`) rather than
+ * lingering as an orphaned process.
+ *
+ * @param defaults - Overrides for the command's own built-in path, preset, port, host, and seed defaults.
+ * @returns A fresh `Command` instance — a factory rather than a shared singleton, since
+ * Commander stores parsed option values on the `Command` instance itself.
+ *
+ * @example
+ * ```sh
+ * ffc mock-server ./mocks --port 4010
+ * ```
+ */
+export function createMockServerCommand(defaults = {}) {
+    // sentinel default for --preset, so the first explicit flag replaces it instead of appending to it
+    const defaultPresets = defaults.preset ?? ['fusion'];
+    return createCommand('mock-server')
+        .description('Serve OpenAPI-fake responses over HTTP, from bundled presets and/or mock modules')
+        .argument('[dirs...]', 'directories of <name>.mock.ts modules, in ascending precedence')
+        .addOption(createOption('--preset <name>', `bundled preset to layer in, in ascending precedence (repeatable; defaults to ${JSON.stringify(defaultPresets)}, replaced by the first explicit flag)`)
+        .default(defaultPresets)
+        .argParser((value, previous) => previous === defaultPresets ? [value] : [...previous, value]))
+        .addOption(createOption('--port <port>', `port to listen on (default: config or ${defaults.port ?? 4010})`).argParser(Number))
+        .addOption(createOption('--host <host>', 'hostname to bind to (default: config or localhost)'))
+        .addOption(createOption('--seed <seed>', `seeds every service's faked responses, for reproducible output (default: ${defaults.seed ?? 'unseeded/random'})`).argParser(Number))
+        .action(async (dirs, options) => {
+        const config = await loadMockServerConfig(process.cwd());
+        const sourceDirs = dirs.length ? dirs : [config.path ?? defaults.path ?? 'mocks'];
+        const definitionGroups = await Promise.all(sourceDirs
+            // Resolve every configured layer before startup so discovery requirements are known.
+            .map((dir) => discoverServices(dir)));
+        const server = createMockServer({
+            seed: options.seed ?? config.seed ?? defaults.seed,
+        });
+        // presets always apply before directories, regardless of flag position on the command line
+        for (const preset of options.preset)
+            server.use(preset);
+        // Resolved directory groups are the highest-precedence layers, applied after every preset.
+        for (const definitions of definitionGroups)
+            server.use(definitions);
+        const { url } = await server.start({
+            port: options.port ?? config.port ?? defaults.port ?? 4010,
+            host: options.host ?? config.host ?? defaults.host ?? 'localhost',
+        });
+        console.log(`mock server listening at ${url}`);
+        const shutdown = () => {
+            void server.close().finally(() => process.exit(0));
+        };
+        process.on('SIGINT', shutdown);
+        process.on('SIGTERM', shutdown);
+    });
+}
+export default createMockServerCommand;
+//# sourceMappingURL=create-mock-server-command.js.map

package/dist/esm/create-mock-server-command.js.map

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

package/dist/esm/dev-server-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dev-server-options.js.map

package/dist/esm/dev-server-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server-options.js","sourceRoot":"","sources":["../../src/dev-server-options.ts"],"names":[],"mappings":""}

package/dist/esm/index.js

@@ -0,0 +1,24 @@
+import { createMockServerCommand, } from './create-mock-server-command.js';
+/**
+ * Creates the `ffc mock-server` CLI plugin, for a `fusion-cli.config.ts`'s `plugins` array.
+ *
+ * @param defaults - Overrides for the command's own built-in `--preset`/`--port`/`--host` defaults.
+ * @returns A plugin function that registers the `mock-server` command on the CLI program.
+ *
+ * @example
+ * ```ts
+ * import { defineFusionCli } from '@equinor/fusion-framework-cli';
+ * import mockServerPlugin from '@equinor/fusion-framework-cli-plugin-mock-server';
+ *
+ * export default defineFusionCli(() => ({
+ *   plugins: [mockServerPlugin({ preset: ['fusion'], port: 4010 })],
+ * }));
+ * ```
+ */
+export function mockServerPlugin(defaults) {
+    return (program) => {
+        program.addCommand(createMockServerCommand(defaults));
+    };
+}
+export default mockServerPlugin;
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,uBAAuB,GAExB,MAAM,iCAAiC,CAAC;AAQzC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAoC;IACnE,OAAO,CAAC,OAAgB,EAAQ,EAAE;QAChC,OAAO,CAAC,UAAU,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC;AACJ,CAAC;AAED,eAAe,gBAAgB,CAAC"}

package/dist/esm/load-mock-server-config.js

@@ -0,0 +1,45 @@
+import { FileNotFoundError, importConfig } from '@equinor/fusion-imports';
+/**
+ * Loads standalone mock-server settings from a project's `dev-server.config.ts`.
+ *
+ * @param root - Project root used to resolve the config file and relative mock path.
+ * @returns Mock-server settings explicitly resolved from the project config.
+ * @throws {Error} When an existing config cannot be imported or returns an invalid value.
+ */
+export async function loadMockServerConfig(root) {
+    const base = {
+        mockServer: { path: 'mocks' },
+        api: { serviceDiscoveryUrl: '' },
+    };
+    try {
+        const { config } = await importConfig('dev-server.config', {
+            baseDir: root,
+            script: {
+                // Config factories receive the same runtime shape as ordinary development serving.
+                resolve: async (module) => {
+                    const exported = module.default;
+                    // Factory configs may derive settings from the supplied base configuration.
+                    if (typeof exported === 'function') {
+                        return ((await exported({ command: 'serve', environment: 'local', mode: 'development', root }, { base })) ?? {});
+                    }
+                    return exported ?? {};
+                },
+            },
+        });
+        return {
+            path: config.mockServer?.path ?? base.mockServer?.path,
+            port: config.mockServer?.port,
+            host: config.mockServer?.host,
+            seed: config.mockServer?.seed,
+        };
+    }
+    catch (error) {
+        // An absent config is a supported convention-only setup; import and evaluation failures are not.
+        if (error instanceof FileNotFoundError) {
+            return {};
+        }
+        throw error;
+    }
+}
+export default loadMockServerConfig;
+//# sourceMappingURL=load-mock-server-config.js.map

package/dist/esm/load-mock-server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-mock-server-config.js","sourceRoot":"","sources":["../../src/load-mock-server-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAkB,MAAM,yBAAyB,CAAC;AAsB1F;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY;IACrD,MAAM,IAAI,GAAqB;QAC7B,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;QAC7B,GAAG,EAAE,EAAE,mBAAmB,EAAE,EAAE,EAAE;KACjC,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,YAAY,CACnC,mBAAmB,EACnB;YACE,OAAO,EAAE,IAAI;YACb,MAAM,EAAE;gBACN,mFAAmF;gBACnF,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;oBACxB,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC;oBAChC,4EAA4E;oBAC5E,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;wBACnC,OAAO,CACL,CAAC,MAAM,QAAQ,CACb,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,EACrE,EAAE,IAAI,EAAE,CACT,CAAC,IAAI,EAAE,CACT,CAAC;oBACJ,CAAC;oBACD,OAAO,QAAQ,IAAI,EAAE,CAAC;gBACxB,CAAC;aACF;SACF,CACF,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,IAAI;YACtD,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI;YAC7B,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI;YAC7B,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI;SAC9B,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,iGAAiG;QACjG,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;YACvC,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,eAAe,oBAAoB,CAAC"}

package/dist/esm/version.js

@@ -0,0 +1,3 @@
+// Generated by genversion.
+export const version = '0.1.0-next.1';
+//# sourceMappingURL=version.js.map

package/dist/esm/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,MAAM,CAAC,MAAM,OAAO,GAAG,cAAc,CAAC"}