mat_views 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b7120f5d0821cb752001586381ab084a7366aeaa9616b86ef6e648be2b52d152
-  data.tar.gz: ab541f3705c974e8272cc07db3c9612add6311cb159467e04055eb980fa648b6
+  metadata.gz: 7adba77306f5d4a4f8738625ad9b584f13c84c082a307bd4473e82fcba93936e
+  data.tar.gz: f8c61cb31ff80d591dac050abe18237aed700532d0b536614fc29b79bade91f5
 SHA512:
-  metadata.gz: e3d260f3fcaf3029af874c943ae72b8786e2e86232dbc352a955ae9c4e1add587a0df88507cb86fe5463b308df1ff354b64ebfed00ebe2bcd124924984121797
-  data.tar.gz: 235208e771305d1085eeea02f5bd762bfb91942901e2b9d7d127281d8e7d04da878fcbf5eb8df4cdec9434c1e5db243fb90b20c79d77ede4136006449cbe2df8
+  metadata.gz: 6b4408b95e63107d1650ca3392e20ff2484837f817abbdce2716909e1647478c7562bc379c38283a99825440c258bff7d7b52dcabbc5d2c54ae68aeac946a731
+  data.tar.gz: 5a684e7384de30dcc5f4af1d10bb4999a8f104dbc7b3c112998b34ba3018cafb650ab24ef4737c2c11ed8259ec4ed711784e38b9ea31af70011b77b26b5dab44

data/README.md

@@ -65,19 +65,19 @@ defn = MatViews::MatViewDefinition.create!(
 
 ```ruby
 # Create
-MatViews::Services::CreateView.new(defn, force: true).run
+MatViews::Services::CreateView.new(defn, force: true).call
 MatViews::CreateViewJob.perform_later(defn.id, force: true)
 
 # Refresh
-MatViews::Services::RegularRefresh.new(defn, row_count_strategy: :estimated).run
+MatViews::Services::RegularRefresh.new(defn, row_count_strategy: :estimated).call
 MatViews::RefreshViewJob.perform_later(defn.id, row_count_strategy: :exact)
 
 # Delete
-MatViews::Services::DeleteView.new(defn, cascade: false, if_exists: true).run
+MatViews::Services::DeleteView.new(defn, cascade: false, if_exists: true).call
 MatViews::DeleteViewJob.perform_later(defn.id, cascade: true)
 ```
 
-**Uniform response**: `status`, `payload`, `meta`, `success?` / `error?`.
+**Uniform response**: `status`, `meta`, `success?` / `error?`.
 
 ---
 

data/app/assets/images/mat_views/favicon.svg

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="128" height="128" viewBox="0 0 256 256" fill="none"
+  xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="title desc">
+  <title id="title">MatViews Monogram</title>
+  <desc id="desc">Stylized M and V mark for Materialized Views. Transparent background.</desc>
+
+  <!-- subtle outer ring -->
+  <circle cx="128" cy="128" r="110" stroke="#0F172A" stroke-opacity="0.18" stroke-width="10" fill="none"/>
+
+  <!-- V (accent) -->
+  <path d="M64 64 L128 192 L192 64" stroke="#10B981" stroke-width="20" stroke-linecap="round" stroke-linejoin="round"/>
+
+  <!-- M (primary) -->
+  <path d="M48 176 L92 80 L128 144 L164 80 L208 176" stroke="#0F172A" stroke-width="20" stroke-linecap="round" stroke-linejoin="round"/>
+
+  <!-- optional tiny dot to balance negative space -->
+  <circle cx="128" cy="208" r="4" fill="#10B981" fill-opacity="0.9"/>
+</svg>

data/app/assets/images/mat_views/logo.svg

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="128" height="128" viewBox="0 0 256 256" fill="none"
+  xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="title desc">
+  <title id="title">MatViews Monogram</title>
+  <desc id="desc">Stylized M and V mark for Materialized Views. Transparent background.</desc>
+
+  <!-- subtle outer ring -->
+  <circle cx="128" cy="128" r="110" stroke="#0F172A" stroke-opacity="0.18" stroke-width="10" fill="none"/>
+
+  <!-- V (accent) -->
+  <path d="M64 64 L128 192 L192 64" stroke="#10B981" stroke-width="20" stroke-linecap="round" stroke-linejoin="round"/>
+
+  <!-- M (primary) -->
+  <path d="M48 176 L92 80 L128 144 L164 80 L208 176" stroke="#0F172A" stroke-width="20" stroke-linecap="round" stroke-linejoin="round"/>
+
+  <!-- optional tiny dot to balance negative space -->
+  <circle cx="128" cy="208" r="4" fill="#10B981" fill-opacity="0.9"/>
+</svg>

data/app/assets/images/mat_views/mask-icon.svg

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 256 256" xmlns="http://www.w3.org/2000/svg" fill="none">
+  <path d="M64 64 L128 192 L192 64" stroke="currentColor" stroke-width="28" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M48 176 L92 80 L128 144 L164 80 L208 176" stroke="currentColor" stroke-width="28" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

data/app/assets/stylesheets/mat_views/application.css

@@ -1,15 +1,326 @@
 /*
- * This is a manifest file that'll be compiled into application.css, which will include all the files
- * listed below.
- *
- * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
- * or any plugin's vendor/assets/stylesheets directory can be referenced here using a relative path.
- *
- * You're free to add application-wide styles to this file and they'll appear at the bottom of the
- * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
- * files in this directory. Styles in this file should be added after the last require_* statement.
- * It is generally better to create a new file per style scope.
- *
  *= require_tree .
  *= require_self
- */
+*/
+
+/* ─────────────────────────────────────────────────────────────────────────────
+   THEME TOKENS
+   - Define semantic variables once.
+   - Light theme is default on :root.
+   - Dark theme overrides via [data-theme="dark"] or prefers-color-scheme.
+   ─────────────────────────────────────────────────────────────────────────── */
+
+:root{
+  /* typography */
+  --font-base:14px/1.4 Inter,system-ui;
+  --font-head:'Space Grotesk';
+  --font-mono:'JetBrains Mono',monospace;
+
+  /* semantic colors (light defaults) */
+  --color-text:#0f172a;
+  --color-sub:#475569;
+  --color-muted:#334155;
+
+  --color-bg:#f8fafc;
+  --color-surface:#ffffff;
+  --color-elev-shadow:rgba(15,23,42,.04);
+
+  --color-white:#ffffff;
+  --color-border:#e2e8f0;
+  --color-border-light:#f1f5f9;
+  --color-border-mid:#cbd5e1;
+  --color-dark:#111827;          /* hover for primary in light */
+  --color-primary:#0f172a;
+
+  --color-danger:#dc2626;
+  --color-danger-dark:#b91c1c;
+
+  --color-success-bg:#ecfdf5;
+  --color-success:#047857;
+  --color-success-border:#a7f3d0;
+
+  --color-running-bg:#fffbeb;
+  --color-running:#92400e;
+  --color-running-border:#fde68a;
+
+  --color-failed-bg:#fef2f2;
+  --color-failed:#b91c1c;
+  --color-failed-border:#fecaca;
+
+  --color-link:#3b82f6;
+
+  /* component-specific surfaces (light) */
+  --card-surface:var(--color-surface);
+  --table-head-bg:#eaeaea;
+  --btn-ghost-hover:#eef2f7;
+  --btn-secondary-hover:#f1f5f9;
+
+  /* overlay / popovers */
+  --overlay-scrim:rgba(15,23,42,.35);
+  --tooltip-bg:#0f172a;
+  --tooltip-shadow:rgba(2,6,23,.20);
+
+  /* transitions */
+  --elev-shadow-lg:rgba(15,23,42,.10);
+
+  color-scheme: light;
+}
+
+/* Dark theme overrides (manual: <html data-theme="dark">) */
+:root[data-theme="dark"]{
+  --color-text:#e5e7eb;
+  --color-sub:#94a3b8;
+  --color-muted:#cbd5e1;
+  --color-bg:#0b1020;
+  --color-surface:#0f172a;
+  --color-elev-shadow:rgba(0,0,0,.25);
+  --color-white:#0f172a;
+  --color-border:#1f2937;
+  --color-border-light:#111827;
+  --color-border-mid:#334155;
+  --color-dark:#f8fafc;
+  --color-primary:#e5e7eb;
+  --color-danger:#ef4444;
+  --color-danger-dark:#dc2626;
+  --color-success-bg:#052e25;
+  --color-success:#34d399;
+  --color-success-border:#065f46;
+  --color-running-bg:#3a2a03;
+  --color-running:#fbbf24;
+  --color-running-border:#854d0e;
+  --color-failed-bg:#3a0d0d;
+  --color-failed:#fca5a5;
+  --color-failed-border:#7f1d1d;
+  --color-link:#60a5fa;
+  --card-surface:var(--color-surface);
+  --table-head-bg:#0f172a;
+  --btn-ghost-hover:#0f172a;
+  --btn-secondary-hover:#111827;
+  --overlay-scrim:rgba(3,7,18,.55);
+  --tooltip-bg:#0b1222;
+  --tooltip-shadow:rgba(0,0,0,.35);
+
+  color-scheme: dark;
+}
+
+/* Auto-dark by system setting unless explicitly overridden by data-theme */
+@media (prefers-color-scheme: dark){
+  :root:not([data-theme]){
+    /* repeat the same overrides as the block above, or factor them with a custom @mixin in SCSS */
+    color-scheme: dark;
+  }
+}
+:root{ color-scheme: light; }
+
+/* ─────────────────────────────────────────────────────────────────────────────
+   BASE
+   ─────────────────────────────────────────────────────────────────────────── */
+
+html,body{height:100%}
+body{
+  display:flex;flex-direction:column;min-height:100vh;
+  font:var(--font-base);color:var(--color-text);background:var(--color-bg)
+}
+h1,h2,h3,h4,h5,h6{font-weight:600;color:var(--color-text);font-family:var(--font-head)}
+code,pre{font-family:var(--font-mono);font-size:.9rem;color:var(--color-muted)}
+a{color:var(--color-link);text-decoration:none}
+a:hover{text-decoration:underline}
+pre{background:var(--card-surface);border:1px solid var(--color-border);border-radius:8px;box-shadow:0 1px 2px var(--color-elev-shadow);padding:.75rem;overflow:auto;margin: 0;white-space:pre-wrap;}
+
+/* ─────────────────────────────────────────────────────────────────────────────
+   LAYOUT
+   ─────────────────────────────────────────────────────────────────────────── */
+
+.mv-main{flex:1 1 auto}
+.mv-container{background:transparent;margin:0 auto;max-width:72rem;padding:1rem 1.25rem}
+.mv-header{background:var(--card-surface);border-bottom:1px solid var(--color-border);color:var(--color-sub);font-size:.9rem;padding:1rem 0}
+.mv-header-row{display:flex;flex-wrap:wrap;gap:12px;justify-content:space-between}
+.mv-header-row.even{justify-content:space-evenly}
+.mv-brand{align-items:center;color:var(--color-text);display:flex;font-weight:600;gap:.6rem;text-decoration:none}
+.mv-logo{height:28px;width:28px}
+.mv-footer{background:var(--card-surface);border-top:1px solid var(--color-border);color:var(--color-sub);font-size:.9rem;margin-top:auto;padding-top:1rem}
+.mv-footer-row{display:flex;flex-wrap:wrap;gap:12px;justify-content:space-between}
+.row-item {display: flex; align-items: center; gap: 6px;}
+
+/* ─────────────────────────────────────────────────────────────────────────────
+   CARDS
+   ─────────────────────────────────────────────────────────────────────────── */
+
+.mv-card{background:var(--card-surface);border:1px solid var(--color-border);border-radius:12px;box-shadow:0 1px 2px var(--color-elev-shadow)}
+.mv-card-b{padding:1rem}
+.mv-card-h{border-bottom:1px solid var(--color-border);font-family:var(--font-head);font-weight:600;padding:.75rem 1rem}
+.mv-card-f{border-top:1px solid var(--color-border);padding:.5rem 1rem;text-align:right;font-size:.85rem;}
+
+/* ─────────────────────────────────────────────────────────────────────────────
+   TOOLBAR
+   ─────────────────────────────────────────────────────────────────────────── */
+.mv-toolbar{display:flex;justify-content:flex-end;margin:.5rem 0;}
+.mv-toolbar.start{justify-content: flex-start;}
+.mv-toolbar.center{justify-content: center;flex: 1;}
+/* ─────────────────────────────────────────────────────────────────────────────
+   BUTTONS
+   ─────────────────────────────────────────────────────────────────────────── */
+
+.mv-btn{align-items:center;border:1px solid transparent;border-radius:8px;box-sizing:border-box;cursor:pointer;display:inline-flex;font-weight:500;gap:.5rem;padding:.4rem .7rem;text-decoration:none}
+.mv-btn--ghost{background:transparent;color:var(--color-muted)}
+.mv-btn--ghost:hover{background:var(--btn-ghost-hover)}
+.mv-btn--lg{font-size:.9rem;height:44px;max-height:44px;padding:0 .8rem}
+.mv-btn--md{font-size:.8rem;height:36px;max-height:36px;padding:0 .55rem}
+.mv-btn--negative{background:var(--color-danger);color:#fff}
+.mv-btn--negative:hover{background:var(--color-danger-dark)}
+.mv-btn--primary{background:var(--color-primary);color:#fff}
+[data-theme="dark"] .mv-btn--primary{color:#0b1020} /* ensure contrast on dark */
+.mv-btn--primary:hover{background:var(--color-dark)}
+.mv-btn--secondary{background:var(--card-surface);border-color:var(--color-border-mid);color:var(--color-primary)}
+.mv-btn--secondary:hover{background:var(--btn-secondary-hover)}
+.mv-btn--sm{font-size:.6rem;height:28px;max-height:28px;padding:0 .4rem}
+.mv-btn.underline{text-decoration:underline;}
+
+/* ─────────────────────────────────────────────────────────────────────────────
+   TABLES
+   ─────────────────────────────────────────────────────────────────────────── */
+
+.mv-table{background:var(--card-surface);border:1px solid var(--color-border);border-collapse:collapse;border-radius:10px;overflow:hidden;width:100%}
+.mv-th{background:var(--table-head-bg);border-bottom:1px solid var(--color-border);color:var(--color-sub);font-family:var(--font-head);font-weight:600;padding:.5rem .75rem;text-align:left}
+.mv-td{border-bottom:1px solid var(--color-border-light);padding:.5rem .75rem}
+.mv-tr:last-child .mv-td{border-bottom:none}
+
+/* ─────────────────────────────────────────────────────────────────────────────
+   BADGES
+   ─────────────────────────────────────────────────────────────────────────── */
+
+.mv-badge{border:1px solid transparent;border-radius:6px;display:inline-block;font-size:.75rem;font-weight:600;padding:.15rem .4rem}
+.mv-badge--failed{background:var(--color-failed-bg);border-color:var(--color-failed-border);color:var(--color-failed)}
+.mv-badge--running{background:var(--color-running-bg);border-color:var(--color-running-border);color:var(--color-running)}
+.mv-badge--success{background:var(--color-success-bg);border-color:var(--color-success-border);color:var(--color-success)}
+
+/* ─────────────────────────────────────────────────────────────────────────────
+   Details/Summary
+   ─────────────────────────────────────────────────────────────────────────── */
+details summary{cursor:pointer;}
+details summary:focus{outline:none}
+.mv-details summary::-webkit-details-marker { display: none; }
+.mv-details summary {display: inline-flex;align-items: center;gap: .5rem;cursor: pointer;}
+.mv-chevron {flex: 0 0 auto;transition: transform 200ms ease;transform-origin: 50% 50%;}
+.mv-details[open] .mv-chevron { transform: rotate(90deg); }
+.mv-details__content {overflow: hidden;will-change: height;margin:0;}
+[dir="rtl"] .mv-details[open] .mv-chevron { transform: rotate(-90deg); }
+
+/* ─────────────────────────────────────────────────────────────────────────────
+   TABS
+   ─────────────────────────────────────────────────────────────────────────── */
+
+.mv-tabs{border-bottom:1px solid var(--color-border);display:flex;gap:1rem;margin:1rem 0}
+.mv-tab{border-bottom:2px solid transparent;color:var(--color-muted);font-family:var(--font-head);padding:.5rem .5rem;text-decoration:none}
+.mv-tab--on{border-color:var(--color-primary)}
+.mv-tab:hover{border-color:var(--color-border-mid)}
+
+/* ─────────────────────────────────────────────────────────────────────────────
+   FORMS
+   ─────────────────────────────────────────────────────────────────────────── */
+
+.mv-form{display:block;padding:0 1rem;max-width:100%}
+.mv-form--no-pad{padding:0}
+.mv-field{display:flex;flex-direction:column;gap:.25rem;margin:.75rem 0}
+.mv-field-inline-row{display:inline-flex;flex-direction:row;align-items:center;gap:.75rem; margin: 1rem 0;}
+.mv-field-inline{display:inline-flex;flex-direction:row;align-items:center;gap:.5rem}
+.mv-input,.mv-textarea,.mv-select{background:var(--card-surface);border:1px solid var(--color-border-mid);border-radius:8px;padding:.45rem .6rem;color:var(--color-text)}
+.mv-label{color:var(--color-muted);font-size:.9rem;font-weight:600;}
+.mv-label--sublabel{font-weight:300;margin:0;font-size:.85rem;}
+.mv-textarea{min-height:10rem;resize:vertical}
+.mv-hint{color:var(--color-sub);font-size:.75rem;}
+
+/* ─────────────────────────────────────────────────────────────────────────────
+   FLASH
+   ─────────────────────────────────────────────────────────────────────────── */
+
+.mv-flash{border-radius:10px;font-size:.9rem;margin:.5rem 0;padding:.5rem .75rem}
+.mv-flash--err{background:var(--color-failed-bg);border:1px solid var(--color-failed-border);color:var(--color-failed)}
+.mv-flash--ok{background:var(--color-success-bg);border:1px solid var(--color-success-border);color:#065f46}
+
+/* ─────────────────────────────────────────────────────────────────────────────
+   UTILS
+   ─────────────────────────────────────────────────────────────────────────── */
+
+.mv-text-right{text-align:end} /* logical for LTR/RTL */
+
+.mv-td-actions{text-align:end}
+.mv-actions{display:inline-flex;flex-wrap:wrap;gap:12px;justify-content:flex-end}
+.mv-action-group{background:var(--card-surface);border:1px solid var(--color-border);border-radius:12px;box-shadow:0 1px 2px var(--color-elev-shadow);display:inline-flex;flex-direction:column;padding:10px 12px}
+.mv-action-title{align-items:center;color:var(--color-sub);display:flex;font-size:.72rem;font-weight:600;gap:6px;letter-spacing:.02em;margin-bottom:.5rem;text-transform:uppercase}
+.mv-buttons{align-items:center;display:inline-flex;flex-direction:column;gap:6px;align-items: stretch;}
+.mv-buttons .mv-btn{width:100%;justify-content:center;}
+.mv-icon{margin-inline-end:.05rem;margin-inline-start: .05rem;}
+.mv-mv-missing{align-items:center;color:#92400e;display:inline-flex;font-size:.88rem;gap:6px;}
+.mv-status-icon{align-items:center;display:inline-flex;}
+.mv-status-missing{color:#dc2626}
+.mv-status-ok{color:#16a34a}
+
+/* ─────────────────────────────────────────────────────────────────────────────
+   DRAWER
+   ─────────────────────────────────────────────────────────────────────────── */
+
+.mv-drawer-root{inset:0;pointer-events:none;position:fixed;z-index:60}
+.mv-drawer-root.is-open{pointer-events:auto}
+.mv-drawer-overlay{background:var(--overlay-scrim);inset:0;opacity:0;position:absolute;transition:opacity .18s ease}
+.mv-drawer-root.is-open .mv-drawer-overlay{opacity:1}
+.mv-drawer{
+  background:var(--card-surface);border-left:1px solid var(--color-border);
+  box-shadow:-8px 0 24px var(--elev-shadow-lg);display:flex;flex-direction:column;
+  height:100%;max-width:90vw;position:absolute;right:0;top:0;
+  transform:translateX(100%);transition:transform .22s ease;width:32rem
+}
+.mv-drawer-root.is-open .mv-drawer{transform:translateX(0)}
+.mv-drawer-body{height:100%;overflow:auto;padding:0}
+.mv-drawer-body .mv-card{border-left:0;border-radius:0;border-right:0}
+.mv-drawer-action{background:transparent;border:0;color:var(--color-muted);cursor:pointer;font-size:1.25rem}
+.mv-drawer-head{align-items:center;border-bottom:1px solid var(--color-border);display:flex;justify-content:space-between;padding:.75rem 1rem;font-family:var(--font-head);}
+.mv-drawer-head h2{margin:0}
+
+/* ─────────────────────────────────────────────────────────────────────────────
+   TOOLTIP + CONFIRM
+   ─────────────────────────────────────────────────────────────────────────── */
+
+.mv-tooltip{background:var(--tooltip-bg);border-radius:6px;box-shadow:0 4px 16px var(--tooltip-shadow);color:#fff;font-size:12px;line-height:1.2;opacity:0;padding:6px 8px;transition:opacity .15s ease;z-index:9999}
+.mv-tooltip[data-show="true"]{opacity:1}
+.mv-tooltip__arrow{background:var(--tooltip-bg);box-shadow:-1px -1px 1px rgba(2,6,23,.08);height:8px;position:absolute;transform:rotate(45deg);width:8px}
+.mv-tooltip__content{display:block;white-space:nowrap}
+.mv-tooltip--bottom .mv-tooltip__arrow{left:50%;margin-left:-4px;top:-4px}
+.mv-tooltip--left .mv-tooltip__arrow{right:-4px;top:50%;margin-top:-4px}
+.mv-tooltip--right .mv-tooltip__arrow{left:-4px;top:50%;margin-top:-4px}
+.mv-tooltip--top .mv-tooltip__arrow{bottom:-4px;left:50%;margin-left:-4px}
+
+.mv-confirm{background:var(--card-surface);border:1px solid var(--color-border);border-radius:8px;box-shadow:0 4px 16px var(--tooltip-shadow);font-size:.85rem;max-width:260px;opacity:0;padding:.75rem;transition:opacity .15s ease;z-index:9999}
+.mv-confirm[data-show="true"]{opacity:1}
+.mv-confirm__content{margin-bottom:.5rem;color:var(--color-text)}
+.mv-confirm__buttons{display:flex;gap:.5rem;justify-content:flex-end}
+.mv-confirm__arrow{background:var(--card-surface);border-left:1px solid var(--color-border);border-top:1px solid var(--color-border);box-shadow:-1px -1px 1px rgba(2,6,23,.08);width:10px;height:10px;position:absolute;transform:rotate(45deg)}
+.mv-confirm--bottom .mv-confirm__arrow{ top:-5px; left:50%; margin-left:-5px }
+.mv-confirm--top    .mv-confirm__arrow{ bottom:-5px; left:50%; margin-left:-5px; transform:rotate(225deg) }
+.mv-confirm--left   .mv-confirm__arrow{ right:-5px; top:50%; margin-top:-5px; transform:rotate(135deg) }
+.mv-confirm--right  .mv-confirm__arrow{ left:-5px;  top:50%; margin-top:-5px; transform:rotate(-45deg) }
+
+/* ─────────────────────────────────────────────────────────────────────────────
+   RTL SUPPORT (no class changes; flip where needed)
+   ─────────────────────────────────────────────────────────────────────────── */
+
+[dir="rtl"] .mv-brand{flex-direction:row-reverse}
+[dir="rtl"] .mv-status-icon{margin-inline-start:0;margin-inline-end:.5rem}
+[dir="rtl"] .mv-mv-missing{margin-inline-end:0;margin-inline-start:.5rem}
+[dir="rtl"] .mv-th{text-align:right}
+[dir="rtl"] .mv-td-actions{text-align:start}
+
+/* Drawer opens from the *left* in RTL */
+[dir="rtl"] .mv-drawer{
+  left:0; right:auto;
+  border-left:0; border-right:1px solid var(--color-border);
+  box-shadow:8px 0 24px var(--elev-shadow-lg);
+  transform:translateX(-100%);
+}
+[dir="rtl"] .mv-drawer-root.is-open .mv-drawer{transform:translateX(0)}
+
+/* Tooltip/Confirm arrow horizontal flip in RTL */
+[dir="rtl"] .mv-tooltip--left  .mv-tooltip__arrow{left:-4px; right:auto}
+[dir="rtl"] .mv-tooltip--right .mv-tooltip__arrow{right:-4px; left:auto}
+[dir="rtl"] .mv-confirm--left  .mv-confirm__arrow{left:-5px; right:auto; transform:rotate(-45deg)}
+[dir="rtl"] .mv-confirm--right .mv-confirm__arrow{right:-5px; left:auto;  transform:rotate(135deg)}

data/app/controllers/mat_views/admin/application_controller.rb

@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+
+# Copyright Codevedas Inc. 2025-present
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+module MatViews
+  module Admin
+    # MatViews::Admin::ApplicationController
+    # --------------------------------------
+    # Base controller for the MatViews admin interface.
+    #
+    # Responsibilities:
+    # - Provides authentication and authorization via MatViews::Admin::AuthBridge.
+    # - Applies the `mat_views/admin` layout and includes UI helpers.
+    # - Manages locale (`I18n.locale`) and enforces language parameter consistency.
+    # - Sets the browser time zone around each request when provided via cookies.
+    # - Exposes `mat_views_data_theme` (light/dark) for theming via cookies.
+    # - Provides frame helpers (`render_frame`, `ensure_frame`) to support Turbo-driven
+    #   admin UI navigation.
+    #
+    # Filters:
+    # - `before_action`: sets locale and redirects to enforce `lang` consistency.
+    # - `around_action`: wraps requests in the browser’s time zone if valid.
+    #
+    # Methods:
+    # - {#default_url_options} ensures `lang` param is included in generated URLs.
+    # - {#set_time_zone} runs the request in the cookie-provided time zone if valid.
+    # - {#render_frame} renders a UI frame partial given `frame_id`.
+    # - {#ensure_frame} requires a `frame_id` param for frame-only actions.
+    # - {#redirect_to_lang} redirects when the URL `lang` param differs from `I18n.locale`.
+    # - {#set_mat_views_locale} sets the session-defined or default locale.
+    # - {#mat_views_data_theme} returns `light`, `dark`, or `nil` for theming.
+    #
+    class ApplicationController < ActionController::Base
+      include MatViews::Admin::AuthBridge
+
+      helper MatViews::Admin::UiHelper
+      helper MatViews::Helpers::UiTestIds
+      layout 'mat_views/admin'
+
+      before_action :set_mat_views_locale, :redirect_to_lang
+      helper_method :mat_views_data_theme
+      around_action :set_time_zone
+
+      private
+
+      # Default URL options, ensuring `lang` is always included.
+      #
+      # @api private
+      #
+      # @return [Hash{Symbol => String}]
+      def default_url_options
+        { lang: params[:lang].presence || I18n.locale }
+      end
+
+      # Wraps the request in the browser’s time zone if one is set in cookies.
+      #
+      # @api private
+      #
+      # @yield the block representing the request lifecycle
+      # @return [void]
+      def set_time_zone(&)
+        browser_tz = cookies[:browser_tz]
+        if browser_tz.present? && ActiveSupport::TimeZone[browser_tz]
+          Time.use_zone(browser_tz, &)
+        else
+          yield
+        end
+      end
+
+      # Ensures a `frame_id` param is present.
+      # If missing, redirects to the admin root with an alert.
+      #
+      # @api private
+      #
+      # @return [void]
+      def ensure_frame
+        @frame_id = params[:frame_id]
+        if @frame_id.present?
+          @frame_action = params[:frame_action]
+          return
+        end
+        redirect_to admin_root_path, alert: I18n.t('mat_views.errors.frame_only')
+      end
+
+      # Redirects to enforce that the `lang` param matches `I18n.locale`.
+      #
+      # @api private
+      #
+      # @return [void]
+      def redirect_to_lang
+        locale_str = locale.to_s
+        return if params[:lang] == locale_str
+
+        lang = locale_str
+        redirect_to url_for(params.permit!.to_h.merge(lang: lang)), status: :see_other
+      end
+
+      # Sets the locale for MatViews admin requests.
+      # Falls back to default locale if session value is invalid.
+      #
+      # @api private
+      #
+      # @return [void]
+      def set_mat_views_locale
+        I18n.locale = if (loc = session[:mat_views_locale]).present? && MatViews::Engine.available_locales.map(&:to_s).include?(loc)
+                        loc
+                      else
+                        MatViews::Engine.default_locale
+                      end
+      end
+
+      # Returns the current theme for the admin UI.
+      #
+      # @api private
+      #
+      # @return ["light", "dark", nil] the theme stored in cookies, or `nil` if invalid
+      def mat_views_data_theme
+        theme = cookies[:theme].to_s
+        %w[light dark].include?(theme) ? theme : nil
+      end
+
+      # Returns the current locale.
+      #
+      # @api private
+      #
+      # @return [Symbol] the current I18n locale
+      def locale
+        I18n.locale
+      end
+    end
+  end
+end

data/app/controllers/mat_views/admin/dashboard_controller.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+# Copyright Codevedas Inc. 2025-present
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+module MatViews
+  module Admin
+    # MatViews::Admin::DashboardController
+    # ------------------------------------
+    # Controller for the MatViews admin dashboard.
+    #
+    # Responsibilities:
+    # - Provides the landing page (`index`) for the admin interface.
+    # - Authorizes access via {ApplicationController#authorize_mat_views!}.
+    # - Prepares placeholder metrics content (future: aggregated refresh metrics).
+    #
+    class DashboardController < ApplicationController
+      # GET /:lang/admin
+      #
+      # Renders the admin dashboard. Currently sets a placeholder message
+      # until metric aggregation is implemented.
+      #
+      # @return [void]
+      def index
+        authorize_mat_views!(:read, :mat_views_dashboard)
+        @metrics_note = 'Metrics coming soon (see: Aggregate refresh metrics for reporting).'
+      end
+    end
+  end
+end