micro-contracts 0.9.0

package/dist/types.js

@@ -0,0 +1,297 @@
+/**
+ * OpenAPI specification types for code generation
+ */
+/**
+ * Parse dependency reference string
+ */
+export function parseDependencyRef(ref) {
+    const parts = ref.split('.');
+    if (parts.length !== 3)
+        return null;
+    return {
+        module: parts[0],
+        domain: parts[1],
+        method: parts[2],
+        raw: ref,
+    };
+}
+// =============================================================================
+// Config Utilities
+// =============================================================================
+/**
+ * Check if config is multi-module format
+ */
+export function isMultiModuleConfig(config) {
+    return typeof config === 'object' && config !== null && 'modules' in config;
+}
+/**
+ * Expand placeholders in a string
+ */
+export function expandPlaceholders(template, moduleName) {
+    const pascalCase = moduleName.charAt(0).toUpperCase() + moduleName.slice(1);
+    const upperSnake = moduleName.toUpperCase().replace(/-/g, '_');
+    return template
+        .replace(/\{module\}/g, moduleName)
+        .replace(/\{Module\}/g, pascalCase)
+        .replace(/\{MODULE\}/g, upperSnake);
+}
+/**
+ * Resolve outputs configuration
+ */
+function resolveOutputs(moduleName, moduleConfig, defaults) {
+    const expand = (s) => expandPlaceholders(s, moduleName);
+    const resolvedOutputs = [];
+    // Merge default outputs with module overrides
+    const defaultOutputs = defaults.outputs || {};
+    const moduleOutputs = moduleConfig.outputs || {};
+    const allOutputIds = new Set([
+        ...Object.keys(defaultOutputs),
+        ...Object.keys(moduleOutputs),
+    ]);
+    for (const id of allOutputIds) {
+        const defaultConfig = defaultOutputs[id];
+        const moduleOverride = moduleOutputs[id];
+        // Skip if explicitly disabled
+        if (moduleOverride?.enabled === false)
+            continue;
+        // Need at least default config
+        if (!defaultConfig && !moduleOverride?.output)
+            continue;
+        const output = expand(moduleOverride?.output ?? defaultConfig?.output ?? '');
+        const template = moduleOverride?.template ?? defaultConfig?.template ?? '';
+        if (!output || !template)
+            continue;
+        resolvedOutputs.push({
+            id,
+            output,
+            template,
+            overwrite: moduleOverride?.overwrite ?? defaultConfig?.overwrite ?? true,
+            condition: moduleOverride?.condition ?? defaultConfig?.condition ?? 'always',
+            enabled: moduleOverride?.enabled ?? defaultConfig?.enabled ?? true,
+            config: {
+                ...(defaultConfig?.config || {}),
+                ...(moduleOverride?.config || {}),
+            },
+        });
+    }
+    return resolvedOutputs;
+}
+/**
+ * Resolve module config by applying defaults and expanding placeholders
+ */
+export function resolveModuleConfig(moduleName, moduleConfig, defaults = {}) {
+    const expand = (s) => expandPlaceholders(s, moduleName);
+    // Contract output
+    const contractOutput = expand(moduleConfig.contract?.output ??
+        defaults.contract?.output ??
+        `packages/contract/${moduleName}`);
+    // Public contract output
+    const contractPublicOutput = expand(moduleConfig.contractPublic?.output ??
+        defaults.contractPublic?.output ??
+        `packages/contract-published/${moduleName}`);
+    // Server config (legacy)
+    const serverEnabled = moduleConfig.server?.enabled !== false;
+    const server = serverEnabled ? {
+        output: expand(moduleConfig.server?.output ??
+            defaults.server?.output ??
+            `server/src/${moduleName}`),
+        routes: moduleConfig.server?.routes ?? defaults.server?.routes ?? 'routes.generated.ts',
+        domainsPath: expand(moduleConfig.server?.domainsPath ??
+            defaults.server?.domainsPath ??
+            `fastify.domains.${moduleName}`),
+    } : null;
+    // Frontend config (legacy)
+    const frontendEnabled = moduleConfig.frontend?.enabled !== false;
+    const frontendDefaults = defaults.frontend;
+    const frontendOverride = moduleConfig.frontend;
+    let frontendShared = null;
+    if (frontendEnabled) {
+        const sharedConfig = frontendOverride?.shared ?? frontendDefaults?.shared;
+        if (sharedConfig) {
+            frontendShared = {
+                output: expand(sharedConfig.output ?? 'frontend/src/shared'),
+                client: expand(sharedConfig.client ?? `${moduleName}.api.generated.ts`),
+            };
+        }
+    }
+    const frontend = frontendEnabled ? {
+        output: expand(frontendOverride?.output ??
+            frontendDefaults?.output ??
+            `frontend/src/${moduleName}`),
+        client: frontendOverride?.client ?? frontendDefaults?.client ?? 'api.generated.ts',
+        domain: frontendOverride?.domain ?? frontendDefaults?.domain ?? 'domain.generated.ts',
+        shared: frontendShared,
+    } : null;
+    // Docs config
+    const docs = {
+        enabled: moduleConfig.docs?.enabled ?? defaults.docs?.enabled ?? true,
+        template: moduleConfig.docs?.template ?? defaults.docs?.template ?? 'default',
+    };
+    // Overlays (shared + module-specific)
+    const overlays = [
+        ...(defaults.overlays?.shared || []),
+        ...(moduleConfig.overlays || []),
+    ];
+    const overlayCollision = defaults.overlays?.collision || 'error';
+    // Templates (module overrides defaults) - legacy
+    const serverWithTemplate = server ? {
+        ...server,
+        template: moduleConfig.templates?.server ?? defaults.templates?.server,
+    } : null;
+    const frontendWithTemplate = frontend ? {
+        ...frontend,
+        template: moduleConfig.templates?.frontend ?? defaults.templates?.frontend,
+    } : null;
+    // New outputs system
+    const outputs = resolveOutputs(moduleName, moduleConfig, defaults);
+    return {
+        name: moduleName,
+        openapi: moduleConfig.openapi,
+        contractOutput,
+        contractPublicOutput,
+        server: serverWithTemplate,
+        frontend: frontendWithTemplate,
+        docs,
+        overlays,
+        overlayCollision,
+        outputs,
+        spectral: moduleConfig.spectral,
+        dependsOn: moduleConfig.dependsOn,
+    };
+}
+// Helper to check if object is a reference
+export function isReference(obj) {
+    return typeof obj === 'object' && obj !== null && '$ref' in obj;
+}
+// Extract schema name from $ref
+export function getRefName(ref) {
+    // "#/components/schemas/EntryListResponse" -> "EntryListResponse"
+    const parts = ref.split('/');
+    return parts[parts.length - 1];
+}
+/**
+ * Extract dependencies from OpenAPI spec
+ */
+export function extractDependencies(spec) {
+    const moduleLevelDeps = [];
+    const operationLevelDeps = new Map();
+    const allDepsSet = new Set();
+    // Module-level dependencies
+    const moduleDepRefs = spec.info['x-micro-contracts-depend-on'] || [];
+    for (const ref of moduleDepRefs) {
+        const parsed = parseDependencyRef(ref);
+        if (parsed) {
+            moduleLevelDeps.push(parsed);
+            allDepsSet.add(ref);
+        }
+    }
+    // Operation-level dependencies
+    for (const [, pathItem] of Object.entries(spec.paths)) {
+        for (const method of ['get', 'post', 'put', 'patch', 'delete']) {
+            const operation = pathItem[method];
+            if (!operation)
+                continue;
+            const opId = operation.operationId || '';
+            const opDepRefs = operation['x-micro-contracts-depend-on'] || [];
+            if (opDepRefs.length > 0) {
+                const parsedDeps = [];
+                for (const ref of opDepRefs) {
+                    const parsed = parseDependencyRef(ref);
+                    if (parsed) {
+                        parsedDeps.push(parsed);
+                        allDepsSet.add(ref);
+                    }
+                }
+                if (parsedDeps.length > 0) {
+                    operationLevelDeps.set(opId, parsedDeps);
+                }
+            }
+        }
+    }
+    // All unique deps
+    const allDeps = [];
+    for (const ref of allDepsSet) {
+        const parsed = parseDependencyRef(ref);
+        if (parsed)
+            allDeps.push(parsed);
+    }
+    return { moduleLevelDeps, operationLevelDeps, allDeps };
+}
+/**
+ * Get canonical extension value (supports both short and long forms)
+ */
+export function getExtensionValue(obj, shortName, longName) {
+    return (obj[longName] ?? obj[shortName]);
+}
+// Check if a schema contains x-private properties
+export function hasPrivateProperties(schema, spec, visited = new Set()) {
+    if (isReference(schema)) {
+        const refName = getRefName(schema.$ref);
+        if (visited.has(refName))
+            return false;
+        visited.add(refName);
+        const resolved = spec.components?.schemas?.[refName];
+        if (!resolved)
+            return false;
+        return hasPrivateProperties(resolved, spec, visited);
+    }
+    // Check if schema itself is private
+    if (schema['x-private'])
+        return true;
+    // Check properties
+    if (schema.properties) {
+        for (const propSchema of Object.values(schema.properties)) {
+            if (hasPrivateProperties(propSchema, spec, visited))
+                return true;
+        }
+    }
+    // Check array items
+    if (schema.items) {
+        if (hasPrivateProperties(schema.items, spec, visited))
+            return true;
+    }
+    // Check allOf/oneOf/anyOf
+    for (const composite of [schema.allOf, schema.oneOf, schema.anyOf]) {
+        if (composite) {
+            for (const s of composite) {
+                if (hasPrivateProperties(s, spec, visited))
+                    return true;
+            }
+        }
+    }
+    return false;
+}
+// Collect all schemas referenced by a schema
+export function collectReferencedSchemas(schema, spec, result = new Set()) {
+    if (isReference(schema)) {
+        const refName = getRefName(schema.$ref);
+        if (result.has(refName))
+            return result;
+        result.add(refName);
+        const resolved = spec.components?.schemas?.[refName];
+        if (resolved) {
+            collectReferencedSchemas(resolved, spec, result);
+        }
+        return result;
+    }
+    if (schema.properties) {
+        for (const propSchema of Object.values(schema.properties)) {
+            collectReferencedSchemas(propSchema, spec, result);
+        }
+    }
+    if (schema.items) {
+        collectReferencedSchemas(schema.items, spec, result);
+    }
+    for (const composite of [schema.allOf, schema.oneOf, schema.anyOf]) {
+        if (composite) {
+            for (const s of composite) {
+                collectReferencedSchemas(s, spec, result);
+            }
+        }
+    }
+    if (schema.additionalProperties && typeof schema.additionalProperties !== 'boolean') {
+        collectReferencedSchemas(schema.additionalProperties, spec, result);
+    }
+    return result;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/docs/architecture.svg

@@ -0,0 +1,226 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 950 870">
+  <defs>
+    <filter id="shadow" x="-20%" y="-20%" width="140%" height="140%">
+      <feDropShadow dx="2" dy="3" stdDeviation="3" flood-opacity="0.15"/>
+    </filter>
+    <marker id="arrowhead" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#64748b"/>
+    </marker>
+    <marker id="arrowhead-blue" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#3b82f6"/>
+    </marker>
+    <marker id="arrowhead-teal" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#0d9488"/>
+    </marker>
+    <pattern id="stripe" patternUnits="userSpaceOnUse" width="8" height="8" patternTransform="rotate(45)">
+      <line x1="0" y1="0" x2="0" y2="8" stroke="#e2e8f0" stroke-width="4"/>
+    </pattern>
+  </defs>
+  
+  <style>
+    .title { font: bold 13px 'Segoe UI', system-ui, sans-serif; fill: white; }
+    .title-dark { font: bold 13px 'Segoe UI', system-ui, sans-serif; fill: #1e293b; }
+    .subtitle { font: 11px 'Segoe UI', system-ui, sans-serif; fill: rgba(255,255,255,0.85); }
+    .item { font: 10px 'Segoe UI', system-ui, sans-serif; fill: #334155; }
+    .item-small { font: 9px 'Segoe UI', system-ui, sans-serif; fill: #64748b; }
+    .label { font: 10px 'Segoe UI', system-ui, sans-serif; fill: #64748b; }
+    .section-label { font: bold 11px 'Segoe UI', system-ui, sans-serif; fill: #475569; }
+  </style>
+
+  <!-- Background -->
+  <rect width="950" height="850" fill="#f8fafc"/>
+  
+  <!-- Title -->
+  <text x="475" y="30" text-anchor="middle" class="title-dark" style="font-size:16px;">Vertical Slice Architecture with micro-contracts</text>
+  
+  <!-- OpenAPI Layer -->
+  <g filter="url(#shadow)">
+    <rect x="50" y="50" width="850" height="50" rx="8" fill="#5b21b6"/>
+  </g>
+  <text x="475" y="75" text-anchor="middle" class="title" style="font-size:14px;">📄 OpenAPI Specs (Single Source of Truth)</text>
+  <text x="475" y="92" text-anchor="middle" class="subtitle">core.yaml · users.yaml · notifications.yaml</text>
+  
+  <!-- Generate arrows -->
+  <path d="M 185 100 L 185 125" fill="none" stroke="#64748b" stroke-width="2" marker-end="url(#arrowhead)"/>
+  <path d="M 475 100 L 475 125" fill="none" stroke="#64748b" stroke-width="2" marker-end="url(#arrowhead)"/>
+  <path d="M 765 100 L 765 125" fill="none" stroke="#64748b" stroke-width="2" marker-end="url(#arrowhead)"/>
+  <text x="120" y="118" class="label">generate</text>
+  <text x="410" y="118" class="label">generate</text>
+  <text x="700" y="118" class="label">generate</text>
+
+  <!-- Contract Layer (3 boxes) -->
+  <!-- contract/core -->
+  <g filter="url(#shadow)">
+    <rect x="50" y="130" width="270" height="60" rx="6" fill="white" stroke="#16a34a" stroke-width="2"/>
+    <rect x="50" y="130" width="270" height="28" rx="6" fill="#16a34a"/>
+    <rect x="50" y="152" width="270" height="6" rx="0" fill="#16a34a"/>
+  </g>
+  <text x="185" y="149" text-anchor="middle" class="title" style="font-size:12px;">📦 contract/core/</text>
+  <text x="60" y="175" class="item-small" style="fill:#16a34a;font-weight:600;">Shared between server ↔ frontend</text>
+  
+  <!-- contract/users -->
+  <g filter="url(#shadow)">
+    <rect x="340" y="130" width="270" height="60" rx="6" fill="white" stroke="#16a34a" stroke-width="2"/>
+    <rect x="340" y="130" width="270" height="28" rx="6" fill="#16a34a"/>
+    <rect x="340" y="152" width="270" height="6" rx="0" fill="#16a34a"/>
+  </g>
+  <text x="475" y="149" text-anchor="middle" class="title" style="font-size:12px;">📦 contract/users/</text>
+  <text x="350" y="175" class="item-small" style="fill:#16a34a;font-weight:600;">Shared between server ↔ frontend</text>
+  
+  <!-- contract/notifications -->
+  <g filter="url(#shadow)">
+    <rect x="630" y="130" width="270" height="60" rx="6" fill="white" stroke="#16a34a" stroke-width="2"/>
+    <rect x="630" y="130" width="270" height="28" rx="6" fill="#16a34a"/>
+    <rect x="630" y="152" width="270" height="6" rx="0" fill="#16a34a"/>
+  </g>
+  <text x="765" y="149" text-anchor="middle" class="title" style="font-size:12px;">📦 contract/notifications/</text>
+  <text x="640" y="175" class="item-small" style="fill:#16a34a;font-weight:600;">Intra-module types (server only)</text>
+
+  <!-- Extract arrows to contract-published -->
+  <path d="M 185 190 L 185 235" fill="none" stroke="#0d9488" stroke-width="2" marker-end="url(#arrowhead-teal)"/>
+  <path d="M 475 190 L 475 235" fill="none" stroke="#0d9488" stroke-width="2" marker-end="url(#arrowhead-teal)"/>
+  <text x="200" y="218" class="item-small" style="fill:#0d9488;">extract</text>
+  <text x="490" y="218" class="item-small" style="fill:#0d9488;">extract</text>
+  <text x="765" y="218" class="item-small" style="fill:#94a3b8;">no x-micro-contracts-published</text>
+
+  <!-- contract-published Layer -->
+  <g filter="url(#shadow)">
+    <rect x="50" y="240" width="850" height="80" rx="8" fill="white" stroke="#0d9488" stroke-width="2"/>
+    <rect x="50" y="240" width="850" height="30" rx="8" fill="#0d9488"/>
+    <rect x="50" y="264" width="850" height="6" rx="0" fill="#0d9488"/>
+  </g>
+  <text x="475" y="260" text-anchor="middle" class="title" style="font-size:12px;">📦 packages/contract-published/ — Cross-module Shared Contracts (x-micro-contracts-published: true only)</text>
+  <text x="475" y="285" text-anchor="middle" class="item-small" style="fill:#0d9488;">Must maintain backward compatibility — Used for cross-module API calls</text>
+  
+  <rect x="120" y="297" width="130" height="16" rx="3" fill="#ccfbf1" stroke="#0d9488"/>
+  <text x="185" y="308" text-anchor="middle" class="item-small" style="fill:#0f766e;font-size:8px;">contract-published/core/</text>
+  
+  <rect x="410" y="297" width="130" height="16" rx="3" fill="#ccfbf1" stroke="#0d9488"/>
+  <text x="475" y="308" text-anchor="middle" class="item-small" style="fill:#0f766e;font-size:8px;">contract-published/users/</text>
+  
+  <rect x="700" y="297" width="130" height="16" rx="3" fill="#f1f5f9" stroke="#cbd5e1"/>
+  <text x="765" y="308" text-anchor="middle" class="item-small" style="fill:#94a3b8;font-size:8px;">(none)</text>
+
+  <!-- Vertical Slice 1: Core -->
+  <g filter="url(#shadow)">
+    <rect x="50" y="370" width="270" height="295" rx="8" fill="white" stroke="#8b5cf6" stroke-width="2"/>
+    <rect x="50" y="370" width="270" height="35" rx="8" fill="#8b5cf6"/>
+    <rect x="50" y="399" width="270" height="6" rx="0" fill="#8b5cf6"/>
+  </g>
+  <text x="185" y="394" text-anchor="middle" class="title">🟣 core module</text>
+  
+  <!-- Core - Server -->
+  <rect x="65" y="420" width="240" height="85" rx="4" fill="#faf5ff" stroke="#c4b5fd"/>
+  <text x="185" y="438" text-anchor="middle" class="item" style="font-weight:600;">🖥️ server/src/core/</text>
+  <text x="75" y="458" class="item-small">▸ routes.generated.ts</text>
+  <text x="75" y="472" class="item-small">▸ domains/ (hand-code)</text>
+  <text x="75" y="486" class="item-small">▸ models/</text>
+  
+  <!-- Core - Frontend -->
+  <rect x="65" y="515" width="240" height="60" rx="4" fill="#f5f3ff" stroke="#c4b5fd"/>
+  <text x="185" y="533" text-anchor="middle" class="item" style="font-weight:600;">🌐 frontend/src/core/</text>
+  <text x="75" y="553" class="item-small">▸ api.generated.ts</text>
+  <text x="75" y="565" class="item-small">▸ ui/ (hand-code)</text>
+  
+  <!-- Core - Deploy info -->
+  <rect x="65" y="585" width="240" height="28" rx="4" fill="#ede9fe" stroke="#a78bfa"/>
+  <text x="185" y="603" text-anchor="middle" class="item-small" style="fill:#6d28d9;">Deploy: api-server + web-app</text>
+  
+  <!-- Core - imports note -->
+  <text x="185" y="635" text-anchor="middle" class="item-small" style="fill:#16a34a;">imports: contract/core/</text>
+  <text x="185" y="650" text-anchor="middle" class="item-small" style="fill:#16a34a;">(server ↔ frontend shared)</text>
+
+  <!-- Vertical Slice 2: Users -->
+  <g filter="url(#shadow)">
+    <rect x="340" y="370" width="270" height="295" rx="8" fill="white" stroke="#f97316" stroke-width="2"/>
+    <rect x="340" y="370" width="270" height="35" rx="8" fill="#f97316"/>
+    <rect x="340" y="399" width="270" height="6" rx="0" fill="#f97316"/>
+  </g>
+  <text x="475" y="394" text-anchor="middle" class="title">🟠 users module</text>
+  
+  <!-- Users - Server -->
+  <rect x="355" y="420" width="240" height="85" rx="4" fill="#fff7ed" stroke="#fdba74"/>
+  <text x="475" y="438" text-anchor="middle" class="item" style="font-weight:600;">🖥️ server/src/users/</text>
+  <text x="365" y="458" class="item-small">▸ routes.generated.ts</text>
+  <text x="365" y="472" class="item-small">▸ domains/ (hand-code)</text>
+  <text x="365" y="486" class="item-small">▸ models/</text>
+  
+  <!-- Users - Frontend -->
+  <rect x="355" y="515" width="240" height="60" rx="4" fill="#ffedd5" stroke="#fdba74"/>
+  <text x="475" y="533" text-anchor="middle" class="item" style="font-weight:600;">🌐 frontend/src/users/</text>
+  <text x="365" y="553" class="item-small">▸ api.generated.ts</text>
+  <text x="365" y="565" class="item-small">▸ ui/ (hand-code)</text>
+  
+  <!-- Users - Deploy info -->
+  <rect x="355" y="585" width="240" height="28" rx="4" fill="#fed7aa" stroke="#fb923c"/>
+  <text x="475" y="603" text-anchor="middle" class="item-small" style="fill:#c2410c;">Deploy: same or separate</text>
+  
+  <!-- Users - imports note -->
+  <text x="475" y="635" text-anchor="middle" class="item-small" style="fill:#16a34a;">imports: contract/users/</text>
+  <text x="475" y="650" text-anchor="middle" class="item-small" style="fill:#0d9488;">+ contract-published/core/ (cross-module)</text>
+
+  <!-- Vertical Slice 3: Notifications -->
+  <g filter="url(#shadow)">
+    <rect x="630" y="370" width="270" height="295" rx="8" fill="white" stroke="#06b6d4" stroke-width="2"/>
+    <rect x="630" y="370" width="270" height="35" rx="8" fill="#06b6d4"/>
+    <rect x="630" y="399" width="270" height="6" rx="0" fill="#06b6d4"/>
+  </g>
+  <text x="765" y="394" text-anchor="middle" class="title">🔵 notifications module</text>
+  
+  <!-- Notifications - Server only -->
+  <rect x="645" y="420" width="240" height="85" rx="4" fill="#ecfeff" stroke="#67e8f9"/>
+  <text x="765" y="438" text-anchor="middle" class="item" style="font-weight:600;">🖥️ notification-service/</text>
+  <text x="655" y="458" class="item-small">▸ routes.generated.ts</text>
+  <text x="655" y="472" class="item-small">▸ domains/ (hand-code)</text>
+  <text x="655" y="486" class="item-small">▸ models/</text>
+  
+  <!-- Notifications - No Frontend -->
+  <rect x="645" y="515" width="240" height="60" rx="4" fill="url(#stripe)" stroke="#94a3b8"/>
+  <text x="765" y="550" text-anchor="middle" class="item-small" style="fill:#94a3b8;">No frontend (API-only)</text>
+  
+  <!-- Notifications - Deploy info -->
+  <rect x="645" y="585" width="240" height="28" rx="4" fill="#cffafe" stroke="#22d3ee"/>
+  <text x="765" y="603" text-anchor="middle" class="item-small" style="fill:#0e7490;">Deploy: separate microservice</text>
+  
+  <!-- Notifications - imports note -->
+  <text x="765" y="635" text-anchor="middle" class="item-small" style="fill:#16a34a;">imports: contract/notifications/</text>
+  <text x="765" y="650" text-anchor="middle" class="item-small" style="fill:#0d9488;">+ contract-published/core/ (cross-module)</text>
+
+  <!-- Intra-module import arrows: contract/{module} → same module (BLUE) -->
+  <path d="M 100 190 L 100 370" fill="none" stroke="#3b82f6" stroke-width="2" marker-end="url(#arrowhead-blue)"/>
+  <path d="M 390 190 L 390 370" fill="none" stroke="#3b82f6" stroke-width="2" marker-end="url(#arrowhead-blue)"/>
+  <path d="M 680 190 L 680 370" fill="none" stroke="#3b82f6" stroke-width="2" marker-end="url(#arrowhead-blue)"/>
+  <text x="108" y="218" class="item-small" style="fill:#3b82f6;">import</text>
+  <text x="398" y="218" class="item-small" style="fill:#3b82f6;">import</text>
+  <text x="688" y="218" class="item-small" style="fill:#3b82f6;">import</text>
+
+  <!-- Cross-module import arrows: contract-published → other modules (TEAL dashed) -->
+  <path d="M 185 313 L 420 370" fill="none" stroke="#0d9488" stroke-width="1.5" stroke-dasharray="5,3"/>
+  <path d="M 185 313 L 700 370" fill="none" stroke="#0d9488" stroke-width="1.5" stroke-dasharray="5,3"/>
+
+  <!-- Section Label (below modules) -->
+  <text x="475" y="685" text-anchor="middle" class="section-label">↑ Vertical Slices (Feature-aligned Modules)</text>
+
+  <!-- Legend -->
+  <g transform="translate(50, 710)">
+    <rect width="850" height="50" rx="6" fill="#f1f5f9" stroke="#e2e8f0"/>
+    <text x="20" y="30" class="section-label">Legend:</text>
+    
+    <line x1="120" y1="27" x2="155" y2="27" stroke="#3b82f6" stroke-width="2" marker-end="url(#arrowhead-blue)"/>
+    <text x="165" y="30" class="item">intra-module import</text>
+    
+    <line x1="340" y1="27" x2="375" y2="27" stroke="#0d9488" stroke-width="2" marker-end="url(#arrowhead-teal)"/>
+    <text x="385" y="30" class="item">extract (x-micro-contracts-published)</text>
+    
+    <line x1="540" y1="27" x2="575" y2="27" stroke="#0d9488" stroke-width="1.5" stroke-dasharray="5,3"/>
+    <text x="585" y="30" class="item">cross-module import</text>
+  </g>
+  
+  <!-- Key insight callout -->
+  <g transform="translate(50, 775)">
+    <rect width="850" height="65" rx="6" fill="#fefce8" stroke="#facc15"/>
+    <text x="20" y="22" class="item" style="font-weight:600;fill:#854d0e;">💡 Key Insight:</text>
+    <text x="20" y="40" class="item" style="fill:#713f12;">contract/ = intra-module shared types (server ↔ frontend), can change freely</text>
+    <text x="20" y="55" class="item" style="fill:#713f12;">contract-published/ = cross-module shared types (x-micro-contracts-published: true only), must maintain backward compatibility</text>
+  </g>
+</svg>