@ikas/component-cli 1.4.0-beta.23 → 1.4.0-beta.231

package/dist/utils/storefront-t.js

@@ -0,0 +1,187 @@
+import * as fs from "fs";
+import { createRequire } from "module";
+import * as path from "path";
+import { generateI18nRuntime, I18N_DEFAULT_FILE, i18nDir, readI18n, } from "./i18n.js";
+const STOREFRONT = "@ikas/bp-storefront";
+const SOURCE_FILE = /\.[cm]?[jt]sx?$/;
+const LOADERS = {
+    ".ts": "ts",
+    ".mts": "ts",
+    ".cts": "ts",
+    ".tsx": "tsx",
+    ".jsx": "jsx",
+};
+/** The project's own TypeScript (the build type-checks with it), else one the CLI can reach. */
+function loadTypeScript(root) {
+    const from = [path.join(root, "package.json"), import.meta.url];
+    const found = from.reduce((ts, base) => {
+        if (ts)
+            return ts;
+        try {
+            return createRequire(base)("typescript");
+        }
+        catch {
+            return undefined;
+        }
+    }, undefined);
+    if (!found)
+        throw new Error(`import { t } from "${STOREFRONT}" needs the project's TypeScript: install it (npm i -D typescript).`);
+    return found;
+}
+/**
+ * `source` with `t` imported from the project's UI texts module (`i18nModule`) in place of `@ikas/bp-storefront`,
+ * whose shared runtime has no `t`: each project reads its own texts. The other imports stay as they are, on the
+ * same lines. `null`: nothing to change. Throws on a form that would read `t` from the shared runtime.
+ */
+export function rewriteStorefrontT(ts, source, fileName, i18nModule) {
+    if (!source.includes(STOREFRONT))
+        return null;
+    const file = ts.createSourceFile(fileName, source, ts.ScriptTarget.Latest, true);
+    const isStorefront = (specifier) => !!specifier &&
+        ts.isStringLiteral(specifier) &&
+        specifier.text === STOREFRONT;
+    const fail = (node, problem) => {
+        const { line } = file.getLineAndCharacterOfPosition(node.getStart(file));
+        throw new Error(`${path.basename(fileName)}:${line + 1}: ${problem} Import it by name: import { t } from "${STOREFRONT}".`);
+    };
+    const needProject = (node) => {
+        if (!i18nModule)
+            fail(node, `t needs the project's ikas.config.json (its projectId): run the build in the project.`);
+    };
+    // A namespace import's `t` would be read from the shared runtime: `S.t`, `S["t"]`, `const { t } = S`
+    const namespaces = new Set();
+    const edits = [];
+    file.statements.forEach((statement) => {
+        if (ts.isExportDeclaration(statement) &&
+            isStorefront(statement.moduleSpecifier) &&
+            !statement.isTypeOnly) {
+            const clause = statement.exportClause;
+            const named = clause && ts.isNamedExports(clause)
+                ? clause.elements.some((e) => !e.isTypeOnly && (e.propertyName ?? e.name).text === "t")
+                : !clause && !!i18nModule;
+            if (named)
+                fail(statement, `t cannot be re-exported from "${STOREFRONT}" (it has no t at runtime).`);
+            return;
+        }
+        if (!ts.isImportDeclaration(statement) ||
+            !isStorefront(statement.moduleSpecifier))
+            return;
+        const clause = statement.importClause;
+        if (!clause || clause.isTypeOnly || !clause.namedBindings)
+            return;
+        const bindings = clause.namedBindings;
+        if (ts.isNamespaceImport(bindings)) {
+            namespaces.add(bindings.name.text);
+            return;
+        }
+        const tImports = bindings.elements.filter((e) => !e.isTypeOnly && (e.propertyName ?? e.name).text === "t");
+        if (!tImports.length)
+            return;
+        needProject(statement);
+        const rest = bindings.elements
+            .filter((e) => !tImports.includes(e))
+            .map((e) => e.getText(file));
+        const head = [
+            clause.name?.text,
+            rest.length ? `{ ${rest.join(", ")} }` : undefined,
+        ].filter(Boolean);
+        const kept = head.length
+            ? `import ${head.join(", ")} from "${STOREFRONT}"; `
+            : "";
+        const names = tImports
+            .map((e) => (e.name.text === "t" ? "t" : `t as ${e.name.text}`))
+            .join(", ");
+        const original = source.slice(statement.getStart(file), statement.getEnd());
+        edits.push({
+            start: statement.getStart(file),
+            end: statement.getEnd(),
+            // On the import's own lines: the code below keeps its line numbers
+            text: `${kept}import { ${names} } from ${JSON.stringify(i18nModule)};${"\n".repeat(original.split("\n").length - 1)}`,
+        });
+    });
+    if (namespaces.size) {
+        const visit = (node) => {
+            const isNamespace = (e) => ts.isIdentifier(e) && namespaces.has(e.text);
+            if (ts.isPropertyAccessExpression(node) &&
+                isNamespace(node.expression) &&
+                node.name.text === "t")
+                fail(node, `t is not read through a namespace import of "${STOREFRONT}".`);
+            if (ts.isElementAccessExpression(node) &&
+                isNamespace(node.expression) &&
+                ts.isStringLiteralLike(node.argumentExpression) &&
+                node.argumentExpression.text === "t")
+                fail(node, `t is not read through a namespace import of "${STOREFRONT}".`);
+            if (ts.isVariableDeclaration(node) &&
+                node.initializer &&
+                isNamespace(node.initializer) &&
+                ts.isObjectBindingPattern(node.name) &&
+                node.name.elements.some((e) => (e.propertyName ?? e.name).text === "t"))
+                fail(node, `t is not read through a namespace import of "${STOREFRONT}".`);
+            ts.forEachChild(node, visit);
+        };
+        visit(file);
+    }
+    if (!edits.length)
+        return null;
+    return edits
+        .sort((a, b) => b.start - a.start)
+        .reduce((text, edit) => text.slice(0, edit.start) + edit.text + text.slice(edit.end), source);
+}
+/** The module the build gives `t` from: the project's texts and their `t`, made from its i18n files. */
+// Under the CLI's own virtual package, which the package rules allow
+export const UI_TEXTS_MODULE = "@ikas/component-utils/ui-texts";
+/**
+ * Binds `import { t } from "@ikas/bp-storefront"` to a `t` reading the project's own UI texts, made from its i18n
+ * files (`UI_TEXTS_MODULE`, never written to the project): the storefront runtime is shared by every project on a
+ * store, so a `t` there could not tell whose text a key is. The generated `index.d.ts` types that `t`.
+ */
+export function storefrontTPlugin(root = process.cwd()) {
+    return {
+        name: "ikas-storefront-t",
+        setup(build) {
+            let config;
+            try {
+                config = JSON.parse(fs.readFileSync(path.join(root, "ikas.config.json"), "utf-8"));
+            }
+            catch {
+                // No project config: nothing to bind
+            }
+            const dir = config ? i18nDir(config, root) : null;
+            const hasTexts = !!dir && fs.existsSync(path.join(dir, `${I18N_DEFAULT_FILE}.json`));
+            build.onResolve({ filter: /^@ikas\/component-utils\/ui-texts$/ }, (args) => ({
+                path: args.path,
+                namespace: "ikas-ui-texts",
+            }));
+            build.onLoad({ filter: /.*/, namespace: "ikas-ui-texts" }, () => ({
+                // Read at each build: a changed base text (its `index.d.ts` rewritten) recompiles in dev
+                // No texts of its own yet: t still reads the store's (`ikas:<key>`)
+                contents: generateI18nRuntime(config.projectId, hasTexts ? readI18n(dir).base : {}),
+                loader: "js",
+                resolveDir: root,
+            }));
+            let ts;
+            build.onLoad({ filter: SOURCE_FILE }, (args) => {
+                if (args.path.split(path.sep).includes("node_modules"))
+                    return undefined;
+                const source = fs.readFileSync(args.path, "utf-8");
+                if (!source.includes(STOREFRONT))
+                    return undefined;
+                try {
+                    ts ??= loadTypeScript(root);
+                    const contents = rewriteStorefrontT(ts, source, args.path, config?.projectId ? UI_TEXTS_MODULE : null);
+                    if (contents === null)
+                        return undefined;
+                    return {
+                        contents,
+                        loader: LOADERS[path.extname(args.path)] ?? "js",
+                        resolveDir: path.dirname(args.path),
+                    };
+                }
+                catch (e) {
+                    return { errors: [{ text: e.message }] };
+                }
+            });
+        },
+    };
+}
+//# sourceMappingURL=storefront-t.js.map

package/dist/utils/storefront-t.js.map

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

package/dist/utils/vendor-storefront.d.ts

@@ -0,0 +1,13 @@
+import type { Plugin } from "esbuild";
+export declare function isVendoredDependencyFile(file: string): boolean;
+/**
+ * Bundle the storefront SDK into the component artifact.
+ *
+ * Deep imports stay forbidden for *component* source — the public contract is still "import only
+ * from the package root", and a component reaching into `/src/...` is still a bug worth failing
+ * on. But the SDK's own modules deep-import each other constantly (97 lazy `import()` calls into
+ * `@ikas/bp-storefront-api/src/__api/...` alone), and those are internal business. So the rule is
+ * keyed on who is importing, not on what is imported.
+ */
+export declare function vendorStorefrontPlugin(): Plugin;
+//# sourceMappingURL=vendor-storefront.d.ts.map

package/dist/utils/vendor-storefront.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendor-storefront.d.ts","sourceRoot":"","sources":["../../src/utils/vendor-storefront.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAqCtC,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAK9D;AAqBD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CA+B/C"}

package/dist/utils/vendor-storefront.js

@@ -0,0 +1,91 @@
+import * as fs from "fs";
+import * as os from "os";
+import * as path from "path";
+/**
+ * Compile the storefront SDK *into* the artifact instead of resolving it against the host.
+ *
+ * The default path (`forbidDeepStorefrontImportsPlugin`) leaves `@ikas/bp-storefront*` external,
+ * so a theme has to hand the component every named export it uses at runtime. That makes the set
+ * of names a contract between two independently-released things: publish a component that reaches
+ * for a name older themes lack and the page renders an error box for every visitor, with nothing
+ * to fall back to.
+ *
+ * Vendoring removes the contract rather than versioning it. The artifact carries the SDK code it
+ * was built against, so what a host must still provide shrinks to the handful of packages that
+ * genuinely have to be shared (`preact`, `preact/hooks`, `mobx` — see the externals in compile.ts)
+ * and cannot grow when we add a feature.
+ *
+ * The trade is duplication: a page rendering a vendored component ships this code even though the
+ * theme already has its own copy. That is the point — the two copies are free to be different
+ * versions.
+ */
+/** `@ikas/bp-storefront` and its siblings, with an optional subpath. */
+const VENDORED_PKG = /^(@ikas\/bp-storefront(?:-(?:models|config|api|api-client))?)(\/.*)?$/;
+/**
+ * True for files that belong to a vendored dependency rather than to component source.
+ *
+ * Two shapes, because the SDK resolves differently depending on where the build runs: an npm
+ * install puts it under `node_modules/@ikas/bp-storefront*`, while inside this monorepo npm
+ * workspaces symlink it and esbuild reports the real path under `packages/storefront*`.
+ */
+const VENDORED_FILE = /[\\/](?:node_modules[\\/]@ikas[\\/]bp-storefront[^\\/]*|packages[\\/]storefront(?:-(?:api|api-client|config|models))?)[\\/]/;
+export function isVendoredDependencyFile(file) {
+    if (!file)
+        return false;
+    // Anything already inside node_modules is a transitive dependency of a package we chose to
+    // vendor, not something a component author wrote — the allowlist has no say over it.
+    return file.includes(`${path.sep}node_modules${path.sep}`) || VENDORED_FILE.test(file);
+}
+/**
+ * Stand-in for `isomorphic-fetch`, which the SDK imports in three places.
+ *
+ * That package pulls `node-fetch` in, which references `global` and dies in a browser with
+ * "global is not defined" — a failure the monorepo never sees while the SDK is merely *external*,
+ * because nothing bundles it there. Vendoring is exactly what makes it reachable, so it has to be
+ * aliased away here rather than left to be discovered at runtime.
+ *
+ * Both build targets already have a native `fetch` (browsers, and Node 18+ for the SSR build), so
+ * the shim is a forwarder. It calls through `globalThis` on every invocation instead of capturing
+ * the function, which keeps `this` correct (a bare reference throws "Illegal invocation") and lets
+ * a host install a polyfill after this module is evaluated.
+ */
+const FETCH_SHIM = path.join(os.tmpdir(), "ikas-vendored-fetch-shim.mjs");
+fs.writeFileSync(FETCH_SHIM, "const f = (...args) => globalThis.fetch(...args);\nexport default f;\nexport { f as fetch };\n");
+/**
+ * Bundle the storefront SDK into the component artifact.
+ *
+ * Deep imports stay forbidden for *component* source — the public contract is still "import only
+ * from the package root", and a component reaching into `/src/...` is still a bug worth failing
+ * on. But the SDK's own modules deep-import each other constantly (97 lazy `import()` calls into
+ * `@ikas/bp-storefront-api/src/__api/...` alone), and those are internal business. So the rule is
+ * keyed on who is importing, not on what is imported.
+ */
+export function vendorStorefrontPlugin() {
+    return {
+        name: "ikas-vendor-storefront",
+        setup(build) {
+            build.onResolve({ filter: /^isomorphic-fetch$/ }, () => ({ path: FETCH_SHIM }));
+            build.onResolve({ filter: VENDORED_PKG }, (args) => {
+                const [, root, subpath] = args.path.match(VENDORED_PKG);
+                if (subpath && subpath !== "/" && !isVendoredDependencyFile(args.importer)) {
+                    return {
+                        errors: [
+                            {
+                                text: `Deep import "${args.path}" is not allowed. Import only from the package root ` +
+                                    `"${root}" — e.g. import { saveCouponCode, getCart } from "${root}". ` +
+                                    `Subpaths like "/dist/..." or "/src/..." are private and may be renamed without ` +
+                                    `notice. If a helper seems missing from the root, it almost always has a public ` +
+                                    `name there (coupon code, for instance, is getCouponCodeForm / ` +
+                                    `setCouponCodeFormCouponCode / submitCouponCodeForm).`,
+                            },
+                        ],
+                    };
+                }
+                // Returning nothing hands the specifier back to esbuild's normal resolution, which is
+                // what pulls the source into the bundle. The default path returns `external: true` here.
+                return undefined;
+            });
+        },
+    };
+}
+//# sourceMappingURL=vendor-storefront.js.map

package/dist/utils/vendor-storefront.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendor-storefront.js","sourceRoot":"","sources":["../../src/utils/vendor-storefront.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;;;;;;;;;;;;;;;;GAiBG;AAEH,wEAAwE;AACxE,MAAM,YAAY,GAAG,uEAAuE,CAAC;AAE7F;;;;;;GAMG;AACH,MAAM,aAAa,GACjB,6HAA6H,CAAC;AAEhI,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,2FAA2F;IAC3F,qFAAqF;IACrF,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,GAAG,eAAe,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzF,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,8BAA8B,CAAC,CAAC;AAC1E,EAAE,CAAC,aAAa,CACd,UAAU,EACV,gGAAgG,CACjG,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,IAAI,EAAE,wBAAwB;QAC9B,KAAK,CAAC,KAAK;YACT,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,oBAAoB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;YAEhF,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE;gBACjD,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAE,CAAC;gBAEzD,IAAI,OAAO,IAAI,OAAO,KAAK,GAAG,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC3E,OAAO;wBACL,MAAM,EAAE;4BACN;gCACE,IAAI,EACF,gBAAgB,IAAI,CAAC,IAAI,sDAAsD;oCAC/E,IAAI,IAAI,qDAAqD,IAAI,KAAK;oCACtE,iFAAiF;oCACjF,iFAAiF;oCACjF,gEAAgE;oCAChE,sDAAsD;6BACzD;yBACF;qBACF,CAAC;gBACJ,CAAC;gBAED,sFAAsF;gBACtF,yFAAyF;gBACzF,OAAO,SAAS,CAAC;YACnB,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/websocket-server.d.ts

@@ -1,5 +1,6 @@
-import type { ComponentProp } from "../types.js";
-import type { IThemePropGroupData } from "./component-helpers.js";
+import type { ComponentProp, ThemeSettingMeta } from "../types.js";
+import type { IThemePropGroupData, WrapperTechnicalTexts } from "./component-helpers.js";
+import type { I18nTree, IProjectI18nData } from "./i18n.js";
 /**
  * Shared module data sent to editors (chunk extracted by code splitting)
  */
@@ -51,6 +52,13 @@ export interface ICodeComponentData {
         typeId?: string;
         /** For ENUM props — the enum type ID from TypeStore */
         enumTypeId?: string;
+        /** For NUMBER_RANGE props — slider config (min/max/interval/unit) */
+        numberRangeData?: {
+            min?: number;
+            max?: number;
+            interval?: number;
+            unit?: string;
+        };
         /** For COMPONENT/COMPONENT_LIST props — map of variable keys to { id, typeId } */
         privateVarMap?: Record<string, {
             id: string;
@@ -58,6 +66,29 @@ export interface ICodeComponentData {
         }>;
         /** For COMPONENT/COMPONENT_LIST props — restrict which components can be selected */
         filteredComponentIds?: string[];
+        /**
+         * Conditional visibility. Resolved from the config's `requiredProp` (a NAME) at broadcast time
+         * into the id the editor addresses props by.
+         */
+        requiredPropId?: string;
+        /** For a BOOLEAN gate — which state of `requiredPropId` shows this prop. Defaults to `true`. */
+        requiredPropValue?: boolean;
+        /** For an ENUM gate — the option's id. */
+        requiredEnumOptionId?: string;
+        /** For an ENUM gate — the option value `requiredPropId` must hold. */
+        requiredEnumOptionValue?: string;
+        /** The label and description in an editor language (`en`), from the config's `translations`. */
+        translations?: Array<{
+            locale: string;
+            displayName?: string;
+            description?: string;
+        }>;
+    }>;
+    /** The name in an editor language, a store language's default prop values; from the config's `translations`. */
+    translations?: Array<{
+        locale: string;
+        name?: string;
+        propValues?: Record<string, unknown>;
     }>;
     compiledServerJs: string;
     compiledClientJs: string;
@@ -78,10 +109,18 @@ export interface ICodeComponentData {
         id: string;
         name: string;
         description?: string;
+        requiredProp?: string;
+        requiredPropValue?: boolean;
+        requiredEnumOptionId?: string;
+        requiredEnumOptionValue?: string;
         children?: Array<{
             id: string;
             name: string;
             description?: string;
+            requiredProp?: string;
+            requiredPropValue?: boolean;
+            requiredEnumOptionId?: string;
+            requiredEnumOptionValue?: string;
         }>;
     }>;
     /** Custom IType definitions referenced by this component's props (for portability across projects) */
@@ -105,6 +144,17 @@ export type DevServerMessage = {
         components: ICodeComponentData[];
         sharedModules?: ISharedModuleData[];
         globalStyles?: IGlobalStyleData;
+        /** The project's UI texts; `null` when it has none */
+        i18n?: IProjectI18nData | null;
+        warnings?: string[];
+        timestamp: number;
+    };
+} | {
+    /** The project's UI texts changed (their files, or the config's `i18n`) */
+    type: "i18n-update";
+    payload: {
+        i18n: IProjectI18nData | null;
+        warnings?: string[];
         timestamp: number;
     };
 } | {
@@ -151,7 +201,7 @@ export type DevServerMessage = {
 } | {
     type: "editor-action";
     requestId: string;
-    action: "list-pages" | "list-imported-components" | "import-component" | "add-section-to-page";
+    action: "list-pages" | "list-imported-components" | "import-component" | "add-section-to-page" | "add-sections-to-page" | "list-page-sections" | "get-section-values" | "get-section-values-locale" | "get-section-values-routing" | "get-component-props" | "update-section-prop" | "update-section-prop-locale" | "update-section-prop-routing" | "upload-image" | "search-products" | "list-entities" | "get-page-by-type" | "update-page-sections" | "update-page-sections-locale" | "update-page-sections-routing" | "upload-images";
     payload?: any;
 } | {
     type: "editor-action-result";
@@ -159,6 +209,12 @@ export type DevServerMessage = {
     success: boolean;
     payload?: any;
     error?: string;
+    /**
+     * Server-generated transient failure: the editor handling the action is
+     * gone or not back yet. Safe to resend the SAME requestId — the editor
+     * deduplicates by it, so a retry can never run the action twice.
+     */
+    retryable?: boolean;
 };
 /**
  * Messages from editor to dev server
@@ -169,6 +225,24 @@ export type EditorMessage = {
     type: "request-state";
 } | {
     type: "ping";
+} | {
+    type: "editor-hello";
+    payload?: {
+        /** Human-readable identity shown when several tabs are connected. */
+        label?: string;
+        /** True when the tab is visible at the time of sending. */
+        visible?: boolean;
+        /**
+         * Theme the tab is editing. When connected tabs disagree, an
+         * `editor-action` is refused instead of mutating an arbitrary theme.
+         */
+        themeId?: string;
+        /**
+         * Stable per-tab id (survives reconnects, dies with the tab). Lets a
+         * retried `editor-action` be pinned back to the tab that first got it.
+         */
+        tabId?: string;
+    };
 } | {
     type: "create-component";
     requestId: string;
@@ -208,6 +282,10 @@ export type EditorMessage = {
             name: string;
             description?: string;
             parentGroupId?: string;
+            requiredProp?: string;
+            requiredPropValue?: boolean;
+            requiredEnumOptionId?: string;
+            requiredEnumOptionValue?: string;
         };
     };
 } | {
@@ -219,6 +297,10 @@ export type EditorMessage = {
         propGroup: {
             name?: string;
             description?: string;
+            requiredProp?: string;
+            requiredPropValue?: boolean;
+            requiredEnumOptionId?: string;
+            requiredEnumOptionValue?: string;
         };
     };
 } | {
@@ -247,6 +329,22 @@ export type EditorMessage = {
         /** Zero-based index inside the target parent's children list (or root list). Appends when omitted. */
         index?: number;
     };
+} | {
+    /** The editor saved a dev component's technical texts (Editor Texts page). */
+    type: "update-translations";
+    requestId: string;
+    payload: {
+        componentId: string;
+    } & WrapperTechnicalTexts;
+} | {
+    /** The editor saved the project's UI texts (Store Translations page): the base ones and the sent languages' */
+    type: "update-i18n";
+    requestId: string;
+    payload: {
+        projectId: string;
+        base: I18nTree;
+        locales: Record<string, I18nTree>;
+    };
 } | {
     type: "sync-types";
     payload: {
@@ -259,6 +357,8 @@ export type EditorMessage = {
             enumOptions?: Record<string, string>;
         }>;
         customTypes?: Array<Record<string, any>>;
+        /** Theme global variables (Styles panel) — drives the typed key union in global-types.ts. */
+        themeSettings?: Array<ThemeSettingMeta>;
     };
 } | {
     type: "request-types";
@@ -283,10 +383,22 @@ export type EditorMessage = {
     payload: {
         enumId: string;
     };
+} | {
+    type: "archive-project";
+    requestId: string;
+    payload: {
+        /** Extra directory / file names to leave out, on top of node_modules & co. */
+        exclude?: string[];
+        /**
+         * Local id → published id table applied to the archived source text, so a
+         * store downloading it gets a project that already speaks its own ids.
+         */
+        rewriteIds?: Record<string, string>;
+    };
 } | {
     type: "editor-action";
     requestId: string;
-    action: "list-pages" | "list-imported-components" | "import-component" | "add-section-to-page";
+    action: "list-pages" | "list-imported-components" | "import-component" | "add-section-to-page" | "add-sections-to-page" | "list-page-sections" | "get-section-values" | "get-section-values-locale" | "get-section-values-routing" | "get-component-props" | "update-section-prop" | "update-section-prop-locale" | "update-section-prop-routing" | "upload-image" | "search-products" | "list-entities" | "get-page-by-type" | "update-page-sections" | "update-page-sections-locale" | "update-page-sections-routing" | "upload-images";
     payload?: any;
 } | {
     type: "editor-action-result";
@@ -303,6 +415,9 @@ export interface EditorMessageHandlers {
         components: ICodeComponentData[];
         sharedModules: ISharedModuleData[];
         globalStyles?: IGlobalStyleData;
+        i18n?: IProjectI18nData | null;
+        /** What the editor shows as a warning: UI texts left out, translations the config holds wrong. */
+        warnings?: string[];
     };
     onCreateComponent?: (name: string, type?: "component" | "section") => Promise<{
         id: string;
@@ -315,14 +430,28 @@ export interface EditorMessageHandlers {
         name: string;
         description?: string;
         parentGroupId?: string;
+        requiredProp?: string;
+        requiredPropValue?: boolean;
+        requiredEnumOptionId?: string;
+        requiredEnumOptionValue?: string;
     }) => Promise<void>;
     onUpdatePropGroup?: (componentId: string, propGroupId: string, propGroup: {
         name?: string;
         description?: string;
+        requiredProp?: string;
+        requiredPropValue?: boolean;
+        requiredEnumOptionId?: string;
+        requiredEnumOptionValue?: string;
     }) => Promise<void>;
     onDeletePropGroup?: (componentId: string, propGroupId: string) => Promise<void>;
     onMovePropToGroup?: (componentId: string, propName: string, groupId: string | null) => Promise<void>;
     onMovePropGroup?: (componentId: string, propGroupId: string, parentGroupId: string | null, index?: number) => Promise<void>;
+    /** The editor saved a dev component's technical texts (Editor Texts page): write them to the config. */
+    onUpdateTranslations?: (componentId: string, texts: WrapperTechnicalTexts) => Promise<void>;
+    onUpdateI18n?: (projectId: string, texts: {
+        base: I18nTree;
+        locales: Record<string, I18nTree>;
+    }) => Promise<void>;
     onSyncTypes?: (types: Array<{
         id: string;
         name: string;
@@ -330,7 +459,7 @@ export interface EditorMessageHandlers {
         category: "type" | "enum";
         sectionAllowed: boolean;
         enumOptions?: Record<string, string>;
-    }>, customTypes?: Array<Record<string, any>>) => void;
+    }>, customTypes?: Array<Record<string, any>>, themeSettings?: Array<ThemeSettingMeta>) => void;
     onRequestTypes?: () => Array<{
         id: string;
         name: string;
@@ -344,6 +473,18 @@ export interface EditorMessageHandlers {
     }>;
     onUpdateEnum?: (enumId: string, name?: string, enumOptions?: Record<string, string>) => Promise<void>;
     onDeleteEnum?: (enumId: string) => Promise<void>;
+    onArchiveProject?: (payload: {
+        exclude?: string[];
+        rewriteIds?: Record<string, string>;
+    }) => Promise<ArchiveProjectCommandResult>;
+}
+export interface ArchiveProjectCommandResult {
+    /** Folder that was archived (the dev server's cwd). */
+    rootDir: string;
+    size: number;
+    fileCount: number;
+    /** The zip itself, base64 — the editor hands it to the ikas backend. */
+    contentBase64: string;
 }
 /**
  * Dev server WebSocket manager
@@ -351,10 +492,13 @@ export interface EditorMessageHandlers {
 export declare class DevServerWebSocket {
     private wss;
     private httpServer;
-    private clients;
     private port;
     private pendingEditorActions;
-    constructor(port?: number);
+    private clientInfo;
+    private forwardedEditorActions;
+    /** What a control client sends to drive the editor (see `writeDevServerToken`); none: every action is refused. */
+    private token;
+    constructor(port?: number, token?: string);
     /**
      * Start the WebSocket server
      */
@@ -369,6 +513,20 @@ export declare class DevServerWebSocket {
      * dead socket.
      */
     private dropPendingEditorActionsForClient;
+    /**
+     * Pick the single editor that should run an `editor-action`, preferring the
+     * tab the user is looking at: most recently visible, then most recently
+     * active. Control clients are never targets.
+     *
+     * The server has no theme identity of its own, so ambiguity is refused, not
+     * guessed at: tabs reporting DIFFERENT themes → `conflictingThemes`; a tab
+     * with NO theme identity (old build or still loading) next to identified
+     * ones → `hasUnidentified` — that tab could be on any theme, and routing
+     * either way risks silently mutating the wrong one. Only an unambiguous
+     * pool (all identified with one theme, or all unidentified legacy tabs) is
+     * ranked.
+     */
+    private pickEditorActionTarget;
     /**
      * Send message to a specific client
      */