feat: add Shops tab to Sync Dashboard for shop discovery

New "Shops" tab in the dashboard lists all shop-type entities from
Chronicle with one-click "Open" buttons. Each row shows:
- Shop name with entity type icon and color
- Shop subtype (General Store, Blacksmith, etc.)
- Shopkeeper name
- Sync status and privacy badge

Clicking "Open" launches the ShopWindow for that entity via the
existing ShopWidget module, removing the need to find and right-click
the linked journal entry.

https://claude.ai/code/session_01XMwxFR8BCi5XvgaSVMSBZB

Author: claude

foundry-module/lang/en.json

@@ -52,6 +52,7 @@
       "NotConfiguredHint": "Go to Module Settings to enter your Chronicle URL, API key, and Campaign ID.",
       "Tabs": {
         "Entities": "Entities",
+        "Shops": "Shops",
         "Maps": "Maps",
         "Calendar": "Calendar",
         "Status": "Status"
@@ -85,6 +86,14 @@
         "Unlink": "Unlink",
         "NoMaps": "No maps found in this Chronicle campaign."
       },
+      "Shops": {
+        "Open": "Open",
+        "Synced": "Synced",
+        "NoShops": "No shops found in this campaign.",
+        "NoShopsHint": "Create shop entities in Chronicle to see them here.",
+        "NoShopType": "No shop entity type found.",
+        "NoShopTypeHint": "Add a \"Shop\" entity type to your campaign in Chronicle."
+      },
       "Calendar": {
         "CalendarModule": "Calendar Module",
         "Chronicle": "Chronicle",

foundry-module/scripts/sync-dashboard.mjs

@@ -55,6 +55,7 @@ export class SyncDashboard extends HandlebarsApplicationMixin(ApplicationV2) {
       reconnect: SyncDashboard.#onReconnectAction,
       'clear-log': SyncDashboard.#onClearLogAction,
       'open-settings': SyncDashboard.#onOpenSettingsAction,
+      'open-shop': SyncDashboard.#onOpenShopAction,
     },
   };
 
@@ -129,6 +130,14 @@ export class SyncDashboard extends HandlebarsApplicationMixin(ApplicationV2) {
       console.error('Chronicle Dashboard: Failed to load maps', err);
     }
 
+    // Build shops tab data.
+    let shopData = { shops: [] };
+    try {
+      shopData = await this._buildShopData();
+    } catch (err) {
+      console.error('Chronicle Dashboard: Failed to load shops', err);
+    }
+
     // Build calendar tab data.
     let calendarData = { available: false };
     try {
@@ -152,6 +161,9 @@ export class SyncDashboard extends HandlebarsApplicationMixin(ApplicationV2) {
       hasChronicleOnly: entityGroups.some(g => g.entities.some(e => e.status === 'chronicle-only')),
       hasFoundryOnly: foundryOnlyJournals.length > 0,
 
+      // Shops tab.
+      ...shopData,
+
       // Maps tab.
       ...mapData,
 
@@ -350,6 +362,72 @@ export class SyncDashboard extends HandlebarsApplicationMixin(ApplicationV2) {
     };
   }
 
+  // ---------------------------------------------------------------------------
+  // Shop data
+  // ---------------------------------------------------------------------------
+
+  /**
+   * Build shops tab data: all shop-type entities from Chronicle with
+   * inventory counts and sync status.
+   * @returns {Promise<object>}
+   * @private
+   */
+  async _buildShopData() {
+    // Ensure entity types are cached.
+    if (!this._cache.entityTypes) {
+      this._cache.entityTypes = await this.api.get('/entity-types');
+    }
+    const types = this._cache.entityTypes || [];
+
+    // Find the shop entity type by slug or name.
+    const shopType = types.find(t =>
+      t.slug === 'shop' || t.name?.toLowerCase() === 'shop'
+    );
+
+    if (!shopType) {
+      return { shops: [], shopTypeExists: false };
+    }
+
+    // Ensure entities are cached.
+    if (!this._cache.entities) {
+      // Trigger entity cache population via _buildEntityGroups path.
+      await this._buildEntityGroups(this._getExclusions());
+    }
+    const allEntities = this._cache.entities || [];
+
+    // Filter to shop entities.
+    const shopEntities = allEntities.filter(e => e.entity_type_id === shopType.id);
+
+    // Index Foundry journals by entityId flag.
+    const journalsByEntityId = new Map();
+    for (const j of game.journal.contents) {
+      const eid = j.getFlag(FLAG_SCOPE, 'entityId');
+      if (eid) journalsByEntityId.set(eid, j);
+    }
+
+    const shops = shopEntities.map(entity => {
+      const journal = journalsByEntityId.get(entity.id);
+      const fields = entity.fields_data || {};
+
+      return {
+        id: entity.id,
+        name: entity.name,
+        shopType: fields.shop_type || '',
+        shopKeeper: fields.shop_keeper || '',
+        synced: !!journal,
+        journalId: journal?.id ?? null,
+        isPrivate: entity.is_private ?? false,
+      };
+    });
+
+    return {
+      shops,
+      shopTypeExists: true,
+      shopTypeIcon: shopType.icon || 'fa-store',
+      shopTypeColor: shopType.color || '#f97316',
+    };
+  }
+
   // ---------------------------------------------------------------------------
   // Calendar data
   // ---------------------------------------------------------------------------
@@ -707,6 +785,18 @@ export class SyncDashboard extends HandlebarsApplicationMixin(ApplicationV2) {
     game.settings.sheet.render(true);
   }
 
+  /** Open a shop window via the ShopWidget module. */
+  static #onOpenShopAction(event, target) {
+    const entityId = target.dataset.entityId;
+    const shopName = target.dataset.shopName || 'Shop';
+    const shopWidget = this._syncManager?._modules?.find(
+      m => m.constructor?.name === 'ShopWidget'
+    );
+    if (shopWidget) {
+      shopWidget.openShop(entityId, shopName);
+    }
+  }
+
   // ---------------------------------------------------------------------------
   // Actions (business logic)
   // ---------------------------------------------------------------------------

foundry-module/styles/chronicle-sync.css

@@ -506,6 +506,98 @@
   color: inherit;
 }
 
+/* ================================================================= */
+/* SHOPS TAB                                                          */
+/* ================================================================= */
+
+.shop-list {
+  padding: 4px 0;
+}
+
+.shop-row {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 8px 10px;
+  border-radius: 4px;
+  margin-bottom: 2px;
+  transition: background 0.1s;
+}
+
+.shop-row:hover {
+  background: rgba(255, 255, 255, 0.03);
+}
+
+.shop-row.synced {
+  background: rgba(74, 222, 128, 0.04);
+}
+
+.shop-info {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  flex: 1;
+  min-width: 0;
+}
+
+.shop-row-icon {
+  width: 36px;
+  height: 36px;
+  border-radius: 6px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 16px;
+  flex-shrink: 0;
+}
+
+.shop-details {
+  display: flex;
+  flex-direction: column;
+  gap: 1px;
+  min-width: 0;
+}
+
+.shop-name {
+  font-size: 13px;
+  font-weight: 500;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.shop-subtype {
+  font-size: 11px;
+  color: rgba(255, 255, 255, 0.4);
+}
+
+.shop-keeper {
+  font-size: 11px;
+  color: rgba(255, 255, 255, 0.35);
+}
+
+.shop-keeper i {
+  font-size: 10px;
+  margin-right: 2px;
+}
+
+.shop-actions {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  flex-shrink: 0;
+}
+
+.shop-private-badge {
+  color: rgba(255, 255, 255, 0.3);
+  font-size: 12px;
+}
+
+.shop-synced-badge {
+  font-size: 11px;
+  color: #4ade80;
+}
+
 /* ================================================================= */
 /* CALENDAR TAB                                                       */
 /* ================================================================= */

foundry-module/templates/sync-dashboard.hbs

@@ -17,6 +17,9 @@
     <a class="item" data-tab="entities">
       <i class="fa-solid fa-book"></i> Entities
     </a>
+    <a class="item" data-tab="shops">
+      <i class="fa-solid fa-store"></i> Shops
+    </a>
     <a class="item" data-tab="maps">
       <i class="fa-solid fa-map"></i> Maps
     </a>
@@ -151,6 +154,64 @@
       </div>
     </div>
 
+    {{!-- ================================================================= --}}
+    {{!-- SHOPS TAB                                                         --}}
+    {{!-- ================================================================= --}}
+    <div class="tab" data-tab="shops" data-group="primary">
+      {{#if shops.length}}
+      <div class="shop-list">
+        {{#each shops}}
+        <div class="shop-row {{#if synced}}synced{{/if}}">
+          <div class="shop-info">
+            <span class="shop-row-icon" style="background-color: {{../shopTypeColor}}20; color: {{../shopTypeColor}}">
+              <i class="fa-solid {{../shopTypeIcon}}"></i>
+            </span>
+            <div class="shop-details">
+              <span class="shop-name">{{name}}</span>
+              {{#if shopType}}
+              <span class="shop-subtype">{{shopType}}</span>
+              {{/if}}
+              {{#if shopKeeper}}
+              <span class="shop-keeper"><i class="fa-solid fa-user"></i> {{shopKeeper}}</span>
+              {{/if}}
+            </div>
+          </div>
+          <div class="shop-actions">
+            {{#if isPrivate}}
+            <span class="shop-private-badge" title="Private (DM only)">
+              <i class="fa-solid fa-lock"></i>
+            </span>
+            {{/if}}
+            {{#if synced}}
+            <span class="shop-synced-badge">
+              <i class="fa-solid fa-check"></i> Synced
+            </span>
+            {{/if}}
+            <button type="button" class="dashboard-btn btn-sm"
+                    data-action="open-shop"
+                    data-entity-id="{{id}}"
+                    data-shop-name="{{name}}">
+              <i class="fa-solid fa-door-open"></i> Open
+            </button>
+          </div>
+        </div>
+        {{/each}}
+      </div>
+      {{else}}
+      <div class="dashboard-empty-tab">
+        {{#if shopTypeExists}}
+        <i class="fa-solid fa-store fa-2x"></i>
+        <p>No shops found in this campaign.</p>
+        <p class="hint">Create shop entities in Chronicle to see them here.</p>
+        {{else}}
+        <i class="fa-solid fa-store fa-2x"></i>
+        <p>No shop entity type found.</p>
+        <p class="hint">Add a "Shop" entity type to your campaign in Chronicle.</p>
+        {{/if}}
+      </div>
+      {{/if}}
+    </div>
+
     {{!-- ================================================================= --}}
     {{!-- MAPS TAB                                                          --}}
     {{!-- ================================================================= --}}