@contractspec/example.marketplace 3.7.6 → 3.8.2

package/dist/ui/renderers/index.d.ts

@@ -1 +1 @@
-export { marketplaceDashboardMarkdownRenderer, productCatalogMarkdownRenderer, orderListMarkdownRenderer, } from './marketplace.markdown';
+export { marketplaceDashboardMarkdownRenderer, orderListMarkdownRenderer, productCatalogMarkdownRenderer, } from './marketplace.markdown';

package/dist/ui/renderers/index.js

@@ -1,4 +1,178 @@
 // @bun
+// src/visualizations/catalog.ts
+import {
+  defineVisualization,
+  VisualizationRegistry
+} from "@contractspec/lib.contracts-spec/visualizations";
+var ORDER_LIST_REF = {
+  key: "marketplace.order.list",
+  version: "1.0.0"
+};
+var PRODUCT_LIST_REF = {
+  key: "marketplace.product.list",
+  version: "1.0.0"
+};
+var META = {
+  version: "1.0.0",
+  domain: "marketplace",
+  stability: "experimental",
+  owners: ["@example.marketplace"],
+  tags: ["marketplace", "visualization", "commerce"]
+};
+var MarketplaceOrderStatusVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "marketplace.visualization.order-status",
+    title: "Order Status Breakdown",
+    description: "Distribution of current order states.",
+    goal: "Expose delivery and backlog mix at a glance.",
+    context: "Marketplace operations overview."
+  },
+  source: { primary: ORDER_LIST_REF, resultPath: "data" },
+  visualization: {
+    kind: "pie",
+    nameDimension: "status",
+    valueMeasure: "orders",
+    dimensions: [
+      { key: "status", label: "Status", dataPath: "status", type: "category" }
+    ],
+    measures: [
+      { key: "orders", label: "Orders", dataPath: "orders", format: "number" }
+    ],
+    table: { caption: "Order counts by status." }
+  }
+});
+var MarketplaceCategoryValueVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "marketplace.visualization.category-value",
+    title: "Category Value Comparison",
+    description: "Catalog value by product category derived from current pricing and stock.",
+    goal: "Compare where the marketplace catalog is concentrated.",
+    context: "Merchandising overview."
+  },
+  source: { primary: PRODUCT_LIST_REF, resultPath: "data" },
+  visualization: {
+    kind: "cartesian",
+    variant: "bar",
+    xDimension: "category",
+    yMeasures: ["catalogValue"],
+    dimensions: [
+      {
+        key: "category",
+        label: "Category",
+        dataPath: "category",
+        type: "category"
+      }
+    ],
+    measures: [
+      {
+        key: "catalogValue",
+        label: "Catalog Value",
+        dataPath: "catalogValue",
+        format: "currency",
+        color: "#1d4ed8"
+      }
+    ],
+    table: { caption: "Catalog value by product category." }
+  }
+});
+var MarketplaceOrderActivityVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "marketplace.visualization.order-activity",
+    title: "Recent Order Activity",
+    description: "Daily order volume from recent order creation timestamps.",
+    goal: "Show recent order activity trends.",
+    context: "Commerce operations trend monitoring."
+  },
+  source: { primary: ORDER_LIST_REF, resultPath: "data" },
+  visualization: {
+    kind: "cartesian",
+    variant: "line",
+    xDimension: "day",
+    yMeasures: ["orders"],
+    dimensions: [{ key: "day", label: "Day", dataPath: "day", type: "time" }],
+    measures: [
+      {
+        key: "orders",
+        label: "Orders",
+        dataPath: "orders",
+        format: "number",
+        color: "#0f766e"
+      }
+    ],
+    table: { caption: "Daily order counts." }
+  }
+});
+var MarketplaceVisualizationSpecs = [
+  MarketplaceOrderStatusVisualization,
+  MarketplaceCategoryValueVisualization,
+  MarketplaceOrderActivityVisualization
+];
+var MarketplaceVisualizationRegistry = new VisualizationRegistry([
+  ...MarketplaceVisualizationSpecs
+]);
+var MarketplaceVisualizationRefs = MarketplaceVisualizationSpecs.map((spec) => ({
+  key: spec.meta.key,
+  version: spec.meta.version
+}));
+
+// src/visualizations/selectors.ts
+function toDayKey(value) {
+  const date = value instanceof Date ? value : new Date(value);
+  return date.toISOString().slice(0, 10);
+}
+function createMarketplaceVisualizationItems(products, orders) {
+  const orderStatus = new Map;
+  const orderActivity = new Map;
+  const categoryValue = new Map;
+  for (const order of orders) {
+    orderStatus.set(order.status, (orderStatus.get(order.status) ?? 0) + 1);
+    const day = toDayKey(order.createdAt);
+    orderActivity.set(day, (orderActivity.get(day) ?? 0) + 1);
+  }
+  for (const product of products) {
+    const category = product.category ?? "Uncategorized";
+    categoryValue.set(category, (categoryValue.get(category) ?? 0) + product.price * product.stock);
+  }
+  return [
+    {
+      key: "marketplace-order-status",
+      spec: MarketplaceOrderStatusVisualization,
+      data: {
+        data: Array.from(orderStatus.entries()).map(([status, count]) => ({
+          status,
+          orders: count
+        }))
+      },
+      title: "Order Status Breakdown",
+      description: "Status mix across the current order set.",
+      height: 260
+    },
+    {
+      key: "marketplace-category-value",
+      spec: MarketplaceCategoryValueVisualization,
+      data: {
+        data: Array.from(categoryValue.entries()).sort(([, left], [, right]) => right - left).map(([category, value]) => ({
+          category,
+          catalogValue: value
+        }))
+      },
+      title: "Category Value Comparison",
+      description: "Derived from current product pricing and stock."
+    },
+    {
+      key: "marketplace-order-activity",
+      spec: MarketplaceOrderActivityVisualization,
+      data: {
+        data: Array.from(orderActivity.entries()).sort(([left], [right]) => left.localeCompare(right)).map(([day, count]) => ({ day, orders: count }))
+      },
+      title: "Recent Order Activity",
+      description: "Daily order count from current order history."
+    }
+  ];
+}
 // src/ui/renderers/marketplace.markdown.ts
 var mockStores = [
   {
@@ -28,6 +202,7 @@ var mockProducts = [
     id: "prod-1",
     name: "Wireless Earbuds",
     storeId: "store-1",
+    category: "Electronics",
     price: 79.99,
     currency: "USD",
     status: "ACTIVE",
@@ -37,6 +212,7 @@ var mockProducts = [
     id: "prod-2",
     name: "Smart Watch",
     storeId: "store-1",
+    category: "Wearables",
     price: 249.99,
     currency: "USD",
     status: "ACTIVE",
@@ -46,6 +222,7 @@ var mockProducts = [
     id: "prod-3",
     name: "Garden Tools Set",
     storeId: "store-2",
+    category: "Garden",
     price: 89.99,
     currency: "USD",
     status: "ACTIVE",
@@ -55,6 +232,7 @@ var mockProducts = [
     id: "prod-4",
     name: "Indoor Plant Kit",
     storeId: "store-2",
+    category: "Garden",
     price: 45.99,
     currency: "USD",
     status: "ACTIVE",
@@ -64,6 +242,7 @@ var mockProducts = [
     id: "prod-5",
     name: "LED Desk Lamp",
     storeId: "store-1",
+    category: "Home Office",
     price: 34.99,
     currency: "USD",
     status: "OUT_OF_STOCK",
@@ -128,6 +307,7 @@ var marketplaceDashboardMarkdownRenderer = {
     const stores = mockStores;
     const products = mockProducts;
     const orders = mockOrders;
+    const visualizationItems = createMarketplaceVisualizationItems(products, orders);
     const activeStores = stores.filter((s) => s.status === "ACTIVE");
     const activeProducts = products.filter((p) => p.status === "ACTIVE");
     const totalRevenue = orders.reduce((sum, o) => sum + o.total, 0);
@@ -147,11 +327,17 @@ var marketplaceDashboardMarkdownRenderer = {
       `| Total Revenue | ${formatCurrency(totalRevenue)} |`,
       `| Pending Orders | ${pendingOrders.length} |`,
       "",
-      "## Top Stores",
-      "",
-      "| Store | Products | Rating | Status |",
-      "|-------|----------|--------|--------|"
+      "## Visualization Overview",
+      ""
     ];
+    for (const item of visualizationItems) {
+      lines.push(`- **${item.title}** via \`${item.spec.meta.key}\``);
+    }
+    lines.push("");
+    lines.push("## Top Stores");
+    lines.push("");
+    lines.push("| Store | Products | Rating | Status |");
+    lines.push("|-------|----------|--------|--------|");
     for (const store of stores.slice(0, 5)) {
       lines.push(`| ${store.name} | ${store.productCount} | \u2B50 ${store.rating || "N/A"} | ${store.status} |`);
     }

package/dist/ui/renderers/marketplace.markdown.js

@@ -1,4 +1,178 @@
 // @bun
+// src/visualizations/catalog.ts
+import {
+  defineVisualization,
+  VisualizationRegistry
+} from "@contractspec/lib.contracts-spec/visualizations";
+var ORDER_LIST_REF = {
+  key: "marketplace.order.list",
+  version: "1.0.0"
+};
+var PRODUCT_LIST_REF = {
+  key: "marketplace.product.list",
+  version: "1.0.0"
+};
+var META = {
+  version: "1.0.0",
+  domain: "marketplace",
+  stability: "experimental",
+  owners: ["@example.marketplace"],
+  tags: ["marketplace", "visualization", "commerce"]
+};
+var MarketplaceOrderStatusVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "marketplace.visualization.order-status",
+    title: "Order Status Breakdown",
+    description: "Distribution of current order states.",
+    goal: "Expose delivery and backlog mix at a glance.",
+    context: "Marketplace operations overview."
+  },
+  source: { primary: ORDER_LIST_REF, resultPath: "data" },
+  visualization: {
+    kind: "pie",
+    nameDimension: "status",
+    valueMeasure: "orders",
+    dimensions: [
+      { key: "status", label: "Status", dataPath: "status", type: "category" }
+    ],
+    measures: [
+      { key: "orders", label: "Orders", dataPath: "orders", format: "number" }
+    ],
+    table: { caption: "Order counts by status." }
+  }
+});
+var MarketplaceCategoryValueVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "marketplace.visualization.category-value",
+    title: "Category Value Comparison",
+    description: "Catalog value by product category derived from current pricing and stock.",
+    goal: "Compare where the marketplace catalog is concentrated.",
+    context: "Merchandising overview."
+  },
+  source: { primary: PRODUCT_LIST_REF, resultPath: "data" },
+  visualization: {
+    kind: "cartesian",
+    variant: "bar",
+    xDimension: "category",
+    yMeasures: ["catalogValue"],
+    dimensions: [
+      {
+        key: "category",
+        label: "Category",
+        dataPath: "category",
+        type: "category"
+      }
+    ],
+    measures: [
+      {
+        key: "catalogValue",
+        label: "Catalog Value",
+        dataPath: "catalogValue",
+        format: "currency",
+        color: "#1d4ed8"
+      }
+    ],
+    table: { caption: "Catalog value by product category." }
+  }
+});
+var MarketplaceOrderActivityVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "marketplace.visualization.order-activity",
+    title: "Recent Order Activity",
+    description: "Daily order volume from recent order creation timestamps.",
+    goal: "Show recent order activity trends.",
+    context: "Commerce operations trend monitoring."
+  },
+  source: { primary: ORDER_LIST_REF, resultPath: "data" },
+  visualization: {
+    kind: "cartesian",
+    variant: "line",
+    xDimension: "day",
+    yMeasures: ["orders"],
+    dimensions: [{ key: "day", label: "Day", dataPath: "day", type: "time" }],
+    measures: [
+      {
+        key: "orders",
+        label: "Orders",
+        dataPath: "orders",
+        format: "number",
+        color: "#0f766e"
+      }
+    ],
+    table: { caption: "Daily order counts." }
+  }
+});
+var MarketplaceVisualizationSpecs = [
+  MarketplaceOrderStatusVisualization,
+  MarketplaceCategoryValueVisualization,
+  MarketplaceOrderActivityVisualization
+];
+var MarketplaceVisualizationRegistry = new VisualizationRegistry([
+  ...MarketplaceVisualizationSpecs
+]);
+var MarketplaceVisualizationRefs = MarketplaceVisualizationSpecs.map((spec) => ({
+  key: spec.meta.key,
+  version: spec.meta.version
+}));
+
+// src/visualizations/selectors.ts
+function toDayKey(value) {
+  const date = value instanceof Date ? value : new Date(value);
+  return date.toISOString().slice(0, 10);
+}
+function createMarketplaceVisualizationItems(products, orders) {
+  const orderStatus = new Map;
+  const orderActivity = new Map;
+  const categoryValue = new Map;
+  for (const order of orders) {
+    orderStatus.set(order.status, (orderStatus.get(order.status) ?? 0) + 1);
+    const day = toDayKey(order.createdAt);
+    orderActivity.set(day, (orderActivity.get(day) ?? 0) + 1);
+  }
+  for (const product of products) {
+    const category = product.category ?? "Uncategorized";
+    categoryValue.set(category, (categoryValue.get(category) ?? 0) + product.price * product.stock);
+  }
+  return [
+    {
+      key: "marketplace-order-status",
+      spec: MarketplaceOrderStatusVisualization,
+      data: {
+        data: Array.from(orderStatus.entries()).map(([status, count]) => ({
+          status,
+          orders: count
+        }))
+      },
+      title: "Order Status Breakdown",
+      description: "Status mix across the current order set.",
+      height: 260
+    },
+    {
+      key: "marketplace-category-value",
+      spec: MarketplaceCategoryValueVisualization,
+      data: {
+        data: Array.from(categoryValue.entries()).sort(([, left], [, right]) => right - left).map(([category, value]) => ({
+          category,
+          catalogValue: value
+        }))
+      },
+      title: "Category Value Comparison",
+      description: "Derived from current product pricing and stock."
+    },
+    {
+      key: "marketplace-order-activity",
+      spec: MarketplaceOrderActivityVisualization,
+      data: {
+        data: Array.from(orderActivity.entries()).sort(([left], [right]) => left.localeCompare(right)).map(([day, count]) => ({ day, orders: count }))
+      },
+      title: "Recent Order Activity",
+      description: "Daily order count from current order history."
+    }
+  ];
+}
 // src/ui/renderers/marketplace.markdown.ts
 var mockStores = [
   {
@@ -28,6 +202,7 @@ var mockProducts = [
     id: "prod-1",
     name: "Wireless Earbuds",
     storeId: "store-1",
+    category: "Electronics",
     price: 79.99,
     currency: "USD",
     status: "ACTIVE",
@@ -37,6 +212,7 @@ var mockProducts = [
     id: "prod-2",
     name: "Smart Watch",
     storeId: "store-1",
+    category: "Wearables",
     price: 249.99,
     currency: "USD",
     status: "ACTIVE",
@@ -46,6 +222,7 @@ var mockProducts = [
     id: "prod-3",
     name: "Garden Tools Set",
     storeId: "store-2",
+    category: "Garden",
     price: 89.99,
     currency: "USD",
     status: "ACTIVE",
@@ -55,6 +232,7 @@ var mockProducts = [
     id: "prod-4",
     name: "Indoor Plant Kit",
     storeId: "store-2",
+    category: "Garden",
     price: 45.99,
     currency: "USD",
     status: "ACTIVE",
@@ -64,6 +242,7 @@ var mockProducts = [
     id: "prod-5",
     name: "LED Desk Lamp",
     storeId: "store-1",
+    category: "Home Office",
     price: 34.99,
     currency: "USD",
     status: "OUT_OF_STOCK",
@@ -128,6 +307,7 @@ var marketplaceDashboardMarkdownRenderer = {
     const stores = mockStores;
     const products = mockProducts;
     const orders = mockOrders;
+    const visualizationItems = createMarketplaceVisualizationItems(products, orders);
     const activeStores = stores.filter((s) => s.status === "ACTIVE");
     const activeProducts = products.filter((p) => p.status === "ACTIVE");
     const totalRevenue = orders.reduce((sum, o) => sum + o.total, 0);
@@ -147,11 +327,17 @@ var marketplaceDashboardMarkdownRenderer = {
       `| Total Revenue | ${formatCurrency(totalRevenue)} |`,
       `| Pending Orders | ${pendingOrders.length} |`,
       "",
-      "## Top Stores",
-      "",
-      "| Store | Products | Rating | Status |",
-      "|-------|----------|--------|--------|"
+      "## Visualization Overview",
+      ""
     ];
+    for (const item of visualizationItems) {
+      lines.push(`- **${item.title}** via \`${item.spec.meta.key}\``);
+    }
+    lines.push("");
+    lines.push("## Top Stores");
+    lines.push("");
+    lines.push("| Store | Products | Rating | Status |");
+    lines.push("|-------|----------|--------|--------|");
     for (const store of stores.slice(0, 5)) {
       lines.push(`| ${store.name} | ${store.productCount} | \u2B50 ${store.rating || "N/A"} | ${store.status} |`);
     }

package/dist/visualizations/catalog.d.ts

@@ -0,0 +1,10 @@
+import { VisualizationRegistry } from '@contractspec/lib.contracts-spec/visualizations';
+export declare const MarketplaceOrderStatusVisualization: import("@contractspec/lib.contracts-spec").VisualizationSpec;
+export declare const MarketplaceCategoryValueVisualization: import("@contractspec/lib.contracts-spec").VisualizationSpec;
+export declare const MarketplaceOrderActivityVisualization: import("@contractspec/lib.contracts-spec").VisualizationSpec;
+export declare const MarketplaceVisualizationSpecs: readonly [import("@contractspec/lib.contracts-spec").VisualizationSpec, import("@contractspec/lib.contracts-spec").VisualizationSpec, import("@contractspec/lib.contracts-spec").VisualizationSpec];
+export declare const MarketplaceVisualizationRegistry: VisualizationRegistry;
+export declare const MarketplaceVisualizationRefs: {
+    key: string;
+    version: string;
+}[];

package/dist/visualizations/catalog.js

@@ -0,0 +1,127 @@
+// @bun
+// src/visualizations/catalog.ts
+import {
+  defineVisualization,
+  VisualizationRegistry
+} from "@contractspec/lib.contracts-spec/visualizations";
+var ORDER_LIST_REF = {
+  key: "marketplace.order.list",
+  version: "1.0.0"
+};
+var PRODUCT_LIST_REF = {
+  key: "marketplace.product.list",
+  version: "1.0.0"
+};
+var META = {
+  version: "1.0.0",
+  domain: "marketplace",
+  stability: "experimental",
+  owners: ["@example.marketplace"],
+  tags: ["marketplace", "visualization", "commerce"]
+};
+var MarketplaceOrderStatusVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "marketplace.visualization.order-status",
+    title: "Order Status Breakdown",
+    description: "Distribution of current order states.",
+    goal: "Expose delivery and backlog mix at a glance.",
+    context: "Marketplace operations overview."
+  },
+  source: { primary: ORDER_LIST_REF, resultPath: "data" },
+  visualization: {
+    kind: "pie",
+    nameDimension: "status",
+    valueMeasure: "orders",
+    dimensions: [
+      { key: "status", label: "Status", dataPath: "status", type: "category" }
+    ],
+    measures: [
+      { key: "orders", label: "Orders", dataPath: "orders", format: "number" }
+    ],
+    table: { caption: "Order counts by status." }
+  }
+});
+var MarketplaceCategoryValueVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "marketplace.visualization.category-value",
+    title: "Category Value Comparison",
+    description: "Catalog value by product category derived from current pricing and stock.",
+    goal: "Compare where the marketplace catalog is concentrated.",
+    context: "Merchandising overview."
+  },
+  source: { primary: PRODUCT_LIST_REF, resultPath: "data" },
+  visualization: {
+    kind: "cartesian",
+    variant: "bar",
+    xDimension: "category",
+    yMeasures: ["catalogValue"],
+    dimensions: [
+      {
+        key: "category",
+        label: "Category",
+        dataPath: "category",
+        type: "category"
+      }
+    ],
+    measures: [
+      {
+        key: "catalogValue",
+        label: "Catalog Value",
+        dataPath: "catalogValue",
+        format: "currency",
+        color: "#1d4ed8"
+      }
+    ],
+    table: { caption: "Catalog value by product category." }
+  }
+});
+var MarketplaceOrderActivityVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "marketplace.visualization.order-activity",
+    title: "Recent Order Activity",
+    description: "Daily order volume from recent order creation timestamps.",
+    goal: "Show recent order activity trends.",
+    context: "Commerce operations trend monitoring."
+  },
+  source: { primary: ORDER_LIST_REF, resultPath: "data" },
+  visualization: {
+    kind: "cartesian",
+    variant: "line",
+    xDimension: "day",
+    yMeasures: ["orders"],
+    dimensions: [{ key: "day", label: "Day", dataPath: "day", type: "time" }],
+    measures: [
+      {
+        key: "orders",
+        label: "Orders",
+        dataPath: "orders",
+        format: "number",
+        color: "#0f766e"
+      }
+    ],
+    table: { caption: "Daily order counts." }
+  }
+});
+var MarketplaceVisualizationSpecs = [
+  MarketplaceOrderStatusVisualization,
+  MarketplaceCategoryValueVisualization,
+  MarketplaceOrderActivityVisualization
+];
+var MarketplaceVisualizationRegistry = new VisualizationRegistry([
+  ...MarketplaceVisualizationSpecs
+]);
+var MarketplaceVisualizationRefs = MarketplaceVisualizationSpecs.map((spec) => ({
+  key: spec.meta.key,
+  version: spec.meta.version
+}));
+export {
+  MarketplaceVisualizationSpecs,
+  MarketplaceVisualizationRegistry,
+  MarketplaceVisualizationRefs,
+  MarketplaceOrderStatusVisualization,
+  MarketplaceOrderActivityVisualization,
+  MarketplaceCategoryValueVisualization
+};

package/dist/visualizations/index.d.ts

@@ -0,0 +1,2 @@
+export * from './catalog';
+export * from './selectors';