emdash-emit 0.1.17 → 0.1.25

package/dist/sync/push/index.js

@@ -0,0 +1,372 @@
+/*
+ * Copyright (C) 2026 SPORT-SERVICE RS★R
+ *
+ * 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.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { extractRev, unwrapItem } from '../../client/api.js';
+import { ApiError } from '../../client/error.js';
+import { createAuthedFetch } from '../../client/http.js';
+import { withEntryLock } from '../../client/lock.js';
+import { localToApiPayload } from '../../client/mapper.js';
+import { articleContentEndpoint } from '../../client/endpoints.js';
+import { parseMarkdown } from '../../utils/frontmatter.js';
+import { syncRemoteBylines } from '../bylines.js';
+import { loadLocalTaxonomyCandidates, loadLocalTaxonomyMaps } from '../taxonomies.js';
+import { PushValidationError, assertNotQuarantinedCopy, evaluatePrePreflightGuards, evaluatePostPreflightGuards, } from './guards.js';
+import { executePreflightStage } from './preflight_stage.js';
+import { canonicalizeFrontmatterTaxonomies, syncArticleTaxonomies } from './taxonomy_plan.js';
+import { preserveOrResolveFeaturedImage, resolveFeaturedImageMediaId, uploadAndRewriteDraftImages, } from './media_stage.js';
+import { auditRemoteTaxonomies } from './tax_audit.js';
+import { resolveConflictAndMerge } from './merge_stage.js';
+import { commitPostPush } from './commit.js';
+import { throwRemoteArticleDeleted } from './transport.js';
+export { PushValidationError, };
+/**
+ * Pushes a local markdown article to remote EmDash with full preflight guards,
+ * two-tier lock lease protection, and automatic 3-way merge on conflict.
+ */
+export async function pushArticle(targetFilePath, options) {
+    const fetchFn = createAuthedFetch(options);
+    const fullPath = path.isAbsolute(targetFilePath)
+        ? targetFilePath
+        : path.join(options.workspaceRoot, targetFilePath);
+    if (!fs.existsSync(fullPath)) {
+        throw new Error(`Target file not found: ${targetFilePath}`);
+    }
+    const originalRelPath = path.relative(options.workspaceRoot, fullPath);
+    // Rescue copies under "<collection>/conflicts/" are deliberately unpushable.
+    assertNotQuarantinedCopy(originalRelPath);
+    const rawContent = fs.readFileSync(fullPath, 'utf8');
+    const parsed = parseMarkdown(rawContent, targetFilePath);
+    const id = parsed.frontmatter.id;
+    const collection = parsed.frontmatter.collection;
+    // Retrieve sync state and base snapshot
+    const syncState = options.cache.getSyncState(id);
+    const baseSnapshot = options.cache.getBaseSnapshot(id);
+    // Pre-load local taxonomy maps once for canonicalization, G4 guard, and remote sync
+    const taxonomyMaps = loadLocalTaxonomyMaps(options.workspaceRoot);
+    // Canonicalize frontmatter taxonomy terms in-place before preflight and payload creation
+    const { resolvedTaxonomies } = canonicalizeFrontmatterTaxonomies(parsed, taxonomyMaps);
+    // Pre-build taxonomy candidates with slugToName for frontmatter serialization with inline '# <Name>' comments
+    const candidates = options.candidates || loadLocalTaxonomyCandidates(options.workspaceRoot);
+    // If knownTaxonomies is not explicitly passed, populate from local categories/ and tags/ (if present)
+    let knownTaxonomies = options.knownTaxonomies;
+    if (!knownTaxonomies) {
+        const knownCats = Object.keys(taxonomyMaps.slugToId.category);
+        const knownTags = Object.keys(taxonomyMaps.slugToId.tag);
+        if (knownCats.length > 0 || knownTags.length > 0) {
+            knownTaxonomies = {
+                ...(knownCats.length > 0 ? { categories: knownCats } : {}),
+                ...(knownTags.length > 0 ? { tags: knownTags } : {}),
+            };
+        }
+    }
+    // 1. Guard against blind re-push when article is marked delete_pending (G15)
+    evaluatePrePreflightGuards(syncState, options, collection, id, targetFilePath);
+    // 2. Preflight Guards (including G6: UNRESOLVED_CONFLICT_MARKERS - T2-1 invariant)
+    const preflight = executePreflightStage(targetFilePath, parsed, options, syncState, baseSnapshot, knownTaxonomies);
+    // 3 & 4. Post-preflight guards (G16: taxonomy conflict pending, G17: taxonomy apply pending)
+    evaluatePostPreflightGuards(syncState, options, collection, id, targetFilePath);
+    // Track 1 (Transport Token): baseSnapshot holds the raw token from server. Prioritize it to prevent 409 conflicts.
+    const currentRev = baseSnapshot?.rev || syncState?.remoteRev || '';
+    const warnings = [...preflight.warnings];
+    // Load local bylines map for converting frontmatter byline slugs to ULIDs
+    let bylineSlugToId = options.bylineSlugToId;
+    if (!bylineSlugToId) {
+        const cachedMaps = options.cache.getBylineMaps();
+        if (Object.keys(cachedMaps.slugToId).length > 0) {
+            bylineSlugToId = cachedMaps.slugToId;
+        }
+        else {
+            const freshMaps = await syncRemoteBylines({
+                origin: options.origin,
+                token: options.token,
+                refreshToken: options.refreshToken,
+                cache: options.cache,
+                fetchFn: options.fetchFn,
+            }).catch(() => ({ slugToId: {}, idToSlug: {} }));
+            bylineSlugToId = freshMaps.slugToId;
+        }
+    }
+    const effectiveOptions = {
+        ...options,
+        bylineSlugToId,
+    };
+    const isNewArticle = !syncState;
+    if (isNewArticle) {
+        // Upload/resolve standalone draft images and rewrite body
+        const { body: rewrittenBody, uploadedByAbsPath } = await uploadAndRewriteDraftImages(parsed.body, preflight.draftImages, options, fetchFn);
+        parsed.body = rewrittenBody;
+        const fiResolution = resolveFeaturedImageMediaId(parsed.frontmatter.featuredImage, uploadedByAbsPath, targetFilePath, options.workspaceRoot);
+        if (fiResolution) {
+            parsed.frontmatter.featuredImage = fiResolution.mediaId;
+        }
+        else if (parsed.frontmatter.featuredImage) {
+            // Defensive guard (W1): preflight guarantees resolution, but fail-fast if an unresolved value reaches push
+            throw new Error(`Failed to resolve featuredImage '${parsed.frontmatter.featuredImage}' to a media record ID during push.`);
+        }
+        const payload = localToApiPayload(parsed, '', effectiveOptions);
+        warnings.push(...preserveOrResolveFeaturedImage(payload, parsed.frontmatter.featuredImage, options.cache, id, options.workspaceRoot, { skipCompanionCheck: fiResolution?.autoUploaded }));
+        const postUrl = articleContentEndpoint(options.origin, collection);
+        const res = await fetchFn(postUrl, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${options.token}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(payload),
+        });
+        if (!res.ok) {
+            const errBody = await res.text().catch(() => '');
+            const slugConflictDetail = 'slug-conflict-detail';
+            let remoteSlug;
+            let conflictSignal = false;
+            try {
+                const parsedJson = JSON.parse(errBody);
+                const errObj = parsedJson?.error || parsedJson;
+                remoteSlug = errObj?.details?.slug;
+                if (errObj?.code === 'SLUG_CONFLICT') {
+                    conflictSignal = true;
+                }
+                else if (remoteSlug !== undefined) {
+                    conflictSignal = slugConflictDetail;
+                }
+                else if (!errObj?.code && (res.status === 409 || res.status === 422)) {
+                    conflictSignal = /slug/i.test(errObj?.message || '');
+                }
+            }
+            catch {
+                conflictSignal =
+                    (res.status === 409 || res.status === 422 ? /slug/i.test(errBody) : false) ||
+                        /slug.*(?:already exists|conflict)|unique constraint.*slug/i.test(errBody);
+            }
+            const isSlugConflict = conflictSignal === true || conflictSignal === slugConflictDetail;
+            const suggestion = isSlugConflict
+                ? [
+                    `An article with slug "${remoteSlug || parsed.frontmatter.slug}" already exists on remote.`,
+                    'Change the "slug" field in frontmatter and re-run',
+                    `"emit push ${targetFilePath}" (Emit will automatically update the filename and cache).`,
+                    'Note: EmDash keeps slugs reserved for trashed entries too, so a slug freed by deletion may still be taken.',
+                ].join(' ')
+                : 'Check if an article with this slug already exists or if token has create permissions.';
+            throw new ApiError({
+                message: `Create push failed: ${res.statusText} - ${errBody}`,
+                code: 'PUSH_CREATE_FAILED',
+                status: res.status,
+                endpoint: postUrl,
+                suggestion,
+            });
+        }
+        const createdJson = await res.json();
+        const createdItem = unwrapItem(createdJson);
+        const actualId = String(createdItem.id || id);
+        const newRev = extractRev(createdJson, '1');
+        parsed.frontmatter.id = actualId;
+        const taxFailures = await syncArticleTaxonomies({
+            articleId: actualId,
+            collection,
+            parsed,
+            taxonomyMaps,
+            resolvedTaxonomies,
+            baseSnapshot,
+            options,
+            fetchFn,
+            warnings,
+        });
+        return await commitPostPush({
+            mode: 'create',
+            actualId,
+            originalId: id,
+            originalRelPath,
+            fullPath,
+            newRev,
+            parsed,
+            rawContent,
+            draftImages: preflight.draftImages,
+            uploadedByAbsPath,
+            candidates,
+            taxFailures,
+            resolvedTaxonomies,
+            options,
+            fetchFn,
+            warnings,
+            createdItemCreatedAt: createdItem.createdAt || null,
+            updatedRawItem: createdJson,
+        });
+    }
+    // Existing article: execute within full 7-minute entry lock lease
+    return await withEntryLock(collection, id, options, async () => {
+        const { body: rewrittenBody, uploadedByAbsPath } = await uploadAndRewriteDraftImages(parsed.body, preflight.draftImages, options, fetchFn);
+        parsed.body = rewrittenBody;
+        const fiResolution = resolveFeaturedImageMediaId(parsed.frontmatter.featuredImage, uploadedByAbsPath, targetFilePath, options.workspaceRoot);
+        if (fiResolution) {
+            parsed.frontmatter.featuredImage = fiResolution.mediaId;
+        }
+        else if (parsed.frontmatter.featuredImage) {
+            // Defensive guard (W1): preflight guarantees resolution, but fail-fast if an unresolved value reaches push
+            throw new Error(`Failed to resolve featuredImage '${parsed.frontmatter.featuredImage}' to a media record ID during push.`);
+        }
+        let payload = localToApiPayload(parsed, currentRev, effectiveOptions);
+        warnings.push(...preserveOrResolveFeaturedImage(payload, parsed.frontmatter.featuredImage, options.cache, id, options.workspaceRoot, { skipCompanionCheck: fiResolution?.autoUploaded }));
+        const putUrl = articleContentEndpoint(options.origin, collection, id);
+        // Pre-PUT Taxonomy Audit
+        const { remoteTaxAudit, taxonomyDivergenceDetected } = await auditRemoteTaxonomies({
+            collection,
+            id,
+            parsed,
+            syncState,
+            baseSnapshot,
+            options,
+            fetchFn,
+            warnings,
+        });
+        let res = null;
+        if (!taxonomyDivergenceDetected) {
+            res = await fetchFn(putUrl, {
+                method: 'PUT',
+                headers: {
+                    Authorization: `Bearer ${options.token}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(payload),
+            });
+            if (res.status === 404 || res.status === 410) {
+                throwRemoteArticleDeleted(collection, id, targetFilePath, putUrl);
+            }
+        }
+        // Handle 409 Conflict or detected taxonomy divergence
+        if (taxonomyDivergenceDetected || res?.status === 409) {
+            const conflictOutcome = await resolveConflictAndMerge({
+                collection,
+                id,
+                targetFilePath,
+                fullPath,
+                putUrl,
+                res,
+                taxonomyDivergenceDetected,
+                parsed,
+                syncState,
+                baseSnapshot,
+                remoteTaxAudit,
+                candidates,
+                options,
+                fetchFn,
+                warnings,
+            });
+            if (conflictOutcome.handled && conflictOutcome.pushResult) {
+                return conflictOutcome.pushResult;
+            }
+            if (conflictOutcome.mergedParsed && conflictOutcome.remoteParsedRev) {
+                parsed.frontmatter = conflictOutcome.mergedParsed.frontmatter;
+                parsed.body = conflictOutcome.mergedParsed.body;
+                payload = localToApiPayload(parsed, conflictOutcome.remoteParsedRev, effectiveOptions);
+                warnings.push(...preserveOrResolveFeaturedImage(payload, parsed.frontmatter.featuredImage, options.cache, id, options.workspaceRoot, {
+                    skipCompanionCheck: fiResolution?.mediaId === parsed.frontmatter.featuredImage &&
+                        fiResolution?.autoUploaded,
+                }));
+                res = await fetchFn(putUrl, {
+                    method: 'PUT',
+                    headers: {
+                        Authorization: `Bearer ${options.token}`,
+                        'Content-Type': 'application/json',
+                    },
+                    body: JSON.stringify(payload),
+                });
+                if (!res.ok) {
+                    if (res.status === 404 || res.status === 410) {
+                        throwRemoteArticleDeleted(collection, id, targetFilePath, putUrl);
+                    }
+                    const errText = await res.text().catch(() => '');
+                    const mergeResult = conflictOutcome.mergeResult;
+                    if ((res.status === 400 || res.status === 422) &&
+                        ((mergeResult?.autoMergedTaxonomies && mergeResult.autoMergedTaxonomies.length > 0) ||
+                            (mergeResult?.strategyAdoptions && mergeResult.strategyAdoptions.length > 0))) {
+                        const wasStrategy = mergeResult.strategyAdoptions && mergeResult.strategyAdoptions.length > 0;
+                        throw new ApiError({
+                            message: `Remote server rejected the merged taxonomy union (HTTP ${res.status}): ${errText || res.statusText}`,
+                            code: 'TAXONOMY_UNION_REJECTED',
+                            status: res.status,
+                            endpoint: putUrl,
+                            suggestion: wasStrategy
+                                ? 'The remote server rejected the taxonomy adopted by your strategy (e.g. single-category constraint). Switch strategy with "--resolve-taxonomy=remote" or edit the frontmatter manually before pushing.'
+                                : 'The remote server enforces constraints that reject combining local and remote taxonomy terms (e.g. single-category constraint). Resolve by explicitly choosing a side: "emit push <file> --resolve-taxonomy=local" (or remote), or edit the frontmatter manually.',
+                        });
+                    }
+                    throw new ApiError({
+                        message: `Retry push after auto-merge failed: ${res.statusText}${errText ? ` - ${errText}` : ''}`,
+                        code: 'PUSH_RETRY_FAILED',
+                        status: res.status,
+                        endpoint: putUrl,
+                        suggestion: 'Another change might have been committed in the meantime. Try pulling again.',
+                    });
+                }
+            }
+        }
+        if (!res || !res.ok) {
+            if (res && (res.status === 404 || res.status === 410)) {
+                throwRemoteArticleDeleted(collection, id, targetFilePath, putUrl);
+            }
+            const errText = res ? await res.text().catch(() => '') : '';
+            throw new ApiError({
+                message: `Push failed: ${res ? res.statusText : 'Request failed'}${errText ? ` - ${errText}` : ''}`,
+                code: 'PUSH_FAILED',
+                status: res ? res.status : 500,
+                endpoint: putUrl,
+                suggestion: 'Verify network connectivity, token permissions, and article status.',
+            });
+        }
+        const updatedJson = await res.json().catch(() => ({}));
+        const newRev = extractRev(updatedJson, currentRev);
+        const taxFailures = await syncArticleTaxonomies({
+            articleId: id,
+            collection,
+            parsed,
+            taxonomyMaps,
+            resolvedTaxonomies,
+            baseSnapshot,
+            options,
+            fetchFn,
+            warnings,
+        });
+        return await commitPostPush({
+            mode: 'update',
+            actualId: id,
+            originalId: id,
+            originalRelPath,
+            fullPath,
+            newRev,
+            parsed,
+            rawContent,
+            draftImages: preflight.draftImages,
+            uploadedByAbsPath,
+            candidates,
+            taxFailures,
+            resolvedTaxonomies,
+            options,
+            fetchFn,
+            warnings,
+            syncState,
+            baseSnapshot,
+            updatedRawItem: updatedJson,
+        });
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/sync/push/index.js.map

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

package/dist/sync/push/media_stage.d.ts

@@ -0,0 +1,56 @@
+import { type localToApiPayload } from '../../client/mapper.js';
+import { type UploadMediaResult } from '../../client/media.js';
+import type { CacheDatabase } from '../../db/cache.js';
+import { type DraftImageReference } from '../preflight.js';
+import type { PushOptions } from './types.js';
+export interface FeaturedImageResolveOptions {
+    skipCompanionCheck?: boolean;
+}
+/**
+ * Resolves the canonical media record ULID for frontmatter featuredImage.
+ *
+ * If featuredImage is a local path (draft or promoted), it resolves the mediaId from
+ * the shared uploadedByAbsPath map. Returns autoUploaded: true when resolved from
+ * a newly uploaded or reused draft image reference so that advisory verification
+ * warnings can be suppressed.
+ */
+export declare function resolveFeaturedImageMediaId(featuredImage: string | null | undefined, uploadedByAbsPath: Map<string, UploadMediaResult>, filePath: string, workspaceRoot?: string): {
+    mediaId: string;
+    autoUploaded: boolean;
+} | null;
+/**
+ * Featured-image preservation / resolution helper.
+ *
+ * EmDash stores `featured_image: { id: "<ULID>" }`.
+ * When pushing an article whose frontmatter sets `featuredImage: <ULID>`, Emit cross-checks that the
+ * referenced media exists locally (or was mirrored), and preserves the exact remote object structure
+ * from the cache when unchanged.
+ */
+export declare function preserveOrResolveFeaturedImage(payload: ReturnType<typeof localToApiPayload>, featuredImage: string | null | undefined, cache: CacheDatabase | undefined, id: string, workspaceRoot?: string, options?: FeaturedImageResolveOptions): string[];
+/**
+ * Rewrites standalone local draft image lines in Markdown body to their confirmed
+ * canonical root-relative URLs (`/_emdash/api/media/file/<storageKey>`), skipping
+ * fenced code blocks and opaque block fences.
+ */
+export declare function rewriteDraftImagesInBody(body: string, draftImages: DraftImageReference[], uploadedByAbsPath: Map<string, UploadMediaResult>): string;
+/**
+ * Promotes uploaded draft images from `media/drafts/<filename>` into
+ * `media/<markdownRef>.<ext>` along with companion `.yaml` metadata, where markdownRef is derived from the
+ * and commits `status = 'ready'` in `media_state`.
+ *
+ * Protected by try/catch per asset (C-2) so that any local filesystem failure
+ * after a successful remote article PUT/POST is downgraded to a warning rather than
+ * aborting `saveBaseSnapshot` / `saveSyncState`.
+ */
+export declare function finalizePromotedDraftImages(draftImages: DraftImageReference[], uploadedByAbsPath: Map<string, UploadMediaResult>, options: PushOptions, warnings: string[]): void;
+/**
+ * Executes P2–P4 (upload/resolve draft images and rewrite Markdown body in-memory).
+ * Already-promoted assets are verified against the remote before their canonical URL is
+ * baked into the body, so a media record deleted on the EmDash side can never produce an
+ * article that renders HTTP 404 images in production.
+ */
+export declare function uploadAndRewriteDraftImages(body: string, draftImages: DraftImageReference[], options: PushOptions, fetchFn: typeof fetch): Promise<{
+    body: string;
+    uploadedByAbsPath: Map<string, UploadMediaResult>;
+}>;
+//# sourceMappingURL=media_stage.d.ts.map

package/dist/sync/push/media_stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media_stage.d.ts","sourceRoot":"","sources":["../../../src/sync/push/media_stage.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAyB,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAElF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,2BAA2B;IAC1C,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACxC,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,EACjD,QAAQ,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,MAAM,GACrB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAkBnD;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,EAC7C,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACxC,KAAK,EAAE,aAAa,GAAG,SAAS,EAChC,EAAE,EAAE,MAAM,EACV,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,2BAA2B,GACpC,MAAM,EAAE,CA0FV;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,mBAAmB,EAAE,EAClC,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAChD,MAAM,CA8CR;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,mBAAmB,EAAE,EAClC,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,EACjD,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,MAAM,EAAE,GACjB,IAAI,CA4FN;AAED;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,mBAAmB,EAAE,EAClC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,OAAO,KAAK,GACpB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;CAAE,CAAC,CAwE9E"}