semantics

specs/019-superset-ux-redesign/contracts/api.md

@@ -196,7 +196,7 @@ export const sidebarStore = writable({
 
 export function toggleSidebar() { /* ... */ }
 export function setActiveItem(path) { /* ... */ }
-// [/DEF:SidebarStore]
+// [/DEF:SidebarStore:Store]
 ```
 
 ### TaskDrawerStore (frontend/src/lib/stores/taskDrawer.js)
@@ -221,7 +221,7 @@ export const taskDrawerStore = writable({
 export function openDrawerForTask(taskId) { /* ... */ }
 export function closeDrawer() { /* ... */ }
 export function updateResourceTask(resourceId, taskId, status) { /* ... */ }
-// [/DEF:TaskDrawerStore]
+// [/DEF:TaskDrawerStore:Store]
 ```
 
 ### ActivityStore (frontend/src/lib/stores/activity.js)
@@ -238,5 +238,5 @@ export const activityStore = derived(taskDrawerStore, ($drawer) => {
     .filter(t => t.status === 'RUNNING').length;
   return { activeCount };
 });
-// [/DEF:ActivityStore]
+// [/DEF:ActivityStore:Store]
 ```

specs/019-superset-ux-redesign/contracts/modules.md

@@ -53,7 +53,7 @@ export function setActiveCategory(category) { /* ... */ }
 export function setActiveItem(path) { /* ... */ }
 export function openMobileSidebar() { /* ... */ }
 export function closeMobileSidebar() { /* ... */ }
-// [/DEF:SidebarStore]
+// [/DEF:SidebarStore:Store]
 ```
 
 ---
@@ -105,7 +105,7 @@ export function openDrawerForTask(taskId) { /* ... */ }
 export function closeDrawer() { /* ... */ }
 export function updateResourceTask(resourceId, taskId, status) { /* ... */ }
 export function clearCompletedTasks() { /* ... */ }
-// [/DEF:TaskDrawerStore]
+// [/DEF:TaskDrawerStore:Store]
 ```
 
 ---
@@ -143,7 +143,7 @@ export const activityStore = derived(
     return { activeCount, recentTasks };
   }
 );
-// [/DEF:ActivityStore]
+// [/DEF:ActivityStore:Store]
 ```
 
 ---
@@ -187,7 +187,7 @@ export const activityStore = derived(
     { id: 'admin', label: 'ADMIN', items: [{ path: '/users', label: 'Users' }, { path: '/settings', label: 'Settings' }], adminOnly: true }
   ];
 </script>
-<!-- [/DEF:Sidebar] -->
+<!-- [/DEF:Sidebar:Component] -->
 ```
 
 ---
@@ -225,7 +225,7 @@ export const activityStore = derived(
   export let logoText = 'Superset Tools';
   export let searchPlaceholder = 'Search...';
 </script>
-<!-- [/DEF:TopNavbar] -->
+<!-- [/DEF:TopNavbar:Component] -->
 ```
 
 ---
@@ -270,7 +270,7 @@ export const activityStore = derived(
   export let width = 480; // px
   export let closeOnOutsideClick = false;
 </script>
-<!-- [/DEF:TaskDrawer] -->
+<!-- [/DEF:TaskDrawer:Component] -->
 ```
 
 ---
@@ -323,7 +323,7 @@ export const activityStore = derived(
   let searchQuery = '';
   let environmentId = null;
 </script>
-<!-- [/DEF:DashboardHub] -->
+<!-- [/DEF:DashboardHub:Component] -->
 ```
 
 ---
@@ -374,7 +374,7 @@ export const activityStore = derived(
   let searchQuery = '';
   let environmentId = null;
 </script>
-<!-- [/DEF:DatasetHub] -->
+<!-- [/DEF:DatasetHub:Component] -->
 ```
 
 ---
@@ -406,7 +406,7 @@ export const activityStore = derived(
   export let items = []; // [{ label: string, path: string | null }]
   export let maxVisible = 3;
 </script>
-<!-- [/DEF:Breadcrumbs] -->
+<!-- [/DEF:Breadcrumbs:Component] -->
 ```
 
 ---
@@ -445,7 +445,7 @@ export const activityStore = derived(
 # Endpoint: POST /api/dashboards/backup
 # Body: { env_id, dashboard_ids, schedule (optional cron) }
 # Response: { task_id }
-# [/DEF:DashboardsAPI]
+# [/DEF:DashboardsAPI:Module]
 ```
 
 ---
@@ -482,7 +482,7 @@ export const activityStore = derived(
 # Endpoint: POST /api/datasets/generate-docs
 # Body: { env_id, dataset_ids, llm_provider, options }
 # Response: { task_id }
-# [/DEF:DatasetsAPI]
+# [/DEF:DatasetsAPI:Module]
 ```
 
 ---
@@ -506,7 +506,7 @@ export const activityStore = derived(
 
 # Endpoint: GET /api/activity
 # Response: { active_count: number, recent_tasks: [...] }
-# [/DEF:ActivityAPI]
+# [/DEF:ActivityAPI:Module]
 ```
 
 ---
@@ -535,7 +535,7 @@ class ResourceService:
     async def fetch_datasets(env_id: str, search: str = None) -> list[Dataset]: ...
     async def get_git_status(env_id: str, resource_id: str) -> GitStatus: ...
     async def get_last_task(resource_type: str, resource_id: str) -> TaskSummary: ...
-# [/DEF:ResourceService]
+# [/DEF:ResourceService:Class]
 ```
 
 ---