@topogram/starter-web-api 0.1.10 → 0.1.12

package/implementation/README.md

@@ -1,5 +1,5 @@
 # Starter Implementation
 
-This folder holds the small implementation provider copied by the package-backed
-`web-api` starter. It intentionally avoids Todo-specific domain logic; richer
-product examples belong in external template packs.
+This folder holds the small implementation provider copied by the local
+`web-api` template fixture. It intentionally avoids product-specific domain
+logic; richer product examples belong in external template packs.

package/implementation/index.js

@@ -19,8 +19,8 @@ import {
   renderHelloRoutes
 } from "./web/renderers.js";
 
-export const WEB_API_IMPLEMENTATION = {
-  exampleId: "web-api-template",
+export const WEB_API_DB_IMPLEMENTATION = {
+  exampleId: "web-api-db-template",
   exampleRoot: "/topogram",
   backend: {
     reference: HELLO_BACKEND_REFERENCE,
@@ -50,4 +50,9 @@ export const WEB_API_IMPLEMENTATION = {
   }
 };
 
-export default WEB_API_IMPLEMENTATION;
+export const WEB_API_IMPLEMENTATION = {
+  ...WEB_API_DB_IMPLEMENTATION,
+  exampleId: "web-api-template"
+};
+
+export default WEB_API_DB_IMPLEMENTATION;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topogram/starter-web-api",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "React and Express Topogram starter.",
   "license": "UNLICENSED",
   "private": false,
@@ -18,8 +18,8 @@
     "README.md"
   ],
   "devDependencies": {
-    "@topogram/generator-express-api": "0.1.3",
-    "@topogram/generator-react-web": "0.1.6"
+    "@topogram/generator-express-api": "0.1.4",
+    "@topogram/generator-react-web": "0.1.7"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",

package/topogram/projections/proj-api.tg

@@ -1,19 +1,19 @@
 projection proj_api {
   name "Starter API"
   description "HTTP API realization for the neutral starter"
-  platform dotnet
+  type api_contract
 
   realizes [cap_create_greeting, cap_get_greeting, cap_list_greetings, cap_update_greeting]
   outputs [database_schema, entity_models, request_contracts, response_contracts, endpoints]
 
-  http {
+  endpoints {
     cap_create_greeting method POST path /greetings success 201 auth none request body
     cap_get_greeting method GET path /greetings/:id success 200 auth none request path
     cap_list_greetings method GET path /greetings success 200 auth none request query
     cap_update_greeting method PATCH path /greetings/:id success 200 auth none request body
   }
 
-  http_fields {
+  wire_fields {
     cap_get_greeting input greeting_id in path as id
     cap_update_greeting input greeting_id in path as id
     cap_update_greeting input message in body
@@ -21,7 +21,7 @@ projection proj_api {
     cap_list_greetings input limit in query
   }
 
-  http_responses {
+  responses {
     cap_list_greetings mode cursor item shape_output_greeting_detail cursor request_after after response_next next_cursor limit field limit default 25 max 100 sort by created_at direction desc total included false
   }
 

package/topogram/projections/{proj-ui-shared.tg → proj-ui-contract.tg}

@@ -1,12 +1,12 @@
-projection proj_ui_shared {
+projection proj_ui_contract {
   name "Starter Shared UI"
   description "Platform-neutral UI semantics for the neutral starter"
-  platform ui_shared
+  type ui_contract
 
   realizes [cap_list_greetings, cap_get_greeting, cap_create_greeting, cap_update_greeting]
   outputs [ui_contract]
 
-  ui_app_shell {
+  app_shell {
     brand "Topogram Starter"
     shell topbar
     global_search false
@@ -15,24 +15,42 @@ projection proj_ui_shared {
     footer none
   }
 
-  ui_screens {
+  design_tokens {
+    density compact
+    tone operational
+    radius_scale medium
+    color_role primary accent
+    color_role danger critical
+    typography_role body readable
+    typography_role heading prominent
+    action_role primary prominent
+    action_role destructive danger
+    accessibility contrast aa
+    accessibility focus visible
+  }
+
+  screens {
     screen greeting_list kind list title "Greetings" load cap_list_greetings item_shape shape_output_greeting_card detail_capability cap_get_greeting primary_action cap_create_greeting empty_title "No greetings yet" empty_body "Create a greeting to verify the generated stack" loading_state skeleton error_state inline
     screen greeting_detail kind detail title "Greeting Details" load cap_get_greeting view_shape shape_output_greeting_detail primary_action cap_update_greeting loading_state skeleton
     screen greeting_create kind form title "Create Greeting" input_shape shape_input_create_greeting submit cap_create_greeting success_navigate greeting_detail success_state banner
   }
 
-  ui_navigation {
+  navigation {
     group starter label "Starter" placement primary pattern primary
     screen greeting_list group starter label "Greetings" order 10 visible true default true sitemap include pattern primary
     screen greeting_create group starter label "Create" order 20 visible true sitemap include pattern primary
     screen greeting_detail group starter label "Greeting Details" visible false breadcrumb greeting_list sitemap exclude pattern stack_navigation
   }
 
-  ui_screen_regions {
+  screen_regions {
     screen greeting_list region hero pattern summary_stats placement primary
     screen greeting_list region results pattern resource_table placement primary
     screen greeting_detail region summary pattern detail_panel placement primary
   }
 
+  widget_bindings {
+    screen greeting_list region results widget widget_greeting_table data rows from cap_list_greetings event row_select navigate greeting_detail
+  }
+
   status active
 }

package/topogram/projections/{proj-ui-web.tg → proj-web-surface.tg}

@@ -1,18 +1,18 @@
-projection proj_ui_web {
+projection proj_web_surface {
   name "Starter Web UI"
   description "Web realization for the neutral starter using a React profile"
-  platform ui_web
+  type web_surface
 
-  realizes [proj_ui_shared, cap_list_greetings, cap_get_greeting, cap_create_greeting, cap_update_greeting]
+  realizes [proj_ui_contract, cap_list_greetings, cap_get_greeting, cap_create_greeting, cap_update_greeting]
   outputs [ui_contract, web_app]
 
-  ui_routes {
+  screen_routes {
     screen greeting_list path /greetings
     screen greeting_detail path /greetings/:id
     screen greeting_create path /greetings/new
   }
 
-  ui_web {
+  web_hints {
     screen greeting_list shell topbar
     screen greeting_list layout responsive_collection
     screen greeting_list desktop_variant table

package/topogram/widgets/widget-greeting-table.tg

@@ -0,0 +1,23 @@
+widget widget_greeting_table {
+  name "Greeting Table"
+  description "Reusable table display for greeting rows"
+  category collection
+
+  props {
+    rows array required
+    loading boolean optional default false
+  }
+
+  events {
+    row_select shape_output_greeting_card
+  }
+
+  slots {
+    empty_state "Empty-state content"
+  }
+
+  patterns [resource_table, data_grid_view]
+  regions [results]
+  version "1.0"
+  status active
+}

package/topogram-template.json

@@ -1,6 +1,6 @@
 {
   "id": "@topogram/starter-web-api",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "kind": "starter",
   "description": "Neutral Hello-resource React/Express web/API starter.",
   "topogramVersion": "0.1",

package/topogram.project.json

@@ -12,29 +12,29 @@
     }
   },
   "topology": {
-    "components": [
+    "runtimes": [
       {
         "id": "app_api",
-        "type": "api",
         "projection": "proj_api",
         "generator": {
           "id": "@topogram/generator-express-api",
           "version": "1",
           "package": "@topogram/generator-express-api"
         },
-        "port": 3000
+        "port": 3000,
+        "kind": "api_service"
       },
       {
         "id": "app_react",
-        "type": "web",
-        "projection": "proj_ui_web",
+        "projection": "proj_web_surface",
         "generator": {
           "id": "@topogram/generator-react-web",
           "version": "1",
           "package": "@topogram/generator-react-web"
         },
         "port": 5173,
-        "api": "app_api"
+        "kind": "web_surface",
+        "uses_api": "app_api"
       }
     ]
   }