@cogenta/import 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { WORDPRESS_IMPORT_COLLECTIONS, wpCategory, wpComment, wpPage, wpPost, wpTag, } from './wordpress/collections.js';
+export type { ContentConversionNote, ContentConversionResult, DraftBlock, } from './wordpress/content-convert.js';
+export { convertContent, mediaUrlsOf, resolveMediaReferences } from './wordpress/content-convert.js';
+export type { ImportWordPressOptions } from './wordpress/import.js';
+export { importWordPress } from './wordpress/import.js';
+export type { DownloadAndStoreMediaOptions, MediaDownloadFailure, MediaImportResult, } from './wordpress/media.js';
+export { downloadAndStoreMedia } from './wordpress/media.js';
+export { parseWxr } from './wordpress/parse.js';
+export type { ConversionReport, UnconvertedItem } from './wordpress/report.js';
+export { formatConversionReport } from './wordpress/report.js';
+export type { ParsedWxr, WxrAuthor, WxrCategory, WxrComment, WxrItem, WxrPostMeta, WxrTag, WxrTermRef, } from './wordpress/types.js';
+export type { XmlElement, XmlNode } from './wordpress/xml.js';
+export { parseXmlDocument } from './wordpress/xml.js';
+//# 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":"AAAA,OAAO,EACL,4BAA4B,EAC5B,UAAU,EACV,SAAS,EACT,MAAM,EACN,MAAM,EACN,KAAK,GACN,MAAM,4BAA4B,CAAA;AACnC,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,UAAU,GACX,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AACpG,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,YAAY,EACV,4BAA4B,EAC5B,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC/C,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,YAAY,EACV,SAAS,EACT,SAAS,EACT,WAAW,EACX,UAAU,EACV,OAAO,EACP,WAAW,EACX,MAAM,EACN,UAAU,GACX,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { WORDPRESS_IMPORT_COLLECTIONS, wpCategory, wpComment, wpPage, wpPost, wpTag, } from './wordpress/collections.js';
+export { convertContent, mediaUrlsOf, resolveMediaReferences } from './wordpress/content-convert.js';
+export { importWordPress } from './wordpress/import.js';
+export { downloadAndStoreMedia } from './wordpress/media.js';
+export { parseWxr } from './wordpress/parse.js';
+export { formatConversionReport } from './wordpress/report.js';
+export { parseXmlDocument } from './wordpress/xml.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,UAAU,EACV,SAAS,EACT,MAAM,EACN,MAAM,EACN,KAAK,GACN,MAAM,4BAA4B,CAAA;AAMnC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AAEpG,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAMvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAE/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAY9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/wordpress/collections.d.ts

@@ -0,0 +1,232 @@
+import { type CollectionDefinition } from '@cogenta/schema';
+/**
+ * The content model a WordPress import writes into.
+ *
+ * Deliberately its own set, not a reuse of `create-cogenta`'s `blog`
+ * blueprint collections: this import needs two fields the blueprint's `post`
+ * does not declare — `publishedAt` (so the entry's real WordPress publish
+ * date survives, rather than being overwritten by the system `createdAt`,
+ * which is always "now") and `customFields` (`f.json()`, the only field kind
+ * contract A offers with no fixed shape, for WordPress postmeta that has
+ * nowhere semantic to go). Running this import against a site that already
+ * has its own `post`/`category`/`tag`/`page` collections under those exact
+ * names — e.g. one scaffolded from the `blog` blueprint — is out of scope for
+ * this task: `createSchemaTables` only creates a table that does not exist
+ * yet, so combining the two is not exercised or supported here.
+ *
+ * `body` is a block zone (`f.blocks()`), not a single `f.richText()` field
+ * like the blueprint's `post.body`: WordPress content commonly mixes
+ * paragraphs, images, quotes, galleries and embeds, and contract B already
+ * has a semantic block for each of those (`prose`, `mediaFigure`, `quote`,
+ * `gallery`, `embed`) — collapsing all of it into one rich-text field would
+ * either lose the image/quote/embed structure or smuggle it through as
+ * embedded HTML, which rule R3 forbids outright.
+ */
+export declare const wpCategory: {
+    readonly name: "category";
+    readonly labels: {
+        readonly singular: "Category";
+        readonly plural: "Categories";
+    };
+    readonly routing: {
+        readonly pattern: "/blog/category/:slug";
+    };
+    readonly fields: {
+        name: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "text";
+            readonly options: Readonly<Record<string, unknown>>;
+        };
+        slug: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "slug";
+            readonly options: Readonly<Record<string, unknown>>;
+        };
+    };
+    readonly indexes: readonly [readonly ["slug"]];
+    readonly permissions: {
+        readonly read: readonly ["public"];
+        readonly create: readonly ["editor", "admin"];
+        readonly update: readonly ["editor", "admin"];
+        readonly delete: readonly ["admin"];
+    };
+};
+export declare const wpTag: {
+    readonly name: "tag";
+    readonly labels: {
+        readonly singular: "Tag";
+        readonly plural: "Tags";
+    };
+    readonly fields: {
+        name: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "text";
+            readonly options: Readonly<Record<string, unknown>>;
+        };
+        slug: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "slug";
+            readonly options: Readonly<Record<string, unknown>>;
+        };
+    };
+    readonly indexes: readonly [readonly ["slug"]];
+    readonly permissions: {
+        readonly read: readonly ["public"];
+        readonly create: readonly ["editor", "admin"];
+        readonly update: readonly ["editor", "admin"];
+        readonly delete: readonly ["admin"];
+    };
+};
+export declare const wpPost: {
+    readonly name: "post";
+    readonly labels: {
+        readonly singular: "Post";
+        readonly plural: "Posts";
+    };
+    readonly routing: {
+        readonly pattern: "/blog/:slug";
+    };
+    readonly versioning: {
+        readonly drafts: true;
+        readonly history: true;
+    };
+    readonly fields: {
+        title: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "text";
+            readonly options: Readonly<Record<string, unknown>>;
+        };
+        slug: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "slug";
+            readonly options: Readonly<Record<string, unknown>>;
+        };
+        excerpt: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "text";
+            readonly options: Readonly<Record<string, unknown>>;
+        };
+        body: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "blocks";
+            readonly options: {
+                allow: "*" | readonly string[];
+            };
+        };
+        publishedAt: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "datetime";
+            readonly options: {};
+        };
+        category: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "relation";
+            readonly options: {
+                to: string;
+                many: boolean;
+                onDelete: import("@cogenta/schema").OnDelete;
+            };
+        };
+        tags: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "relation";
+            readonly options: {
+                to: string;
+                many: boolean;
+                onDelete: import("@cogenta/schema").OnDelete;
+            };
+        };
+        /** Opaque WordPress postmeta — contract A has no free-form field kind, so this is the honest carrier for it. */
+        customFields: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "json";
+            readonly options: {};
+        };
+    };
+    readonly indexes: readonly [readonly ["slug"]];
+    readonly permissions: {
+        readonly read: readonly ["public"];
+        readonly create: readonly ["editor", "admin"];
+        readonly update: readonly ["editor", "admin"];
+        readonly delete: readonly ["admin"];
+        readonly publish: readonly ["admin"];
+    };
+};
+export declare const wpPage: {
+    readonly name: "page";
+    readonly labels: {
+        readonly singular: "Page";
+        readonly plural: "Pages";
+    };
+    readonly routing: {
+        readonly pattern: "/:slug";
+    };
+    readonly fields: {
+        title: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "text";
+            readonly options: Readonly<Record<string, unknown>>;
+        };
+        slug: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "slug";
+            readonly options: Readonly<Record<string, unknown>>;
+        };
+        body: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "blocks";
+            readonly options: {
+                allow: "*" | readonly string[];
+            };
+        };
+        publishedAt: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "datetime";
+            readonly options: {};
+        };
+        customFields: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "json";
+            readonly options: {};
+        };
+    };
+    readonly indexes: readonly [readonly ["slug"]];
+    readonly permissions: {
+        readonly read: readonly ["public"];
+        readonly create: readonly ["editor", "admin"];
+        readonly update: readonly ["editor", "admin"];
+        readonly delete: readonly ["admin"];
+    };
+};
+/**
+ * A minimal, real comment model — not a stub. WordPress comments have no
+ * declared-user identity (a commenter is a name and an email, not an
+ * account), so `author`/`authorEmail` are plain fields rather than a
+ * `relation` to a user; `post` ties a comment back to the entry it belongs
+ * to. Only fields the frozen field vocabulary (contract A) already offers
+ * are used, the same discipline `create-cogenta`'s blueprints follow.
+ */
+export declare const wpComment: {
+    readonly name: "comment";
+    readonly labels: {
+        readonly singular: "Comment";
+        readonly plural: "Comments";
+    };
+    readonly fields: {
+        post: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "relation";
+            readonly options: {
+                to: string;
+                many: boolean;
+                onDelete: import("@cogenta/schema").OnDelete;
+            };
+        };
+        author: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "text";
+            readonly options: Readonly<Record<string, unknown>>;
+        };
+        authorEmail: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "text";
+            readonly options: Readonly<Record<string, unknown>>;
+        };
+        body: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "text";
+            readonly options: Readonly<Record<string, unknown>>;
+        };
+        publishedAt: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "datetime";
+            readonly options: {};
+        };
+    };
+    readonly permissions: {
+        readonly read: readonly ["public"];
+        readonly create: readonly ["public"];
+        readonly update: readonly ["editor", "admin"];
+        readonly delete: readonly ["admin"];
+    };
+};
+export declare const WORDPRESS_IMPORT_COLLECTIONS: readonly CollectionDefinition[];
+//# sourceMappingURL=collections.d.ts.map

package/dist/wordpress/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../src/wordpress/collections.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,oBAAoB,EAI1B,MAAM,iBAAiB,CAAA;AAExB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;QAKnB,IAAI;;;;QACJ,IAAI;;;;;;;;;;;;CASN,CAAA;AAEF,eAAO,MAAM,KAAK;;;;;;;QAId,IAAI;;;;QACJ,IAAI;;;;;;;;;;;;CASN,CAAA;AAEF,eAAO,MAAM,MAAM;;;;;;;;;;;;;;QAMf,KAAK;;;;QACL,IAAI;;;;QACJ,OAAO;;;;QACP,IAAI;;;;;;QACJ,WAAW;;;;QACX,QAAQ;;;;;;;;QACR,IAAI;;;;;;;;QACJ,gHAAgH;QAChH,YAAY;;;;;;;;;;;;;CAUd,CAAA;AAEF,eAAO,MAAM,MAAM;;;;;;;;;;QAKf,KAAK;;;;QACL,IAAI;;;;QACJ,IAAI;;;;;;QACJ,WAAW;;;;QACX,YAAY;;;;;;;;;;;;CASd,CAAA;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS;;;;;;;QAIlB,IAAI;;;;;;;;QACJ,MAAM;;;;QACN,WAAW;;;;QACX,IAAI;;;;QACJ,WAAW;;;;;;;;;;;CAQb,CAAA;AAEF,eAAO,MAAM,4BAA4B,EAAE,SAAS,oBAAoB,EAMvE,CAAA"}

package/dist/wordpress/collections.js

@@ -0,0 +1,133 @@
+import { defineCollection, f, validateCollectionSet, } from '@cogenta/schema';
+/**
+ * The content model a WordPress import writes into.
+ *
+ * Deliberately its own set, not a reuse of `create-cogenta`'s `blog`
+ * blueprint collections: this import needs two fields the blueprint's `post`
+ * does not declare — `publishedAt` (so the entry's real WordPress publish
+ * date survives, rather than being overwritten by the system `createdAt`,
+ * which is always "now") and `customFields` (`f.json()`, the only field kind
+ * contract A offers with no fixed shape, for WordPress postmeta that has
+ * nowhere semantic to go). Running this import against a site that already
+ * has its own `post`/`category`/`tag`/`page` collections under those exact
+ * names — e.g. one scaffolded from the `blog` blueprint — is out of scope for
+ * this task: `createSchemaTables` only creates a table that does not exist
+ * yet, so combining the two is not exercised or supported here.
+ *
+ * `body` is a block zone (`f.blocks()`), not a single `f.richText()` field
+ * like the blueprint's `post.body`: WordPress content commonly mixes
+ * paragraphs, images, quotes, galleries and embeds, and contract B already
+ * has a semantic block for each of those (`prose`, `mediaFigure`, `quote`,
+ * `gallery`, `embed`) — collapsing all of it into one rich-text field would
+ * either lose the image/quote/embed structure or smuggle it through as
+ * embedded HTML, which rule R3 forbids outright.
+ */
+export const wpCategory = defineCollection({
+    name: 'category',
+    labels: { singular: 'Category', plural: 'Categories' },
+    routing: { pattern: '/blog/category/:slug' },
+    fields: {
+        name: f.text({ required: true, max: 200 }),
+        slug: f.slug({ from: 'name', unique: true }),
+    },
+    indexes: [['slug']],
+    permissions: {
+        read: ['public'],
+        create: ['editor', 'admin'],
+        update: ['editor', 'admin'],
+        delete: ['admin'],
+    },
+});
+export const wpTag = defineCollection({
+    name: 'tag',
+    labels: { singular: 'Tag', plural: 'Tags' },
+    fields: {
+        name: f.text({ required: true, max: 200 }),
+        slug: f.slug({ from: 'name', unique: true }),
+    },
+    indexes: [['slug']],
+    permissions: {
+        read: ['public'],
+        create: ['editor', 'admin'],
+        update: ['editor', 'admin'],
+        delete: ['admin'],
+    },
+});
+export const wpPost = defineCollection({
+    name: 'post',
+    labels: { singular: 'Post', plural: 'Posts' },
+    routing: { pattern: '/blog/:slug' },
+    versioning: { drafts: true, history: true },
+    fields: {
+        title: f.text({ required: true, max: 300 }),
+        slug: f.slug({ from: 'title', unique: true }),
+        excerpt: f.text({ max: 2000, multiline: true }),
+        body: f.blocks({ allow: ['prose', 'mediaFigure', 'quote', 'gallery', 'embed'] }),
+        publishedAt: f.datetime(),
+        category: f.relation({ to: 'category', onDelete: 'setNull' }),
+        tags: f.relation({ to: 'tag', many: true, onDelete: 'cascade' }),
+        /** Opaque WordPress postmeta — contract A has no free-form field kind, so this is the honest carrier for it. */
+        customFields: f.json(),
+    },
+    indexes: [['slug']],
+    permissions: {
+        read: ['public'],
+        create: ['editor', 'admin'],
+        update: ['editor', 'admin'],
+        delete: ['admin'],
+        publish: ['admin'],
+    },
+});
+export const wpPage = defineCollection({
+    name: 'page',
+    labels: { singular: 'Page', plural: 'Pages' },
+    routing: { pattern: '/:slug' },
+    fields: {
+        title: f.text({ required: true, max: 300 }),
+        slug: f.slug({ from: 'title', unique: true }),
+        body: f.blocks({ allow: ['prose', 'mediaFigure', 'quote', 'gallery', 'embed'] }),
+        publishedAt: f.datetime(),
+        customFields: f.json(),
+    },
+    indexes: [['slug']],
+    permissions: {
+        read: ['public'],
+        create: ['editor', 'admin'],
+        update: ['editor', 'admin'],
+        delete: ['admin'],
+    },
+});
+/**
+ * A minimal, real comment model — not a stub. WordPress comments have no
+ * declared-user identity (a commenter is a name and an email, not an
+ * account), so `author`/`authorEmail` are plain fields rather than a
+ * `relation` to a user; `post` ties a comment back to the entry it belongs
+ * to. Only fields the frozen field vocabulary (contract A) already offers
+ * are used, the same discipline `create-cogenta`'s blueprints follow.
+ */
+export const wpComment = defineCollection({
+    name: 'comment',
+    labels: { singular: 'Comment', plural: 'Comments' },
+    fields: {
+        post: f.relation({ to: 'post', onDelete: 'cascade', required: true }),
+        author: f.text({ required: true, max: 200 }),
+        authorEmail: f.text({ max: 320 }),
+        body: f.text({ required: true, multiline: true, max: 10000 }),
+        publishedAt: f.datetime(),
+    },
+    permissions: {
+        read: ['public'],
+        create: ['public'],
+        update: ['editor', 'admin'],
+        delete: ['admin'],
+    },
+});
+export const WORDPRESS_IMPORT_COLLECTIONS = [
+    wpPost,
+    wpPage,
+    wpCategory,
+    wpTag,
+    wpComment,
+];
+validateCollectionSet(WORDPRESS_IMPORT_COLLECTIONS);
+//# sourceMappingURL=collections.js.map

package/dist/wordpress/collections.js.map

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

package/dist/wordpress/content-convert.d.ts

@@ -0,0 +1,50 @@
+import type { EmbedBlock, GalleryBlock, MediaFigureBlock, ProseBlock, QuoteBlock } from '@cogenta/blocks';
+/**
+ * A block produced by this converter. Shaped exactly like the vocabulary
+ * (contract B) except that `media`/`gallery.items[].media` momentarily hold
+ * the *source URL* of the image rather than a `MediaAsset` id — `import.ts`
+ * downloads every referenced URL once, across the whole import, and
+ * `resolveMediaReferences` below substitutes the real ids afterwards. This
+ * keeps content conversion (pure, synchronous, heavily tested) separate from
+ * media download (network, best-effort, graceful on failure).
+ */
+export type DraftBlock = (Omit<ProseBlock, '_key' | '_version'> & {
+    readonly _key: string;
+}) | (Omit<MediaFigureBlock, '_key' | '_version' | 'media'> & {
+    readonly _key: string;
+    readonly media: string;
+}) | (Omit<QuoteBlock, '_key' | '_version'> & {
+    readonly _key: string;
+}) | (Omit<GalleryBlock, '_key' | '_version' | 'items'> & {
+    readonly _key: string;
+    readonly items: readonly {
+        readonly _key: string;
+        readonly media: string;
+    }[];
+}) | (Omit<EmbedBlock, '_key' | '_version'> & {
+    readonly _key: string;
+});
+export interface ContentConversionNote {
+    /** The Gutenberg block name, or an HTML tag name, that could not be represented. */
+    readonly source: string;
+    readonly reason: string;
+}
+export interface ContentConversionResult {
+    readonly blocks: readonly DraftBlock[];
+    readonly notes: readonly ContentConversionNote[];
+}
+/**
+ * Converts a post's `content:encoded` into the block vocabulary (contract B),
+ * best-effort. Everything that cannot be represented is named in `notes`
+ * rather than silently dropped or coerced into `prose` as raw HTML (rule R3).
+ */
+export declare function convertContent(content: string): ContentConversionResult;
+/** Every source URL a draft's blocks reference, so the caller can download them once, up front. */
+export declare function mediaUrlsOf(blocks: readonly DraftBlock[]): readonly string[];
+/**
+ * Substitutes real media ids for the source URLs `convertContent` left in
+ * place. A block whose image never downloaded is dropped rather than written
+ * with a dangling reference; a gallery that loses every item is dropped too.
+ */
+export declare function resolveMediaReferences(blocks: readonly DraftBlock[], urlToMediaId: ReadonlyMap<string, string>, notes: ContentConversionNote[]): readonly DraftBlock[];
+//# sourceMappingURL=content-convert.d.ts.map

package/dist/wordpress/content-convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-convert.d.ts","sourceRoot":"","sources":["../../src/wordpress/content-convert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,UAAU,EACX,MAAM,iBAAiB,CAAA;AAKxB;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAClB,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAAC,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACnE,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,GAAG;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB,CAAC,GACF,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAAC,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACnE,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,GAAG;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAC7E,CAAC,GACF,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAAC,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAEvE,MAAM,WAAW,qBAAqB;IACpC,oFAAoF;IACpF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAA;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,qBAAqB,EAAE,CAAA;CACjD;AAkKD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB,CAKvE;AAED,mGAAmG;AACnG,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,MAAM,EAAE,CAO5E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,KAAK,EAAE,qBAAqB,EAAE,GAC7B,SAAS,UAAU,EAAE,CAwCvB"}