@open-agreements/open-agreements 0.2.0

package/dist/core/metadata.d.ts

@@ -0,0 +1,194 @@
+import { z } from 'zod';
+export declare const LicenseEnum: z.ZodEnum<{
+    "CC-BY-4.0": "CC-BY-4.0";
+    "CC0-1.0": "CC0-1.0";
+    "CC-BY-ND-4.0": "CC-BY-ND-4.0";
+}>;
+export type License = z.infer<typeof LicenseEnum>;
+export declare const FieldDefinitionSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        date: "date";
+        enum: "enum";
+        array: "array";
+    }>;
+    description: z.ZodString;
+    default: z.ZodOptional<z.ZodString>;
+    options: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    section: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type FieldDefinition = z.infer<typeof FieldDefinitionSchema>;
+export declare const TemplateMetadataSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    source_url: z.ZodString;
+    version: z.ZodString;
+    license: z.ZodEnum<{
+        "CC-BY-4.0": "CC-BY-4.0";
+        "CC0-1.0": "CC0-1.0";
+        "CC-BY-ND-4.0": "CC-BY-ND-4.0";
+    }>;
+    allow_derivatives: z.ZodBoolean;
+    attribution_text: z.ZodString;
+    fields: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            date: "date";
+            enum: "enum";
+            array: "array";
+        }>;
+        description: z.ZodString;
+        default: z.ZodOptional<z.ZodString>;
+        options: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        section: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    required_fields: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type TemplateMetadata = z.infer<typeof TemplateMetadataSchema>;
+export declare const ExternalMetadataSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    source_url: z.ZodString;
+    version: z.ZodString;
+    license: z.ZodEnum<{
+        "CC-BY-4.0": "CC-BY-4.0";
+        "CC0-1.0": "CC0-1.0";
+        "CC-BY-ND-4.0": "CC-BY-ND-4.0";
+    }>;
+    allow_derivatives: z.ZodBoolean;
+    attribution_text: z.ZodString;
+    fields: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            date: "date";
+            enum: "enum";
+            array: "array";
+        }>;
+        description: z.ZodString;
+        default: z.ZodOptional<z.ZodString>;
+        options: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        section: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    required_fields: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    source_sha256: z.ZodString;
+}, z.core.$strip>;
+export type ExternalMetadata = z.infer<typeof ExternalMetadataSchema>;
+export declare const CleanConfigSchema: z.ZodObject<{
+    removeFootnotes: z.ZodDefault<z.ZodBoolean>;
+    removeParagraphPatterns: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    removeRanges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        start: z.ZodString;
+        end: z.ZodString;
+    }, z.core.$strip>>>;
+    clearParts: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type CleanConfig = z.infer<typeof CleanConfigSchema>;
+export declare const DeclarativeParagraphNormalizeRuleSchema: z.ZodObject<{
+    id: z.ZodString;
+    section_heading: z.ZodString;
+    section_heading_any: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    ignore_heading: z.ZodOptional<z.ZodBoolean>;
+    paragraph_contains: z.ZodString;
+    paragraph_end_contains: z.ZodOptional<z.ZodString>;
+    replacements: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    trim_unmatched_trailing_bracket: z.ZodOptional<z.ZodBoolean>;
+    expected_min_matches: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type DeclarativeParagraphNormalizeRule = z.infer<typeof DeclarativeParagraphNormalizeRuleSchema>;
+export declare const NormalizeConfigSchema: z.ZodObject<{
+    paragraph_rules: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        section_heading: z.ZodString;
+        section_heading_any: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        ignore_heading: z.ZodOptional<z.ZodBoolean>;
+        paragraph_contains: z.ZodString;
+        paragraph_end_contains: z.ZodOptional<z.ZodString>;
+        replacements: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        trim_unmatched_trailing_bracket: z.ZodOptional<z.ZodBoolean>;
+        expected_min_matches: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type NormalizeConfig = z.infer<typeof NormalizeConfigSchema>;
+export declare const GuidanceEntrySchema: z.ZodObject<{
+    source: z.ZodEnum<{
+        footnote: "footnote";
+        pattern: "pattern";
+        range: "range";
+    }>;
+    part: z.ZodString;
+    index: z.ZodNumber;
+    text: z.ZodString;
+    groupId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GuidanceEntry = z.infer<typeof GuidanceEntrySchema>;
+export declare const GuidanceOutputSchema: z.ZodObject<{
+    extractedFrom: z.ZodObject<{
+        sourceHash: z.ZodString;
+        configHash: z.ZodString;
+    }, z.core.$strip>;
+    entries: z.ZodArray<z.ZodObject<{
+        source: z.ZodEnum<{
+            footnote: "footnote";
+            pattern: "pattern";
+            range: "range";
+        }>;
+        part: z.ZodString;
+        index: z.ZodNumber;
+        text: z.ZodString;
+        groupId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type GuidanceOutput = z.infer<typeof GuidanceOutputSchema>;
+export declare const RecipeMetadataSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    source_url: z.ZodString;
+    source_version: z.ZodString;
+    license_note: z.ZodString;
+    optional: z.ZodDefault<z.ZodBoolean>;
+    source_sha256: z.ZodOptional<z.ZodString>;
+    fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            date: "date";
+            enum: "enum";
+            array: "array";
+        }>;
+        description: z.ZodString;
+        default: z.ZodOptional<z.ZodString>;
+        options: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        section: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    required_fields: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type RecipeMetadata = z.infer<typeof RecipeMetadataSchema>;
+export declare function loadMetadata(templateDir: string): TemplateMetadata;
+export declare function validateMetadata(templateDir: string): {
+    valid: boolean;
+    errors: string[];
+};
+export declare function loadExternalMetadata(externalDir: string): ExternalMetadata;
+export declare function validateExternalMetadata(externalDir: string): {
+    valid: boolean;
+    errors: string[];
+};
+export declare function loadRecipeMetadata(recipeDir: string): RecipeMetadata;
+export declare function loadCleanConfig(recipeDir: string): CleanConfig;
+export declare function loadNormalizeConfig(recipeDir: string): NormalizeConfig;
+export declare function validateRecipeMetadata(recipeDir: string): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=metadata.d.ts.map

package/dist/core/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/core/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,WAAW;;;;EAAmD,CAAC;AAC5E,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAElD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;iBAkBjC,CAAC;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AA0CpE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAEjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAItE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAItE,eAAO,MAAM,iBAAiB;;;;;;;;iBAQ5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,uCAAuC;;;;;;;;;;iBAUlD,CAAC;AACH,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uCAAuC,CAAC,CAAC;AAExG,eAAO,MAAM,qBAAqB;;;;;;;;;;;;iBAEhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,mBAAmB;;;;;;;;;;iBAM9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;iBAM/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;iBAY/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,CAKlE;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAe1F;AAID,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,CAK1E;AAED,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAelG;AAID,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAKpE;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAO9D;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAOtE;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAe9F"}

package/dist/core/metadata.js

@@ -0,0 +1,197 @@
+import { z } from 'zod';
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import yaml from 'js-yaml';
+export const LicenseEnum = z.enum(['CC-BY-4.0', 'CC0-1.0', 'CC-BY-ND-4.0']);
+export const FieldDefinitionSchema = z.object({
+    name: z.string(),
+    type: z.enum(['string', 'date', 'number', 'boolean', 'enum', 'array']),
+    description: z.string(),
+    default: z.string().optional(),
+    options: z.array(z.string()).optional(),
+    section: z.string().optional(),
+}).refine((f) => f.type !== 'enum' || (f.options !== undefined && f.options.length > 0), { message: 'Fields with type "enum" must have a non-empty options array' }).refine((f) => {
+    if (f.default === undefined)
+        return true;
+    if (f.type === 'number')
+        return !isNaN(Number(f.default));
+    if (f.type === 'boolean')
+        return f.default === 'true' || f.default === 'false';
+    return true;
+}, { message: 'Default value must be valid for the declared field type' });
+function validateRequiredFields(fields, requiredFields, ctx) {
+    const fieldNames = new Set(fields.map((field) => field.name));
+    const seen = new Set();
+    requiredFields.forEach((fieldName, index) => {
+        if (seen.has(fieldName)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ['required_fields', index],
+                message: `Duplicate required field "${fieldName}"`,
+            });
+            return;
+        }
+        seen.add(fieldName);
+        if (!fieldNames.has(fieldName)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ['required_fields', index],
+                message: `Required field "${fieldName}" is not defined in fields`,
+            });
+        }
+    });
+}
+const TemplateMetadataBaseSchema = z.object({
+    name: z.string(),
+    description: z.string().optional(),
+    source_url: z.string().url(),
+    version: z.string(),
+    license: LicenseEnum,
+    allow_derivatives: z.boolean(),
+    attribution_text: z.string(),
+    fields: z.array(FieldDefinitionSchema),
+    required_fields: z.array(z.string()).default([]),
+});
+export const TemplateMetadataSchema = TemplateMetadataBaseSchema.superRefine((meta, ctx) => {
+    validateRequiredFields(meta.fields, meta.required_fields, ctx);
+});
+// --- External template schemas ---
+export const ExternalMetadataSchema = TemplateMetadataBaseSchema.extend({
+    source_sha256: z.string(),
+}).superRefine((meta, ctx) => {
+    validateRequiredFields(meta.fields, meta.required_fields, ctx);
+});
+// --- Recipe schemas ---
+export const CleanConfigSchema = z.object({
+    removeFootnotes: z.boolean().default(false),
+    removeParagraphPatterns: z.array(z.string()).default([]),
+    removeRanges: z.array(z.object({
+        start: z.string(),
+        end: z.string(),
+    })).default([]),
+    clearParts: z.array(z.string()).default([]),
+});
+export const DeclarativeParagraphNormalizeRuleSchema = z.object({
+    id: z.string(),
+    section_heading: z.string(),
+    section_heading_any: z.array(z.string()).optional(),
+    ignore_heading: z.boolean().optional(),
+    paragraph_contains: z.string(),
+    paragraph_end_contains: z.string().optional(),
+    replacements: z.record(z.string(), z.string()).optional(),
+    trim_unmatched_trailing_bracket: z.boolean().optional(),
+    expected_min_matches: z.number().int().nonnegative().optional(),
+});
+export const NormalizeConfigSchema = z.object({
+    paragraph_rules: z.array(DeclarativeParagraphNormalizeRuleSchema).default([]),
+});
+export const GuidanceEntrySchema = z.object({
+    source: z.enum(['footnote', 'pattern', 'range']),
+    part: z.string(),
+    index: z.number(),
+    text: z.string(),
+    groupId: z.string().optional(),
+});
+export const GuidanceOutputSchema = z.object({
+    extractedFrom: z.object({
+        sourceHash: z.string(),
+        configHash: z.string(),
+    }),
+    entries: z.array(GuidanceEntrySchema),
+});
+export const RecipeMetadataSchema = z.object({
+    name: z.string(),
+    description: z.string().optional(),
+    source_url: z.string().url(),
+    source_version: z.string(),
+    license_note: z.string(),
+    optional: z.boolean().default(false),
+    source_sha256: z.string().optional(),
+    fields: z.array(FieldDefinitionSchema).default([]),
+    required_fields: z.array(z.string()).default([]),
+}).superRefine((meta, ctx) => {
+    validateRequiredFields(meta.fields, meta.required_fields, ctx);
+});
+// --- Template loaders ---
+export function loadMetadata(templateDir) {
+    const metadataPath = join(templateDir, 'metadata.yaml');
+    const raw = readFileSync(metadataPath, 'utf-8');
+    const parsed = yaml.load(raw);
+    return TemplateMetadataSchema.parse(parsed);
+}
+export function validateMetadata(templateDir) {
+    try {
+        loadMetadata(templateDir);
+        return { valid: true, errors: [] };
+    }
+    catch (err) {
+        if (err instanceof z.ZodError) {
+            return {
+                valid: false,
+                errors: err.issues.map((i) => `${i.path.join('.')}: ${i.message}`),
+            };
+        }
+        return { valid: false, errors: [err.message] };
+    }
+}
+// --- External template loaders ---
+export function loadExternalMetadata(externalDir) {
+    const metadataPath = join(externalDir, 'metadata.yaml');
+    const raw = readFileSync(metadataPath, 'utf-8');
+    const parsed = yaml.load(raw);
+    return ExternalMetadataSchema.parse(parsed);
+}
+export function validateExternalMetadata(externalDir) {
+    try {
+        loadExternalMetadata(externalDir);
+        return { valid: true, errors: [] };
+    }
+    catch (err) {
+        if (err instanceof z.ZodError) {
+            return {
+                valid: false,
+                errors: err.issues.map((i) => `${i.path.join('.')}: ${i.message}`),
+            };
+        }
+        return { valid: false, errors: [err.message] };
+    }
+}
+// --- Recipe loaders ---
+export function loadRecipeMetadata(recipeDir) {
+    const metadataPath = join(recipeDir, 'metadata.yaml');
+    const raw = readFileSync(metadataPath, 'utf-8');
+    const parsed = yaml.load(raw);
+    return RecipeMetadataSchema.parse(parsed);
+}
+export function loadCleanConfig(recipeDir) {
+    const cleanPath = join(recipeDir, 'clean.json');
+    if (!existsSync(cleanPath)) {
+        return { removeFootnotes: false, removeParagraphPatterns: [], removeRanges: [], clearParts: [] };
+    }
+    const raw = readFileSync(cleanPath, 'utf-8');
+    return CleanConfigSchema.parse(JSON.parse(raw));
+}
+export function loadNormalizeConfig(recipeDir) {
+    const normalizePath = join(recipeDir, 'normalize.json');
+    if (!existsSync(normalizePath)) {
+        return { paragraph_rules: [] };
+    }
+    const raw = readFileSync(normalizePath, 'utf-8');
+    return NormalizeConfigSchema.parse(JSON.parse(raw));
+}
+export function validateRecipeMetadata(recipeDir) {
+    try {
+        loadRecipeMetadata(recipeDir);
+        return { valid: true, errors: [] };
+    }
+    catch (err) {
+        if (err instanceof z.ZodError) {
+            return {
+                valid: false,
+                errors: err.issues.map((i) => `${i.path.join('.')}: ${i.message}`),
+            };
+        }
+        return { valid: false, errors: [err.message] };
+    }
+}
+//# sourceMappingURL=metadata.js.map

package/dist/core/metadata.js.map

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

package/dist/core/recipe/bracket-normalizer.d.ts

@@ -0,0 +1,46 @@
+export interface BracketNormalizationStats {
+    unbracketedSegments: number;
+    removedSegments: number;
+    removedParagraphs: number;
+    normalizedParagraphs: number;
+    declarativeRuleApplications: number;
+    declarativeRuleMatchCounts: Record<string, number>;
+    declarativeRuleMutationCounts: Record<string, number>;
+    declarativeRuleExpectationFailures: string[];
+    declarativeRuleExamples: Array<{
+        rule_id: string;
+        heading: string;
+        before: string;
+        after: string;
+    }>;
+}
+export interface DeclarativeParagraphNormalizeRule {
+    id: string;
+    section_heading: string;
+    section_heading_any?: string[];
+    ignore_heading?: boolean;
+    paragraph_contains: string;
+    paragraph_end_contains?: string;
+    replacements?: Record<string, string>;
+    trim_unmatched_trailing_bracket?: boolean;
+    expected_min_matches?: number;
+}
+export interface DeclarativeNormalizeConfig {
+    paragraph_rules: DeclarativeParagraphNormalizeRule[];
+}
+export interface BracketNormalizationOptions {
+    rules?: DeclarativeParagraphNormalizeRule[];
+    fieldValues?: Record<string, string | boolean>;
+    blankPlaceholder?: string;
+}
+/**
+ * Normalize residual bracket artifacts in generated recipe documents.
+ *
+ * Strategy:
+ * - Unbracket simple single-level clauses (`[text]` -> `text`)
+ * - Remove complex/nested segments with unresolved placeholders
+ * - Remove orphan bracket characters and punctuation artifacts
+ * - Drop paragraphs that collapse to punctuation-only content
+ */
+export declare function normalizeBracketArtifacts(inputPath: string, outputPath: string, options?: BracketNormalizationOptions): Promise<BracketNormalizationStats>;
+//# sourceMappingURL=bracket-normalizer.d.ts.map

package/dist/core/recipe/bracket-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bracket-normalizer.d.ts","sourceRoot":"","sources":["../../../src/core/recipe/bracket-normalizer.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,yBAAyB;IACxC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,2BAA2B,EAAE,MAAM,CAAC;IACpC,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,6BAA6B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,kCAAkC,EAAE,MAAM,EAAE,CAAC;IAC7C,uBAAuB,EAAE,KAAK,CAAC;QAC7B,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,iCAAiC;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,+BAA+B,CAAC,EAAE,OAAO,CAAC;IAC1C,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,0BAA0B;IACzC,eAAe,EAAE,iCAAiC,EAAE,CAAC;CACtD;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,CAAC,EAAE,iCAAiC,EAAE,CAAC;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IAC/C,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,yBAAyB,CAAC,CA+HpC"}