@multiplayer-app/sandbox 0.0.30 → 0.0.32

package/dist/agents/shared/session-quality-report.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-quality-report.tool.js","sourceRoot":"","sources":["../../../src/agents/shared/session-quality-report.tool.ts"],"names":[],"mappings":"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"}

package/dist/agents/shared/session-vm-bridge.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Host-injected bridge from agent tools to a per-session app VM (workspace,
+ * exec, preview). Implemented by the embedding host against its VM control
+ * plane; absent when the deployment has no VM runtime — tools then report
+ * that app workspaces are unavailable and agents fall back to session artifacts.
+ */
+export interface AppVmInfo {
+    vmId: string;
+    stack: string;
+    /** Public URL where the VM's HTTP port is reachable through the preview gateway. */
+    previewUrl?: string;
+}
+export interface AppVmFile {
+    /** Path relative to the VM workspace root (no leading slash, no traversal). */
+    path: string;
+    content: string;
+    encoding?: 'utf8' | 'base64';
+}
+export interface AppVmExecRequest {
+    command: string;
+    cwd?: string;
+    timeoutMs?: number;
+}
+export interface AppVmExecResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    durationMs: number;
+    truncated: boolean;
+    timedOut: boolean;
+}
+export interface SessionVmBridge {
+    /** Find or create the session's app VM. */
+    ensureVm(sessionId: string, stack?: string): Promise<AppVmInfo>;
+    /** Write files into the session VM's workspace (creates the VM if needed). */
+    writeFiles(sessionId: string, files: AppVmFile[]): Promise<{
+        vm: AppVmInfo;
+        written: Array<{
+            path: string;
+            bytes: number;
+        }>;
+    }>;
+    /** Run a shell command in the session VM's workspace (creates the VM if needed). */
+    exec(sessionId: string, request: AppVmExecRequest): Promise<{
+        vm: AppVmInfo;
+        result: AppVmExecResult;
+    }>;
+}
+//# sourceMappingURL=session-vm-bridge.d.ts.map

package/dist/agents/shared/session-vm-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-vm-bridge.d.ts","sourceRoot":"","sources":["../../../src/agents/shared/session-vm-bridge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;IAC/D,8EAA8E;IAC9E,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,SAAS,CAAC;QAAC,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAA;IAC9H,oFAAoF;IACpF,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,SAAS,CAAC;QAAC,MAAM,EAAE,eAAe,CAAA;KAAE,CAAC,CAAA;CACxG"}

package/dist/agents/shared/session-vm-bridge.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Host-injected bridge from agent tools to a per-session app VM (workspace,
+ * exec, preview). Implemented by the embedding host against its VM control
+ * plane; absent when the deployment has no VM runtime — tools then report
+ * that app workspaces are unavailable and agents fall back to session artifacts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=session-vm-bridge.js.map

package/dist/agents/shared/session-vm-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-vm-bridge.js","sourceRoot":"","sources":["../../../src/agents/shared/session-vm-bridge.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/agents/skills/a11y.skill.d.ts

@@ -0,0 +1,3 @@
+import type { GenerationSkill } from './types';
+export declare const a11ySkill: GenerationSkill;
+//# sourceMappingURL=a11y.skill.d.ts.map

package/dist/agents/skills/a11y.skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y.skill.d.ts","sourceRoot":"","sources":["../../../src/agents/skills/a11y.skill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,eAAO,MAAM,SAAS,EAAE,eAkBvB,CAAA"}

package/dist/agents/skills/a11y.skill.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.a11ySkill = void 0;
+exports.a11ySkill = {
+    name: 'a11y',
+    description: 'Accessibility checklist applied before publishing any page',
+    whenToUse: 'Every UI/HTML page (auto-included with designer).',
+    instructions: `## a11y — bake into the single write
+
+Incorporate these into the ONE publish/update call — do not iterate tool calls to satisfy the checklist:
+
+1. Landmarks: exactly one <main>; site chrome in <header>/<nav>/<footer>; sections labelled via headings or aria-label.
+2. Heading order: one <h1>; no skipped levels; headings describe content, not styling.
+3. Contrast: body text ≥ 4.5:1, large text ≥ 3:1 against its actual background. Bright accent fills (#1DB954-class greens) need text-slate-950 (not text-white) OR a darker fill; bright accent text on white needs a darker accent shade.
+4. Keyboard: everything clickable is a <button>/<a>/input; Esc closes dialogs; :focus-visible clearly visible.
+5. Labels & names: every input has a <label>; icon-only buttons get aria-label; links make sense out of context.
+6. Images/SVG: informative SVGs get role="img" + <title>; decorative ones aria-hidden="true".
+7. State semantics: aria-selected / aria-expanded / aria-sort / role="status" where relevant.
+8. Color is never the only signal — pair statuses with symbols or text.
+9. Motion: animations disabled under prefers-reduced-motion.
+10. Touch targets ≥ 44×44px on primary actions.`,
+};
+//# sourceMappingURL=a11y.skill.js.map

package/dist/agents/skills/a11y.skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y.skill.js","sourceRoot":"","sources":["../../../src/agents/skills/a11y.skill.ts"],"names":[],"mappings":";;;AAEa,QAAA,SAAS,GAAoB;IACxC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,4DAA4D;IACzE,SAAS,EAAE,mDAAmD;IAC9D,YAAY,EAAE;;;;;;;;;;;;;gDAagC;CAC/C,CAAA"}

package/dist/agents/skills/account-skill-loader.d.ts

@@ -0,0 +1,13 @@
+import type { AdditionalContext } from '@multiplayer-app/ai-agent-types';
+import type { GenerationSkill } from './types';
+/** Loads account-defined skills for the account in the agent context. */
+export type AccountSkillLoader = (context?: AdditionalContext) => Promise<GenerationSkill[]>;
+export declare function getContextAccountId(context?: AdditionalContext): string | undefined;
+/**
+ * Default loader: reads the account's custom skills via the injected
+ * CustomSkillRepository. Resolves to [] when no repository is configured,
+ * no account is in context, or the lookup fails — generation must never
+ * break because custom skills are unavailable.
+ */
+export declare const loadAccountSkills: AccountSkillLoader;
+//# sourceMappingURL=account-skill-loader.d.ts.map

package/dist/agents/skills/account-skill-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-skill-loader.d.ts","sourceRoot":"","sources":["../../../src/agents/skills/account-skill-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAI9C,yEAAyE;AACzE,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;AAE5F,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAGnF;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,kBAqB/B,CAAA"}

package/dist/agents/skills/account-skill-loader.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadAccountSkills = void 0;
+exports.getContextAccountId = getContextAccountId;
+const context_1 = require("../../context");
+const logger_1 = require("../../logger");
+function getContextAccountId(context) {
+    var _a;
+    const accountId = (_a = context === null || context === void 0 ? void 0 : context.data) === null || _a === void 0 ? void 0 : _a.accountId;
+    return typeof accountId === 'string' && accountId ? accountId : undefined;
+}
+/**
+ * Default loader: reads the account's custom skills via the injected
+ * CustomSkillRepository. Resolves to [] when no repository is configured,
+ * no account is in context, or the lookup fails — generation must never
+ * break because custom skills are unavailable.
+ */
+const loadAccountSkills = async (context) => {
+    const accountId = getContextAccountId(context);
+    if (!accountId) {
+        return [];
+    }
+    try {
+        const repository = (0, context_1.getBuilderApiContext)().customSkillRepository;
+        if (!repository) {
+            return [];
+        }
+        const records = await repository.listByAccount(accountId);
+        return records.map((record) => ({
+            name: record.name,
+            description: record.description,
+            whenToUse: record.whenToUse,
+            instructions: record.instructions,
+        }));
+    }
+    catch (err) {
+        (0, logger_1.getBuilderApiLogger)().error({ err }, 'Failed to load account skills');
+        return [];
+    }
+};
+exports.loadAccountSkills = loadAccountSkills;
+//# sourceMappingURL=account-skill-loader.js.map

package/dist/agents/skills/account-skill-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-skill-loader.js","sourceRoot":"","sources":["../../../src/agents/skills/account-skill-loader.ts"],"names":[],"mappings":";;;AAQA,kDAGC;AATD,2CAAoD;AACpD,yCAAkD;AAKlD,SAAgB,mBAAmB,CAAC,OAA2B;;IAC7D,MAAM,SAAS,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,IAAI,0CAAE,SAAS,CAAA;IAC1C,OAAO,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAA;AAC3E,CAAC;AAED;;;;;GAKG;AACI,MAAM,iBAAiB,GAAuB,KAAK,EAAE,OAAO,EAAE,EAAE;IACrE,MAAM,SAAS,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAA;IAC9C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,CAAA;IACX,CAAC;IACD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAA,8BAAoB,GAAE,CAAC,qBAAqB,CAAA;QAC/D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,EAAE,CAAA;QACX,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAA;QACzD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC9B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC,CAAC,CAAC,CAAA;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAA,4BAAmB,GAAE,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,+BAA+B,CAAC,CAAA;QACrE,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC,CAAA;AArBY,QAAA,iBAAiB,qBAqB7B"}

package/dist/agents/skills/app-scaffold.skill.d.ts

@@ -0,0 +1,3 @@
+import type { GenerationSkill } from './types';
+export declare const appScaffoldSkill: GenerationSkill;
+//# sourceMappingURL=app-scaffold.skill.d.ts.map

package/dist/agents/skills/app-scaffold.skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-scaffold.skill.d.ts","sourceRoot":"","sources":["../../../src/agents/skills/app-scaffold.skill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,eAAO,MAAM,gBAAgB,EAAE,eAyB9B,CAAA"}

package/dist/agents/skills/app-scaffold.skill.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appScaffoldSkill = void 0;
+exports.appScaffoldSkill = {
+    name: 'app-scaffold',
+    description: 'Build real multi-file apps in the session app workspace (VM) with writeAppFiles/runAppCommand',
+    whenToUse: 'The user wants an actual app or project — multiple source files, npm packages, build steps, a backend — beyond a single generated page.',
+    instructions: `## app-scaffold
+
+When the request is an actual application (multi-file project, npm dependencies, build tooling, server code) target the session app workspace — an isolated per-session VM — instead of session artifacts.
+
+### Tools
+- writeAppFiles: write project files into the workspace (batched; workspace-relative paths). Static files are served at the returned previewUrl immediately.
+- runAppCommand: run shell commands in the workspace (npm install, node scripts, builds). Check exitCode and stderr after every command; fix and retry on failure instead of reporting broken output.
+- If these tools error that app workspaces are unavailable, fall back to session artifacts (publishSessionArtifacts) and say so.
+
+### Workflow
+1. Static-first: prefer a no-build project (index.html + ES modules + import maps for CDN deps) — it previews instantly and has no toolchain to break. Reach for a build step only when the request genuinely needs one.
+2. Write ALL project files in one writeAppFiles call: entry index.html, source under src/, package.json when using npm.
+3. When npm is needed: package.json with pinned versions → runAppCommand "npm install --no-audit --no-fund" → verify exitCode 0 → build if applicable → verify the output exists (ls dist).
+4. Verify before reporting: runAppCommand a smoke check (node script, curl the built output, ls expected files). A non-zero exit or empty stderr-only result is NOT success.
+5. Report the previewUrl and what was built. Keep docs (README.md) in the workspace too.
+
+### Structure conventions
+- index.html at the workspace root is the preview entry.
+- src/ for modules, data/ for JSON fixtures, styles in a single stylesheet unless the project warrants more.
+- package.json scripts: "build" and "start" when relevant; never rely on globally installed CLIs — use npx.
+- All design/interaction/content skills still apply to the UI you produce inside the app.`,
+};
+//# sourceMappingURL=app-scaffold.skill.js.map

package/dist/agents/skills/app-scaffold.skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-scaffold.skill.js","sourceRoot":"","sources":["../../../src/agents/skills/app-scaffold.skill.ts"],"names":[],"mappings":";;;AAEa,QAAA,gBAAgB,GAAoB;IAC/C,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,+FAA+F;IAC5G,SAAS,EAAE,yIAAyI;IACpJ,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;0FAoB0E;CACzF,CAAA"}

package/dist/agents/skills/copywriting.skill.d.ts

@@ -0,0 +1,3 @@
+import type { GenerationSkill } from './types';
+export declare const copywritingSkill: GenerationSkill;
+//# sourceMappingURL=copywriting.skill.d.ts.map

package/dist/agents/skills/copywriting.skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copywriting.skill.d.ts","sourceRoot":"","sources":["../../../src/agents/skills/copywriting.skill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,eAAO,MAAM,gBAAgB,EAAE,eA8B9B,CAAA"}

package/dist/agents/skills/copywriting.skill.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copywritingSkill = void 0;
+exports.copywritingSkill = {
+    name: 'copywriting',
+    description: 'Headlines, CTAs, microcopy, realistic sample content — no lorem ipsum',
+    whenToUse: 'User-facing pages where the words sell or guide: landing pages, product pages, dashboards with empty states, onboarding.',
+    instructions: `## copywriting
+
+The words are part of the design. Generic copy makes a beautiful page feel like a template.
+
+### Headlines
+- Lead with the outcome, not the category: "Ship dashboards your team actually reads" beats "A Modern Dashboard Solution".
+- One idea per headline, ≤10 words, no title-case-every-word; subhead (1-2 sentences) carries the how/what and names the audience.
+- Ban template words: "Welcome to", "revolutionary", "seamless", "cutting-edge", "unleash", "empower", "solutions".
+
+### CTAs
+- Verb + outcome, 2-4 words: "Start free trial", "Book a demo", "See the numbers". Never "Submit", "Click here", or "Learn more" as the primary CTA ("Learn more" is fine only as a quiet text link).
+- One primary CTA per view; the secondary is visually quieter (outline/ghost) and genuinely different in intent.
+
+### Body & features
+- Feature blurbs: benefit first, mechanism second — "Find any session in seconds. Full-text search across every recording." 2 sentences max.
+- Concrete beats abstract: numbers, timeframes, named integrations. "Syncs in under 5s" beats "blazing fast".
+- Sentence case everywhere, including buttons and nav.
+
+### Microcopy
+- Buttons say what happens next; loading states say what is happening ("Creating your workspace…"); confirmations say what happened and what is next.
+- Empty states are onboarding: what this area will show + the action that fills it ("No sessions yet — start one from the dashboard"), never a bare "No data".
+- Error messages: what went wrong + how to fix, no codes, no blame ("We couldn't save — check your connection and try again").
+
+### Sample data (when the page needs content)
+- Realistic and internally consistent: plausible names from varied cultures, real-looking companies/emails (use example.com domains), dates near today, metrics that add up and vary naturally (not 100/200/300).
+- Match the domain: a sales dashboard shows deal names and quotas; a fitness app shows workouts and streaks. Never lorem ipsum, never "Item 1/Item 2/Item 3".`,
+};
+//# sourceMappingURL=copywriting.skill.js.map

package/dist/agents/skills/copywriting.skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copywriting.skill.js","sourceRoot":"","sources":["../../../src/agents/skills/copywriting.skill.ts"],"names":[],"mappings":";;;AAEa,QAAA,gBAAgB,GAAoB;IAC/C,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,uEAAuE;IACpF,SAAS,EAAE,0HAA0H;IACrI,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;8JAyB8I;CAC7J,CAAA"}

package/dist/agents/skills/custom-skill-repository.d.ts

@@ -0,0 +1,40 @@
+/** An account-defined generation skill (brand pack, house style, domain guide). */
+export interface CustomSkillRecord {
+    skillId: string;
+    accountId: string;
+    /** Kebab-case identifier; may shadow a built-in skill to replace it account-wide. */
+    name: string;
+    description: string;
+    whenToUse: string;
+    instructions: string;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateCustomSkillInput {
+    accountId: string;
+    name: string;
+    description: string;
+    whenToUse: string;
+    instructions: string;
+    createdBy: string;
+}
+export interface UpdateCustomSkillInput {
+    accountId: string;
+    skillId: string;
+    name?: string;
+    description?: string;
+    whenToUse?: string;
+    instructions?: string;
+    updatedBy: string;
+}
+/** Implemented by the embedding host (like NotebookRepository); injected via createBuilderApi options. */
+export interface CustomSkillRepository {
+    listByAccount(accountId: string): Promise<CustomSkillRecord[]>;
+    getById(accountId: string, skillId: string): Promise<CustomSkillRecord | null>;
+    create(input: CreateCustomSkillInput): Promise<CustomSkillRecord>;
+    update(input: UpdateCustomSkillInput): Promise<CustomSkillRecord | null>;
+    delete(accountId: string, skillId: string): Promise<boolean>;
+}
+//# sourceMappingURL=custom-skill-repository.d.ts.map

package/dist/agents/skills/custom-skill-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-skill-repository.d.ts","sourceRoot":"","sources":["../../../src/agents/skills/custom-skill-repository.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,qFAAqF;IACrF,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,0GAA0G;AAC1G,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAA;IAC9D,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;IAC9E,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACjE,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;IACxE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC7D"}

package/dist/agents/skills/custom-skill-repository.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=custom-skill-repository.js.map

package/dist/agents/skills/custom-skill-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-skill-repository.js","sourceRoot":"","sources":["../../../src/agents/skills/custom-skill-repository.ts"],"names":[],"mappings":""}

package/dist/agents/skills/data-viz.skill.d.ts

@@ -0,0 +1,3 @@
+import type { GenerationSkill } from './types';
+export declare const dataVizSkill: GenerationSkill;
+//# sourceMappingURL=data-viz.skill.d.ts.map

package/dist/agents/skills/data-viz.skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-viz.skill.d.ts","sourceRoot":"","sources":["../../../src/agents/skills/data-viz.skill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,eAAO,MAAM,YAAY,EAAE,eAqC1B,CAAA"}

package/dist/agents/skills/data-viz.skill.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dataVizSkill = void 0;
+exports.dataVizSkill = {
+    name: 'data-viz',
+    description: 'Charts, KPI stat cards, sparklines, tables that read well',
+    whenToUse: 'Pages with metrics, statistics, time series, comparisons, or any numeric data.',
+    instructions: `## data-viz
+
+Numbers deserve visuals. Never present a dataset as a bare table alone — lead with KPIs and a chart, keep the table as detail.
+
+### Chart selection
+- Trend over time → line/area chart. Comparison across categories → horizontal bar (vertical only when labels are short). Part-of-whole → doughnut ONLY with ≤5 slices, else bar. Distribution → histogram-style bar. Two variables → scatter.
+- One message per chart. If a chart needs a paragraph to explain, split it.
+
+### KPI stat row (top of data pages)
+<section class="kpis"> with 3-5 cards: label (small, muted, uppercase tracking), value (2-2.5rem, font-weight 700, font-variant-numeric: tabular-nums), delta chip (▲/▼ + %, color-coded — pair with the symbol, never color alone). Grid: repeat(auto-fit, minmax(180px, 1fr)).
+
+### Chart.js recipe (data-heavy pages)
+Load once before your script: <script src="https://cdn.jsdelivr.net/npm/chart.js@4"></script>
+Theme-aware defaults — read colors from CSS so light/dark both work:
+  const css = getComputedStyle(document.documentElement)
+  const textColor = css.getPropertyValue('--pico-color').trim()
+  const gridColor = css.getPropertyValue('--pico-muted-border-color').trim()
+  Chart.defaults.color = textColor; Chart.defaults.borderColor = gridColor
+  Chart.defaults.font.family = css.getPropertyValue('--pico-font-family')
+- Wrap every canvas in a sized container (<div style="position:relative;height:320px">) with maintainAspectRatio: false — unsized canvases explode layouts.
+- Line charts: tension 0.3, thin points (radius 0-2, hover 4), subtle area fill via accent at low alpha.
+- Bars: borderRadius 6, category spacing; hide vertical gridlines (x: { grid: { display: false } }).
+- Legend only when >1 series; tooltips on; no chart titles inside the canvas (use an <h3> above).
+
+### Categorical palette (color-blind safe, works on light and dark)
+#6366f1 #0ea5e9 #10b981 #f59e0b #ef4444 #8b5cf6 — use in this order; series >6 means the chart is overloaded, aggregate instead.
+
+### Inline SVG sparkline (when Chart.js is overkill)
+<svg viewBox="0 0 100 28" preserveAspectRatio="none" class="spark"><polyline fill="none" stroke="var(--accent)" stroke-width="2" points="0,20 15,16 30,18 45,10 60,12 75,6 90,9 100,4"/></svg>
+Compute points from data in <script> when values are dynamic.
+
+### Tables as detail
+Wrap in a card with a toolbar (search input filtering rows); right-align numeric columns with tabular-nums; zebra via odd:bg-* striping or a subtle row hover; cap visible rows and add a "show all" toggle for long data. Ship 8–15 rows of realistic, varied sample data (real-sounding names/companies, plausible spread of values) — a 3-row table with "John Doe / Example Corp" reads as a broken demo.`,
+};
+//# sourceMappingURL=data-viz.skill.js.map

package/dist/agents/skills/data-viz.skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-viz.skill.js","sourceRoot":"","sources":["../../../src/agents/skills/data-viz.skill.ts"],"names":[],"mappings":";;;AAEa,QAAA,YAAY,GAAoB;IAC3C,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,2DAA2D;IACxE,SAAS,EAAE,gFAAgF;IAC3F,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8YAgC8X;CAC7Y,CAAA"}

package/dist/agents/skills/designer.skill.d.ts

@@ -0,0 +1,3 @@
+import type { GenerationSkill } from './types';
+export declare const designerSkill: GenerationSkill;
+//# sourceMappingURL=designer.skill.d.ts.map

package/dist/agents/skills/designer.skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"designer.skill.d.ts","sourceRoot":"","sources":["../../../src/agents/skills/designer.skill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,eAAO,MAAM,aAAa,EAAE,eAsI3B,CAAA"}

package/dist/agents/skills/designer.skill.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.designerSkill = void 0;
+exports.designerSkill = {
+    name: 'designer',
+    description: 'Visual design system: Tailwind utilities, tokens, layout packs, typography, atmosphere, polish',
+    whenToUse: 'Every UI/HTML page. Always include for any .html artifact.',
+    instructions: `## designer
+
+Goal: every page should feel like a shipped 2025 product site — distinctive, spacious, intentional — never a Bootstrap doc or generic AI template. Tailwind Play CDN is on (preflight): bare elements are unstyled. Utility-class every visible element. Use a small <style> only for fonts, keyframes, and atmosphere (mesh/grain).
+
+### Design brief is law
+Use the brief's accent as LITERAL hex utilities (bg-[#0EA5E9] hover:bg-[#0284C7]) — same hex everywhere. One neutral scale (slate OR zinc OR stone). Never indigo/violet defaults unless the brief names them. Never Inter. Never bg-[var(--x)] class names (undefined vars fail the gate).
+
+### Accent contrast (buttons & labels)
+Bright accents (#1DB954, lime, cyan-400, etc.) fail WCAG with white text and as body/eyebrow text on white. Prefer one of:
+- CTA: dark text on bright fill — e.g. \`bg-[#1DB954] text-slate-950\` (not text-white)
+- Or darken the fill for white text — e.g. \`bg-[#15803d] text-white\` (keep a brighter hover only if still AA)
+- Accent-as-text (eyebrows, links): use a darker shade of the brief accent (\`text-[#15803d]\`), not the bright fill hex on white
+Never waste turns "fixing contrast" by nudging slate body text — fix the accent/button pairing once.
+
+### Brand-first first viewport
+ONE composition: brand/product name as a hero-level signal, one headline, one supporting sentence, one CTA pair, one dominant visual plane (gradient mesh, abstract SVG, or atmospheric wash). No KPI strips, promo chips, address blocks, or card grids in the first viewport.
+- Launch pages: full-bleed hero — section background edge-to-edge; max-w column INSIDE the section. Never put the hero inside a rounded card.
+- Brand must still read if the nav disappeared.
+- At most one quiet eyebrow line — no floating stickers on hero media.
+
+### Atmosphere (required — flat white pages fail the bar)
+Give the page depth without clutter. Pick 1–2 of:
+- Soft accent-tint wash: bg-gradient-to-b from-[#ACCENT]/15 via-transparent to-transparent on the hero
+- Mesh blob: absolutely positioned blurred circles (blur-3xl opacity-30) behind hero content, pointer-events-none
+- Subtle grain: CSS repeating-radial-gradient noise at 3–5% opacity on a ::before (optional)
+- Glass chrome: sticky nav with bg-white/70 dark:bg-slate-950/70 backdrop-blur-xl border-b border-*/10
+Never neon saturated walls. Atmosphere supports content; it does not compete with it.
+
+### Typography
+Load the brief's Google Fonts <link> + wire font-family on body in <style>. Pairings: Manrope+Plus Jakarta Sans (product), Sora+Space Grotesk (tech), Fraunces+Newsreader (editorial), Outfit+DM Sans (friendly). Max two families.
+Scale: hero text-5xl sm:text-6xl lg:text-7xl font-extrabold tracking-tight → section h2 text-3xl sm:text-4xl font-bold tracking-tight → body text-base/lg text-slate-600. tabular-nums on metrics. Secondary text text-slate-500.
+
+### Canonical patterns — adapt hex/fonts/copy; do not invent a weaker layout from scratch
+
+Sticky glass nav:
+\`\`\`html
+<header class="sticky top-0 z-50 border-b border-slate-200/70 bg-white/70 backdrop-blur-xl">
+  <div class="mx-auto flex h-16 max-w-6xl items-center justify-between px-4 sm:px-6">
+    <a href="index.html" class="flex items-center gap-2.5 text-lg font-extrabold tracking-tight text-slate-900">
+      <span class="inline-flex h-8 w-8 items-center justify-center rounded-lg bg-[#0EA5E9] text-white"><!-- lucide svg --></span>
+      Brand
+    </a>
+    <nav class="hidden items-center gap-8 text-sm font-medium text-slate-600 md:flex">
+      <a href="features.html" class="transition-colors hover:text-[#0EA5E9]">Features</a>
+      <a href="pricing.html" class="transition-colors hover:text-[#0EA5E9]">Pricing</a>
+    </nav>
+    <div class="flex items-center gap-3">
+      <button type="button" class="md:hidden inline-flex h-10 w-10 items-center justify-center rounded-lg text-slate-700" aria-label="Open menu"><!-- menu svg --></button>
+      <a href="#cta" class="hidden sm:inline-flex items-center rounded-lg bg-[#0EA5E9] px-4 py-2 text-sm font-semibold text-white shadow-sm transition hover:bg-[#0284C7] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[#0EA5E9] focus-visible:ring-offset-2">Start free</a>
+    </div>
+  </div>
+</header>
+\`\`\`
+Include a mobile drawer/menu script for the md:hidden button — a sticky nav that does nothing on mobile looks unfinished.
+
+Launch hero:
+\`\`\`html
+<section class="relative overflow-hidden">
+  <div class="pointer-events-none absolute -top-24 left-1/2 h-72 w-72 -translate-x-1/2 rounded-full bg-[#0EA5E9]/25 blur-3xl"></div>
+  <div class="relative mx-auto max-w-6xl px-4 py-24 text-center sm:px-6 sm:py-32">
+    <p class="text-sm font-semibold tracking-wide text-[#0EA5E9]">For ops teams who live in data</p>
+    <h1 class="mt-4 text-5xl font-extrabold tracking-tight text-slate-900 sm:text-6xl lg:text-7xl">Ship clarity,<br><span class="text-[#0EA5E9]">not dashboards</span></h1>
+    <p class="mx-auto mt-6 max-w-2xl text-lg text-slate-600">One sentence of concrete value for a named audience — not "welcome to our platform".</p>
+    <div class="mt-10 flex flex-wrap items-center justify-center gap-4">
+      <a href="#cta" class="inline-flex items-center rounded-lg bg-[#0EA5E9] px-6 py-3 text-sm font-semibold text-white shadow-lg shadow-[#0EA5E9]/25 transition hover:bg-[#0284C7]">Start free trial</a>
+      <a href="features.html" class="inline-flex items-center rounded-lg border border-slate-200 bg-white px-6 py-3 text-sm font-semibold text-slate-800 transition hover:border-slate-300 hover:bg-slate-50">See how it works</a>
+    </div>
+  </div>
+</section>
+\`\`\`
+
+Feature row (alternate direction with lg:flex-row-reverse on odd sections):
+\`\`\`html
+<section class="border-t border-slate-100 py-20 sm:py-28">
+  <div class="mx-auto grid max-w-6xl items-center gap-12 px-4 sm:px-6 lg:grid-cols-2">
+    <div>
+      <h2 class="text-3xl font-bold tracking-tight text-slate-900 sm:text-4xl">Outcome-led headline</h2>
+      <p class="mt-4 text-lg text-slate-600">Benefit first, mechanism second. Two sentences max.</p>
+      <ul class="mt-8 space-y-3 text-slate-700">
+        <li class="flex gap-3"><span class="mt-0.5 text-[#0EA5E9]"><!-- check svg --></span>Concrete capability</li>
+      </ul>
+    </div>
+    <div class="relative aspect-[4/3] overflow-hidden rounded-2xl border border-slate-200 bg-gradient-to-br from-[#0EA5E9]/10 to-slate-50 shadow-sm">
+      <!-- abstract SVG illustration or UI mock framed here — never a hotlinked photo -->
+    </div>
+  </div>
+</section>
+\`\`\`
+
+KPI (product pack only — never in launch hero):
+\`\`\`html
+<div class="rounded-2xl border border-slate-200/80 bg-white p-5 shadow-sm transition hover:-translate-y-0.5 hover:shadow-lg">
+  <div class="flex items-center justify-between">
+    <span class="text-sm font-medium text-slate-500">Weekly active</span>
+    <span class="inline-flex h-9 w-9 items-center justify-center rounded-xl bg-[#0EA5E9]/10 text-[#0EA5E9]"><!-- svg --></span>
+  </div>
+  <p class="mt-3 text-3xl font-bold tracking-tight tabular-nums text-slate-900">12,480</p>
+  <p class="mt-1 text-sm font-medium text-emerald-600">↑ 12.4% vs last week</p>
+</div>
+\`\`\`
+
+Pricing highlight:
+\`\`\`html
+<div class="relative rounded-2xl border-2 border-[#0EA5E9] bg-white p-8 shadow-xl shadow-[#0EA5E9]/10">
+  <span class="absolute -top-3 left-1/2 -translate-x-1/2 rounded-full bg-[#0EA5E9] px-3 py-1 text-xs font-semibold text-white">Most popular</span>
+  <h3 class="text-lg font-semibold text-slate-900">Growth</h3>
+  <p class="mt-3"><span class="text-4xl font-extrabold tracking-tight tabular-nums">$149</span><span class="text-slate-500">/mo</span></p>
+  <a href="#cta" class="mt-8 block rounded-lg bg-[#0EA5E9] py-2.5 text-center text-sm font-semibold text-white transition hover:bg-[#0284C7]">Start free trial</a>
+</div>
+\`\`\`
+
+### Layout packs
+- **launch**: hero → 2–3 alternating features → social proof (logos or quote) → pricing or final CTA band. Section rhythm py-20 sm:py-28. Alternate alignment; not everything centered.
+- **product**: dense glass header; KPI row; card grid or sidebar+main; tables in cards with toolbar; space-y-6.
+- **editorial**: max-w-2xl measure, strong type, sticky TOC (lg+), accent border-l-4 callouts.
+
+### Icons
+Inline Lucide/Heroicons SVG only (stroke="currentColor" stroke-width="2" class="h-5 w-5"). Never emoji. Feature icons sit in rounded-xl accent/10 badges.
+
+### Interactions & polish (include in the same write — do not iterate)
+- Mobile nav works; primary actions ≥ 44px touch targets
+- Hover + focus-visible:ring-2 ring-offset-2 on every control; nav links transition-colors, no underline
+- 2–3 purposeful motions max (hero fade-in, card hover lift, scroll reveal) behind prefers-reduced-motion
+- body { background } set to match scheme; gutters never flash white on dark pages
+- Footer with real product name + working relative links
+- One <h1>; every section has a clear job; no dead href="#"; no lorem; no "Welcome to"
+- Mentally check 360px and 1280px — grids collapse, type stays readable
+
+### Automatic fails
+Indigo/violet-on-white gradient cliché · Inter · emoji icons · hero-in-a-card · first-viewport KPI soup · flat unstyled sections · external raster images · template adjectives (revolutionary/seamless/cutting-edge/unleash/empower)`,
+};
+//# sourceMappingURL=designer.skill.js.map

package/dist/agents/skills/designer.skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"designer.skill.js","sourceRoot":"","sources":["../../../src/agents/skills/designer.skill.ts"],"names":[],"mappings":";;;AAEa,QAAA,aAAa,GAAoB;IAC5C,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,gGAAgG;IAC7G,SAAS,EAAE,4DAA4D;IACvE,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sOAiIsN;CACrO,CAAA"}

package/dist/agents/skills/forms.skill.d.ts

@@ -0,0 +1,3 @@
+import type { GenerationSkill } from './types';
+export declare const formsSkill: GenerationSkill;
+//# sourceMappingURL=forms.skill.d.ts.map

package/dist/agents/skills/forms.skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms.skill.d.ts","sourceRoot":"","sources":["../../../src/agents/skills/forms.skill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,eAAO,MAAM,UAAU,EAAE,eAgCxB,CAAA"}

package/dist/agents/skills/forms.skill.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formsSkill = void 0;
+exports.formsSkill = {
+    name: 'forms',
+    description: 'Form UX: validation timing, inline errors, multi-step flows, success states',
+    whenToUse: 'Pages with user input: signup/contact/checkout/settings forms, wizards, feedback widgets.',
+    instructions: `## forms
+
+Forms are judged by how they fail. Build the error and success paths, not just the happy markup.
+
+### Structure
+- One <label> per control, always visible (placeholders are hints, never labels). Group related fields with <fieldset><legend>.
+- Right input types and autocomplete attrs: type="email" autocomplete="email", inputmode="numeric" for codes, autocomplete="name|tel|postal-code|current-password" etc. — mobile keyboards and autofill depend on them.
+- Mark optional fields with "(optional)" in the label rather than starring required ones when most fields are required.
+- Single-column layout; short related fields (city/zip) may share a row. Primary submit button full-width or right-aligned, styled with the accent; never two competing primary buttons.
+
+### Validation timing (the part everyone gets wrong)
+- Validate a field on blur, not on every keystroke; once a field has shown an error, re-validate on input so the error clears the moment it is fixed.
+- On submit: preventDefault, validate all, focus the first invalid field, and show a compact error summary at the top if more than one field failed.
+- Use novalidate on the <form> and run your own checks (Checking validity via input.validity is fine) so styling stays consistent.
+
+### Error display
+- Inline, under the field: <small class="error" id="email-error">Enter a valid email, like name@company.com</small>; set aria-describedby="email-error" and aria-invalid="true" on the input, and style the invalid state (e.g. aria-invalid:border-red-500 or a .error class).
+- Error copy says how to fix, not what failed: "Password needs at least 8 characters" beats "Invalid password".
+- Never disable the submit button as the only validation strategy — let users submit and see what is missing.
+
+### Multi-step (wizard) forms
+- Step indicator with current/total and step names; one <section> per step, hidden attr on inactive ones; validate the current step before advancing; Back never loses data.
+- Persist draft state to localStorage on change so refresh does not wipe progress; clear it on success.
+
+### Async submit & success
+- On submit: button disables to block double-submit and shows a busy state (spinner SVG or "Sending…" label + reduced opacity); simulate the request when there is no backend (setTimeout ~800ms).
+- Success replaces the form (or shows a distinct panel): checkmark icon, confirmation headline, what happens next. Keep it in the DOM (hidden) from the start and toggle.
+- Failure shows a retryable, non-destructive error banner above the form — never wipe entered data.`,
+};
+//# sourceMappingURL=forms.skill.js.map

package/dist/agents/skills/forms.skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms.skill.js","sourceRoot":"","sources":["../../../src/agents/skills/forms.skill.ts"],"names":[],"mappings":";;;AAEa,QAAA,UAAU,GAAoB;IACzC,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,6EAA6E;IAC1F,SAAS,EAAE,2FAA2F;IACtG,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;oGA2BoF;CACnG,CAAA"}

package/dist/agents/skills/index.d.ts

@@ -0,0 +1,6 @@
+export type { GenerationSkill } from './types';
+export { GENERATION_SKILLS, STATIC_SKILL_GUIDES, getSkillCatalog, mergeSkills, buildSkillGuidance, } from './registry';
+export { extractRequestedSkills, inferRequestedSkills, extractDesignTokens, createSkillInjectingPrepareStep, } from './skill-injection';
+export { loadAccountSkills, getContextAccountId, type AccountSkillLoader, } from './account-skill-loader';
+export type { CustomSkillRecord, CreateCustomSkillInput, UpdateCustomSkillInput, CustomSkillRepository, } from './custom-skill-repository';
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/skills/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAC9C,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,kBAAkB,GACnB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,+BAA+B,GAChC,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,kBAAkB,GACxB,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EACV,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,2BAA2B,CAAA"}