@attentionform/ooxml-validator 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,206 @@
+Business Source License 1.1
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+-----------------------------------------------------------------------------
+
+Parameters
+
+Licensor:             Attentionform, the publisher of ASTra, operated by the
+                      holder of the GitHub account github.com/Userfrom1995
+                      and also identified by the GitHub organization
+                      github.com/Attentionform and the domain
+                      attentionform.com, together with its successors and
+                      assigns.
+
+Licensed Work:        ASTra: the engine, command-line tool, MCP server and
+                      OOXML validator in this repository, in each version
+                      that the Licensor makes publicly available, beginning
+                      with the first public release. Each version carries
+                      its own Change Date, below.
+                      The Licensed Work is (c) 2026 Attentionform.
+                      This License applies to all files in this repository and
+                      to the packages published from it, UNLESS another license
+                      file is present in a sub-directory, in which case that
+                      license applies to the files in that sub-directory.
+
+Additional Use Grant: You may make production use of the Licensed Work, free of
+                      charge, if Your use is Individual Use, Educational and
+                      Research Use, Non-Profit Use, Public-Sector Use or Small
+                      Business Use, each as defined below. Any other production
+                      use requires a commercial license from the Licensor.
+
+                      "Individual Use" means use by a natural person on his or
+                      her own account, including as a freelancer or consultant,
+                      either personally or through a business entity that has
+                      no employees. Contractors engaged for a specific project
+                      are not employees. Individual Use does not include use
+                      for the internal operations of an employer or of a client
+                      (for example, running the Licensed Work on a client's
+                      systems for the client's own continuing use). Using the
+                      Licensed Work to prepare documents or other deliverables
+                      for clients is Individual Use.
+
+                      "Educational and Research Use" means use by an accredited
+                      school, college or university, or by its students and
+                      staff, for teaching, learning or non-commercial academic
+                      research.
+
+                      "Non-Profit Use" means use by a Qualifying Non-Profit in
+                      furtherance of its exempt purposes, and not in connection
+                      with the sale of products or services (other than fees
+                      that only recover the cost of its charitable activities).
+                      A "Qualifying Non-Profit" is an organization that is
+                      organized and operated exclusively for charitable,
+                      educational, religious, scientific or similar
+                      public-benefit purposes, whose net earnings do not
+                      benefit any private person, and that is recognized as a
+                      charity or as exempt from income tax on that basis under
+                      the law of its jurisdiction (for example, under Section
+                      501(c)(3) of the U.S. Internal Revenue Code, or as a
+                      charity registered in the United Kingdom).
+
+                      "Public-Sector Use" means use by a government department,
+                      agency, municipality or other public authority for its
+                      governmental functions. It does not include use by a
+                      state-owned or government-controlled enterprise, or by
+                      any body that sells products or services on a commercial
+                      basis. Fees charged only to recover the cost of statutory
+                      services are not a commercial basis.
+
+                      Any organization that is not described in Individual Use,
+                      Educational and Research Use, Non-Profit Use or
+                      Public-Sector Use, including a company, partnership or
+                      other business with employees and any state-owned or
+                      government-controlled enterprise, is a "For-Profit
+                      Organization". Production use by or for a For-Profit
+                      Organization requires a commercial license unless it is
+                      Small Business Use.
+
+                      "Small Business Use" means use by a For-Profit
+                      Organization that, together with its affiliates, had
+                      total gross revenue below USD 1,000,000 and fewer than 10
+                      people working for it in its last completed fiscal year,
+                      or that has not yet completed a fiscal year and
+                      reasonably expects to meet both limits in its first one.
+                      The people working for it are its employees and the
+                      individuals who work for it on a regular basis as
+                      contractors, counted as individuals and not as
+                      companies. An "affiliate" is any entity that controls,
+                      is controlled by, or is under common control with
+                      another entity.
+
+                      Individual Use and Small Business Use include using the
+                      Licensed Work as a component of a product or service of
+                      Your own that has substantial functionality beyond that
+                      of the Licensed Work, and Your customers and users may
+                      use the Licensed Work only as part of that product or
+                      service. A product or service includes software that You
+                      make available free of charge. No category above
+                      includes a Competing Offering, which always requires a
+                      commercial license. A "Competing Offering" is a product
+                      or service offered to third parties whose value consists
+                      mainly of the functionality of the Licensed Work, for
+                      example hosting the Licensed Work as a service for others
+                      or reselling it.
+
+                      If You stop qualifying for a category above, You may
+                      continue Your existing use for 90 days (for Small
+                      Business Use, until the end of Your next fiscal year),
+                      and must then obtain a commercial license or stop.
+                      "Production use" means any use of the Licensed Work
+                      other than non-production use, including making it part
+                      of a product or service that You provide to others.
+                      Non-production use (including evaluation, development,
+                      testing and demonstration) is permitted by this License
+                      without any category. Documents and other output that You
+                      create with the Licensed Work belong to You, and this
+                      License places no restriction on them.
+
+Change Date:          Four years after the date on which a specific version of
+                      the Licensed Work is first made publicly available.
+
+Change License:       Apache License, Version 2.0
+
+For information about commercial licenses for the Licensed Work, contact:
+astra@attentionform.com
+
+-----------------------------------------------------------------------------
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License’s text to license
+your works, and to refer to it using the trademark "Business Source License",
+as long as you comply with the Covenants of Licensor below.
+
+-----------------------------------------------------------------------------
+
+Covenants of Licensor
+
+In consideration of the right to use this License’s text and the "Business
+Source License" name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where "compatible" means that software provided under the Change License can
+   be included in a program with software provided under GPL Version 2.0 or a
+   later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text "None".
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.
+
+-----------------------------------------------------------------------------
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.

package/NOTICE

@@ -0,0 +1,12 @@
+ASTra
+Copyright 2026 Attentionform (https://attentionform.com)
+
+This product includes software developed by Attentionform and its contributors.
+
+ASTra is licensed under the Business Source License 1.1 (source-available, not open source).
+See the LICENSE file for the terms, including who may use it for free. Each version
+converts to the Apache License, Version 2.0 four years after it is first made
+publicly available. For a commercial license, write to astra@attentionform.com.
+
+Third-party software included in or used by ASTra, with its own licenses and
+copyright notices, is listed in THIRD_PARTY_NOTICES.md.

package/README.md

@@ -1,3 +1,106 @@
-# Temporary Holding Version
+# @attentionform/ooxml-validator
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Cross-platform OOXML (ECMA-376 / ISO-29500) document schema validator powered by .NET 10 OpenXmlValidator.
+
+Portions of the code are adapted from `xarsh/ooxml-validator` (MIT). See `THIRD_PARTY_NOTICES.md`.
+
+## Installation
+
+```bash
+npm install @attentionform/ooxml-validator
+```
+
+The package automatically uses the matching prebuilt native platform binary from optional dependencies:
+- `@attentionform/ooxml-validator-linux-x64`
+- `@attentionform/ooxml-validator-linux-arm64`
+- `@attentionform/ooxml-validator-darwin-x64`
+- `@attentionform/ooxml-validator-darwin-arm64`
+- `@attentionform/ooxml-validator-win32-x64`
+- `@attentionform/ooxml-validator-win32-arm64`
+
+## API
+
+### `validateFile(filePath, options?): Promise<ValidationResult>`
+Validates an OOXML document from disk. Defaults to `Microsoft365` office version when unspecified.
+
+```typescript
+import { validateFile } from '@attentionform/ooxml-validator';
+
+const result = await validateFile('path/to/doc.docx', { officeVersion: 'Office2019' });
+console.log(result.ok, result.errors);
+```
+
+### `isValid(filePath, options?): Promise<boolean>`
+Convenience helper returning `true` when the file validates without schema errors.
+
+```typescript
+import { isValid } from '@attentionform/ooxml-validator';
+
+if (!await isValid('contract.docx')) {
+  throw new Error('Invalid document');
+}
+```
+
+### `validateBuffer(bytes, options?): Promise<ValidationResult>`
+Validates an in-memory document buffer directly without creating temporary disk files. Uses a resident worker process via streaming stdin/stdout IPC. Defaults to `Office2019`.
+
+```typescript
+import { validateBuffer } from '@attentionform/ooxml-validator';
+import fs from 'node:fs';
+
+const bytes = fs.readFileSync('document.docx');
+const result = await validateBuffer(bytes, { officeVersion: 'Office2019', maxErrors: 100 });
+```
+
+### `createValidator(options?): ValidatorInstance`
+Creates an isolated validator worker client with configurable recycling, limits, and timeouts.
+
+```typescript
+import { createValidator } from '@attentionform/ooxml-validator';
+
+const validator = createValidator({
+  timeoutMs: 20000,
+  recycleAfter: 500,
+  maxDocBytes: 64 * 1024 * 1024,
+});
+
+const result = await validator.validate(buffer);
+await validator.close();
+```
+
+### `selfTest(): Promise<{ ok: boolean; details: string }>`
+Validates internal known-good and known-bad embedded test documents to verify runtime health.
+
+### `backendInfo(): BackendInfo`
+Returns diagnostic metadata regarding the active binary, platform package, SDK version, and SHA-256 hash.
+
+## Environment Variables
+
+- `OOXML_VALIDATOR_CLI`: Explicit path to a native `ooxml-validator` binary. Overrides platform package resolution and local fallback.
+
+## Supported Platforms
+
+- Linux (x64, arm64) - glibc 2.31+ (Linux musl / Alpine is currently not supported)
+- macOS (Apple Silicon arm64, Intel x64) - macOS 13+
+- Windows (x64, arm64) - Windows 10+ / Windows Server 2019+
+
+## Local Development & Building Native Binaries
+
+Building the native executable requires the .NET 10 SDK, version 10.0.100 or newer (the minimum in `native/global.json`). CI builds with the exact version set as `dotnet-version` in `.github/workflows/`; all three workflows must carry the same version (a test checks this). To bump it, change the version in all three workflows, then regenerate the lock file with that SDK (`dotnet restore native/ooxml-validator.csproj --force-evaluate`): the lock records runtime-tied packages, so a locked restore fails on a different SDK until it is regenerated. The restore also audits the dependencies and fails on a known high or critical advisory.
+
+```bash
+# Build the native binary for the current host architecture:
+npm run build:native
+
+# Compile the TypeScript wrapper:
+npm run build
+
+# Run unit tests:
+npm test
+```
+
+## License
+
+This package is licensed under BUSL-1.1. It incorporates and adapts code from `xarsh/ooxml-validator` (Copyright (c) 2025 Takao Naito, MIT License) and uses Microsoft's DocumentFormat.OpenXml SDK (MIT License). See `THIRD_PARTY_NOTICES.md` for full attribution and license texts.
+
+The six platform packages (`@attentionform/ooxml-validator-<platform>`) are not listed in this package's `package.json` in the repository: they are built from the native binaries at release time, and listing packages that are not on npm yet would make `npm ci` fail. The published wrapper lists them as optional dependencies at the range of native binaries it accepts, which is declared in the repository manifest as `validatorBinary.range` (for example `>=0.1.0 <0.2.0`). The platform packages carry that binary version, which changes only when the native validator changes and is separate from the wrapper's own version. So a platform whose newest binary could not be published keeps the last one inside the range, and the wrapper is not released while any platform has no binary in the range. See [Releasing](../../docs/releasing.md).

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,98 @@
+# Third-Party Software Notices and Information
+
+ASTra includes third-party software. The notices below are provided as required by their licenses.
+
+---
+
+## 1. xarsh/ooxml-validator
+
+- **Component:** OOXML validator wrapper (runner, binary resolution, one-shot native program)
+- **Upstream Project:** ooxml-validator
+- **Version:** 0.4.0
+- **Upstream Commit:** `11e3e8c5430d054c8d9102e3e5f5e15c6697c7b2`
+- **Source URL:** https://github.com/xarsh/ooxml-validator
+- **Copyright:** Copyright (c) 2025 Takao Naito
+- **License:** MIT
+- **Where it appears in ASTra:**
+  - `packages/ooxml-validator/src/**`
+  - `packages/ooxml-validator/native/**`
+  - `@attentionform/ooxml-validator-<platform>` packages
+- **Modifications:** Modified by Attention Form for use in ASTra.
+
+---
+
+## 2. Open XML SDK (DocumentFormat.OpenXml)
+
+- **Component:** OOXML schema validation
+- **Source URL:** https://github.com/dotnet/Open-XML-SDK
+- **Version:** 3.5.1
+- **Copyright:** Copyright (c) .NET Foundation and Contributors
+- **License:** MIT
+- **Where it appears:** linked into each platform binary.
+
+---
+
+## 3. .NET runtime
+
+- **Component:** self-contained runtime bundled in each platform binary
+- **Source URL:** https://github.com/dotnet/runtime
+- **Copyright:** Copyright (c) .NET Foundation and Contributors
+- **License:** MIT
+- **Where it appears:** bundled in each platform binary. The runtime's licence (`DOTNET-LICENSE.TXT`) and its own third-party notices (`THIRD-PARTY-NOTICES.TXT`) ship in every platform package, next to the binary.
+
+---
+
+# License Texts
+
+## MIT License (xarsh/ooxml-validator)
+
+MIT License
+
+Copyright (c) 2025 Takao Naito
+
+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.
+
+---
+
+## MIT License (Open XML SDK and .NET runtime)
+
+The MIT License (MIT)
+
+Copyright (c) .NET Foundation and Contributors
+
+All rights reserved.
+
+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/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+// Adapted from xarsh/ooxml-validator (MIT). See LICENSE-MIT-xarsh.
+import { parseArgs } from 'node:util';
+import { OFFICE_VERSIONS, validateFile } from './index.js';
+const USAGE = `Usage: ooxml-validator <file> [--officeVersion <version>]
+
+Validates one Office Open XML file and prints a single JSON object to stdout.
+
+Options:
+  --officeVersion <version>  ${OFFICE_VERSIONS.join(', ')} (default: Microsoft365)
+  --help                     Print this message
+
+Exit codes:
+  0  file is valid
+  1  file is invalid, or could not be opened (see errors[].errorType)
+  2  usage error, or the validator could not be run`;
+function parseCliArgs() {
+    return parseArgs({
+        options: {
+            officeVersion: { type: 'string' },
+            help: { type: 'boolean' },
+        },
+        allowPositionals: true,
+    });
+}
+async function main() {
+    let values;
+    let positionals;
+    try {
+        ({ values, positionals } = parseCliArgs());
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        console.error(USAGE);
+        return 2;
+    }
+    if (values.help) {
+        console.log(USAGE);
+        return 0;
+    }
+    if (positionals.length === 0) {
+        console.error('Missing <file>.');
+        console.error(USAGE);
+        return 2;
+    }
+    if (positionals.length > 1) {
+        console.error(`Expected exactly one file, got ${positionals.length}: ${positionals.join(', ')}`);
+        console.error(USAGE);
+        return 2;
+    }
+    const officeVersion = values.officeVersion ?? 'Microsoft365';
+    if (!OFFICE_VERSIONS.includes(officeVersion)) {
+        console.error(`Invalid --officeVersion "${officeVersion}". Expected one of: ${OFFICE_VERSIONS.join(', ')}`);
+        return 2;
+    }
+    try {
+        const res = await validateFile(positionals[0], { officeVersion: officeVersion });
+        console.log(JSON.stringify(res, null, 2));
+        return res.ok ? 0 : 1;
+    }
+    catch (err) {
+        console.error('[ooxml-validator] Failed to validate:', err instanceof Error ? err.message : String(err));
+        return 2;
+    }
+}
+process.stdout.on('error', (err) => {
+    if (err.code !== 'EPIPE')
+        throw err;
+});
+process.exitCode = await main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+export { resolveEmbeddedBinary, resolveBinaryDetails } from './resolve-binary.js';
+import { OFFICE_VERSIONS, type OfficeVersion, type ValidateOptions, type ValidationError, type ValidationResult, type ValidatorPoolOptions, type BackendInfo, type ValidatorInstance, type ErrorNode, type ValidationErrorClass } from './types.js';
+export { OFFICE_VERSIONS };
+export type { OfficeVersion, ValidateOptions, ValidationError, ValidationResult, ValidatorPoolOptions, BackendInfo, ValidatorInstance, ErrorNode, ValidationErrorClass, };
+/**
+ * Validates a single OOXML file from disk.
+ * Defaults to 'Microsoft365' to match standard ECMA-376 / ISO-29500 behavior.
+ */
+export declare function validateFile(filePath: string, options?: ValidateOptions): Promise<ValidationResult>;
+/**
+ * Convenience helper returning a boolean indicating if the document is valid.
+ */
+export declare function isValid(filePath: string, options?: ValidateOptions): Promise<boolean>;
+/**
+ * Validates an in-memory DOCX buffer without creating temporary files.
+ * Defaults to 'Office2019' matching the ASTra engine's standard validation target.
+ */
+export declare function validateBuffer(bytes: Buffer | Uint8Array, options?: ValidateOptions): Promise<ValidationResult>;
+/**
+ * Creates an isolated validator worker client instance.
+ */
+export declare function createValidator(opts?: ValidatorPoolOptions): ValidatorInstance;
+/**
+ * Returns diagnostic metadata about the resolved binary and platform package.
+ */
+export declare function backendInfo(): Promise<BackendInfo>;
+/**
+ * Runs a self-diagnostic validating an embedded known-good and known-bad document.
+ */
+export declare function selfTest(): Promise<{
+    ok: boolean;
+    details: string;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAElF,OAAO,EACL,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,CAAC;AAC3B,YAAY,EACV,aAAa,EACb,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,oBAAoB,GACrB,CAAC;AAeF;;;GAGG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CAE3B;AAED;;GAEG;AACH,wBAAsB,OAAO,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,GAAG,UAAU,EAC1B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CA4B3B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,oBAAyB,GAAG,iBAAiB,CAyClF;AAcD;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CA6BxD;AAUD;;GAEG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAyC1E"}