bilingual-jekyll-resume-theme 1.0.0 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 00d980490bbad955afa894d864e4379a65a6f39f371d97a6db9d1808785ccaed
-  data.tar.gz: b5c302a20cb5d88382151575fdb376b870969a4067d401da907cb2608f76ed3b
+  metadata.gz: b8eb8d16040a681b4a06c1d6eba60b957aee132434d038ce56b53415e74774f9
+  data.tar.gz: e7cb05ea3e65d241cab36fb5734062a13af1931e8cabe736ee749a108bf8655b
 SHA512:
-  metadata.gz: 35046ae1202cd6e65a03d90313cb6dbf2ebecff360f4d1f4183a413b02b7b0da17df223b8066133ea90f3e44d5596dfb9ea2f6834ab981afa73d2165c53f480d
-  data.tar.gz: ab8eb568a6ca00d51c040c2282efdfddb2dc3a29634f706e6b7d9cf96e08f49b069ceddb9c83d11f2582a5fcea9ca2d978674521aa866c9ed14281630c196135
+  metadata.gz: c13e0bd5ff9f935997e3977abe7e7e8b257ace6499f0fdc098f8955dc1999ffd36103518e5143c9d3357763f511cb9e5448e8fbb8cc41bc9c7be9ee9493cd432
+  data.tar.gz: '0069c903af37bd0e31ffa14ac4e5901d4f5c19d4ae3ffca36d41dd647196f931bd5d87593b65a158fd25017f75704cf7750f4803a6887e6a41665e6ed3ddda3a'

data/CHANGELOG.md

@@ -4,6 +4,28 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+## [1.0.2] - 2026-09-25
+
+### Changed
+* Update submodule to latest commit ([`f1779be`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/f1779be39697ccea22e9185b0bf57278e8a29707))
+
+* Extract Sherlock Holmes demo to submodule and relocate sample config ([`bfd9e83`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/bfd9e8374753885fece3098cfd00f40606e5d26b))
+
+* Archive completed features 3.2 and 3.3 and streamline audit log ([`39ae7f3`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/39ae7f346dff45828e74fafbfb445420b0d699dd))
+
+
+### Fixed
+* Render language switcher on error pages ([`8e942f9`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/8e942f9fccc23a2c6e097938992c3f23f446bf97))
+
+* Register theme gem in jekyll_plugins group; bump demo submodule ([`392c192`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/392c19209a42f629aba5e1c1e9a2a964832bf0a9))
+
+## [1.0.1] - 2026-09-24
+
+### Changed
+* Replace language-switcher button row with a dropdown ([`f37c6f6`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/f37c6f6b410f5de4841ed36115db60408c805293))
+
+* Pin language-switcher/dark-mode-toggle to fixed corners ([`305408c`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/305408c8885c194ad71d88831179b287d4a10ec3))
+
 ## [1.0.0] - 2026-09-24
 
 ### Added
@@ -350,6 +372,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 * Initial commit (New Theme Template) ([`00af662`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/00af6628dfec7aefe0ef7d7083bf98c9713a5ffd))
 
+[1.0.2]: https://github.com/kmutahar/bilingual-jekyll-resume-theme/compare/v1.0.1...v1.0.2
+[1.0.1]: https://github.com/kmutahar/bilingual-jekyll-resume-theme/compare/v1.0.0...v1.0.1
 [1.0.0]: https://github.com/kmutahar/bilingual-jekyll-resume-theme/compare/v0.9.0...v1.0.0
 [0.9.0]: https://github.com/kmutahar/bilingual-jekyll-resume-theme/compare/v0.8.0...v0.9.0
 [0.8.0]: https://github.com/kmutahar/bilingual-jekyll-resume-theme/compare/v0.7.0...v0.8.0

data/README.md

@@ -42,9 +42,9 @@ bundle install
 
 ### Basic Setup
 
-1. **Copy sample configuration**: Use `docs/_data/_config.sample.yml` as a starting point for your `_config.yml`. Keep a `languages.<lang>` entry for each language you publish and delete the rest.
+1. **Copy sample configuration**: Use `_config.sample.yml` at the repository root as a starting point for your `_config.yml`. Keep a `languages.<lang>` entry for each language you publish and delete the rest.
 
-2. **Copy sample data files**: Copy each language folder you need from `docs/_data/` (`en`, `ar`, `es`, `fr`, `de`, `ur`) to your site's `_data/`. Each holds 13 files, including `header.yml` for the intro paragraph.
+2. **Copy sample data files**: Copy each language folder you need from `demo/_data/` (`en`, `ar`, `es`, `fr`, `de`, `ur`) to your site's `_data/`. Each holds 13 files, including `header.yml` for the intro paragraph.
 
 3. **Create resume pages**: One page per language, all using the `resume` layout:
 ```yaml
@@ -130,7 +130,7 @@ See the [Configuration Guide](docs/CONFIG_GUIDE.md#3-languages) for every per-la
 
 ### Sample Files
 
-`docs/_data/{en,ar,es,fr,de,ur}/` hold a complete Sherlock Holmes demo resume in six languages, covering all 12 section types. Copy the folders you need to your site.
+`demo/_data/{en,ar,es,fr,de,ur}/` hold a complete Sherlock Holmes demo resume in six languages, covering all 12 section types. Copy the folders you need to your site.
 
 ### Locales
 
@@ -144,18 +144,18 @@ To develop this theme locally:
 # Install dependencies
 bundle install
 
-# Serve the six-language demo (sample config + demo overlay pointing data_dir at docs/_data)
-bundle exec jekyll serve --config docs/_data/_config.sample.yml,docs/_data/_config.demo.yml
+# Serve the six-language demo from the demo submodule
+bundle exec jekyll serve --source demo --destination _site
 
 # Build static output
-bundle exec jekyll build --config docs/_data/_config.sample.yml,docs/_data/_config.demo.yml
+bundle exec jekyll build --source demo --destination _site
 
 # Validate resume data schemas and parity (CLI or Rake)
-./bin/validate-resume docs/_data
+./bin/validate-resume demo/_data
 bundle exec rake validate
 
 # Check that the theme's own templates only reference real data keys (CLI or Rake)
-./bin/check-data-keys docs/_data
+./bin/check-data-keys demo/_data
 bundle exec rake check_data_keys
 
 # Validators, RuboCop, and tests together

data/{docs/_data/_config.sample.yml → _config.sample.yml}

@@ -274,6 +274,11 @@ analytics:
 # ==============================================================================
 # Required plugins (bundled as theme runtime dependencies)
 plugins:
+  # Belt-and-suspenders: Jekyll auto-requires gems listed here (site.gems) regardless
+  # of Bundler group, guarding against a Gemfile that forgets to put the theme gem in
+  # the `:jekyll_plugins` group — without that, the build-time resume validator and
+  # HTTP error page generator silently never run.
+  - bilingual-jekyll-resume-theme
   - jekyll-feed
   - jekyll-seo-tag
   - jekyll-sitemap

data/_includes/language-switcher.html

@@ -1,61 +1,72 @@
 {%- comment -%}
-Include: Reusable Multilingual Language Switcher Component (Feature 1.2)
-- Purpose: Floating list of links to every other configured language's resume.
-- Positioning: Fixed top-left (LTR layouts) / top-right (RTL layouts); mirrors the dark-mode toggle.
+Include: Reusable Multilingual Language Switcher Component (Feature 1.2; dropdown redesign Feature 2.12)
+- Purpose: Floating dropdown listing links to every other configured language's resume.
+- Positioning: Fixed top-left viewport corner (see _sass/_layout.scss).
+- Markup: Native <details>/<summary> disclosure — zero JavaScript, full keyboard support
+  (Enter/Space toggles the panel open and closed; browsers do not natively close it on Esc
+  or outside click, matching plain <details> behavior everywhere else). Scales to any number
+  of configured languages without growing a row of buttons.
 - Link Resolution (two-tier), per target language:
     1. Discovers the counterpart page via page.t_id + lang match (site.pages).
     2. Falls back to languages.<lang>.url from _config.yml.
-- Accessibility: Each link is labelled with its own locale's ui.language_name; the group
-  wrapper is labelled with the current page's own locale ui.language_switcher string.
+- Accessibility: The trigger's visible text is the current locale's ui.language_switcher
+  string. The panel is a <nav> landmark labelled with the same string. Each link is labelled
+  with its own locale's ui.language_name.
 - Print Safety: Decorated with class="no-print" — hidden on printed resume sheets.
 - Toggle: Disabled via site.resume_language_switcher: false in _config.yml.
 {%- endcomment -%}
 
-{% if site.resume_language_switcher != false and page.language_switcher != false and page.layout != 'error' %}
+{% if site.resume_language_switcher != false and page.language_switcher != false %}
   {%- assign current_lang = page.lang | default: site.default_lang | default: 'en' -%}
   {%- assign current_locale = site.data.locales[current_lang] | default: site.data.locales[site.default_lang] -%}
 
-  <div class="language-switcher no-print" role="navigation" aria-label="{{ current_locale.ui.language_switcher }}">
-    {%- comment -%}
-    IMPORTANT: {% include %} shares Liquid variable scope with its caller (resume.html),
-    so every variable assigned in this loop body must use a switch_-prefixed name that
-    cannot collide with resume.html's own lang/locale/lang_cfg - otherwise the last loop
-    iteration's values would silently leak out and corrupt the rest of the caller's render.
-    {%- endcomment -%}
-    {% for switch_entry in site.languages %}
-      {%- assign switch_lang = switch_entry[0] -%}
-      {%- assign switch_lang_cfg = switch_entry[1] -%}
-      {%- if switch_lang != current_lang -%}
-        {%- assign switch_locale = site.data.locales[switch_lang] -%}
+  <details class="language-switcher no-print">
+    <summary class="language-switcher-trigger">
+      <span class="lang-icon" aria-hidden="true">🌐</span>
+      <span class="language-switcher-label">{{ current_locale.ui.language_switcher }}</span>
+    </summary>
+    <nav class="language-switcher-panel" aria-label="{{ current_locale.ui.language_switcher }}">
+      {%- comment -%}
+      IMPORTANT: {% include %} shares Liquid variable scope with its caller (resume.html),
+      so every variable assigned in this loop body must use a switch_-prefixed name that
+      cannot collide with resume.html's own lang/locale/lang_cfg - otherwise the last loop
+      iteration's values would silently leak out and corrupt the rest of the caller's render.
+      {%- endcomment -%}
+      {% for switch_entry in site.languages %}
+        {%- assign switch_lang = switch_entry[0] -%}
+        {%- assign switch_lang_cfg = switch_entry[1] -%}
+        {%- if switch_lang != current_lang -%}
+          {%- assign switch_locale = site.data.locales[switch_lang] -%}
 
-        {%- comment -%}
-        TIER 1: Auto-discover counterpart page by matching page.t_id + target language.
-        Both pages must have the same t_id value in their front matter (e.g., t_id: cv-main).
-        {%- endcomment -%}
-        {%- assign switch_url = nil -%}
-        {%- if page.t_id -%}
-          {%- assign switch_matched_page = site.pages | where: "t_id", page.t_id | where: "lang", switch_lang | first -%}
-          {%- if switch_matched_page -%}
-            {%- assign switch_url = switch_matched_page.url | relative_url -%}
+          {%- comment -%}
+          TIER 1: Auto-discover counterpart page by matching page.t_id + target language.
+          Both pages must have the same t_id value in their front matter (e.g., t_id: cv-main).
+          {%- endcomment -%}
+          {%- assign switch_url = nil -%}
+          {%- if page.t_id -%}
+            {%- assign switch_matched_page = site.pages | where: "t_id", page.t_id | where: "lang", switch_lang | first -%}
+            {%- if switch_matched_page -%}
+              {%- assign switch_url = switch_matched_page.url | relative_url -%}
+            {%- endif -%}
           {%- endif -%}
-        {%- endif -%}
 
-        {%- comment -%}
-        TIER 2: Fall back to languages.<lang>.url from _config.yml.
-        {%- endcomment -%}
-        {%- unless switch_url -%}
-          {%- assign switch_url = switch_lang_cfg.url | relative_url -%}
-        {%- endunless -%}
+          {%- comment -%}
+          TIER 2: Fall back to languages.<lang>.url from _config.yml.
+          {%- endcomment -%}
+          {%- unless switch_url -%}
+            {%- assign switch_url = switch_lang_cfg.url | relative_url -%}
+          {%- endunless -%}
 
-        <a href="{{ switch_url }}"
-           class="lang-switch-btn"
-           aria-label="{{ switch_locale.ui.language_name }}"
-           title="{{ switch_locale.ui.language_name }}"
-           dir="{{ switch_locale.direction }}">
-          <span class="lang-icon" aria-hidden="true">🌐</span>
-          <span class="lang-label-target">{{ switch_locale.ui.language_name }}</span>
-        </a>
-      {%- endif -%}
-    {% endfor %}
-  </div>
+          <a href="{{ switch_url }}"
+             class="lang-switch-btn"
+             aria-label="{{ switch_locale.ui.language_name }}"
+             title="{{ switch_locale.ui.language_name }}"
+             dir="{{ switch_locale.direction }}">
+            <span class="lang-icon" aria-hidden="true">🌐</span>
+            <span class="lang-label-target">{{ switch_locale.ui.language_name }}</span>
+          </a>
+        {%- endif -%}
+      {% endfor %}
+    </nav>
+  </details>
 {% endif %}

data/_sass/_dark-mode.scss

@@ -385,11 +385,3 @@ html.light {
   }
 }
 
-// RTL layout positioning
-// Repositions the toggle button to the top-left corner in Arabic layouts.
-html[dir="rtl"] {
-  .dark-mode-toggle {
-    right: auto;
-    left: 1.25rem;
-  }
-}

data/_sass/_layout.scss

@@ -84,12 +84,12 @@
 }
 
 // --------------------------------------------------------------------------
-// Language Switcher Component (Feature 1.2)
+// Language Switcher Component (Feature 1.2; dropdown redesign Feature 2.12)
 // --------------------------------------------------------------------------
-// Floating pill button fixed to the top-left viewport corner in LTR layouts.
-// RTL coordinate flip is handled in _resume-rtl.scss for resume pages and
-// the html[dir="rtl"] block below for other layouts.
-// Mirrors the visual language of .dark-mode-toggle (same shadow and transition).
+// <details>/<summary> disclosure fixed to the top-left viewport corner.
+// The trigger (.language-switcher-trigger) mirrors the visual language of
+// .dark-mode-toggle (same pill shape, shadow, and transition); the opened
+// panel (.language-switcher-panel) lists every other configured language.
 // --------------------------------------------------------------------------
 
 .language-switcher {
@@ -98,7 +98,9 @@
   left: 1.25rem;
   z-index: 1000;
 
-  .lang-switch-btn {
+  // <summary> gets a default disclosure marker in most browsers; suppress it since the
+  // trigger already renders its own icon + label.
+  .language-switcher-trigger {
     display: inline-flex;
     align-items: center;
     justify-content: center;
@@ -109,12 +111,18 @@
     color: var(--text-color, #333333);
     border: 1px solid var(--toggle-btn-border, #e0e0e0);
     border-radius: 9999px;
+    cursor: pointer;
+    list-style: none;
     text-decoration: none;
     font-size: 0.85rem;
     font-weight: 700;
     box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
     transition: background-color 0.2s ease, border-color 0.2s ease, transform 0.2s ease;
 
+    &::-webkit-details-marker {
+      display: none;
+    }
+
     &:hover {
       background-color: var(--toggle-btn-hover-bg, #f5f5f5);
       border-color: var(--accent-color, #007acc);
@@ -127,6 +135,45 @@
     }
   }
 
+  &[open] .language-switcher-trigger {
+    border-color: var(--accent-color, #007acc);
+  }
+
+  .language-switcher-panel {
+    display: flex;
+    flex-direction: column;
+    gap: 0.25rem;
+    min-width: 10rem;
+    margin-top: 0.5rem;
+    padding: 0.5rem;
+    background: var(--bg-color, #ffffff);
+    border: 1px solid var(--toggle-btn-border, #e0e0e0);
+    border-radius: 0.75rem;
+    box-shadow: 0 4px 16px rgba(0, 0, 0, 0.12);
+  }
+
+  .lang-switch-btn {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.5rem;
+    padding: 0.5rem 0.75rem;
+    color: var(--text-color, #333333);
+    text-decoration: none;
+    font-size: 0.85rem;
+    font-weight: 600;
+    border-radius: 0.5rem;
+    transition: background-color 0.2s ease;
+
+    &:hover {
+      background-color: var(--toggle-btn-hover-bg, #f5f5f5);
+    }
+
+    &:focus-visible {
+      outline: 2px solid var(--accent-color, #007acc);
+      outline-offset: 2px;
+    }
+  }
+
   .lang-icon {
     font-size: 1rem;
     line-height: 1;
@@ -137,14 +184,6 @@
   }
 }
 
-// RTL: mirror switcher to top-right (dark-mode toggle auto-mirrors to top-left)
-html[dir="rtl"] {
-  .language-switcher {
-    left: auto;
-    right: 1.25rem;
-  }
-}
-
 // Print: explicit safety net — .no-print on the element already handles most cases
 @media print {
   .language-switcher {

data/_sass/_resume-rtl.scss

@@ -91,18 +91,4 @@ html[dir="rtl"] {
   .page-footer {
     text-align: center; // keep centered
   }
-
-  // Dark mode toggle positioning for RTL
-  // Mirrors the floating theme switcher from top-right to top-left (left: 1.25rem; right: auto)
-  // to avoid colliding with right-aligned Arabic header titles.
-  .dark-mode-toggle {
-    right: auto;
-    left: 1.25rem;
-  }
-
-  // Language switcher positioning for RTL
-  .language-switcher {
-    left: auto;
-    right: 1.25rem;
-  }
 }

data/bin/check-data-keys

@@ -20,7 +20,7 @@ parser = OptionParser.new do |opts|
   opts.separator ""
   opts.separator "Options:"
 
-  opts.on("-d", "--dir DIR", "Path to data directory (default: _data or docs/_data)") do |d|
+  opts.on("-d", "--dir DIR", "Path to data directory (default: _data or demo/_data)") do |d|
     options[:data_dir] = d
   end
 
@@ -51,9 +51,10 @@ parser.parse!
 # Positional argument takes precedence over -d, or fall back to standard data dirs
 data_dir = ARGV[0] || options[:data_dir]
 if data_dir.nil?
-  # Prefer a directory that holds at least one language folder (a site's _data, else the theme's docs sample).
-  data_dir = %w[_data docs/_data].find { |dir| BilingualJekyllResumeTheme::TemplateKeyChecker.new(dir).discover_languages.any? } ||
-             "docs/_data"
+  # Prefer a directory that holds at least one language folder (a site's _data, else the theme's demo).
+  data_dir = %w[_data demo/_data].find do |dir|
+    BilingualJekyllResumeTheme::TemplateKeyChecker.new(dir).discover_languages.any?
+  end || "demo/_data"
 end
 
 checker = BilingualJekyllResumeTheme::TemplateKeyChecker.new(data_dir, config_path: options[:config_path])

data/bin/validate-resume

@@ -22,7 +22,7 @@ parser = OptionParser.new do |opts|
   opts.separator ""
   opts.separator "Options:"
 
-  opts.on("-d", "--dir DIR", "Path to data directory (default: _data or docs/_data)") do |d|
+  opts.on("-d", "--dir DIR", "Path to data directory (default: _data or demo/_data)") do |d|
     options[:data_dir] = d
   end
 
@@ -66,9 +66,10 @@ parser.parse!
 # Positional argument takes precedence over -d, or fall back to standard data dirs
 data_dir = ARGV[0] || options[:data_dir]
 if data_dir.nil?
-  # Prefer a directory that holds at least one language folder (a site's _data, else the theme's docs sample).
-  data_dir = %w[_data docs/_data].find { |dir| BilingualJekyllResumeTheme::ResumeValidator.new(dir).discover_languages.any? } ||
-             "_data"
+  # Prefer a directory that holds at least one language folder (a site's _data, else the theme's demo).
+  data_dir = %w[_data demo/_data].find do |dir|
+    BilingualJekyllResumeTheme::ResumeValidator.new(dir).discover_languages.any?
+  end || "_data"
 end
 
 validator = BilingualJekyllResumeTheme::ResumeValidator.new(

data/docs/ACCESSIBILITY_GUIDE.md

@@ -37,7 +37,7 @@ All theme layouts define explicit ARIA landmark roles alongside semantic HTML5 e
 | `<header class="page-header">` | `role="banner"` | Page Header | Houses candidate name, title, avatar, and contact bar |
 | `<main class="main-content">` | `role="main"` | `id="main-content"` `tabindex="-1"` | Primary content container target of skip-to-content links |
 | `<footer class="page-footer">` | `role="contentinfo"` | Page Footer | Generation timestamp, copyright, and permalink |
-| `<nav class="language-switcher">`| `role="navigation"` | Language Switcher | Floating bilingual language selector |
+| `<details class="language-switcher">` → `<nav class="language-switcher-panel">` | native disclosure + `role="navigation"` (implicit on `<nav>`) | Language Switcher | Floating dropdown language selector, zero JavaScript |
 | `<form class="error-search">` | `role="search"` | Search Form | Search interface on error pages |
 
 ---
@@ -127,7 +127,7 @@ Run the automated build and verify accessibility attributes:
 
 ```bash
 # Build static site
-bundle exec jekyll build --config docs/_data/_config.sample.yml
+bundle exec jekyll build --source demo --destination _site
 
 # Verify skip link presence
 grep -q 'class="skip-link' _site/index.html && echo "Skip link verified."

data/docs/COMPLETED_AUDIT.md

@@ -1,47 +1,20 @@
 # Completed Historical Remediation & Engineering Audit Log
 
 **Project:** `bilingual-jekyll-resume-theme`  
-**Current Release:** `v1.0.0` (Audited Baseline: `v0.7.0`)  
+**Current Release:** `v1.0.1` (Audited Baseline: `v0.7.0`)  
 **Milestone:** M1 Completed Audit Archival  
 **Audit Date:** September 2026  
 **Master Active Roadmap:** [`/FEATURE_ROADMAP.md`](../FEATURE_ROADMAP.md)  
-**Status:** Permanent Historical Record. 18 foundation items (through `v0.7.0`), later completed features, and the four v1.0.0 deliveries (Section 5), all completed and verified
+**Status:** Permanent Historical Record. All foundation items, completed features, and release deliverables are verified in git history and documented in this audit archive.
 
 ---
 
 ## 1. Executive Summary & Audit Overview
 
-This document provides the definitive, permanent engineering record of all **18 bug fixes, security hardenings, data resilience enhancements, accessibility upgrades, and architectural feature deliverables** completed across the `bilingual-jekyll-resume-theme` repository up through release `v0.7.0`. While the current project release has advanced to `v1.0.0`, this document is preserved as the immutable historical record of the 18 foundation remediations.
+This document provides the definitive, permanent engineering record of all **bug fixes, security hardenings, data resilience enhancements, accessibility upgrades, and architectural feature deliverables** completed across the `bilingual-jekyll-resume-theme` repository. It serves as the immutable historical record of foundation remediations and completed features across releases.
 
 To maintain strict hygiene in the active roadmap and eliminate document drift across planning cycles, completed items have been permanently retired from the active roadmap phases and archived in this audit document. For the active, forward-looking engineering roadmap detailing upcoming uncompleted features across Priorities 1 through 4, refer to the authoritative master roadmap at [`/FEATURE_ROADMAP.md`](../FEATURE_ROADMAP.md).
 
-### 1.1 Remediation Metrics & Completion Summary
-
-| Scope Phase | Total Audited | Completed & Verified | Completion Rate | Releases Delivered |
-|---|---|---|---|---|
-| **Priority 0 (Immediate Stability, Correctness & Security)** | 16 | 16 | **100%** | `v0.4.0`, `v0.7.0` |
-| **Priority 1 (Visual Enhancements & Quick Wins)** | 2 (P1.2, P1.4) | 2 | **100%** | `v0.7.0`, `v0.8.0` |
-| **Priority 2 (Core Functional & Architecture)** | 3 (P2.4, P2.7, #216) | 3 | **100%** | `v0.7.0`, `v0.8.0` |
-| **Total Completed Engineering Deliverables** | **21** | **21** | **100%** | `v0.4.0` – `v0.8.0` |
-| **v1.0.0 Roadmap Features (1.7, 2.8, 4.1, 4.6)** | 4 | 4 | **100%** | `v1.0.0` (on `feature/extended-multilingual-v1.0.0`, unreleased) |
-
-### 1.2 Categorical Remediation Distribution
-
-```
-+-------------------------------------------------------------+
-| Category Distribution of 21 Completed Items                 |
-+-------------------------------------------------------------+
-| Bug / Logic Fixes:              4 items (P0.1, P0.2, P0.3, P0.9)
-| Security & HTML Correctness:    2 items (P0.5, P0.7)
-| Data Resilience & Optionality:  3 items (P0.13, P0.14, P0.15)
-| Accessibility (WCAG 2.1/2.2):   3 items (P0.10, P1.4, P2.7)
-| RTL & Internationalization:     4 items (P0.8, P0.11, P1.4, P1.2)
-| Architecture & Navigation:      4 items (P0.4, P0.16, P2.4, #216)
-| Asset Management & 404s:        1 item  (P0.6)
-| Governance & Versioning:        1 item  (P0.12)
-+-------------------------------------------------------------+
-```
-
 ---
 
 ## 2. Master Completed Remediation Matrix
@@ -73,6 +46,10 @@ To maintain strict hygiene in the active roadmap and eliminate document drift ac
 | **F2.8** | Header Contact Icon and Text Alignment in Arabic Layout | Issue [#217](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/217) | RTL / a11y | `v1.0.0` | `315356972b326d9fcd5ff58e0208da9a2140116f` | `_layouts/resume-ar.html` (carried into `_layouts/resume.html`) |
 | **F4.1** | Extended Multilingual Support (EN, AR, ES, FR, DE, UR) | Issue [#15](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/15) | i18n / Architecture | `v1.0.0` | `54b40a4`, `3e840a7`, `5058532`, `c37df29`, `da2cd74`, `3f467fe`, `5188e96` | `_data/locales/*.yml`, `_layouts/resume.html`, `_includes/resume-section.html`, `_includes/date-formatter.html`, `_sass/_resume-ltr.scss`, `assets/css/cv-{ltr,rtl}.scss`, every locale consumer, `docs/_data/`, `docs/demo/` |
 | **F4.6** | Deprecation Retirement & Legacy Fallbacks Cleanup | Issue [#214](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/214) | Cleanup / Config | `v1.0.0` | `2c88adf75c915cb682634ac0c98a2211caedb101` | `_includes/avatar.html`, `_includes/analytics-head.html`, `_includes/resume-section.html` |
+| **F3.2** | Automated CI/CD Build & Verification Pipeline | Issue [#206](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/206) | CI/CD | `v1.0.0` | `3be935f` | `.github/workflows/ci.yml`, `.github/workflows/lint.yml`, `README.md` |
+| **F3.3** | YAML Resume Data Validator & Schema Linter | Issue [#13](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/13) | Tooling / Quality | `v1.0.0` | `3be935f` | `bin/validate-resume`, `lib/bilingual-jekyll-resume-theme/resume_validator.rb`, `_plugins/resume_validator.rb`, `docs/VALIDATION_GUIDE.md`, `test/test_resume_validator.rb` |
+| **F2.11** | Pin Language-Switcher/Dark-Mode-Toggle to Fixed Corners (Remove RTL Mirror) | Issue [#227](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/227) | Layout / RTL | `v1.0.1` | `305408c` | `_sass/_layout.scss`, `_sass/_dark-mode.scss`, `_sass/_resume-rtl.scss`, `test/test_language_switcher.rb`, `docs/INCLUDES_GUIDE.md` |
+| **F2.12** | Dropdown Language Switcher (Replace Per-Language Button Row) | Issue [#228](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/228) | i18n / a11y | `v1.0.1` | `f37c6f6` | `_includes/language-switcher.html`, `_sass/_layout.scss`, `test/test_language_switcher.rb`, `docs/INCLUDES_GUIDE.md`, `docs/ACCESSIBILITY_GUIDE.md`, `docs/PROJECT_OVERVIEW.md` |
 
 ---
 
@@ -603,9 +580,9 @@ To maintain strict hygiene in the active roadmap and eliminate document drift ac
 
 ---
 
-## 5. v1.0.0 Delivered Features (1.7, 2.8, 4.1, 4.6)
+## 5. v1.0.0 Delivered Features (1.7, 2.8, 3.2, 3.3, 4.1, 4.6)
 
-The v1.0.0 multilingual release was executed on branch `feature/extended-multilingual-v1.0.0` from an implementation plan that has since been retired; this section, [`../CHANGELOG.md`](../CHANGELOG.md), and [`MULTILINGUAL_GUIDE.md`](MULTILINGUAL_GUIDE.md) are its permanent record. v1.0.0 is a hard break with no compatibility aliases; the full removed-to-replacement table is in [`MULTILINGUAL_GUIDE.md`](MULTILINGUAL_GUIDE.md#breaking-changes--migration-v090-to-v100). Features 3.2 (CI pipeline, #206) and 3.3 (validator, #13) were implemented on the same branch but stay in the active roadmap until their closure checks pass.
+The v1.0.0 multilingual release was executed on branch `feature/extended-multilingual-v1.0.0` from an implementation plan that has since been retired; this section, [`../CHANGELOG.md`](../CHANGELOG.md), and [`MULTILINGUAL_GUIDE.md`](MULTILINGUAL_GUIDE.md) are its permanent record. v1.0.0 is a hard break with no compatibility aliases; the full removed-to-replacement table is in [`MULTILINGUAL_GUIDE.md`](MULTILINGUAL_GUIDE.md#breaking-changes--migration-v090-to-v100). All deliverables, including the CI/CD pipeline (#206) and the validator (#13), are verified live and permanently archived here.
 
 ### 5.1 Feature 1.7: Native Email Support in Social Links Include (#215)
 
@@ -638,35 +615,65 @@ The v1.0.0 multilingual release was executed on branch `feature/extended-multili
 - **Delivered:** Removed the `site.avatar` fallback from `_includes/avatar.html`, the `analytics.ga` Universal Analytics branch from `_includes/analytics-head.html`, and the singular `resume_section.recognition` fallback (dropped in `_includes/resume-section.html`). Confirmed `site.resume_dark_mode` and `site.resume_header_intro` have no remaining references.
 - **Commit:** `2c88adf75c915cb682634ac0c98a2211caedb101` (`chore(cleanup): purge deprecated site.avatar, analytics.ga, and resume_dark_mode fallbacks`).
 
+### 5.5 Feature 3.2: Automated CI/CD Build & Verification Pipeline (#206)
+
+- **Problem:** Absence of automated continuous integration allowed invalid front-matter, broken YAML data, or gem specification packaging defects to reach consumers unnoticed.
+- **Delivered:** Configured `.github/workflows/ci.yml` matrix testing across modern Ruby releases (3.3, 3.4, 4.0), strict Jekyll demo build, RuboCop, unit test execution, and gem packaging verification. Added `.github/workflows/lint.yml` and CI status badge to `README.md`.
+- **Commit:** `3be935f` (carried in from `feature/resume-validator-ecosystem`, verified live on PR #220).
+
+### 5.6 Feature 3.3: YAML Resume Data Validator & Schema Linter (#13)
+
+- **Problem:** Non-technical user errors in YAML syntax (missing fields, wrong data types, malformed dates, cross-locale file asymmetries) resulted in cryptic Liquid build failures.
+- **Delivered:** Standalone CLI tool `bin/validate-resume` and core engine `lib/bilingual-jekyll-resume-theme/resume_validator.rb` validating all 13 standard resume files, date formats, active flags, and multi-locale parity. Includes build-time Jekyll plugin `_plugins/resume_validator.rb`, Rake task `rake validate`, comprehensive guide `docs/VALIDATION_GUIDE.md`, and full Minitest suite `test/test_resume_validator.rb`.
+- **Commit:** `3be935f` (carried in from `feature/resume-validator-ecosystem`, verified live on PR #220).
+
+---
+
+## 6. v1.0.1 Delivered Features (2.11, 2.12)
+
+The v1.0.1 maintenance release addressed two visual widget improvements scoped together before v1.0.0. Both were verified against live LTR and RTL builds and merged directly into `master`.
+
+### 6.1 Feature 2.11: Pin Language-Switcher/Dark-Mode-Toggle to Fixed Corners (#227)
+
+- **Problem:** `.language-switcher` and `.dark-mode-toggle` previously swapped top-left/top-right corners based on `locale.direction`, with mirror rules duplicated across `_sass/_layout.scss`, `_sass/_dark-mode.scss`, and `_sass/_resume-rtl.scss`.
+- **Delivered:** Pinned `.language-switcher` fixed to top-left and `.dark-mode-toggle` fixed to top-right across all locales (LTR and RTL), removing all three RTL override locations. Verified against live `ar/cv/` and `ur/cv/` builds at desktop and mobile widths confirming no collision with right-aligned Arabic header titles.
+- **Commit:** `305408c8885c194ad71d88831179b287d4a10ec3` (`feat(layout): pin language-switcher/dark-mode-toggle to fixed corners (Closes #227)`).
+
+### 6.2 Feature 2.12: Dropdown Language Switcher (#228)
+
+- **Problem:** `_includes/language-switcher.html` rendered one button per configured language in a flat row, taking excessive horizontal space and wrapping across multiple rows on mobile screens as locales increased.
+- **Delivered:** Replaced the button row with a semantic `<details>/<summary>` disclosure element wrapping a `<nav>` landmark of per-language links with zero new JavaScript. Preserves full no-JS graceful degradation, keyboard navigation (Tab, Enter/Space, Esc), and accessible screen-reader states.
+- **Commit:** `f37c6f6b410f5de4841ed36115db60408c805293` (`feat(i18n): replace language-switcher button row with a dropdown (Closes #228)`).
+
 ---
 
-## 6. Verification Protocols & Independent Audit Attestation
+## 7. Verification Protocols & Independent Audit Attestation
 
 The following independent verification commands confirm the integrity of the codebase following the completion of all 18 remediation tasks:
 
-### 6.1 RubyGem Packaging Verification
+### 7.1 RubyGem Packaging Verification
 ```bash
 gem build bilingual-jekyll-resume-theme.gemspec
 ```
 *Passing Result:* Successfully built RubyGem `bilingual-jekyll-resume-theme-0.7.0.gem` with zero packaging errors. All new files (`404.html`, `403.html`, `500.html`, `_layouts/error.html`, `_data/error_pages.yml`, `_includes/avatar.html`) are verified in the gem manifest.
 
-### 6.2 Liquid Syntax & Template Tag Inspection
+### 7.2 Liquid Syntax & Template Tag Inspection
 All modified templates (`_layouts/resume-ar.html`, `_layouts/resume-en.html`, `_layouts/default.html`, `_layouts/error.html`, `_includes/analytics-body.html`, `_includes/analytics-head.html`, `_includes/avatar.html`, `_includes/resume-section-*.html`, `_includes/shared-head.html`, `_includes/social-links.html`, `_includes/print-social-links.html`) contain valid, balanced Liquid tags and conform to Jekyll 3.9+ / 4.x standards.
 
-### 6.3 WCAG 2.1 AA Accessibility Attestation
+### 7.3 WCAG 2.1 AA Accessibility Attestation
 - All social links contain `aria-label`, `title`, and visually-hidden `<span class="sr-only">` text.
 - All SVG icons contain `aria-hidden="true" focusable="false"`.
 - Avatar image component includes bilingual fallback alt text, Schema.org `itemprop="image"`, and accessible link targets.
 
-### 6.4 RTL & Bidirectional Text Isolation Attestation
+### 7.4 RTL & Bidirectional Text Isolation Attestation
 - Arabic templates enforce `dir="rtl"` root direction with `<span dir="ltr">` isolation for telephone links, URLs, and printed social links.
 - Arabic Google Font Cairo loads reliably across all themes and custom palettes with preconnect hints.
 
 ---
 
-## 7. Closed Redundant Duplicate Issues Registry & Root Cause Analysis
+## 8. Closed Redundant Duplicate Issues Registry & Root Cause Analysis
 
-### 7.1 Duplicate Creation Root Cause Analysis (RCA)
+### 8.1 Duplicate Creation Root Cause Analysis (RCA)
 
 Between `2026-09-12T11:37:00Z` and `2026-09-12T12:10:49Z`, an automated script executed 13 successive batch sweeps across the repository issue tracker. In each cycle, a batch of 14 items was generated:
 1. 11 remediation items corresponding to Phase 0 bug fixes (P0.1–P0.11): immediately closed upon creation.
@@ -681,9 +688,9 @@ Because 13 successive batch runs were triggered, 13 identical copies of the Soci
 
 The 13th batch produced `#204` and `#206`, which are designated as the **canonical active open issues** in [`/FEATURE_ROADMAP.md`](../FEATURE_ROADMAP.md). All preceding 24 issues were formally closed on GitHub using GitHub's native `state_reason: "duplicate"` linking to `#204` and `#206`, preceded by an explanatory cross-reference comment.
 
-### 7.2 Social Media Platform Closed Duplicates (12 Issues)
+### 8.2 Social Media Platform Closed Duplicates
 
-All 12 duplicate issues share the title `"Expand Social Media Platforms (Mastodon, Discord, Bluesky, etc.)"`, labels `["enhancement", "phase-1"]`, and milestone `"Phase 1 (Quick Wins - 1-2 weeks)"`.
+The duplicate issues share the title `"Expand Social Media Platforms (Mastodon, Discord, Bluesky, etc.)"`, labels `["enhancement", "phase-1"]`, and milestone `"Phase 1 (Quick Wins - 1-2 weeks)"`.
 
 | Issue # | Title | Created (UTC) | Closed (UTC) | Status | Canonical Reference | Resolution Details |
 |---|---|---|---|---|---|---|
@@ -700,9 +707,9 @@ All 12 duplicate issues share the title `"Expand Social Media Platforms (Mastodo
 | [#176](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/176) | Expand Social Media Platforms | 2026-09-12T12:05:43Z | 2026-09-12T14:06:23Z | `CLOSED (duplicate)` | [#204](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/204) | Closed via GitHub API with cross-reference comment to #204 |
 | [#190](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/190) | Expand Social Media Platforms | 2026-09-12T12:08:26Z | 2026-09-12T14:06:35Z | `CLOSED (duplicate)` | [#204](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/204) | Closed via GitHub API with cross-reference comment to #204 |
 
-### 7.3 CI/CD Pipeline Closed Duplicates (12 Issues)
+### 8.3 CI/CD Pipeline Closed Duplicates
 
-All 12 duplicate issues share the title `"Automated CI/CD Build & Verification Pipeline"`, labels `["enhancement", "phase-3"]`, and milestone `"Phase 3 (Long-term - 2-3 months)"`.
+The duplicate issues share the title `"Automated CI/CD Build & Verification Pipeline"`, labels `["enhancement", "phase-3"]`, and milestone `"Phase 3 (Long-term - 2-3 months)"`.
 
 | Issue # | Title | Created (UTC) | Closed (UTC) | Status | Canonical Reference | Resolution Details |
 |---|---|---|---|---|---|---|
@@ -719,7 +726,7 @@ All 12 duplicate issues share the title `"Automated CI/CD Build & Verification P
 | [#178](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/178) | Automated CI/CD Build & Pipeline | 2026-09-12T12:05:54Z | 2026-09-12T14:08:45Z | `CLOSED (duplicate)` | [#206](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/206) | Closed via GitHub API with cross-reference comment to #206 |
 | [#192](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/192) | Automated CI/CD Build & Pipeline | 2026-09-12T12:08:37Z | 2026-09-12T14:08:57Z | `CLOSED (duplicate)` | [#206](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/206) | Closed via GitHub API with cross-reference comment to #206 |
 
-### 7.4 Closing Comment Audit Trail
+### 8.4 Closing Comment Audit Trail
 
 Each duplicate issue received a courteous explanatory comment before closure on GitHub:
 - **Social Media Comment:**
@@ -733,7 +740,7 @@ Each duplicate issue received a courteous explanatory comment before closure on
 
 ---
 
-## 8. Pull Requests & Ancillary GitHub Records
+## 9. Pull Requests & Ancillary GitHub Records
 
 | PR # | Status | Title | Description | Resolution |
 |---|---|---|---|---|