equilibria-mcp-server 1.0.0

package/dist/templates/supplyDemand.js

@@ -0,0 +1,1282 @@
+/**
+ * Supply and Demand Templates
+ *
+ * Templates for basic supply and demand models.
+ */
+/**
+ * Basic Supply and Demand
+ */
+const supplyDemandBasic = {
+    id: 'supply_demand_basic',
+    name: 'Basic Supply and Demand',
+    description: 'A simple supply and demand model showing market equilibrium. Linear demand and supply curves with equilibrium point and droplines.',
+    category: 'supply_demand',
+    level: 'high_school',
+    tags: ['supply', 'demand', 'equilibrium', 'market', 'basic'],
+    parameters: {
+        demandIntercept: {
+            type: 'number',
+            default: 100,
+            min: 50,
+            max: 200,
+            description: 'Y-intercept of the demand curve (maximum price)',
+        },
+        demandSlope: {
+            type: 'number',
+            default: 1,
+            min: 0.1,
+            max: 5,
+            description: 'Slope of the demand curve',
+        },
+        supplyIntercept: {
+            type: 'number',
+            default: 0,
+            min: 0,
+            max: 50,
+            description: 'Y-intercept of the supply curve (minimum price)',
+        },
+        supplySlope: {
+            type: 'number',
+            default: 1,
+            min: 0.1,
+            max: 5,
+            description: 'Slope of the supply curve',
+        },
+    },
+    generate: (params) => {
+        const demandIntercept = params.demandIntercept ?? 100;
+        const demandSlope = params.demandSlope ?? 1;
+        const supplyIntercept = params.supplyIntercept ?? 0;
+        const supplySlope = params.supplySlope ?? 1;
+        return {
+            metadata: {
+                specVersion: '1.3',
+                title: 'Basic Supply and Demand',
+                description: 'Market equilibrium with linear supply and demand curves',
+            },
+            parameters: {
+                demandIntercept: { value: demandIntercept, label: 'Demand Intercept' },
+                demandSlope: { value: demandSlope, label: 'Demand Slope' },
+                supplyIntercept: { value: supplyIntercept, label: 'Supply Intercept' },
+                supplySlope: { value: supplySlope, label: 'Supply Slope' },
+                eqQ: {
+                    expression: '(demandIntercept - supplyIntercept) / (demandSlope + supplySlope)',
+                    label: 'Equilibrium Quantity',
+                },
+                eqP: {
+                    expression: 'supplyIntercept + supplySlope * eqQ',
+                    label: 'Equilibrium Price',
+                },
+            },
+            charts: [
+                {
+                    id: 'main',
+                    title: 'Supply and Demand',
+                    xAxis: { label: 'Quantity (Q)', min: 0, max: 'demandIntercept' },
+                    yAxis: { label: 'Price (P)', min: 0, max: 'demandIntercept' },
+                    elements: [
+                        {
+                            id: 'demand',
+                            type: 'line',
+                            equation: 'demandIntercept - demandSlope * x',
+                            color: '#2563EB',
+                            label: 'Demand (D)',
+                            curveLabel: {
+                                text: 'D',
+                                x: 'demandIntercept * 0.9',
+                                position: 'below',
+                            },
+                        },
+                        {
+                            id: 'supply',
+                            type: 'line',
+                            equation: 'supplyIntercept + supplySlope * x',
+                            color: '#DC2626',
+                            label: 'Supply (S)',
+                            curveLabel: {
+                                text: 'S',
+                                x: 'demandIntercept * 0.9',
+                                position: 'above',
+                            },
+                        },
+                        {
+                            id: 'equilibrium',
+                            type: 'point',
+                            x: 'eqQ',
+                            y: 'eqP',
+                            color: '#16A34A',
+                            label: 'E',
+                            droplines: {
+                                x: 'Q*',
+                                y: 'P*',
+                                style: 'dashed',
+                            },
+                        },
+                    ],
+                },
+            ],
+        };
+    },
+};
+/**
+ * Supply and Demand with Surplus
+ */
+const supplyDemandSurplus = {
+    id: 'supply_demand_surplus',
+    name: 'Supply and Demand with Surplus',
+    description: 'Supply and demand model showing consumer surplus and producer surplus areas.',
+    category: 'supply_demand',
+    level: 'high_school',
+    tags: ['supply', 'demand', 'surplus', 'consumer surplus', 'producer surplus', 'welfare'],
+    parameters: {
+        demandIntercept: {
+            type: 'number',
+            default: 100,
+            min: 50,
+            max: 200,
+            description: 'Y-intercept of the demand curve',
+        },
+        demandSlope: {
+            type: 'number',
+            default: 1,
+            min: 0.1,
+            max: 5,
+            description: 'Slope of the demand curve',
+        },
+        supplyIntercept: {
+            type: 'number',
+            default: 10,
+            min: 0,
+            max: 50,
+            description: 'Y-intercept of the supply curve',
+        },
+        supplySlope: {
+            type: 'number',
+            default: 1,
+            min: 0.1,
+            max: 5,
+            description: 'Slope of the supply curve',
+        },
+    },
+    generate: (params) => {
+        const demandIntercept = params.demandIntercept ?? 100;
+        const demandSlope = params.demandSlope ?? 1;
+        const supplyIntercept = params.supplyIntercept ?? 10;
+        const supplySlope = params.supplySlope ?? 1;
+        return {
+            metadata: {
+                specVersion: '1.3',
+                title: 'Supply and Demand with Surplus',
+                description: 'Market equilibrium showing consumer and producer surplus',
+            },
+            parameters: {
+                demandIntercept: { value: demandIntercept, label: 'Demand Intercept', min: 50, max: 200 },
+                demandSlope: { value: demandSlope, label: 'Demand Slope', min: 0.1, max: 5, step: 0.1 },
+                supplyIntercept: { value: supplyIntercept, label: 'Supply Intercept', min: 0, max: 50 },
+                supplySlope: { value: supplySlope, label: 'Supply Slope', min: 0.1, max: 5, step: 0.1 },
+                eqQ: {
+                    expression: '(demandIntercept - supplyIntercept) / (demandSlope + supplySlope)',
+                    hidden: true,
+                },
+                eqP: {
+                    expression: 'supplyIntercept + supplySlope * eqQ',
+                    hidden: true,
+                },
+                CS: {
+                    expression: '0.5 * (demandIntercept - eqP) * eqQ',
+                    label: 'Consumer Surplus',
+                    readonly: true,
+                },
+                PS: {
+                    expression: '0.5 * (eqP - supplyIntercept) * eqQ',
+                    label: 'Producer Surplus',
+                    readonly: true,
+                },
+                TS: {
+                    expression: 'CS + PS',
+                    label: 'Total Surplus',
+                    readonly: true,
+                },
+            },
+            charts: [
+                {
+                    id: 'main',
+                    title: 'Consumer and Producer Surplus',
+                    xAxis: { label: 'Quantity (Q)', min: 0, max: 'demandIntercept' },
+                    yAxis: { label: 'Price (P)', min: 0, max: 'demandIntercept' },
+                    elements: [
+                        {
+                            id: 'cs-area',
+                            type: 'area',
+                            topBoundary: 'demand',
+                            bottomBoundary: 'eqP',
+                            leftBoundary: '0',
+                            rightBoundary: 'eqQ',
+                            color: '#3B82F6',
+                            opacity: 0.3,
+                            label: 'Consumer Surplus',
+                        },
+                        {
+                            id: 'ps-area',
+                            type: 'area',
+                            topBoundary: 'eqP',
+                            bottomBoundary: 'supply',
+                            leftBoundary: '0',
+                            rightBoundary: 'eqQ',
+                            color: '#EF4444',
+                            opacity: 0.3,
+                            label: 'Producer Surplus',
+                        },
+                        {
+                            id: 'demand',
+                            type: 'line',
+                            equation: 'demandIntercept - demandSlope * x',
+                            color: '#2563EB',
+                            label: 'Demand',
+                        },
+                        {
+                            id: 'supply',
+                            type: 'line',
+                            equation: 'supplyIntercept + supplySlope * x',
+                            color: '#DC2626',
+                            label: 'Supply',
+                        },
+                        {
+                            id: 'equilibrium',
+                            type: 'point',
+                            x: 'eqQ',
+                            y: 'eqP',
+                            color: '#16A34A',
+                            label: 'E',
+                            droplines: { x: true, y: true },
+                        },
+                    ],
+                    annotations: [
+                        {
+                            id: 'cs-label',
+                            text: 'CS = ${CS:,.0f}',
+                            x: 'eqQ / 3',
+                            y: '(demandIntercept + eqP) / 2',
+                            color: '#1E40AF',
+                        },
+                        {
+                            id: 'ps-label',
+                            text: 'PS = ${PS:,.0f}',
+                            x: 'eqQ / 3',
+                            y: '(supplyIntercept + eqP) / 2',
+                            color: '#991B1B',
+                        },
+                    ],
+                },
+            ],
+        };
+    },
+};
+/**
+ * Supply and Demand with Tax
+ */
+const supplyDemandTax = {
+    id: 'supply_demand_tax',
+    name: 'Supply and Demand with Tax',
+    description: 'Supply and demand model showing the effect of a per-unit tax, including tax incidence, deadweight loss, and tax revenue.',
+    category: 'supply_demand',
+    level: 'undergraduate',
+    tags: ['supply', 'demand', 'tax', 'deadweight loss', 'incidence', 'welfare'],
+    parameters: {
+        demandIntercept: {
+            type: 'number',
+            default: 100,
+            min: 50,
+            max: 200,
+            description: 'Y-intercept of the demand curve',
+        },
+        demandSlope: {
+            type: 'number',
+            default: 1,
+            min: 0.1,
+            max: 5,
+            description: 'Slope of the demand curve',
+        },
+        supplyIntercept: {
+            type: 'number',
+            default: 10,
+            min: 0,
+            max: 50,
+            description: 'Y-intercept of the supply curve',
+        },
+        supplySlope: {
+            type: 'number',
+            default: 1,
+            min: 0.1,
+            max: 5,
+            description: 'Slope of the supply curve',
+        },
+        taxAmount: {
+            type: 'number',
+            default: 20,
+            min: 0,
+            max: 50,
+            description: 'Per-unit tax amount',
+        },
+    },
+    generate: (params) => {
+        const demandIntercept = params.demandIntercept ?? 100;
+        const demandSlope = params.demandSlope ?? 1;
+        const supplyIntercept = params.supplyIntercept ?? 10;
+        const supplySlope = params.supplySlope ?? 1;
+        const taxAmount = params.taxAmount ?? 20;
+        return {
+            metadata: {
+                specVersion: '1.3',
+                title: 'Tax Incidence and Deadweight Loss',
+                description: 'Per-unit tax showing incidence, revenue, and deadweight loss',
+            },
+            parameters: {
+                demandIntercept: { value: demandIntercept, label: 'Demand Intercept' },
+                demandSlope: { value: demandSlope, label: 'Demand Slope', step: 0.1 },
+                supplyIntercept: { value: supplyIntercept, label: 'Supply Intercept' },
+                supplySlope: { value: supplySlope, label: 'Supply Slope', step: 0.1 },
+                tax: { value: taxAmount, label: 'Tax Amount', min: 0, max: 50 },
+                // Pre-tax equilibrium
+                Q0: {
+                    expression: '(demandIntercept - supplyIntercept) / (demandSlope + supplySlope)',
+                    hidden: true,
+                },
+                P0: {
+                    expression: 'supplyIntercept + supplySlope * Q0',
+                    hidden: true,
+                },
+                // Post-tax equilibrium
+                Q1: {
+                    expression: '(demandIntercept - supplyIntercept - tax) / (demandSlope + supplySlope)',
+                    hidden: true,
+                },
+                Pb: {
+                    expression: 'demandIntercept - demandSlope * Q1',
+                    label: 'Buyer Price',
+                    readonly: true,
+                },
+                Ps: {
+                    expression: 'Pb - tax',
+                    label: 'Seller Price',
+                    readonly: true,
+                },
+                taxRevenue: {
+                    expression: 'tax * Q1',
+                    label: 'Tax Revenue',
+                    readonly: true,
+                },
+                DWL: {
+                    expression: '0.5 * tax * (Q0 - Q1)',
+                    label: 'Deadweight Loss',
+                    readonly: true,
+                },
+            },
+            charts: [
+                {
+                    id: 'main',
+                    title: 'Tax Incidence',
+                    xAxis: { label: 'Quantity (Q)', min: 0, max: 'demandIntercept' },
+                    yAxis: { label: 'Price (P)', min: 0, max: 'demandIntercept' },
+                    elements: [
+                        // Tax revenue rectangle
+                        {
+                            id: 'tax-revenue',
+                            type: 'area',
+                            topBoundary: 'Pb',
+                            bottomBoundary: 'Ps',
+                            leftBoundary: '0',
+                            rightBoundary: 'Q1',
+                            color: '#22C55E',
+                            opacity: 0.3,
+                            label: 'Tax Revenue',
+                        },
+                        // Deadweight loss triangle
+                        {
+                            id: 'dwl-area',
+                            type: 'area',
+                            topBoundary: 'demand',
+                            bottomBoundary: 'supply',
+                            leftBoundary: 'Q1',
+                            rightBoundary: 'Q0',
+                            color: '#A855F7',
+                            opacity: 0.4,
+                            label: 'Deadweight Loss',
+                        },
+                        // Curves
+                        {
+                            id: 'demand',
+                            type: 'line',
+                            equation: 'demandIntercept - demandSlope * x',
+                            color: '#2563EB',
+                            label: 'Demand',
+                        },
+                        {
+                            id: 'supply',
+                            type: 'line',
+                            equation: 'supplyIntercept + supplySlope * x',
+                            color: '#DC2626',
+                            label: 'Supply',
+                        },
+                        {
+                            id: 'supply-tax',
+                            type: 'line',
+                            equation: 'supplyIntercept + tax + supplySlope * x',
+                            color: '#DC2626',
+                            lineStyle: 'dashed',
+                            label: 'Supply + Tax',
+                        },
+                        // Points
+                        {
+                            id: 'eq-original',
+                            type: 'point',
+                            x: 'Q0',
+                            y: 'P0',
+                            color: '#6B7280',
+                            label: 'E₀',
+                        },
+                        {
+                            id: 'buyer-point',
+                            type: 'point',
+                            x: 'Q1',
+                            y: 'Pb',
+                            color: '#2563EB',
+                            label: 'Pb',
+                            droplines: { x: 'Q₁', y: true },
+                        },
+                        {
+                            id: 'seller-point',
+                            type: 'point',
+                            x: 'Q1',
+                            y: 'Ps',
+                            color: '#DC2626',
+                            label: 'Ps',
+                            droplines: { y: true },
+                        },
+                        // Tax wedge
+                        {
+                            id: 'tax-wedge',
+                            type: 'segment',
+                            x1: 'Q1',
+                            y1: 'Ps',
+                            x2: 'Q1',
+                            y2: 'Pb',
+                            color: '#16A34A',
+                            strokeWidth: 3,
+                        },
+                    ],
+                    annotations: [
+                        {
+                            id: 'tax-label',
+                            text: 't = ${tax}',
+                            x: 'Q1 + 5',
+                            y: '(Pb + Ps) / 2',
+                            color: '#16A34A',
+                        },
+                    ],
+                },
+            ],
+        };
+    },
+};
+/**
+ * Price Ceiling
+ */
+const supplyDemandPriceCeiling = {
+    id: 'supply_demand_price_ceiling',
+    name: 'Price Ceiling',
+    description: 'Supply and demand model showing the effect of a binding price ceiling, creating a shortage.',
+    category: 'supply_demand',
+    level: 'high_school',
+    tags: ['supply', 'demand', 'price ceiling', 'price control', 'shortage'],
+    parameters: {
+        demandIntercept: {
+            type: 'number',
+            default: 100,
+            description: 'Y-intercept of the demand curve',
+        },
+        demandSlope: {
+            type: 'number',
+            default: 1,
+            description: 'Slope of the demand curve',
+        },
+        supplyIntercept: {
+            type: 'number',
+            default: 10,
+            description: 'Y-intercept of the supply curve',
+        },
+        supplySlope: {
+            type: 'number',
+            default: 1,
+            description: 'Slope of the supply curve',
+        },
+        priceCeiling: {
+            type: 'number',
+            default: 40,
+            description: 'Maximum allowed price',
+        },
+    },
+    generate: (params) => {
+        const demandIntercept = params.demandIntercept ?? 100;
+        const demandSlope = params.demandSlope ?? 1;
+        const supplyIntercept = params.supplyIntercept ?? 10;
+        const supplySlope = params.supplySlope ?? 1;
+        const priceCeiling = params.priceCeiling ?? 40;
+        return {
+            metadata: {
+                specVersion: '1.3',
+                title: 'Price Ceiling',
+                description: 'Market with a binding price ceiling creating a shortage',
+            },
+            parameters: {
+                demandIntercept: { value: demandIntercept, label: 'Demand Intercept' },
+                demandSlope: { value: demandSlope, label: 'Demand Slope' },
+                supplyIntercept: { value: supplyIntercept, label: 'Supply Intercept' },
+                supplySlope: { value: supplySlope, label: 'Supply Slope' },
+                Pc: { value: priceCeiling, label: 'Price Ceiling', min: 0, max: 80 },
+                eqQ: {
+                    expression: '(demandIntercept - supplyIntercept) / (demandSlope + supplySlope)',
+                    hidden: true,
+                },
+                eqP: {
+                    expression: 'supplyIntercept + supplySlope * eqQ',
+                    hidden: true,
+                },
+                Qs: {
+                    expression: 'max(0, (Pc - supplyIntercept) / supplySlope)',
+                    label: 'Quantity Supplied',
+                    readonly: true,
+                },
+                Qd: {
+                    expression: 'max(0, (demandIntercept - Pc) / demandSlope)',
+                    label: 'Quantity Demanded',
+                    readonly: true,
+                },
+                shortage: {
+                    expression: 'max(0, Qd - Qs)',
+                    label: 'Shortage',
+                    readonly: true,
+                },
+                isBinding: {
+                    expression: 'Pc < eqP',
+                    hidden: true,
+                },
+            },
+            charts: [
+                {
+                    id: 'main',
+                    title: 'Price Ceiling and Shortage',
+                    xAxis: { label: 'Quantity (Q)', min: 0, max: 'demandIntercept' },
+                    yAxis: { label: 'Price (P)', min: 0, max: 'demandIntercept' },
+                    elements: [
+                        // Shortage bracket
+                        {
+                            id: 'shortage-bracket',
+                            type: 'bracket',
+                            axis: 'x',
+                            from: 'Qs',
+                            to: 'Qd',
+                            label: 'Shortage',
+                            style: 'brace',
+                            position: 'outside',
+                            visible: 'isBinding',
+                        },
+                        // Curves
+                        {
+                            id: 'demand',
+                            type: 'line',
+                            equation: 'demandIntercept - demandSlope * x',
+                            color: '#2563EB',
+                            label: 'Demand',
+                        },
+                        {
+                            id: 'supply',
+                            type: 'line',
+                            equation: 'supplyIntercept + supplySlope * x',
+                            color: '#DC2626',
+                            label: 'Supply',
+                        },
+                        // Price ceiling line
+                        {
+                            id: 'ceiling-line',
+                            type: 'horizontalLine',
+                            y: 'Pc',
+                            color: '#7C3AED',
+                            strokeDasharray: '5,5',
+                        },
+                        // Equilibrium
+                        {
+                            id: 'equilibrium',
+                            type: 'point',
+                            x: 'eqQ',
+                            y: 'eqP',
+                            color: '#6B7280',
+                            label: 'E*',
+                        },
+                        // Points at ceiling
+                        {
+                            id: 'supply-at-ceiling',
+                            type: 'point',
+                            x: 'Qs',
+                            y: 'Pc',
+                            color: '#DC2626',
+                            label: 'Qs',
+                            droplines: { x: true },
+                            visible: 'isBinding',
+                        },
+                        {
+                            id: 'demand-at-ceiling',
+                            type: 'point',
+                            x: 'Qd',
+                            y: 'Pc',
+                            color: '#2563EB',
+                            label: 'Qd',
+                            droplines: { x: true },
+                            visible: 'isBinding',
+                        },
+                    ],
+                    annotations: [
+                        {
+                            id: 'ceiling-label',
+                            text: 'Price Ceiling = ${Pc}',
+                            x: 'demandIntercept * 0.7',
+                            y: 'Pc + 5',
+                            color: '#7C3AED',
+                        },
+                    ],
+                },
+            ],
+        };
+    },
+};
+/**
+ * Price Floor
+ */
+const supplyDemandPriceFloor = {
+    id: 'supply_demand_price_floor',
+    name: 'Price Floor',
+    description: 'Supply and demand model showing the effect of a binding price floor, creating a surplus.',
+    category: 'supply_demand',
+    level: 'high_school',
+    tags: ['supply', 'demand', 'price floor', 'price control', 'surplus', 'minimum wage'],
+    parameters: {
+        demandIntercept: {
+            type: 'number',
+            default: 100,
+            description: 'Y-intercept of the demand curve',
+        },
+        demandSlope: {
+            type: 'number',
+            default: 1,
+            description: 'Slope of the demand curve',
+        },
+        supplyIntercept: {
+            type: 'number',
+            default: 10,
+            description: 'Y-intercept of the supply curve',
+        },
+        supplySlope: {
+            type: 'number',
+            default: 1,
+            description: 'Slope of the supply curve',
+        },
+        priceFloor: {
+            type: 'number',
+            default: 70,
+            description: 'Minimum allowed price',
+        },
+    },
+    generate: (params) => {
+        const demandIntercept = params.demandIntercept ?? 100;
+        const demandSlope = params.demandSlope ?? 1;
+        const supplyIntercept = params.supplyIntercept ?? 10;
+        const supplySlope = params.supplySlope ?? 1;
+        const priceFloor = params.priceFloor ?? 70;
+        return {
+            metadata: {
+                specVersion: '1.3',
+                title: 'Price Floor',
+                description: 'Market with a binding price floor creating a surplus',
+            },
+            parameters: {
+                demandIntercept: { value: demandIntercept, label: 'Demand Intercept' },
+                demandSlope: { value: demandSlope, label: 'Demand Slope' },
+                supplyIntercept: { value: supplyIntercept, label: 'Supply Intercept' },
+                supplySlope: { value: supplySlope, label: 'Supply Slope' },
+                Pf: { value: priceFloor, label: 'Price Floor', min: 20, max: 90 },
+                eqQ: {
+                    expression: '(demandIntercept - supplyIntercept) / (demandSlope + supplySlope)',
+                    hidden: true,
+                },
+                eqP: {
+                    expression: 'supplyIntercept + supplySlope * eqQ',
+                    hidden: true,
+                },
+                Qd: {
+                    expression: 'max(0, (demandIntercept - Pf) / demandSlope)',
+                    label: 'Quantity Demanded',
+                    readonly: true,
+                },
+                Qs: {
+                    expression: 'max(0, (Pf - supplyIntercept) / supplySlope)',
+                    label: 'Quantity Supplied',
+                    readonly: true,
+                },
+                surplus: {
+                    expression: 'max(0, Qs - Qd)',
+                    label: 'Surplus',
+                    readonly: true,
+                },
+                isBinding: {
+                    expression: 'Pf > eqP',
+                    hidden: true,
+                },
+            },
+            charts: [
+                {
+                    id: 'main',
+                    title: 'Price Floor and Surplus',
+                    xAxis: { label: 'Quantity (Q)', min: 0, max: 'demandIntercept' },
+                    yAxis: { label: 'Price (P)', min: 0, max: 'demandIntercept' },
+                    elements: [
+                        {
+                            id: 'surplus-bracket',
+                            type: 'bracket',
+                            axis: 'x',
+                            from: 'Qd',
+                            to: 'Qs',
+                            label: 'Surplus',
+                            style: 'brace',
+                            position: 'outside',
+                            visible: 'isBinding',
+                        },
+                        {
+                            id: 'demand',
+                            type: 'line',
+                            equation: 'demandIntercept - demandSlope * x',
+                            color: '#2563EB',
+                            label: 'Demand',
+                        },
+                        {
+                            id: 'supply',
+                            type: 'line',
+                            equation: 'supplyIntercept + supplySlope * x',
+                            color: '#DC2626',
+                            label: 'Supply',
+                        },
+                        {
+                            id: 'floor-line',
+                            type: 'horizontalLine',
+                            y: 'Pf',
+                            color: '#7C3AED',
+                            strokeDasharray: '5,5',
+                        },
+                        {
+                            id: 'equilibrium',
+                            type: 'point',
+                            x: 'eqQ',
+                            y: 'eqP',
+                            color: '#6B7280',
+                            label: 'E*',
+                        },
+                        {
+                            id: 'demand-at-floor',
+                            type: 'point',
+                            x: 'Qd',
+                            y: 'Pf',
+                            color: '#2563EB',
+                            label: 'Qd',
+                            droplines: { x: true },
+                            visible: 'isBinding',
+                        },
+                        {
+                            id: 'supply-at-floor',
+                            type: 'point',
+                            x: 'Qs',
+                            y: 'Pf',
+                            color: '#DC2626',
+                            label: 'Qs',
+                            droplines: { x: true },
+                            visible: 'isBinding',
+                        },
+                    ],
+                    annotations: [
+                        {
+                            id: 'floor-label',
+                            text: 'Price Floor = ${Pf}',
+                            x: 'demandIntercept * 0.7',
+                            y: 'Pf + 5',
+                            color: '#7C3AED',
+                        },
+                    ],
+                },
+            ],
+        };
+    },
+};
+/**
+ * Subsidy
+ */
+const supplyDemandSubsidy = {
+    id: 'supply_demand_subsidy',
+    name: 'Supply and Demand with Subsidy',
+    description: 'Supply and demand model showing the effect of a per-unit subsidy on market outcomes.',
+    category: 'supply_demand',
+    level: 'undergraduate',
+    tags: ['supply', 'demand', 'subsidy', 'government intervention', 'welfare'],
+    parameters: {
+        demandIntercept: {
+            type: 'number',
+            default: 100,
+            description: 'Y-intercept of the demand curve',
+        },
+        demandSlope: {
+            type: 'number',
+            default: 1,
+            description: 'Slope of the demand curve',
+        },
+        supplyIntercept: {
+            type: 'number',
+            default: 20,
+            description: 'Y-intercept of the supply curve',
+        },
+        supplySlope: {
+            type: 'number',
+            default: 1,
+            description: 'Slope of the supply curve',
+        },
+        subsidyAmount: {
+            type: 'number',
+            default: 20,
+            description: 'Per-unit subsidy amount',
+        },
+    },
+    generate: (params) => {
+        const demandIntercept = params.demandIntercept ?? 100;
+        const demandSlope = params.demandSlope ?? 1;
+        const supplyIntercept = params.supplyIntercept ?? 20;
+        const supplySlope = params.supplySlope ?? 1;
+        const subsidyAmount = params.subsidyAmount ?? 20;
+        return {
+            metadata: {
+                specVersion: '1.3',
+                title: 'Per-Unit Subsidy',
+                description: 'Market effects of a government subsidy to producers',
+            },
+            parameters: {
+                demandIntercept: { value: demandIntercept, label: 'Demand Intercept' },
+                demandSlope: { value: demandSlope, label: 'Demand Slope', step: 0.1 },
+                supplyIntercept: { value: supplyIntercept, label: 'Supply Intercept' },
+                supplySlope: { value: supplySlope, label: 'Supply Slope', step: 0.1 },
+                subsidy: { value: subsidyAmount, label: 'Subsidy Amount', min: 0, max: 50 },
+                Q0: {
+                    expression: '(demandIntercept - supplyIntercept) / (demandSlope + supplySlope)',
+                    hidden: true,
+                },
+                P0: {
+                    expression: 'supplyIntercept + supplySlope * Q0',
+                    hidden: true,
+                },
+                Q1: {
+                    expression: '(demandIntercept - supplyIntercept + subsidy) / (demandSlope + supplySlope)',
+                    hidden: true,
+                },
+                Pb: {
+                    expression: 'demandIntercept - demandSlope * Q1',
+                    label: 'Buyer Price',
+                    readonly: true,
+                },
+                Ps: {
+                    expression: 'Pb + subsidy',
+                    label: 'Seller Price',
+                    readonly: true,
+                },
+                govCost: {
+                    expression: 'subsidy * Q1',
+                    label: 'Government Cost',
+                    readonly: true,
+                },
+            },
+            charts: [
+                {
+                    id: 'main',
+                    title: 'Subsidy Effects',
+                    xAxis: { label: 'Quantity (Q)', min: 0, max: 'demandIntercept' },
+                    yAxis: { label: 'Price (P)', min: 0, max: 'demandIntercept' },
+                    elements: [
+                        {
+                            id: 'gov-cost-area',
+                            type: 'area',
+                            topBoundary: 'Ps',
+                            bottomBoundary: 'Pb',
+                            leftBoundary: '0',
+                            rightBoundary: 'Q1',
+                            color: '#F59E0B',
+                            opacity: 0.3,
+                            label: 'Government Cost',
+                        },
+                        {
+                            id: 'demand',
+                            type: 'line',
+                            equation: 'demandIntercept - demandSlope * x',
+                            color: '#2563EB',
+                            label: 'Demand',
+                        },
+                        {
+                            id: 'supply',
+                            type: 'line',
+                            equation: 'supplyIntercept + supplySlope * x',
+                            color: '#DC2626',
+                            label: 'Supply',
+                        },
+                        {
+                            id: 'supply-subsidy',
+                            type: 'line',
+                            equation: 'supplyIntercept - subsidy + supplySlope * x',
+                            color: '#DC2626',
+                            lineStyle: 'dashed',
+                            label: 'Supply - Subsidy',
+                        },
+                        {
+                            id: 'eq-original',
+                            type: 'point',
+                            x: 'Q0',
+                            y: 'P0',
+                            color: '#6B7280',
+                            label: 'E₀',
+                        },
+                        {
+                            id: 'buyer-point',
+                            type: 'point',
+                            x: 'Q1',
+                            y: 'Pb',
+                            color: '#2563EB',
+                            label: 'Pb',
+                            droplines: { x: 'Q₁', y: true },
+                        },
+                        {
+                            id: 'seller-point',
+                            type: 'point',
+                            x: 'Q1',
+                            y: 'Ps',
+                            color: '#DC2626',
+                            label: 'Ps',
+                            droplines: { y: true },
+                        },
+                    ],
+                },
+            ],
+        };
+    },
+};
+/**
+ * Quota
+ */
+const supplyDemandQuota = {
+    id: 'supply_demand_quota',
+    name: 'Supply and Demand with Quota',
+    description: 'Supply and demand model showing the effect of a quantity restriction (quota) on market outcomes.',
+    category: 'supply_demand',
+    level: 'undergraduate',
+    tags: ['supply', 'demand', 'quota', 'quantity restriction', 'deadweight loss'],
+    parameters: {
+        demandIntercept: {
+            type: 'number',
+            default: 100,
+            description: 'Y-intercept of the demand curve',
+        },
+        demandSlope: {
+            type: 'number',
+            default: 1,
+            description: 'Slope of the demand curve',
+        },
+        supplyIntercept: {
+            type: 'number',
+            default: 10,
+            description: 'Y-intercept of the supply curve',
+        },
+        supplySlope: {
+            type: 'number',
+            default: 1,
+            description: 'Slope of the supply curve',
+        },
+        quotaQuantity: {
+            type: 'number',
+            default: 30,
+            description: 'Maximum allowed quantity',
+        },
+    },
+    generate: (params) => {
+        const demandIntercept = params.demandIntercept ?? 100;
+        const demandSlope = params.demandSlope ?? 1;
+        const supplyIntercept = params.supplyIntercept ?? 10;
+        const supplySlope = params.supplySlope ?? 1;
+        const quotaQuantity = params.quotaQuantity ?? 30;
+        return {
+            metadata: {
+                specVersion: '1.3',
+                title: 'Quantity Quota',
+                description: 'Market effects of a binding quantity restriction',
+            },
+            parameters: {
+                demandIntercept: { value: demandIntercept, label: 'Demand Intercept' },
+                demandSlope: { value: demandSlope, label: 'Demand Slope' },
+                supplyIntercept: { value: supplyIntercept, label: 'Supply Intercept' },
+                supplySlope: { value: supplySlope, label: 'Supply Slope' },
+                Qbar: { value: quotaQuantity, label: 'Quota Quantity', min: 10, max: 80 },
+                eqQ: {
+                    expression: '(demandIntercept - supplyIntercept) / (demandSlope + supplySlope)',
+                    hidden: true,
+                },
+                eqP: {
+                    expression: 'supplyIntercept + supplySlope * eqQ',
+                    hidden: true,
+                },
+                Pd: {
+                    expression: 'demandIntercept - demandSlope * Qbar',
+                    label: 'Demand Price',
+                    readonly: true,
+                },
+                Ps: {
+                    expression: 'supplyIntercept + supplySlope * Qbar',
+                    label: 'Supply Price',
+                    readonly: true,
+                },
+                quotaRent: {
+                    expression: '(Pd - Ps) * Qbar',
+                    label: 'Quota Rent',
+                    readonly: true,
+                },
+                isBinding: {
+                    expression: 'Qbar < eqQ',
+                    hidden: true,
+                },
+                DWL: {
+                    expression: '0.5 * (Pd - Ps) * (eqQ - Qbar)',
+                    label: 'Deadweight Loss',
+                    readonly: true,
+                },
+            },
+            charts: [
+                {
+                    id: 'main',
+                    title: 'Quota and Deadweight Loss',
+                    xAxis: { label: 'Quantity (Q)', min: 0, max: 'demandIntercept' },
+                    yAxis: { label: 'Price (P)', min: 0, max: 'demandIntercept' },
+                    elements: [
+                        {
+                            id: 'quota-rent-area',
+                            type: 'area',
+                            topBoundary: 'Pd',
+                            bottomBoundary: 'Ps',
+                            leftBoundary: '0',
+                            rightBoundary: 'Qbar',
+                            color: '#22C55E',
+                            opacity: 0.3,
+                            label: 'Quota Rent',
+                            visible: 'isBinding',
+                        },
+                        {
+                            id: 'dwl-area',
+                            type: 'area',
+                            topBoundary: 'demand',
+                            bottomBoundary: 'supply',
+                            leftBoundary: 'Qbar',
+                            rightBoundary: 'eqQ',
+                            color: '#A855F7',
+                            opacity: 0.4,
+                            label: 'Deadweight Loss',
+                            visible: 'isBinding',
+                        },
+                        {
+                            id: 'demand',
+                            type: 'line',
+                            equation: 'demandIntercept - demandSlope * x',
+                            color: '#2563EB',
+                            label: 'Demand',
+                        },
+                        {
+                            id: 'supply',
+                            type: 'line',
+                            equation: 'supplyIntercept + supplySlope * x',
+                            color: '#DC2626',
+                            label: 'Supply',
+                        },
+                        {
+                            id: 'quota-line',
+                            type: 'verticalLine',
+                            x: 'Qbar',
+                            color: '#7C3AED',
+                            strokeDasharray: '5,5',
+                        },
+                        {
+                            id: 'equilibrium',
+                            type: 'point',
+                            x: 'eqQ',
+                            y: 'eqP',
+                            color: '#6B7280',
+                            label: 'E*',
+                        },
+                        {
+                            id: 'demand-at-quota',
+                            type: 'point',
+                            x: 'Qbar',
+                            y: 'Pd',
+                            color: '#2563EB',
+                            label: 'Pd',
+                            droplines: { y: true },
+                            visible: 'isBinding',
+                        },
+                        {
+                            id: 'supply-at-quota',
+                            type: 'point',
+                            x: 'Qbar',
+                            y: 'Ps',
+                            color: '#DC2626',
+                            label: 'Ps',
+                            droplines: { y: true },
+                            visible: 'isBinding',
+                        },
+                    ],
+                    annotations: [
+                        {
+                            id: 'quota-label',
+                            text: 'Quota = ${Qbar}',
+                            x: 'Qbar + 3',
+                            y: 'demandIntercept * 0.8',
+                            color: '#7C3AED',
+                        },
+                    ],
+                },
+            ],
+        };
+    },
+};
+/**
+ * Comparative Statics (Shift)
+ */
+const supplyDemandShift = {
+    id: 'supply_demand_shift',
+    name: 'Supply and Demand Shift',
+    description: 'Demonstrates comparative statics by showing how shifts in supply or demand affect equilibrium.',
+    category: 'supply_demand',
+    level: 'high_school',
+    tags: ['supply', 'demand', 'shift', 'comparative statics', 'equilibrium'],
+    parameters: {
+        demandIntercept: {
+            type: 'number',
+            default: 100,
+            description: 'Original demand intercept',
+        },
+        demandShift: {
+            type: 'number',
+            default: 20,
+            description: 'Shift in demand (positive = right shift)',
+        },
+        supplyIntercept: {
+            type: 'number',
+            default: 10,
+            description: 'Original supply intercept',
+        },
+        supplyShift: {
+            type: 'number',
+            default: 0,
+            description: 'Shift in supply (positive = right shift, i.e., lower intercept)',
+        },
+    },
+    generate: (params) => {
+        const demandIntercept = params.demandIntercept ?? 100;
+        const demandShift = params.demandShift ?? 20;
+        const supplyIntercept = params.supplyIntercept ?? 10;
+        const supplyShift = params.supplyShift ?? 0;
+        return {
+            metadata: {
+                specVersion: '1.3',
+                title: 'Comparative Statics',
+                description: 'Effects of supply and demand shifts on equilibrium',
+            },
+            parameters: {
+                a0: { value: demandIntercept, label: 'Original Demand Intercept' },
+                dShift: { value: demandShift, label: 'Demand Shift', min: -50, max: 50 },
+                c0: { value: supplyIntercept, label: 'Original Supply Intercept' },
+                sShift: { value: supplyShift, label: 'Supply Shift', min: -50, max: 50 },
+                a1: { expression: 'a0 + dShift', hidden: true },
+                c1: { expression: 'c0 - sShift', hidden: true },
+                Q0: { expression: '(a0 - c0) / 2', label: 'Original Q*', readonly: true },
+                P0: { expression: 'c0 + Q0', label: 'Original P*', readonly: true },
+                Q1: { expression: '(a1 - c1) / 2', label: 'New Q*', readonly: true },
+                P1: { expression: 'c1 + Q1', label: 'New P*', readonly: true },
+                deltaQ: { expression: 'Q1 - Q0', label: 'Change in Q', readonly: true },
+                deltaP: { expression: 'P1 - P0', label: 'Change in P', readonly: true },
+            },
+            charts: [
+                {
+                    id: 'main',
+                    title: 'Supply and Demand Shifts',
+                    xAxis: { label: 'Quantity (Q)', min: 0, max: 'max(a0, a1) + 10' },
+                    yAxis: { label: 'Price (P)', min: 0, max: 'max(a0, a1) + 10' },
+                    elements: [
+                        {
+                            id: 'demand-original',
+                            type: 'line',
+                            equation: 'a0 - x',
+                            color: '#93C5FD',
+                            lineStyle: 'dashed',
+                            label: 'D₀',
+                        },
+                        {
+                            id: 'supply-original',
+                            type: 'line',
+                            equation: 'c0 + x',
+                            color: '#FCA5A5',
+                            lineStyle: 'dashed',
+                            label: 'S₀',
+                        },
+                        {
+                            id: 'demand-new',
+                            type: 'line',
+                            equation: 'a1 - x',
+                            color: '#2563EB',
+                            label: 'D₁',
+                        },
+                        {
+                            id: 'supply-new',
+                            type: 'line',
+                            equation: 'c1 + x',
+                            color: '#DC2626',
+                            label: 'S₁',
+                        },
+                        {
+                            id: 'eq-original',
+                            type: 'point',
+                            x: 'Q0',
+                            y: 'P0',
+                            color: '#6B7280',
+                            label: 'E₀',
+                        },
+                        {
+                            id: 'eq-new',
+                            type: 'point',
+                            x: 'Q1',
+                            y: 'P1',
+                            color: '#16A34A',
+                            label: 'E₁',
+                            droplines: { x: true, y: true },
+                        },
+                    ],
+                },
+            ],
+        };
+    },
+};
+export const supplyDemandTemplates = [
+    supplyDemandBasic,
+    supplyDemandSurplus,
+    supplyDemandTax,
+    supplyDemandPriceCeiling,
+    supplyDemandPriceFloor,
+    supplyDemandSubsidy,
+    supplyDemandQuota,
+    supplyDemandShift,
+];
+//# sourceMappingURL=supplyDemand.js.map