Add merchant block documentation infrastructure

Infrastructure for generating and maintaining merchant block documentation:

GENERATOR ENHANCEMENTS:
- Enhanced @generate-merchant-block-docs.js with contextual guidance system
- Add source-code verification workflow for 100% accuracy
- Implement automated update detection tracking boilerplate changes
- Add enhanced property descriptions with WHEN/WHY context
- Add common configurations with real-world scenarios
- Add important notes extraction for requirements/warnings

ENRICHMENT SYSTEM:
- Create comprehensive enrichment system in _dropin-enrichments/merchant-blocks/
- Add descriptions.json with verified merchant-friendly descriptions
- Add complete workflow documentation (README, QUICK-REFERENCE)
- Add implementation documentation (ENHANCEMENTS-SUMMARY, etc.)

VERIFICATION TOOLS:
- Add @verify-block-configs-source-code.js for config validation
- Add @verify-merchant-block-descriptions.js for description checking
- Add @check-for-updates.js for boilerplate change detection

SIDEBAR & NAVIGATION:
- Organize commerce blocks into B2C and B2B categories
- Sort B2B blocks alphabetically for better navigation
- Make Quick start section collapsed by default

B2C BLOCK ENHANCEMENTS:
- Update all 33 existing B2C merchant blocks with enhanced descriptions
- Add section metadata tables with varied examples
- Add contextual property guidance
- Add important notes where applicable

CLEANUP & FIXES:
- Consolidate personalization/product-recommendations pages
- Fix broken links across documentation
- Move incomplete company-switcher docs to _drafts/
- Add targeted-block.mdx for Personalization feature

All changes verified against boilerplate b2b-suite-release1 branch.

Author: bdenham

SPLIT-VERIFICATION-CHECKLIST.md

@@ -0,0 +1,180 @@
+# Merchant Blocks Split Verification Checklist
+
+## Original Commit Details
+- **Branch**: `feature/merchant-block-enhancements`
+- **Backup Tag**: `merchant-blocks-backup-2025-12-07`
+- **Commit SHA**: `2562764b`
+- **Patch File**: `merchant-blocks-complete.patch`
+- **Total Files Changed**: 84 files
+- **Total Changes**: +7,098 insertions, -1,220 deletions
+
+## File Categories and Destinations
+
+### Infrastructure (→ releases/b2b-nov-release)
+**Scripts (8 files)**:
+- [ ] scripts/@check-for-updates.js (NEW)
+- [ ] scripts/@generate-merchant-block-docs.js (MODIFIED)
+- [ ] scripts/@generate-merchant-block-docs.js.bak (NEW)
+- [ ] scripts/@verify-block-configs-source-code.js (NEW)
+- [ ] scripts/@verify-merchant-block-descriptions.js (NEW)
+
+**Enrichments (13 files)**:
+- [ ] _dropin-enrichments/merchant-blocks/AUTOMATED-UPDATE-WORKFLOW.md (NEW)
+- [ ] _dropin-enrichments/merchant-blocks/ENHANCEMENTS-SUMMARY.md (NEW)
+- [ ] _dropin-enrichments/merchant-blocks/EXPANDED-ENHANCEMENTS-REPORT.md (NEW)
+- [ ] _dropin-enrichments/merchant-blocks/IMPLEMENTATION-SUMMARY.md (NEW)
+- [ ] _dropin-enrichments/merchant-blocks/INTEGRATION-CONFIRMATION.md (NEW)
+- [ ] _dropin-enrichments/merchant-blocks/MERCHANT-INFORMATION-GAPS.md (NEW)
+- [ ] _dropin-enrichments/merchant-blocks/QUICK-REFERENCE.md (NEW)
+- [ ] _dropin-enrichments/merchant-blocks/README.md (NEW)
+- [ ] _dropin-enrichments/merchant-blocks/SYSTEM-DIAGRAM.md (NEW)
+- [ ] _dropin-enrichments/merchant-blocks/descriptions.json (NEW)
+
+**Configuration & Sidebar (2 files)**:
+- [ ] astro.config.mjs (MODIFIED)
+- [ ] package.json (MODIFIED)
+
+**Link Fixes (3 files)**:
+- [ ] src/content/docs/get-started/architecture.mdx (MODIFIED)
+- [ ] src/content/docs/releases/changelog.mdx (MODIFIED)
+- [ ] src/content/docs/releases/index.mdx (MODIFIED)
+
+**Cleanup (3 files)**:
+- [ ] src/content/docs/merchants/commerce-blocks/personalization.mdx (DELETED)
+- [ ] src/content/docs/merchants/commerce-blocks/product-recommendations.mdx (DELETED)
+- [ ] src/content/docs/dropins-b2b/company-switcher/ (MOVED to _drafts/)
+
+**B2C Block Enhancements (33 files)**:
+- [ ] src/content/docs/merchants/blocks/commerce-account-header.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-account-sidebar.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-addresses.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-cart.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-checkout.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-confirm-account.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-create-account.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-create-password.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-create-return.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-customer-details.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-customer-information.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-forgot-password.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-gift-options.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-login.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-mini-cart.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-order-cost-summary.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-order-header.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-order-product-list.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-order-returns.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-order-status.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-orders-list.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-return-header.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-returns-list.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-search-order.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-shipping-status.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/commerce-wishlist.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/product-details.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/product-list-page.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/product-recommendations.mdx (MODIFIED)
+- [ ] src/content/docs/merchants/blocks/targeted-block.mdx (NEW)
+- [ ] src/content/docs/merchants/commerce-blocks/index.mdx (MODIFIED)
+
+**TOTAL INFRASTRUCTURE**: 57 files
+
+---
+
+### Company Management (→ feature/merchant-blocks-company-management)
+- [ ] src/content/docs/merchants/blocks/commerce-company-accept-invitation.mdx (NEW)
+- [ ] src/content/docs/merchants/blocks/commerce-company-create.mdx (NEW)
+- [ ] src/content/docs/merchants/blocks/commerce-company-credit.mdx (NEW)
+- [ ] src/content/docs/merchants/blocks/commerce-company-profile.mdx (NEW)
+- [ ] src/content/docs/merchants/blocks/commerce-company-roles-permissions.mdx (NEW)
+- [ ] src/content/docs/merchants/blocks/commerce-company-structure.mdx (NEW)
+- [ ] src/content/docs/merchants/blocks/commerce-company-users.mdx (NEW)
+
+**TOTAL**: 7 files
+
+---
+
+### Purchase Order (→ feature/merchant-blocks-purchase-order)
+- [ ] src/content/docs/merchants/blocks/commerce-b2b-po-approval-flow.mdx (NEW)
+- [ ] src/content/docs/merchants/blocks/commerce-b2b-po-approval-rule-details.mdx (NEW)
+- [ ] src/content/docs/merchants/blocks/commerce-b2b-po-approval-rule-form.mdx (NEW)
+- [ ] src/content/docs/merchants/blocks/commerce-b2b-po-approval-rules-list.mdx (NEW)
+- [ ] src/content/docs/merchants/blocks/commerce-b2b-po-checkout-success.mdx (NEW)
+- [ ] src/content/docs/merchants/blocks/commerce-b2b-po-comment-form.mdx (NEW)
+- [ ] src/content/docs/merchants/blocks/commerce-b2b-po-comments-list.mdx (NEW)
+- [ ] src/content/docs/merchants/blocks/commerce-b2b-po-company-purchase-orders.mdx (NEW)
+- [ ] src/content/docs/merchants/blocks/commerce-b2b-po-customer-purchase-orders.mdx (NEW)
+- [ ] src/content/docs/merchants/blocks/commerce-b2b-po-header.mdx (NEW)
+- [ ] src/content/docs/merchants/blocks/commerce-b2b-po-history-log.mdx (NEW)
+- [ ] src/content/docs/merchants/blocks/commerce-b2b-po-require-approval-purchase-orders.mdx (NEW)
+- [ ] src/content/docs/merchants/blocks/commerce-b2b-po-status.mdx (NEW)
+
+**TOTAL**: 13 files
+
+---
+
+### Quote Management (→ feature/merchant-blocks-quote-management)
+- [ ] src/content/docs/merchants/blocks/commerce-b2b-negotiable-quote-template.mdx (NEW)
+- [ ] src/content/docs/merchants/blocks/commerce-b2b-negotiable-quote.mdx (NEW)
+- [ ] src/content/docs/merchants/blocks/commerce-b2b-quote-checkout.mdx (NEW)
+
+**TOTAL**: 3 files
+
+---
+
+### Requisition List (→ feature/merchant-blocks-requisition-list)
+- [ ] src/content/docs/merchants/blocks/commerce-b2b-requisition-list-view.mdx (NEW)
+- [ ] src/content/docs/merchants/blocks/commerce-b2b-requisition-list.mdx (NEW)
+
+**TOTAL**: 2 files
+
+---
+
+### Checkout & Account (→ feature/merchant-blocks-checkout-account)
+- [ ] src/content/docs/merchants/blocks/commerce-checkout-success.mdx (NEW)
+- [ ] src/content/docs/merchants/blocks/commerce-account-nav.mdx (NEW)
+- [ ] src/content/docs/merchants/blocks/commerce-customer-company.mdx (NEW)
+
+**TOTAL**: 3 files
+
+---
+
+## Verification Steps
+
+### After Infrastructure Commit
+- [ ] Verify releases/b2b-nov-release has all 57 infrastructure files
+- [ ] Run build and confirm it passes
+- [ ] Check git log shows proper commit message
+- [ ] Verify total insertions: ~5,000+ lines
+
+### After Each Feature Branch
+- [ ] Verify feature branch has correct file count
+- [ ] Run build and confirm it passes
+- [ ] Check sidebar shows new blocks
+- [ ] Verify content matches backup tag
+
+### Final Verification
+- [ ] Sum all new branches = 84 total files
+- [ ] Compare line counts: should total +7,098 insertions
+- [ ] Test patch can be reapplied if needed: `git apply --check merchant-blocks-complete.patch`
+- [ ] All 5 PRs created and pointing to releases/b2b-nov-release
+- [ ] b2b-documentation preview branch has everything
+
+### Recovery Commands (if needed)
+```bash
+# Restore from tag
+git checkout merchant-blocks-backup-2025-12-07
+
+# Apply patch file
+git apply merchant-blocks-complete.patch
+
+# View backup
+git show merchant-blocks-backup-2025-12-07
+```
+
+## Sign-off
+- [ ] All files accounted for
+- [ ] All builds passing
+- [ ] All PRs created
+- [ ] Backup can be deleted
+

…switcher/containers/company-switcher.mdx …cher-wip/containers/company-switcher.mdxsrc/content/docs/dropins-b2b/company-switcher/containers/company-switcher.mdx renamed to _drafts/company-switcher-wip/containers/company-switcher.mdx src/content/docs/dropins-b2b/company-switcher/containers/company-switcher.mdx renamed to _drafts/company-switcher-wip/containers/company-switcher.mdx

@@ -25,7 +25,7 @@ Containers are pre-built UI components that combine functionality, state managem
 
 | Container | Description |
 | --------- | ----------- |
-| [CompanySwitcher](/dropins-b2b/company-switcher/containers/company-switcher/) | *****************************************************************. |
+| [CompanySwitcher](/dropins-b2b/company-switcher/containers/company-switcher/) | Dropdown selector that displays all companies the user belongs to and handles context switching between companies. |
 
 
 </TableWrapper>

…2b/company-switcher/containers/index.mdx …ompany-switcher-wip/containers/index.mdxsrc/content/docs/dropins-b2b/company-switcher/containers/index.mdx renamed to _drafts/company-switcher-wip/containers/index.mdx src/content/docs/dropins-b2b/company-switcher/containers/index.mdx renamed to _drafts/company-switcher-wip/containers/index.mdx

@@ -0,0 +1,126 @@
+---
+title: Company Switcher
+description: Enable seamless company context switching for users who belong to multiple companies in Adobe Commerce B2B storefronts.
+sidebar:
+  order: 1
+---
+
+import { Aside } from '@astrojs/starlight/components';
+import TableWrapper from '@components/TableWrapper.astro';
+
+The **Company Switcher** drop-in enables B2B users who belong to multiple companies to seamlessly switch between company contexts without logging out. When a user switches companies, all company-specific data (pricing, catalogs, orders, quotes, purchase orders) updates automatically to reflect the selected company's permissions and settings.
+
+<div style="background-color: var(--sl-color-blue-low); border-left: 4px solid var(--sl-color-blue); padding: 0.75rem 1rem; border-radius: 0.25rem; margin: 1rem 0;">
+<strong>Version: 1.0.5</strong>
+</div>
+
+## What it solves
+
+In B2B scenarios, a single user often belongs to multiple companies - for example, a purchasing manager who buys for multiple franchise locations, or a consultant working with several client companies. Without the Company Switcher, these users would need to:
+
+- Log out and log back in to access each company
+- Maintain separate accounts for each company
+- Manually track which account is associated with which company
+
+The Company Switcher eliminates these friction points by providing a simple dropdown selector that instantly switches the user's context between all their associated companies.
+
+## Key functionality
+
+The Company Switcher provides:
+
+- **One-click company switching** - Users select from a dropdown of all companies they belong to
+- **Automatic data isolation** - All displayed data (orders, quotes, catalogs, pricing) updates to match the selected company
+- **Session persistence** - The selected company remains active across page navigation and browser sessions
+- **Real-time updates** - Other drop-ins automatically refresh when company context changes via event system
+- **GraphQL header management** - Automatically injects correct company context headers into all Commerce API calls
+- **Permission enforcement** - User permissions update to match their role in the selected company
+
+## Who should use this
+
+The Company Switcher is essential for B2B storefronts where:
+
+- Users belong to multiple companies
+- Different companies have different catalogs, pricing, or approval workflows
+- Users need to place orders or manage quotes for multiple organizations
+- Company-specific data must remain strictly separated
+
+<Aside type="note">
+The Company Switcher requires Adobe Commerce B2B module and the Company feature to be enabled in your Commerce backend.
+</Aside>
+
+## Commerce integration
+
+The Company Switcher integrates with these Adobe Commerce B2B features:
+
+- **Company Accounts** - Retrieves list of companies associated with current user
+- **Company Structure** - Respects user roles and permissions within each company
+- **Shared Catalogs** - Displays company-specific product catalogs
+- **Custom Pricing** - Shows negotiated pricing for selected company
+- **Purchase Orders** - Enforces company-specific approval rules
+- **Negotiable Quotes** - Manages quotes within company context
+- **Requisition Lists** - Maintains separate lists per company
+
+## Supported features
+
+<TableWrapper nowrap={[0]}>
+
+| Feature | Status |
+|---------|--------|
+| Multi-company user access | Supported |
+| Company context switching | Supported |
+| Company context retrieval | Supported |
+| Automatic GraphQL header management | Supported |
+| Customer group header management | Supported |
+| Real-time context change events | Supported |
+| Data isolation across companies | Supported |
+| Permission-based access control | Supported |
+| Session persistence | Supported |
+| GraphQL API integration | Supported |
+
+</TableWrapper>
+
+## How it works
+
+1. **User logs in** - Commerce backend returns all companies the user belongs to
+2. **Switcher displays** - Dropdown shows list of available companies
+3. **User selects company** - Click changes active company context
+4. **Event fires** - `companyContext/changed` event notifies all drop-ins
+5. **Drop-ins refresh** - Cart, Orders, Quotes, and other drop-ins reload with new company data
+6. **Context persists** - Selected company remains active until user switches again
+
+## Getting started
+
+The topics in this section will help you understand how to customize and use the Company Switcher effectively within your storefront.
+
+### [Quick Start](/dropins-b2b/company-switcher/quick-start/)
+
+Provides quick reference information and getting started guide for the Company Switcher drop-in. This topic covers package details, import paths, and basic usage examples to help you integrate Company Switcher functionality into your site.
+
+### [Initialization](/dropins-b2b/company-switcher/initialization/)
+
+Configure the Company Switcher drop-in with endpoint URLs, authentication settings, and fetch options required for Commerce integration.
+
+### [Containers](/dropins-b2b/company-switcher/containers/)
+
+The Company Switcher provides the CompanySwitcher container - a dropdown selector that displays available companies and handles context switching.
+
+### [Functions](/dropins-b2b/company-switcher/functions/)
+
+API functions enable retrieving the user's companies, getting the current company context, and programmatically switching between companies.
+
+### [Events](/dropins-b2b/company-switcher/events/)
+
+The Company Switcher emits `companyContext/changed` events when users switch companies, allowing other drop-ins to refresh their data automatically.
+
+### [Slots](/dropins-b2b/company-switcher/slots/)
+
+Customize the company switcher UI by replacing the dropdown selector, company list items, or empty state with your own components.
+
+### [Dictionary](/dropins-b2b/company-switcher/dictionary/)
+
+Internationalization keys for labels, placeholders, and messages displayed in the company switcher interface.
+
+### [Styles](/dropins-b2b/company-switcher/styles/)
+
+Design tokens for customizing the visual appearance of the company switcher dropdown, including colors, spacing, and typography.
+