@notionx/create-notionx-app 1.0.0

package/dist/registry/migration-planner.js

@@ -0,0 +1,204 @@
+// packages/create-notionx-app/src/registry/migration-planner.ts
+//
+// Convert catalog `RegistryItem.migrations` into a sequenced
+// `UpdatePlan` that the CLI can show, then turn into files.
+//
+// The planner is **pure**: it does no I/O, takes the catalog + the
+// installed manifest as inputs, and returns a plan. That makes
+// it easy to test the bookkeeping (idempotency, downgrade
+// detection, version-chain selection) without touching the file
+// system.
+/**
+ * Look up the migration chain (a sequence of `from`/`to` hops)
+ * that the planner is walking. Each hop is recorded as
+ * `<itemId> <fromV>-><toV>` in the applied migration's `label`
+ * (e.g. `blog 1->2`). The chain is a map from item id to the
+ * list of `fromV->toV` strings the user has already applied.
+ */
+function indexAppliedChains(applied) {
+    const out = new Map();
+    for (const m of applied) {
+        if (!m.label)
+            continue;
+        // Convention: `<itemId> <fromV>-><toV>`.
+        const match = m.label.match(/^(.+)\s+(\d+)->(\d+)$/);
+        if (!match)
+            continue;
+        const [, itemId, fromV, toV] = match;
+        if (!itemId || !fromV || !toV)
+            continue;
+        const key = itemId;
+        let set = out.get(key);
+        if (!set) {
+            set = new Set();
+            out.set(key, set);
+        }
+        set.add(`${fromV}->${toV}`);
+    }
+    return out;
+}
+/**
+ * Walk the catalog and the installed manifest, producing an
+ * `UpdatePlan` of every step that needs to run to bring
+ * `installed` up to date with `catalogItems`.
+ *
+ * What the planner does **not** do:
+ *   - I/O. No file writes. The writer (`update.ts`) handles that.
+ *   - Apply migrations itself. It just describes them.
+ *   - Run codemods. Codemods are listed under `codemodTargets` and
+ *     re-rendered as a hint to the user (and consumed by the
+ *     writer).
+ */
+export function buildUpdatePlan(input) {
+    const plan = {
+        additive: [],
+        destructive: [],
+        noop: [],
+        renderedFiles: [],
+        codemodTargets: [],
+    };
+    const appliedChains = indexAppliedChains(input.appliedMigrations);
+    for (const item of input.installed) {
+        const catalog = input.catalogItems.find((c) => c.id === item.id);
+        if (!catalog)
+            continue; // unknown / third-party item
+        if (catalog.version < item.version) {
+            // Catalog is behind the project — never auto-downgrade.
+            continue;
+        }
+        if (catalog.version === item.version) {
+            // Up to date. Skip.
+            continue;
+        }
+        // Find the **single hop** that starts at the project's
+        // currently-installed version. We do *not* walk a multi-hop
+        // chain here — each RegistryItem.migrations entry is one
+        // hop, and the catalog author is expected to provide a
+        // cumulative `from: "<id>@<currentV>", to: "<id>@<newV>"`
+        // migration that bundles every step needed.
+        //
+        // After the user applies the hop, the next `notionx update`
+        // call picks up the next one. This keeps each migration
+        // independently testable + reversible.
+        const hop = catalog.migrations.find((m) => {
+            const fromV = parseInt(m.from.split("@")[1] ?? "", 10);
+            return fromV === item.version;
+        });
+        if (!hop)
+            continue;
+        const toV = parseInt(hop.to.split("@")[1] ?? "", 10);
+        if (Number.isNaN(toV) || toV <= item.version)
+            continue;
+        const hopApplied = appliedChains.get(item.id)?.has(`${item.version}->${toV}`) ?? false;
+        for (const step of hop.steps) {
+            const planStep = toPlannedStep(item, step);
+            if (!planStep)
+                continue;
+            if (hopApplied) {
+                plan.noop.push(planStep);
+                continue;
+            }
+            if (isDestructiveStep(planStep)) {
+                plan.destructive.push(planStep);
+            }
+            else {
+                plan.additive.push(planStep);
+            }
+            if (planStep.kind === "ts-codemod") {
+                plan.codemodTargets.push(...planStep.targets);
+            }
+        }
+    }
+    return plan;
+}
+function parseInt(s, radix) {
+    return globalThis.parseInt(s, radix);
+}
+function toPlannedStep(item, step) {
+    switch (step.kind) {
+        case "notion-field-add":
+            return {
+                kind: "notion-field-add",
+                itemId: item.id,
+                dataSourceEnv: step.source,
+                property: step.property,
+                type: step.type,
+            };
+        case "notion-field-rename":
+            return {
+                kind: "notion-field-rename",
+                itemId: item.id,
+                dataSourceEnv: step.source,
+                from: step.from,
+                to: step.to,
+            };
+        case "notion-field-deprecate":
+            return {
+                kind: "notion-field-deprecate",
+                itemId: item.id,
+                dataSourceEnv: step.source,
+                property: step.property,
+                ...(step.fallback !== undefined
+                    ? { fallback: step.fallback }
+                    : {}),
+            };
+        case "d1-table-create":
+            return {
+                kind: "d1-table-create",
+                itemId: item.id,
+                tableName: step.name,
+                sql: step.sql,
+            };
+        case "d1-table-alter":
+            return {
+                kind: "d1-table-alter",
+                itemId: item.id,
+                tableName: step.name,
+                sql: step.sql,
+            };
+        case "ts-codemod":
+            return {
+                kind: "ts-codemod",
+                itemId: item.id,
+                transform: step.transform,
+                targets: [step.file],
+            };
+        case "env-add":
+            return {
+                kind: "env-add",
+                itemId: item.id,
+                name: step.name,
+                ...(step.default !== undefined ? { default: step.default } : {}),
+                ...(step.secret !== undefined ? { secret: step.secret } : {}),
+            };
+        case "config-merge":
+            return {
+                kind: "config-merge",
+                itemId: item.id,
+                file: step.file,
+                json: step.json,
+            };
+        case "d1-migration-file":
+            return {
+                kind: "d1-migration-file",
+                itemId: item.id,
+                file: step.file,
+            };
+    }
+}
+function isDestructiveStep(step) {
+    switch (step.kind) {
+        case "notion-field-rename":
+        case "notion-field-deprecate":
+        case "d1-table-alter":
+            return true;
+        case "notion-field-add":
+        case "d1-table-create":
+        case "ts-codemod":
+        case "env-add":
+        case "config-merge":
+        case "d1-migration-file":
+            return false;
+    }
+}
+//# sourceMappingURL=migration-planner.js.map

package/dist/registry/migration-planner.js.map

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

package/dist/registry/migration-planner.test.js

@@ -0,0 +1,340 @@
+// packages/create-notionx-app/src/registry/migration-planner.test.ts
+import { describe, expect, it } from "vitest";
+import { buildUpdatePlan } from "./migration-planner.js";
+const OFFICIAL = {
+    kind: "official",
+    name: "@notionx/official",
+};
+function installedItem(id, version) {
+    return {
+        id,
+        kind: "content-source",
+        version,
+        source: OFFICIAL,
+        params: { contentSourceId: id },
+        installedAt: "2026-06-10T00:00:00.000Z",
+    };
+}
+function blogV2() {
+    return {
+        id: "blog",
+        kind: "content-source",
+        version: 2,
+        source: OFFICIAL,
+        publishedAt: "2026-06-15T00:00:00.000Z",
+        params: { contentSourceId: "blog" },
+        files: [],
+        capabilities: { envVars: ["NOTION_BLOG_DATA_SOURCE_ID"] },
+        migrations: [
+            {
+                from: "blog@1",
+                to: "blog@2",
+                steps: [
+                    {
+                        kind: "notion-field-add",
+                        source: "NOTION_BLOG_DATA_SOURCE_ID",
+                        property: "Author",
+                        type: "people",
+                    },
+                    {
+                        kind: "notion-field-rename",
+                        source: "NOTION_BLOG_DATA_SOURCE_ID",
+                        from: "Eyebrow",
+                        to: "Subheadline",
+                    },
+                ],
+            },
+        ],
+    };
+}
+describe("buildUpdatePlan", () => {
+    it("returns an empty plan when the installed version equals the catalog version", () => {
+        const plan = buildUpdatePlan({
+            installed: [installedItem("blog", 2)],
+            catalogItems: [blogV2()],
+            appliedMigrations: [],
+        });
+        expect(plan.additive).toEqual([]);
+        expect(plan.destructive).toEqual([]);
+        expect(plan.noop).toEqual([]);
+    });
+    it("classifies notion-field-add as additive (safe, no data loss)", () => {
+        const plan = buildUpdatePlan({
+            installed: [installedItem("blog", 1)],
+            catalogItems: [blogV2()],
+            appliedMigrations: [],
+        });
+        const add = plan.additive.find((s) => s.kind === "notion-field-add");
+        expect(add).toMatchObject({
+            kind: "notion-field-add",
+            itemId: "blog",
+            dataSourceEnv: "NOTION_BLOG_DATA_SOURCE_ID",
+            property: "Author",
+            type: "people",
+        });
+        // The destructive bucket contains the rename — that's a
+        // *separate* step. The test only checks add isn't in
+        // destructive.
+        expect(plan.destructive.find((s) => s.kind === "notion-field-add")).toBeUndefined();
+    });
+    it("classifies notion-field-rename as destructive (could lose data if it aliases to a wrong prop)", () => {
+        const plan = buildUpdatePlan({
+            installed: [installedItem("blog", 1)],
+            catalogItems: [blogV2()],
+            appliedMigrations: [],
+        });
+        const rename = plan.destructive.find((s) => s.kind === "notion-field-rename");
+        expect(rename).toMatchObject({
+            kind: "notion-field-rename",
+            from: "Eyebrow",
+            to: "Subheadline",
+        });
+    });
+    it("skips steps whose migration is already in appliedMigrations (idempotent)", () => {
+        const applied = [
+            {
+                sequence: "0001",
+                itemId: "blog",
+                itemKind: "content-source",
+                label: "blog 1->2",
+                file: { kind: "notion-diff", filename: "0001_blog.notion-diff.json" },
+                generatedAt: "2026-06-15T00:00:00.000Z",
+                applied: true,
+                appliedAt: "2026-06-15T01:00:00.000Z",
+            },
+        ];
+        const plan = buildUpdatePlan({
+            installed: [installedItem("blog", 1)],
+            catalogItems: [blogV2()],
+            appliedMigrations: applied,
+        });
+        expect(plan.additive).toEqual([]);
+        expect(plan.destructive).toEqual([]);
+        expect(plan.noop.length).toBeGreaterThanOrEqual(2);
+    });
+    it("skips items the catalog does not know about (third-party items)", () => {
+        const plan = buildUpdatePlan({
+            installed: [installedItem("custom-team-source", 1)],
+            catalogItems: [blogV2()],
+            appliedMigrations: [],
+        });
+        expect(plan.additive).toEqual([]);
+        expect(plan.destructive).toEqual([]);
+    });
+    it("only emits migrations for the installed version, not for future versions", () => {
+        // v1 installed, v3 in catalog. There's no v1->v2->v3 chain
+        // expressed in the catalog, so the planner should only emit
+        // v1->v2.
+        const blogV3 = {
+            ...blogV2(),
+            version: 3,
+            migrations: [
+                {
+                    from: "blog@1",
+                    to: "blog@2",
+                    steps: [
+                        {
+                            kind: "notion-field-add",
+                            source: "NOTION_BLOG_DATA_SOURCE_ID",
+                            property: "Author",
+                            type: "people",
+                        },
+                    ],
+                },
+                {
+                    from: "blog@2",
+                    to: "blog@3",
+                    steps: [
+                        {
+                            kind: "d1-table-create",
+                            name: "blog_authors",
+                            sql: "CREATE TABLE blog_authors (id INTEGER PRIMARY KEY);",
+                        },
+                    ],
+                },
+            ],
+        };
+        const plan = buildUpdatePlan({
+            installed: [installedItem("blog", 1)],
+            catalogItems: [blogV3],
+            appliedMigrations: [],
+        });
+        // We only get v1->v2 in the plan; v2->v3 is not yet reachable.
+        expect(plan.additive.length).toBe(1);
+        expect(plan.additive[0]).toMatchObject({
+            kind: "notion-field-add",
+            property: "Author",
+        });
+    });
+    it("returns an empty plan when the installed version is *newer* than the catalog (downgrade blocked)", () => {
+        const plan = buildUpdatePlan({
+            installed: [installedItem("blog", 5)],
+            catalogItems: [blogV2()], // catalog only has v2
+            appliedMigrations: [],
+        });
+        expect(plan.additive).toEqual([]);
+        expect(plan.destructive).toEqual([]);
+    });
+});
+describe("buildUpdatePlan: codemod support", () => {
+    it("includes ts-codemod steps in the additive bucket", () => {
+        const item = {
+            id: "blog",
+            kind: "content-source",
+            version: 2,
+            source: OFFICIAL,
+            publishedAt: "2026-06-15T00:00:00.000Z",
+            params: { contentSourceId: "blog" },
+            files: [],
+            capabilities: {},
+            migrations: [
+                {
+                    from: "blog@1",
+                    to: "blog@2",
+                    steps: [
+                        {
+                            kind: "ts-codemod",
+                            file: "app/blog/page.tsx",
+                            transform: "rename-eyebrow-to-subheadline",
+                        },
+                    ],
+                },
+            ],
+        };
+        const plan = buildUpdatePlan({
+            installed: [installedItem("blog", 1)],
+            catalogItems: [item],
+            appliedMigrations: [],
+        });
+        expect(plan.additive).toEqual([
+            {
+                kind: "ts-codemod",
+                itemId: "blog",
+                transform: "rename-eyebrow-to-subheadline",
+                targets: ["app/blog/page.tsx"],
+            },
+        ]);
+        expect(plan.codemodTargets).toEqual(["app/blog/page.tsx"]);
+    });
+});
+describe("buildUpdatePlan: env-add / config-merge / d1-migration-file", () => {
+    it("classifies env-add as additive and forwards name/default/secret", () => {
+        const item = {
+            id: "blog",
+            kind: "content-source",
+            version: 2,
+            source: OFFICIAL,
+            publishedAt: "2026-06-15T00:00:00.000Z",
+            params: { contentSourceId: "blog" },
+            files: [],
+            capabilities: {},
+            migrations: [
+                {
+                    from: "blog@1",
+                    to: "blog@2",
+                    steps: [
+                        {
+                            kind: "env-add",
+                            name: "BLOG_SEARCH_INDEX_KEY",
+                            default: "dev-key",
+                            secret: true,
+                        },
+                    ],
+                },
+            ],
+        };
+        const plan = buildUpdatePlan({
+            installed: [installedItem("blog", 1)],
+            catalogItems: [item],
+            appliedMigrations: [],
+        });
+        expect(plan.additive).toEqual([
+            {
+                kind: "env-add",
+                itemId: "blog",
+                name: "BLOG_SEARCH_INDEX_KEY",
+                default: "dev-key",
+                secret: true,
+            },
+        ]);
+        expect(plan.destructive).toEqual([]);
+    });
+    it("classifies config-merge as additive and forwards file/json", () => {
+        const mergeJson = { compatibility_date: "2026-07-01" };
+        const item = {
+            id: "blog",
+            kind: "content-source",
+            version: 2,
+            source: OFFICIAL,
+            publishedAt: "2026-06-15T00:00:00.000Z",
+            params: { contentSourceId: "blog" },
+            files: [],
+            capabilities: {},
+            migrations: [
+                {
+                    from: "blog@1",
+                    to: "blog@2",
+                    steps: [
+                        {
+                            kind: "config-merge",
+                            file: "wrangler.jsonc",
+                            json: mergeJson,
+                        },
+                    ],
+                },
+            ],
+        };
+        const plan = buildUpdatePlan({
+            installed: [installedItem("blog", 1)],
+            catalogItems: [item],
+            appliedMigrations: [],
+        });
+        expect(plan.additive).toEqual([
+            {
+                kind: "config-merge",
+                itemId: "blog",
+                file: "wrangler.jsonc",
+                json: mergeJson,
+            },
+        ]);
+        expect(plan.destructive).toEqual([]);
+    });
+    it("classifies d1-migration-file as additive and forwards file", () => {
+        const item = {
+            id: "blog",
+            kind: "content-source",
+            version: 2,
+            source: OFFICIAL,
+            publishedAt: "2026-06-15T00:00:00.000Z",
+            params: { contentSourceId: "blog" },
+            files: [],
+            capabilities: {},
+            migrations: [
+                {
+                    from: "blog@1",
+                    to: "blog@2",
+                    steps: [
+                        {
+                            kind: "d1-migration-file",
+                            file: "migrations/0002_add_blog_indexes.sql",
+                        },
+                    ],
+                },
+            ],
+        };
+        const plan = buildUpdatePlan({
+            installed: [installedItem("blog", 1)],
+            catalogItems: [item],
+            appliedMigrations: [],
+        });
+        expect(plan.additive).toEqual([
+            {
+                kind: "d1-migration-file",
+                itemId: "blog",
+                file: "migrations/0002_add_blog_indexes.sql",
+            },
+        ]);
+        expect(plan.destructive).toEqual([]);
+    });
+});
+//# sourceMappingURL=migration-planner.test.js.map

package/dist/registry/migration-planner.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-planner.test.js","sourceRoot":"","sources":["../../src/registry/migration-planner.test.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAErE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAQzD,MAAM,QAAQ,GAA2B;IACvC,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,mBAAmB;CAC1B,CAAC;AAEF,SAAS,aAAa,CACpB,EAAU,EACV,OAAe;IAEf,OAAO;QACL,EAAE;QACF,IAAI,EAAE,gBAAgB;QACtB,OAAO;QACP,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE;QAC/B,WAAW,EAAE,0BAA0B;KACxC,CAAC;AACJ,CAAC;AAED,SAAS,MAAM;IACb,OAAO;QACL,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,0BAA0B;QACvC,MAAM,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE;QACnC,KAAK,EAAE,EAAE;QACT,YAAY,EAAE,EAAE,OAAO,EAAE,CAAC,4BAA4B,CAAC,EAAE;QACzD,UAAU,EAAE;YACV;gBACE,IAAI,EAAE,QAAQ;gBACd,EAAE,EAAE,QAAQ;gBACZ,KAAK,EAAE;oBACL;wBACE,IAAI,EAAE,kBAAkB;wBACxB,MAAM,EAAE,4BAA4B;wBACpC,QAAQ,EAAE,QAAQ;wBAClB,IAAI,EAAE,QAAQ;qBACf;oBACD;wBACE,IAAI,EAAE,qBAAqB;wBAC3B,MAAM,EAAE,4BAA4B;wBACpC,IAAI,EAAE,SAAS;wBACf,EAAE,EAAE,aAAa;qBAClB;iBACF;aACF;SACF;KACF,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACrF,MAAM,IAAI,GAAG,eAAe,CAAC;YAC3B,SAAS,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACrC,YAAY,EAAE,CAAC,MAAM,EAAE,CAAC;YACxB,iBAAiB,EAAE,EAAE;SACtB,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,IAAI,GAAG,eAAe,CAAC;YAC3B,SAAS,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACrC,YAAY,EAAE,CAAC,MAAM,EAAE,CAAC;YACxB,iBAAiB,EAAE,EAAE;SACtB,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAC5B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,kBAAkB,CACrC,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,CAAC,aAAa,CAAC;YACxB,IAAI,EAAE,kBAAkB;YACxB,MAAM,EAAE,MAAM;YACd,aAAa,EAAE,4BAA4B;YAC3C,QAAQ,EAAE,QAAQ;YAClB,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;QACH,wDAAwD;QACxD,qDAAqD;QACrD,eAAe;QACf,MAAM,CACJ,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,kBAAkB,CAAC,CAC5D,CAAC,aAAa,EAAE,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+FAA+F,EAAE,GAAG,EAAE;QACvG,MAAM,IAAI,GAAG,eAAe,CAAC;YAC3B,SAAS,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACrC,YAAY,EAAE,CAAC,MAAM,EAAE,CAAC;YACxB,iBAAiB,EAAE,EAAE;SACtB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,qBAAqB,CACxC,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC;YAC3B,IAAI,EAAE,qBAAqB;YAC3B,IAAI,EAAE,SAAS;YACf,EAAE,EAAE,aAAa;SAClB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAClF,MAAM,OAAO,GAAuB;YAClC;gBACE,QAAQ,EAAE,MAAM;gBAChB,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,gBAAgB;gBAC1B,KAAK,EAAE,WAAW;gBAClB,IAAI,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,4BAA4B,EAAE;gBACrE,WAAW,EAAE,0BAA0B;gBACvC,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,0BAA0B;aACtC;SACF,CAAC;QACF,MAAM,IAAI,GAAG,eAAe,CAAC;YAC3B,SAAS,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACrC,YAAY,EAAE,CAAC,MAAM,EAAE,CAAC;YACxB,iBAAiB,EAAE,OAAO;SAC3B,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,IAAI,GAAG,eAAe,CAAC;YAC3B,SAAS,EAAE,CAAC,aAAa,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC;YACnD,YAAY,EAAE,CAAC,MAAM,EAAE,CAAC;YACxB,iBAAiB,EAAE,EAAE;SACtB,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAClF,2DAA2D;QAC3D,4DAA4D;QAC5D,UAAU;QACV,MAAM,MAAM,GAAiB;YAC3B,GAAG,MAAM,EAAE;YACX,OAAO,EAAE,CAAC;YACV,UAAU,EAAE;gBACV;oBACE,IAAI,EAAE,QAAQ;oBACd,EAAE,EAAE,QAAQ;oBACZ,KAAK,EAAE;wBACL;4BACE,IAAI,EAAE,kBAAkB;4BACxB,MAAM,EAAE,4BAA4B;4BACpC,QAAQ,EAAE,QAAQ;4BAClB,IAAI,EAAE,QAAQ;yBACf;qBACF;iBACF;gBACD;oBACE,IAAI,EAAE,QAAQ;oBACd,EAAE,EAAE,QAAQ;oBACZ,KAAK,EAAE;wBACL;4BACE,IAAI,EAAE,iBAAiB;4BACvB,IAAI,EAAE,cAAc;4BACpB,GAAG,EAAE,qDAAqD;yBAC3D;qBACF;iBACF;aACF;SACF,CAAC;QACF,MAAM,IAAI,GAAG,eAAe,CAAC;YAC3B,SAAS,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACrC,YAAY,EAAE,CAAC,MAAM,CAAC;YACtB,iBAAiB,EAAE,EAAE;SACtB,CAAC,CAAC;QACH,+DAA+D;QAC/D,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YACrC,IAAI,EAAE,kBAAkB;YACxB,QAAQ,EAAE,QAAQ;SACnB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kGAAkG,EAAE,GAAG,EAAE;QAC1G,MAAM,IAAI,GAAG,eAAe,CAAC;YAC3B,SAAS,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACrC,YAAY,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,sBAAsB;YAChD,iBAAiB,EAAE,EAAE;SACtB,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAChD,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,IAAI,GAAiB;YACzB,EAAE,EAAE,MAAM;YACV,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,0BAA0B;YACvC,MAAM,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE;YACnC,KAAK,EAAE,EAAE;YACT,YAAY,EAAE,EAAE;YAChB,UAAU,EAAE;gBACV;oBACE,IAAI,EAAE,QAAQ;oBACd,EAAE,EAAE,QAAQ;oBACZ,KAAK,EAAE;wBACL;4BACE,IAAI,EAAE,YAAY;4BAClB,IAAI,EAAE,mBAAmB;4BACzB,SAAS,EAAE,+BAA+B;yBAC3C;qBACF;iBACF;aAC4B;SAChC,CAAC;QACF,MAAM,IAAI,GAAG,eAAe,CAAC;YAC3B,SAAS,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACrC,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,iBAAiB,EAAE,EAAE;SACtB,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YAC5B;gBACE,IAAI,EAAE,YAAY;gBAClB,MAAM,EAAE,MAAM;gBACd,SAAS,EAAE,+BAA+B;gBAC1C,OAAO,EAAE,CAAC,mBAAmB,CAAC;aAC/B;SACF,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,6DAA6D,EAAE,GAAG,EAAE;IAC3E,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,IAAI,GAAiB;YACzB,EAAE,EAAE,MAAM;YACV,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,0BAA0B;YACvC,MAAM,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE;YACnC,KAAK,EAAE,EAAE;YACT,YAAY,EAAE,EAAE;YAChB,UAAU,EAAE;gBACV;oBACE,IAAI,EAAE,QAAQ;oBACd,EAAE,EAAE,QAAQ;oBACZ,KAAK,EAAE;wBACL;4BACE,IAAI,EAAE,SAAS;4BACf,IAAI,EAAE,uBAAuB;4BAC7B,OAAO,EAAE,SAAS;4BAClB,MAAM,EAAE,IAAI;yBACb;qBACF;iBACF;aAC4B;SAChC,CAAC;QACF,MAAM,IAAI,GAAG,eAAe,CAAC;YAC3B,SAAS,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACrC,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,iBAAiB,EAAE,EAAE;SACtB,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YAC5B;gBACE,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,uBAAuB;gBAC7B,OAAO,EAAE,SAAS;gBAClB,MAAM,EAAE,IAAI;aACb;SACF,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,SAAS,GAAG,EAAE,kBAAkB,EAAE,YAAY,EAAE,CAAC;QACvD,MAAM,IAAI,GAAiB;YACzB,EAAE,EAAE,MAAM;YACV,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,0BAA0B;YACvC,MAAM,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE;YACnC,KAAK,EAAE,EAAE;YACT,YAAY,EAAE,EAAE;YAChB,UAAU,EAAE;gBACV;oBACE,IAAI,EAAE,QAAQ;oBACd,EAAE,EAAE,QAAQ;oBACZ,KAAK,EAAE;wBACL;4BACE,IAAI,EAAE,cAAc;4BACpB,IAAI,EAAE,gBAAgB;4BACtB,IAAI,EAAE,SAAS;yBAChB;qBACF;iBACF;aAC4B;SAChC,CAAC;QACF,MAAM,IAAI,GAAG,eAAe,CAAC;YAC3B,SAAS,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACrC,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,iBAAiB,EAAE,EAAE;SACtB,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YAC5B;gBACE,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,SAAS;aAChB;SACF,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,IAAI,GAAiB;YACzB,EAAE,EAAE,MAAM;YACV,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,0BAA0B;YACvC,MAAM,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE;YACnC,KAAK,EAAE,EAAE;YACT,YAAY,EAAE,EAAE;YAChB,UAAU,EAAE;gBACV;oBACE,IAAI,EAAE,QAAQ;oBACd,EAAE,EAAE,QAAQ;oBACZ,KAAK,EAAE;wBACL;4BACE,IAAI,EAAE,mBAAmB;4BACzB,IAAI,EAAE,sCAAsC;yBAC7C;qBACF;iBACF;aAC4B;SAChC,CAAC;QACF,MAAM,IAAI,GAAG,eAAe,CAAC;YAC3B,SAAS,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACrC,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,iBAAiB,EAAE,EAAE;SACtB,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YAC5B;gBACE,IAAI,EAAE,mBAAmB;gBACzB,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,sCAAsC;aAC7C;SACF,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}