@topogram/template-todo 0.1.33 → 0.1.34

package/README.md

@@ -26,10 +26,10 @@ This template includes executable implementation provider JavaScript under `impl
 may load it later after local trust metadata is recorded. Use it as trusted code
 from the `@topogram` package scope.
 
-The Topogram source includes reusable UI components for task summary metrics,
-task tables, task boards, and task calendars. `proj_ui_shared` owns their
-screen and region placement through `ui_components`, so SvelteKit and React web
-projections inherit the same component contract metadata.
+The Topogram source includes reusable UI widgets for task summary metrics,
+task tables, task boards, and task calendars. `proj_ui_contract` owns their
+screen and region placement through `widget_bindings`, so SvelteKit and React web
+projections inherit the same widget contract metadata.
 
 ## Runtime Semantics
 
@@ -63,7 +63,7 @@ By default the smoke test installs the `@topogram/cli` version pinned in
 `topogram-cli.version`. Override it with:
 
 ```bash
-TOPOGRAM_CLI_PACKAGE_SPEC=/path/to/topogram-cli-0.3.38.tgz npm run pack:check
+TOPOGRAM_CLI_PACKAGE_SPEC=/path/to/topogram-cli.tgz npm run pack:check
 ```
 
 ## Release

package/implementation/web/renderers.js

@@ -1,6 +1,6 @@
 import { renderSvelteKitRedirectingAction } from "@topogram/cli/src/generator/surfaces/web/sveltekit-actions.js";
 import {
-  renderSvelteKitComponentRegion
+  renderSvelteKitWidgetRegion
 } from "@topogram/cli/template-helpers/sveltekit.js";
 import { TODO_WEB_SCREEN_REFERENCE } from "./screens-reference.js";
 
@@ -75,13 +75,13 @@ export function renderTodoTaskRoutes({
   const editTaskVisibility = taskDetail.visibility?.find((entry) => entry.capability?.id === "cap_update_task") || null;
   const completeTaskVisibility = taskDetail.visibility?.find((entry) => entry.capability?.id === "cap_complete_task") || null;
   const deleteTaskVisibility = taskDetail.visibility?.find((entry) => entry.capability?.id === "cap_delete_task") || null;
-  const taskListHeroComponents = renderSvelteKitComponentRegion(taskList, "hero", {
-    componentContracts: contract.components,
+  const taskListHeroComponents = renderSvelteKitWidgetRegion(taskList, "hero", {
+    widgetContracts: contract.widgets,
     itemsExpression: "data.result.items",
     useTypescript
   });
-  const taskListResultsComponents = renderSvelteKitComponentRegion(taskList, "results", {
-    componentContracts: contract.components,
+  const taskListResultsComponents = renderSvelteKitWidgetRegion(taskList, "results", {
+    widgetContracts: contract.widgets,
     itemsExpression: "data.result.items",
     useTypescript
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topogram/template-todo",
-  "version": "0.1.33",
+  "version": "0.1.34",
   "description": "Topogram template pack for starting a generated Todo app.",
   "private": false,
   "license": "UNLICENSED",
@@ -27,9 +27,9 @@
     "release:check": "bash ./scripts/check-release-version.sh"
   },
   "devDependencies": {
-    "@topogram/cli": "^0.3.49",
-    "@topogram/generator-hono-api": "0.2.7",
-    "@topogram/generator-postgres-db": "0.1.6",
-    "@topogram/generator-sveltekit-web": "0.1.16"
+    "@topogram/cli": "^0.3.52",
+    "@topogram/generator-hono-api": "0.2.8",
+    "@topogram/generator-postgres-db": "0.1.7",
+    "@topogram/generator-sveltekit-web": "0.1.17"
   }
 }

package/topogram/docs/journeys/task-creation-and-ownership.md

@@ -23,8 +23,8 @@ related_rules:
   - rule_only_active_users_may_own_tasks
 related_projections:
   - proj_api
-  - proj_ui_shared
-  - proj_ui_web
+  - proj_ui_contract
+  - proj_web_surface
 failure_signals:
   - The user can create a task in an archived project.
   - The user can assign a task to an inactive owner.

package/topogram/projections/proj-api.tg

@@ -1,7 +1,7 @@
 projection proj_api {
   name "API"
   description "HTTP API realization for Todo"
-  platform dotnet
+  type api_contract
 
   realizes [cap_create_task, cap_get_task, cap_update_task, cap_complete_task, cap_list_tasks, cap_delete_task, cap_export_tasks, cap_get_task_export_job, cap_download_task_export, cap_list_projects, cap_get_project, cap_create_project, cap_update_project, cap_list_users, cap_get_user, cap_create_user, cap_update_user]
 
@@ -14,7 +14,7 @@ projection proj_api {
     endpoints
   ]
 
-  http {
+  endpoints {
     cap_create_task method POST path /tasks success 201 auth user request body
     cap_get_task method GET path /tasks/:id success 200 auth user request path
     cap_update_task method PATCH path /tasks/:id success 200 auth user request body
@@ -34,7 +34,7 @@ projection proj_api {
     cap_download_task_export method GET path /task-exports/:job_id/download success 200 auth user request path
   }
 
-  http_errors {
+  error_responses {
     cap_create_task rule_no_task_creation_in_archived_project 409
     cap_create_task rule_only_active_users_may_own_tasks 400
     cap_create_task cap_create_task_invalid_request 400
@@ -49,7 +49,7 @@ projection proj_api {
     cap_download_task_export cap_download_task_export_not_ready 409
   }
 
-  http_fields {
+  wire_fields {
     cap_create_task input title in body
     cap_create_task input description in body
     cap_create_task input priority in body
@@ -112,44 +112,44 @@ projection proj_api {
     cap_export_tasks input callback_url in body
   }
 
-  http_responses {
+  responses {
     cap_list_tasks mode cursor item shape_output_task_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
     cap_list_projects mode cursor item shape_output_project_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
     cap_list_users mode cursor item shape_output_user_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
   }
 
-  http_preconditions {
+  preconditions {
     cap_update_task header If-Match required true error 412 source updated_at code cap_update_task_precondition_failed
     cap_complete_task header If-Match required true error 412 source updated_at code cap_complete_task_precondition_failed
     cap_delete_task header If-Match required true error 412 source updated_at code cap_delete_task_precondition_failed
   }
 
-  http_idempotency {
+  idempotency {
     cap_create_task header Idempotency-Key required true error 409 code cap_create_task_idempotency_conflict
     cap_complete_task header Idempotency-Key required true error 409 code cap_complete_task_idempotency_conflict
   }
 
-  http_cache {
+  cache {
     cap_get_task response_header ETag request_header If-None-Match required false not_modified 304 source updated_at code cap_get_task_not_modified
   }
 
-  http_delete {
+  delete_semantics {
     cap_delete_task mode soft field status value archived response body
   }
 
-  http_async {
+  async_jobs {
     cap_export_tasks mode job accepted 202 location_header Location retry_after_header Retry-After status_path /task-exports/:job_id status_capability cap_get_task_export_job job shape_output_task_export_job
   }
 
-  http_status {
+  async_status {
     cap_get_task_export_job async_for cap_export_tasks state_field status completed completed failed failed expired expired download_capability cap_download_task_export download_field download_url error_field error_message
   }
 
-  http_download {
+  downloads {
     cap_download_task_export async_for cap_export_tasks media application/zip filename task-export.zip disposition attachment
   }
 
-  http_authz {
+  authorization {
     cap_create_task permission tasks.create
     cap_get_task ownership owner_or_admin ownership_field owner_id
     cap_update_task ownership owner_or_admin ownership_field owner_id permission tasks.update
@@ -169,7 +169,7 @@ projection proj_api {
     cap_download_task_export permission tasks.export.download ownership owner_or_admin ownership_field owner_id
   }
 
-  http_callbacks {
+  callbacks {
     cap_export_tasks event export_completed target_field callback_url method POST payload shape_output_task_export_callback success 202
   }
 

package/topogram/projections/proj-db-postgres.tg

@@ -2,17 +2,17 @@ projection proj_db_postgres {
   name "Todo Postgres DB"
   description "Postgres persistence realization for the Todo domain"
 
-  platform db_postgres
+  type db_contract
   realizes [entity_task, entity_project, entity_user]
   outputs [db_contract, sql_schema]
 
-  db_tables {
+  tables {
     entity_task table tasks
     entity_project table projects
     entity_user table users
   }
 
-  db_columns {
+  columns {
     entity_task field owner_id column owner_id
     entity_task field project_id column project_id
     entity_project field owner_id column owner_id
@@ -20,13 +20,13 @@ projection proj_db_postgres {
     entity_user field display_name column display_name
   }
 
-  db_keys {
+  keys {
     entity_task primary [id]
     entity_project primary [id]
     entity_user primary [id]
   }
 
-  db_indexes {
+  indexes {
     entity_task index [project_id, status]
     entity_task index [owner_id, status]
     entity_project unique [name]
@@ -34,13 +34,13 @@ projection proj_db_postgres {
     entity_user unique [email]
   }
 
-  db_relations {
+  relations {
     entity_task foreign_key owner_id references entity_user.id on_delete set_null
     entity_task foreign_key project_id references entity_project.id on_delete cascade
     entity_project foreign_key owner_id references entity_user.id on_delete set_null
   }
 
-  db_lifecycle {
+  lifecycle {
     entity_task soft_delete field status value archived
     entity_task timestamps created_at created_at updated_at updated_at
   }

package/topogram/projections/proj-db-sqlite.tg

@@ -2,23 +2,23 @@ projection proj_db_sqlite {
   name "Todo SQLite DB"
   description "SQLite persistence realization for the Todo domain"
 
-  platform db_sqlite
+  type db_contract
   realizes [entity_task, entity_project, entity_user]
   outputs [db_contract, sql_schema]
 
-  db_tables {
+  tables {
     entity_task table tasks
     entity_project table projects
     entity_user table users
   }
 
-  db_keys {
+  keys {
     entity_task primary [id]
     entity_project primary [id]
     entity_user primary [id]
   }
 
-  db_indexes {
+  indexes {
     entity_task index [project_id, status]
     entity_task index [owner_id, status]
     entity_project unique [name]
@@ -26,13 +26,13 @@ projection proj_db_sqlite {
     entity_user unique [email]
   }
 
-  db_relations {
+  relations {
     entity_task foreign_key owner_id references entity_user.id on_delete set_null
     entity_task foreign_key project_id references entity_project.id on_delete cascade
     entity_project foreign_key owner_id references entity_user.id on_delete set_null
   }
 
-  db_lifecycle {
+  lifecycle {
     entity_task soft_delete field status value archived
     entity_task timestamps created_at created_at updated_at updated_at
   }

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

@@ -1,8 +1,8 @@
-projection proj_ui_shared {
+projection proj_ui_contract {
   name "Todo Shared UI"
   description "Platform-neutral UI semantics for the Todo product"
 
-  platform ui_shared
+  type ui_contract
   realizes [
     cap_list_projects,
     cap_get_project,
@@ -24,7 +24,7 @@ projection proj_ui_shared {
   ]
   outputs [ui_contract]
 
-  ui_app_shell {
+  app_shell {
     brand "Topogram Todo"
     shell bottom_tabs
     global_search true
@@ -33,7 +33,7 @@ projection proj_ui_shared {
     footer legal
   }
 
-  ui_design {
+  design_tokens {
     density compact
     tone operational
     radius_scale medium
@@ -61,7 +61,7 @@ projection proj_ui_shared {
     accessibility min_touch_target comfortable
   }
 
-  ui_screens {
+  screens {
     screen project_list kind list title "Projects" load cap_list_projects item_shape shape_output_project_card detail_capability cap_get_project primary_action cap_create_project empty_title "No projects yet" empty_body "Create a project to organize your tasks" loading_state skeleton error_state inline
     screen project_detail kind detail title "Project Details" load cap_get_project view_shape shape_output_project_detail primary_action cap_update_project loading_state skeleton
     screen project_create kind form title "Create Project" input_shape shape_input_create_project submit cap_create_project success_navigate project_detail success_state banner
@@ -79,7 +79,7 @@ projection proj_ui_shared {
     screen task_exports kind job_status title "Export Status" load cap_get_task_export_job view_shape shape_output_task_export_status terminal_action cap_download_task_export
   }
 
-  ui_collections {
+  collection_views {
     screen project_list pagination cursor
     screen project_list sort created_at desc
     screen project_list view table
@@ -95,7 +95,7 @@ projection proj_ui_shared {
     screen task_list view table
   }
 
-  ui_actions {
+  screen_actions {
     screen project_list action cap_create_project prominence primary placement toolbar
     screen user_list action cap_create_user prominence primary placement toolbar
     screen task_list action cap_export_tasks prominence secondary placement toolbar
@@ -103,7 +103,7 @@ projection proj_ui_shared {
     screen task_detail action cap_delete_task prominence destructive placement footer
   }
 
-  ui_visibility {
+  visibility_rules {
     action cap_create_project visible_if permission projects.create
     action cap_update_project visible_if permission projects.update
     action cap_create_user visible_if permission users.create
@@ -114,7 +114,7 @@ projection proj_ui_shared {
     action cap_export_tasks visible_if permission tasks.export
   }
 
-  ui_lookups {
+  field_lookups {
     screen project_create field owner_id entity entity_user label_field display_name empty_label "Unassigned"
     screen project_edit field owner_id entity entity_user label_field display_name empty_label "Unassigned"
     screen task_list field project_id entity entity_project label_field name empty_label "All projects"
@@ -124,7 +124,7 @@ projection proj_ui_shared {
     screen task_edit field owner_id entity entity_user label_field display_name empty_label "Unassigned"
   }
 
-  ui_navigation {
+  navigation {
     group workspace label "Workspace" placement primary pattern bottom_tabs
     group admin label "Admin" placement primary pattern bottom_tabs
     screen task_list group workspace label "Tasks" order 10 visible true default true sitemap include pattern bottom_tabs
@@ -136,7 +136,7 @@ projection proj_ui_shared {
     screen task_detail group workspace label "Task Details" visible false breadcrumb task_list sitemap exclude pattern stack_navigation
   }
 
-  ui_screen_regions {
+  screen_regions {
     screen task_list region hero pattern summary_stats placement primary
     screen task_list region toolbar pattern action_bar placement primary
     screen task_list region results pattern resource_table placement primary
@@ -150,11 +150,11 @@ projection proj_ui_shared {
     screen user_list region results pattern resource_table placement primary
   }
 
-  ui_components {
-    screen task_list region hero component component_ui_task_summary data metrics from cap_list_tasks
-    screen task_list region results component component_ui_task_table data rows from cap_list_tasks event row_select navigate task_detail event export_request action cap_export_tasks
-    screen task_board region results component component_ui_task_board data columns from cap_list_tasks event card_select navigate task_detail event card_move action cap_update_task
-    screen task_calendar region results component component_ui_task_calendar data events from cap_list_tasks event event_select navigate task_detail
+  widget_bindings {
+    screen task_list region hero widget widget_ui_task_summary data metrics from cap_list_tasks
+    screen task_list region results widget widget_ui_task_table data rows from cap_list_tasks event row_select navigate task_detail event export_request action cap_export_tasks
+    screen task_board region results widget widget_ui_task_board data columns from cap_list_tasks event card_select navigate task_detail event card_move action cap_update_task
+    screen task_calendar region results widget widget_ui_task_calendar data events from cap_list_tasks event event_select navigate task_detail
   }
 
   status active

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

@@ -1,8 +1,8 @@
-projection proj_ui_web_react {
+projection proj_web_surface_react {
   name "Todo Web UI (React)"
   description "Web realization for the shared Todo UI using a React profile"
 
-  platform ui_web
+  type web_surface
   realizes [
     cap_list_projects,
     cap_get_project,
@@ -12,7 +12,7 @@ projection proj_ui_web_react {
     cap_get_user,
     cap_create_user,
     cap_update_user,
-    proj_ui_shared,
+    proj_ui_contract,
     cap_list_tasks,
     cap_get_task,
     cap_create_task,
@@ -25,7 +25,7 @@ projection proj_ui_web_react {
   ]
   outputs [ui_contract, web_app]
 
-  ui_routes {
+  screen_routes {
     screen project_list path /projects
     screen project_detail path /projects/:id
     screen project_create path /projects/new
@@ -43,7 +43,7 @@ projection proj_ui_web_react {
     screen task_exports path /task-exports/:job_id
   }
 
-  ui_web {
+  web_hints {
     screen task_list shell bottom_tabs
     screen project_list layout responsive_collection
     screen project_list desktop_variant table

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

@@ -1,8 +1,8 @@
-projection proj_ui_web {
+projection proj_web_surface {
   name "Todo Web UI"
   description "Web realization for the shared Todo UI using a SvelteKit profile"
 
-  platform ui_web
+  type web_surface
   realizes [
     cap_list_projects,
     cap_get_project,
@@ -12,7 +12,7 @@ projection proj_ui_web {
     cap_get_user,
     cap_create_user,
     cap_update_user,
-    proj_ui_shared,
+    proj_ui_contract,
     cap_list_tasks,
     cap_get_task,
     cap_create_task,
@@ -25,7 +25,7 @@ projection proj_ui_web {
   ]
   outputs [ui_contract, web_app]
 
-  ui_routes {
+  screen_routes {
     screen project_list path /projects
     screen project_detail path /projects/:id
     screen project_create path /projects/new
@@ -43,7 +43,7 @@ projection proj_ui_web {
     screen task_exports path /task-exports/:job_id
   }
 
-  ui_web {
+  web_hints {
     screen task_list shell bottom_tabs
     screen project_list layout responsive_collection
     screen project_list desktop_variant table

package/topogram/{components/component-ui-task-board.tg → widgets/widget-ui-task-board.tg}

@@ -1,4 +1,4 @@
-component component_ui_task_board {
+widget widget_ui_task_board {
   name "Task Board"
   description "Reusable kanban-style task board grouped by status"
   category collection

package/topogram/{components/component-ui-task-calendar.tg → widgets/widget-ui-task-calendar.tg}

@@ -1,4 +1,4 @@
-component component_ui_task_calendar {
+widget widget_ui_task_calendar {
   name "Task Calendar"
   description "Reusable calendar view for scheduled tasks"
   category collection

package/topogram/{components/component-ui-task-summary.tg → widgets/widget-ui-task-summary.tg}

@@ -1,4 +1,4 @@
-component component_ui_task_summary {
+widget widget_ui_task_summary {
   name "Task Summary"
   description "Reusable summary metrics for task workload state"
   category display

package/topogram/{components/component-ui-task-table.tg → widgets/widget-ui-task-table.tg}

@@ -1,4 +1,4 @@
-component component_ui_task_table {
+widget widget_ui_task_table {
   name "Task Table"
   description "Reusable tabular task collection with selection, sorting, filtering, and export affordances"
   category collection

package/topogram-template.json

@@ -1,11 +1,11 @@
 {
   "id": "@topogram/template-todo",
-  "version": "0.1.33",
+  "version": "0.1.34",
   "kind": "starter",
-  "description": "Todo/task management starter with generated web, API, and Postgres components.",
+  "description": "Todo/task management starter with generated web, API, and Postgres runtimes.",
   "topogramVersion": "0.1",
   "includesExecutableImplementation": true,
   "starterScripts": {
-    "component:behavior:query": "topogram query component-behavior ./topogram --projection proj_ui_web --json"
+    "widget:behavior:query": "topogram query widget-behavior ./topogram --projection proj_web_surface --json"
   }
 }

package/topogram.project.json

@@ -12,10 +12,9 @@
     }
   },
   "topology": {
-    "components": [
+    "runtimes": [
       {
         "id": "app_api",
-        "type": "api",
         "projection": "proj_api",
         "generator": {
           "id": "@topogram/generator-hono-api",
@@ -23,30 +22,31 @@
           "package": "@topogram/generator-hono-api"
         },
         "port": 3000,
-        "database": "app_postgres"
+        "kind": "api_service",
+        "uses_database": "app_postgres"
       },
       {
         "id": "app_sveltekit",
-        "type": "web",
-        "projection": "proj_ui_web",
+        "projection": "proj_web_surface",
         "generator": {
           "id": "@topogram/generator-sveltekit-web",
           "version": "1",
           "package": "@topogram/generator-sveltekit-web"
         },
         "port": 5173,
-        "api": "app_api"
+        "kind": "web_surface",
+        "uses_api": "app_api"
       },
       {
         "id": "app_postgres",
-        "type": "database",
         "projection": "proj_db_postgres",
         "generator": {
           "id": "@topogram/generator-postgres-db",
           "version": "1",
           "package": "@topogram/generator-postgres-db"
         },
-        "port": 5432
+        "port": 5432,
+        "kind": "database"
       }
     ]
   }