@songsid/agend 2.2.0 → 2.3.0-beta.2

package/dist/web-mod-bundle.js

@@ -0,0 +1,470 @@
+/**
+ * #1629 r4 §4 (option A): a mod bundle — one JSON file, `<name>-<version>.agendmod.json`, at most 8 MiB, that carries a
+ * look: a theme (with its pictures), identity defaults (a card's tagline and bio — never card pictures), widget specs
+ * with their values, effect entries (CW1: Sol's runtime validates them), and a person's own CSS (with its assets).
+ * No zip: no extraction, no symlinks, no paths outside the file.
+ *
+ * Checking is pure and whole: closed schemas everywhere; every path matches MOD_PATH with no `..`; every file's sha256
+ * matches its bytes and every file is named by exactly one part; each part goes through its own validator (the theme's
+ * checkTheme and picture checks, web-widget.ts, the owner-CSS checker, the effect entry checker). Nothing is written
+ * here. The bundle's identity is the hash of its canonical manifest and file list — `version` is for people.
+ */
+import { createHash } from "node:crypto";
+import { compareVersions } from "./agent-whats-new.js";
+import { checkEffectEntry } from "./web-effect-bundle.js";
+import { resolveEffectParams } from "./web-effect.js";
+import { checkOwnerCss, OWNER_CSS_MAX_BYTES } from "./web-owner-css.js";
+import { MEDIA_EXT, sniffMedia, stripMetadata } from "./web-image-meta.js";
+import { canonicalBio, canonicalTagline, canonicalText, checkTheme } from "./web-theme.js";
+import { prepareThemeAsset } from "./web-theme-store.js";
+import { checkWidgetData, checkWidgetSpec, WIDGET_SLOTS } from "./web-widget.js";
+export const MOD_FORMAT = "agend-mod";
+export const MOD_MAX_BYTES = 8 * 1024 * 1024;
+export const MOD_MAX_FILES = 128;
+export const MOD_MAX_EFFECTS = 8;
+/** A path inside a bundle: lowercase, no leading dot or slash, no `..` segment, no empty segment. */
+export const MOD_PATH = /^[a-z0-9][a-z0-9._/-]{0,127}$/;
+const SLUG = /^[a-z0-9][a-z0-9-]{0,63}$/;
+const SEMVER = /^(0|[1-9]\d{0,5})\.(0|[1-9]\d{0,5})\.(0|[1-9]\d{0,5})$/;
+const SHA256 = /^[0-9a-f]{64}$/;
+const B64 = /^[A-Za-z0-9+/]*={0,2}$/;
+/** Owner-CSS assets a bundle may carry (the owner-CSS store's own kinds). */
+const CSS_ASSET_KINDS = new Set(["png", "jpeg", "webp", "gif", "woff2"]);
+const isObj = (v) => typeof v === "object" && v !== null && !Array.isArray(v) && Object.getPrototypeOf(v) === Object.prototype;
+const sha256 = (b) => createHash("sha256").update(b).digest("hex");
+const hash32 = (b) => sha256(b).slice(0, 32);
+const utf8 = new TextDecoder("utf-8", { fatal: true, ignoreBOM: false });
+function pathOk(p) {
+    return typeof p === "string" && MOD_PATH.test(p) && !p.split("/").some(seg => seg === "" || seg === "." || seg === "..") && !p.endsWith("/");
+}
+/** Stable JSON: keys sorted at every level. */
+export function canonicalJson(v) {
+    const norm = (x) => Array.isArray(x) ? x.map(norm)
+        : x !== null && typeof x === "object" ? Object.fromEntries(Object.keys(x).sort().map(k => [k, norm(x[k])])) : x;
+    return JSON.stringify(norm(v));
+}
+/** A bundle's identity: the first 32 hex of the sha256 of its canonical manifest and sorted [path, sha256] list. */
+export function modBundleId(manifest, files) {
+    const list = [...files].sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+    return sha256(canonicalJson({ manifest, files: list })).slice(0, 32);
+}
+function checkManifest(raw, ctx, bad) {
+    if (!isObj(raw)) {
+        bad("manifest", "an object");
+        return null;
+    }
+    const known = ["name", "version", "title", "description", "author", "requires", "contents"];
+    for (const k of Object.keys(raw))
+        if (!known.includes(k))
+            bad(`manifest.${k}`, "unknown key");
+    const m = {};
+    if (typeof raw.name === "string" && SLUG.test(raw.name))
+        m.name = raw.name;
+    else
+        bad("manifest.name", "a-z, 0-9 and - (1..64)");
+    if (typeof raw.version === "string" && SEMVER.test(raw.version))
+        m.version = raw.version;
+    else
+        bad("manifest.version", "MAJOR.MINOR.PATCH");
+    const title = canonicalText(raw.title, 1, 60);
+    if (title === null)
+        bad("manifest.title", "1..60 characters on one line");
+    else
+        m.title = title;
+    for (const [k, max] of [["description", 280], ["author", 60]]) {
+        if (raw[k] === undefined)
+            continue;
+        const t = canonicalText(raw[k], 1, max);
+        if (t === null)
+            bad(`manifest.${k}`, `1..${max} characters on one line`);
+        else
+            m[k] = t;
+    }
+    if (raw.requires !== undefined) {
+        const r = raw.requires;
+        const want = isObj(r) && Object.keys(r).length === 1 && typeof r.agend === "string" ? r.agend : null;
+        const min = want ? /^>=(\d+\.\d+\.\d+(?:-[0-9A-Za-z.]+)?)$/.exec(want) : null;
+        if (!min)
+            bad("manifest.requires", "{ agend: \">=MAJOR.MINOR.PATCH\" }");
+        else {
+            const cmp = ctx.agendVersion ? compareVersions(ctx.agendVersion, min[1]) : null;
+            if (cmp === null || cmp < 0)
+                bad("manifest.requires", `needs AgEnD ${want}; this fleet runs ${ctx.agendVersion ?? "an unknown version"}`);
+            else
+                m.requires = { agend: want };
+        }
+    }
+    const c = raw.contents;
+    if (!isObj(c)) {
+        bad("manifest.contents", "an object");
+        return null;
+    }
+    for (const k of Object.keys(c))
+        if (!["theme", "identity", "widgets", "effects", "ownerCss"].includes(k))
+            bad(`manifest.contents.${k}`, "unknown key");
+    const contents = {};
+    for (const k of ["theme", "identity"])
+        if (c[k] !== undefined) {
+            if (pathOk(c[k]))
+                contents[k] = c[k];
+            else
+                bad(`manifest.contents.${k}`, "a path in the bundle");
+        }
+    if (c.widgets !== undefined) {
+        if (!isObj(c.widgets))
+            bad("manifest.contents.widgets", "{ chat_header?, details?, sidebar? }");
+        else {
+            const w = {};
+            for (const [slot, p] of Object.entries(c.widgets)) {
+                if (!WIDGET_SLOTS.includes(slot))
+                    bad(`manifest.contents.widgets.${slot}`, "chat_header, details or sidebar");
+                else if (!pathOk(p))
+                    bad(`manifest.contents.widgets.${slot}`, "a path in the bundle");
+                else
+                    w[slot] = p;
+            }
+            contents.widgets = w;
+        }
+    }
+    if (c.effects !== undefined) {
+        if (!Array.isArray(c.effects) || c.effects.length > MOD_MAX_EFFECTS || new Set(c.effects).size !== c.effects.length || !c.effects.every(pathOk))
+            bad("manifest.contents.effects", `at most ${MOD_MAX_EFFECTS} distinct directory paths`);
+        else
+            contents.effects = c.effects;
+    }
+    if (c.ownerCss !== undefined) {
+        const o = c.ownerCss;
+        if (!isObj(o) || Object.keys(o).some(k => k !== "css" && k !== "assets") || !pathOk(o.css) || (o.assets !== undefined && (!Array.isArray(o.assets) || !o.assets.every(pathOk) || new Set(o.assets).size !== o.assets.length)))
+            bad("manifest.contents.ownerCss", "{ css: path, assets?: [path] }");
+        else
+            contents.ownerCss = { css: o.css, ...(o.assets ? { assets: o.assets } : {}) };
+    }
+    if (!Object.keys(contents).length)
+        bad("manifest.contents", "names nothing");
+    m.contents = contents;
+    return m;
+}
+/**
+ * Parse and check a whole bundle. `text` is the file as uploaded (UTF-8 JSON). All or nothing: the first problems are
+ * returned (at most 20), and nothing in a refused bundle is ever used.
+ */
+export function checkModBundle(text, ctx) {
+    const problems = [];
+    const bad = (path, problem) => { if (problems.length < 20)
+        problems.push({ path, problem }); };
+    const fail = () => ({ ok: false, problems });
+    const size = Buffer.byteLength(text, "utf8");
+    if (size > MOD_MAX_BYTES) {
+        bad("", `at most ${MOD_MAX_BYTES / 1024 / 1024} MiB`);
+        return fail();
+    }
+    let doc;
+    try {
+        doc = JSON.parse(text);
+    }
+    catch {
+        bad("", "not JSON");
+        return fail();
+    }
+    if (!isObj(doc)) {
+        bad("", "an object { format, v, manifest, files }");
+        return fail();
+    }
+    for (const k of Object.keys(doc))
+        if (!["format", "v", "manifest", "files"].includes(k))
+            bad(k, "unknown key");
+    if (doc.format !== MOD_FORMAT)
+        bad("format", `must be "${MOD_FORMAT}"`);
+    if (doc.v !== 1)
+        bad("v", "must be 1");
+    const manifest = checkManifest(doc.manifest, ctx, bad);
+    // Every file: a good path, its bytes, its sha256.
+    const files = new Map();
+    const shas = new Map();
+    if (!isObj(doc.files))
+        bad("files", "an object { path: { sha256, b64 } }");
+    else {
+        const entries = Object.entries(doc.files);
+        if (entries.length > MOD_MAX_FILES)
+            bad("files", `at most ${MOD_MAX_FILES}`);
+        else
+            for (const [p, f] of entries) {
+                if (!pathOk(p)) {
+                    bad(`files.${String(p).slice(0, 80)}`, "a lowercase path: a-z 0-9 . _ - /, no .. or empty segment");
+                    continue;
+                }
+                if (!isObj(f) || Object.keys(f).length !== 2 || typeof f.sha256 !== "string" || !SHA256.test(f.sha256) || typeof f.b64 !== "string" || !B64.test(f.b64) || f.b64.length % 4 !== 0) {
+                    bad(`files.${p}`, "{ sha256, b64 }");
+                    continue;
+                }
+                const bytes = Buffer.from(f.b64, "base64");
+                if (sha256(bytes) !== f.sha256) {
+                    bad(`files.${p}`, "sha256 does not match its bytes");
+                    continue;
+                }
+                files.set(p, bytes);
+                shas.set(p, f.sha256);
+            }
+        // A path that is both a file and a directory prefix of another would be two things.
+        for (const p of files.keys())
+            if ([...files.keys()].some(q => q.startsWith(`${p}/`)))
+                bad(`files.${p}`, "both a file and a directory");
+    }
+    if (problems.length || !manifest)
+        return fail();
+    const used = new Set();
+    const take = (p, where) => {
+        const b = files.get(p);
+        if (!b) {
+            bad(where, `no file ${p}`);
+            return null;
+        }
+        if (used.has(p)) {
+            bad(where, `${p} is already used by another part`);
+            return null;
+        }
+        used.add(p);
+        return b;
+    };
+    const json = (p, where) => {
+        const b = take(p, where);
+        if (!b)
+            return undefined;
+        try {
+            return JSON.parse(utf8.decode(b));
+        }
+        catch {
+            bad(where, `${p}: not UTF-8 JSON`);
+            return undefined;
+        }
+    };
+    const mod = { id: modBundleId(manifest, shas), manifest, bytes: size, widgets: {}, effects: [] };
+    const c = manifest.contents;
+    // Effects first: the theme's placements name them.
+    const effectPaths = new Set(c.effects ?? []);
+    if (c.effects?.length) {
+        if (!ctx.effects)
+            bad("manifest.contents.effects", "effects_unavailable: this fleet has no effect runtime yet");
+        else
+            for (const dir of c.effects) {
+                const entry = new Map();
+                for (const [p, b] of files)
+                    if (p.startsWith(`${dir}/`)) {
+                        entry.set(p.slice(dir.length + 1), b);
+                        used.add(p);
+                    }
+                if (!entry.size) {
+                    bad(`effects.${dir}`, "no files under it");
+                    continue;
+                }
+                const r = ctx.effects.check(entry);
+                if (!r.ok) {
+                    for (const q of r.problems)
+                        bad(`effects.${dir}/${q.path}`, q.problem);
+                    continue;
+                }
+                mod.effects.push({ path: dir, files: entry, summary: r.summary, manifest: r.manifest });
+            }
+    }
+    if (c.theme) {
+        const raw = json(c.theme, "manifest.contents.theme");
+        if (raw !== undefined) {
+            if (!isObj(raw))
+                bad("theme", "an object");
+            else {
+                const { effects: placed, ...look } = raw;
+                if (look.card !== undefined)
+                    bad("theme.card", "a card travels as identity (tagline, bio) — never in the theme, and its pictures never in a bundle");
+                // Pictures are named by path in a bundle: each is checked as an upload to its slot, then named by its id.
+                const pictures = [];
+                const picture = (p, slot, where) => {
+                    if (!pathOk(p)) {
+                        bad(where, "a path in the bundle");
+                        return null;
+                    }
+                    const b = take(p, where);
+                    if (!b)
+                        return null;
+                    const r = prepareThemeAsset(slot, b, ctx.limits);
+                    if (!r.ok) {
+                        bad(where, `${r.error}${r.detail ? `: ${r.detail}` : ""}`);
+                        return null;
+                    }
+                    if (pictures.some(x => x.id === r.id)) {
+                        bad(where, "the same picture as another slot's: a picture holds one slot");
+                        return null;
+                    }
+                    pictures.push({ path: p, slot, id: r.id, kind: r.kind, kept: r.kept });
+                    return r.id;
+                };
+                const input = { ...look };
+                if (isObj(look.background)) {
+                    const id = picture(look.background.image, "background", "theme.background.image");
+                    if (id)
+                        input.background = { ...look.background, image: id };
+                }
+                if (look.avatar !== undefined) {
+                    const id = picture(look.avatar, "avatar", "theme.avatar");
+                    if (id)
+                        input.avatar = id;
+                }
+                const checked = checkTheme(input, { assets: new Set(pictures.map(p => p.id)) });
+                if (!checked.ok)
+                    for (const e of checked.errors)
+                        bad(`theme.${e.path}`, e.problem);
+                const effects = [];
+                if (placed !== undefined) {
+                    if (!Array.isArray(placed) || placed.length > 2)
+                        bad("theme.effects", "at most 2 [{ effect, params? }]");
+                    else
+                        placed.forEach((p, i) => {
+                            const where = `theme.effects.${i}`;
+                            if (!isObj(p) || Object.keys(p).some(k => k !== "effect" && k !== "params") || typeof p.effect !== "string") {
+                                bad(where, "{ effect: path, params? }");
+                                return;
+                            }
+                            if (!effectPaths.has(p.effect)) {
+                                bad(where, `${p.effect} is not one of this bundle's effects`);
+                                return;
+                            }
+                            const entry = mod.effects.find(e => e.path === p.effect);
+                            if (!entry || !ctx.effects)
+                                return; // its own problem is reported already
+                            // #2017: a chat placement needs an effect that plays in chat. A non-chat effect may still come as a library
+                            // entry (contents.effects) without being placed.
+                            if (ctx.placementRegions !== false && !entry.summary.regions.includes("chat")) {
+                                bad(where, `effect_region: ${p.effect}'s regions do not include chat`);
+                                return;
+                            }
+                            const r = ctx.effects.params(entry.manifest, p.params ?? {});
+                            if (!r.ok) {
+                                bad(`${where}.params`, r.error);
+                                return;
+                            }
+                            if (effects.some(e => e.effect === p.effect)) {
+                                bad(where, "placed twice");
+                                return;
+                            }
+                            effects.push({ effect: p.effect, params: r.overrides });
+                        });
+                }
+                if (checked.ok)
+                    mod.theme = { theme: checked.theme, pictures, effects };
+            }
+        }
+    }
+    if (c.identity) {
+        const raw = json(c.identity, "manifest.contents.identity");
+        if (raw !== undefined) {
+            if (!isObj(raw) || Object.keys(raw).some(k => k !== "tagline" && k !== "bio") || !Object.keys(raw).length)
+                bad("identity", "{ tagline?, bio? }");
+            else {
+                const id = {};
+                if (raw.tagline !== undefined) {
+                    const t = canonicalTagline(raw.tagline);
+                    if (t === null)
+                        bad("identity.tagline", "one line, 1..60 characters");
+                    else
+                        id.tagline = t;
+                }
+                if (raw.bio !== undefined) {
+                    const t = canonicalBio(raw.bio);
+                    if (t === null)
+                        bad("identity.bio", "1..280 characters, at most 3 line breaks");
+                    else
+                        id.bio = t;
+                }
+                mod.identity = id;
+            }
+        }
+    }
+    for (const [slot, p] of Object.entries(c.widgets ?? {})) {
+        const raw = json(p, `manifest.contents.widgets.${slot}`);
+        if (raw === undefined)
+            continue;
+        if (!isObj(raw) || Object.keys(raw).length !== 2 || !("spec" in raw) || !("data" in raw)) {
+            bad(`widgets.${slot}`, "{ spec, data }");
+            continue;
+        }
+        const spec = checkWidgetSpec(raw.spec, slot);
+        if (!spec.ok) {
+            for (const e of spec.errors)
+                bad(`widgets.${slot}.${e.path}`, e.problem);
+            continue;
+        }
+        const data = checkWidgetData(raw.data, spec.value);
+        if (!data.ok) {
+            for (const e of data.errors)
+                bad(`widgets.${slot}.${e.path}`, e.problem);
+            continue;
+        }
+        mod.widgets[slot] = { spec: spec.value, data: { ...data.value } };
+    }
+    if (c.ownerCss) {
+        const assets = [];
+        for (const p of c.ownerCss.assets ?? []) {
+            const b = take(p, `ownerCss.assets.${p}`);
+            if (!b)
+                continue;
+            const kind = sniffMedia(b);
+            const kept = kind && CSS_ASSET_KINDS.has(kind) ? stripMetadata(b, kind) : null;
+            if (!kind || !kept) {
+                bad(`ownerCss.assets.${p}`, "png, webp, jpeg, gif or woff2");
+                continue;
+            }
+            assets.push({ path: p, id: hash32(kept), kind, kept });
+        }
+        const cssBytes = take(c.ownerCss.css, "manifest.contents.ownerCss.css");
+        if (cssBytes) {
+            let text = null;
+            try {
+                text = utf8.decode(cssBytes);
+            }
+            catch {
+                bad("ownerCss.css", "not UTF-8");
+            }
+            if (text !== null) {
+                if (cssBytes.length > OWNER_CSS_MAX_BYTES)
+                    bad("ownerCss.css", `at most ${OWNER_CSS_MAX_BYTES / 1024} KiB`);
+                else {
+                    // url("asset:<id>") names one of the bundle's CSS assets by the id it will have (the hash of its kept bytes).
+                    const checked = checkOwnerCss(text, new Set(assets.map(a => a.id)));
+                    if (!checked.ok)
+                        bad("ownerCss.css", `${checked.error.problem}${checked.error.detail ? `: ${checked.error.detail}` : ""}`);
+                    else
+                        mod.ownerCss = { text, assets };
+                }
+            }
+        }
+    }
+    for (const p of files.keys())
+        if (!used.has(p))
+            bad(`files.${p}`, "not used by any part");
+    return problems.length ? fail() : { ok: true, mod };
+}
+/** A file's entry for a bundle being built (export). */
+export function modFile(bytes) {
+    return { sha256: sha256(bytes), b64: Buffer.from(bytes).toString("base64") };
+}
+/** The extension a picture or CSS asset is exported under. */
+export function modAssetName(base, kind) { return `${base}.${MEDIA_EXT[kind]}`; }
+/**
+ * The effect runtime's checker (CW1: Sol's src/web-effect-bundle.ts and src/web-effect.ts) as a bundle uses it. Used
+ * once the fleet has an effect library to install into; until then the fleet passes null and effects are refused.
+ */
+export function cw1EffectChecker() {
+    return {
+        check(files) {
+            const r = checkEffectEntry(files);
+            if (!r.ok)
+                return { ok: false, problems: r.problems };
+            const m = r.manifest;
+            return { ok: true, manifest: m, summary: { id: r.id, title: m.title, bytes: r.bytes, regions: [...m.regions], wants: [...m.wants], params: Object.keys(m.params ?? {}) } };
+        },
+        params(manifest, overrides) {
+            const r = resolveEffectParams(manifest, overrides);
+            return r.ok ? { ok: true, overrides: { ...r.overrides } } : { ok: false, error: r.error };
+        },
+    };
+}
+//# sourceMappingURL=web-mod-bundle.js.map

package/dist/web-mod-bundle.js.map

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

package/dist/web-mod-export.d.ts

@@ -0,0 +1,59 @@
+/**
+ * #1629 r4 §4 (r4-5): building a mod bundle from what is in force — one instance's look (theme with its pictures,
+ * identity text, its widgets) and, for a person, their sidebar widget and their own CSS with its assets. The result is
+ * the same format the importer checks (web-mod-bundle.ts), and it passes that check: export → import is the round trip.
+ * Card pictures never travel (a card is an instance's identity, not a look).
+ */
+import { type MediaKind } from "./web-image-meta.js";
+import type { Theme } from "./web-theme.js";
+import type { WidgetData, WidgetSlot, WidgetSpec } from "./web-widget.js";
+export interface ModExportParts {
+    /**
+     * The theme, and (r4-5c) the effects it places: each a CW1 entry's files as the library keeps them, written under
+     * `effects/<name>/`, with the placement's non-default params. Effects travel only with the theme that places them.
+     */
+    theme?: {
+        theme: Theme;
+        picture: (id: string) => {
+            bytes: Uint8Array;
+            kind: MediaKind;
+        } | null;
+        effects?: Array<{
+            name: string;
+            files: ReadonlyMap<string, Uint8Array>;
+            params: Record<string, unknown>;
+        }>;
+    };
+    identity?: {
+        tagline?: string;
+        bio?: string;
+    };
+    widgets?: Partial<Record<WidgetSlot, {
+        spec: WidgetSpec;
+        data: WidgetData;
+    }>>;
+    ownerCss?: {
+        text: string;
+        assets: Array<{
+            id: string;
+            bytes: Uint8Array;
+            kind: MediaKind;
+        }>;
+    };
+}
+export interface ModExportMeta {
+    name: string;
+    version: string;
+    title: string;
+    description?: string;
+    author?: string;
+}
+/** The bundle file's text (UTF-8 JSON), or why it can't be built (a picture the theme names is missing). */
+export declare function buildModBundle(meta: ModExportMeta, parts: ModExportParts): {
+    ok: true;
+    text: string;
+    filename: string;
+} | {
+    ok: false;
+    error: string;
+};

package/dist/web-mod-export.js

@@ -0,0 +1,79 @@
+/**
+ * #1629 r4 §4 (r4-5): building a mod bundle from what is in force — one instance's look (theme with its pictures,
+ * identity text, its widgets) and, for a person, their sidebar widget and their own CSS with its assets. The result is
+ * the same format the importer checks (web-mod-bundle.ts), and it passes that check: export → import is the round trip.
+ * Card pictures never travel (a card is an instance's identity, not a look).
+ */
+import { MEDIA_EXT } from "./web-image-meta.js";
+import { MOD_FORMAT, modFile } from "./web-mod-bundle.js";
+const enc = new TextEncoder();
+const jsonBytes = (v) => enc.encode(JSON.stringify(v, null, 2) + "\n");
+/** The bundle file's text (UTF-8 JSON), or why it can't be built (a picture the theme names is missing). */
+export function buildModBundle(meta, parts) {
+    const files = {};
+    const put = (path, bytes) => { files[path] = modFile(bytes); };
+    const contents = {};
+    if (parts.theme) {
+        const { card: _card, ...look } = parts.theme.theme;
+        void _card;
+        const out = { ...look };
+        const picture = (id, base) => {
+            const p = parts.theme.picture(id);
+            if (!p)
+                return null;
+            const path = `pictures/${base}.${MEDIA_EXT[p.kind]}`;
+            put(path, p.bytes);
+            return path;
+        };
+        if (look.background) {
+            const path = picture(look.background.image, "background");
+            if (!path)
+                return { ok: false, error: "picture_missing" };
+            out.background = { ...look.background, image: path };
+        }
+        if (look.avatar) {
+            const path = picture(look.avatar, "avatar");
+            if (!path)
+                return { ok: false, error: "picture_missing" };
+            out.avatar = path;
+        }
+        const placed = [];
+        const taken = new Set();
+        for (const e of parts.theme.effects ?? []) {
+            const base = /^[a-z0-9][a-z0-9-]{0,47}$/.test(e.name) ? e.name : "effect";
+            let slug = base;
+            for (let n = 2; taken.has(slug); n++)
+                slug = `${base}-${n}`;
+            taken.add(slug);
+            const dir = `effects/${slug}`;
+            for (const [rel, bytes] of e.files)
+                put(`${dir}/${rel}`, bytes);
+            (contents.effects ??= []).push(dir);
+            placed.push({ effect: dir, ...(Object.keys(e.params).length ? { params: e.params } : {}) });
+        }
+        if (placed.length)
+            out.effects = placed;
+        put("theme.json", jsonBytes(out));
+        contents.theme = "theme.json";
+    }
+    if (parts.identity && (parts.identity.tagline || parts.identity.bio)) {
+        put("identity.json", jsonBytes({ ...(parts.identity.tagline ? { tagline: parts.identity.tagline } : {}), ...(parts.identity.bio ? { bio: parts.identity.bio } : {}) }));
+        contents.identity = "identity.json";
+    }
+    for (const [slot, w] of Object.entries(parts.widgets ?? {})) {
+        const path = `widgets/${slot.replace("_", "-")}.json`;
+        put(path, jsonBytes({ spec: w.spec, data: w.data }));
+        (contents.widgets ??= {})[slot] = path;
+    }
+    if (parts.ownerCss) {
+        // The CSS names its assets as url("asset:<id>"): the id is the hash of the kept bytes, the same on import.
+        const assets = parts.ownerCss.assets.map(a => { const path = `css/assets/${a.id}.${MEDIA_EXT[a.kind]}`; put(path, a.bytes); return path; });
+        put("css/custom.css", enc.encode(parts.ownerCss.text));
+        contents.ownerCss = { css: "css/custom.css", ...(assets.length ? { assets } : {}) };
+    }
+    if (!Object.keys(contents).length)
+        return { ok: false, error: "nothing_to_export" };
+    const manifest = { name: meta.name, version: meta.version, title: meta.title, ...(meta.description ? { description: meta.description } : {}), ...(meta.author ? { author: meta.author } : {}), contents };
+    return { ok: true, text: JSON.stringify({ format: MOD_FORMAT, v: 1, manifest, files }) + "\n", filename: `${meta.name}-${meta.version}.agendmod.json` };
+}
+//# sourceMappingURL=web-mod-export.js.map

package/dist/web-mod-export.js.map

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