@sociallane/elements 1.0.12 → 1.0.14

package/.github/workflows/npm-npx-gates.yml

@@ -0,0 +1,58 @@
+name: SocialLane npm/npx Gates
+
+on:
+  pull_request:
+    paths:
+      - 'sociallane-elements/**'
+  push:
+    branches:
+      - main
+    paths:
+      - 'sociallane-elements/**'
+  workflow_dispatch:
+
+jobs:
+  cli-smoke:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: sociallane-elements
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: CLI smoke tests
+        run: node scripts/test-cli-smoke.js
+
+      - name: List command sanity check
+        run: node scripts/install.js list --json
+
+      - name: Doctor command sanity check
+        run: node scripts/install.js doctor --json --target .
+
+  release-gate:
+    if: github.event_name == 'workflow_dispatch'
+    runs-on: ubuntu-latest
+    needs: cli-smoke
+    defaults:
+      run:
+        working-directory: sociallane-elements
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Sync canonical widget manifest
+        run: node scripts/generate-widget-manifest.js
+
+      - name: Release gate (strict)
+        run: node scripts/release-gate.js --strict

package/docs/install-new-instance.md

@@ -55,13 +55,13 @@ cd wp-content/plugins/sociallane-elements && npm install && npm run build
 
 ```bash
 # From your WordPress root (directory that contains wp-content)
-npx @sociallane/elements --minimal
+npx @sociallane/elements --base
 ```
 
 Then add widgets by slug (no manual `widgets.json` editing):
 
 ```bash
-npx @sociallane/elements add hero-split faq content-block widget-filter
+npx @sociallane/elements add hero-split faq-stacked content-block widget-filter
 ```
 
 Each `add` updates `widgets.json` and runs the build. You can run `add` anytime to add more widgets.
@@ -77,8 +77,8 @@ This copies the full plugin to `wp-content/plugins/sociallane-elements`, runs `n
 **Custom path:**
 
 ```bash
-npx @sociallane/elements --minimal path/to/wp-content/plugins/sociallane-elements
-npx @sociallane/elements add hero-split faq   # run from WordPress root or plugin dir
+npx @sociallane/elements --base path/to/wp-content/plugins/sociallane-elements
+npx @sociallane/elements add --target path/to/wp-content/plugins/sociallane-elements hero-split faq-stacked
 ```
 
 **Single widget (per-widget packages):**
@@ -87,7 +87,7 @@ You can install one widget at a time via its own package. This installs the Soci
 
 ```bash
 # From your WordPress root or wp-content/plugins
-npx @sociallane/widget-hero-overlay
+npx @sociallane/widget-content-block
 npx @sociallane/widget-faq-stacked
 ```
 

package/docs/npm-widget-cheatsheet.md

@@ -7,8 +7,11 @@ Quick reference for loading widgets via npm workspaces.
 ## One-liners
 
 ```bash
-# Full install — REQUIRED for styled widgets (from plugin root)
-npm install && npm run build
+# Base install (no widgets imported yet)
+npx @sociallane/elements --base
+
+# Add selected widgets
+npx @sociallane/elements add hero-split faq-stacked content-block
 
 # Dev watch (rebuilds on file change)
 npm run dev
@@ -28,7 +31,7 @@ Edit `widgets.json` at plugin root:
     "hero-split",
     "hero-overlay",
     "content-block",
-    "faq"
+    "faq-stacked"
   ]
 }
 ```
@@ -39,7 +42,10 @@ Only slugs listed here are loaded. Add or remove as needed.
 
 ## Widget → npm package & command
 
-Every widget and its npm package / add command:
+Common widgets and their npm package / add command:
+
+> Note: per-widget packages may not all be published at the same time.  
+> The most reliable flow is `npx @sociallane/elements --base` then `npx @sociallane/elements add ...`.
 
 | Widget | Package | Command |
 |--------|---------|---------|
@@ -52,7 +58,9 @@ Every widget and its npm package / add command:
 | cta-banner | `@sociallane/widget-cta-banner` | `npm install @sociallane/widget-cta-banner` |
 | cta-notify | `@sociallane/widget-cta-notify` | `npm install @sociallane/widget-cta-notify` |
 | cta-split | `@sociallane/widget-cta-split` | `npm install @sociallane/widget-cta-split` |
-| faq | `@sociallane/widget-faq` | `npm install @sociallane/widget-faq` |
+| faq-stacked | `@sociallane/widget-faq-stacked` | `npm install @sociallane/widget-faq-stacked` |
+| faq-split | `@sociallane/widget-faq-split` | `npm install @sociallane/widget-faq-split` |
+| faq-centered | `@sociallane/widget-faq-centered` | `npm install @sociallane/widget-faq-centered` |
 | feature-grid | `@sociallane/widget-feature-grid` | `npm install @sociallane/widget-feature-grid` |
 | feature-list | `@sociallane/widget-feature-list` | `npm install @sociallane/widget-feature-list` |
 | feature-list-cta | `@sociallane/widget-feature-list-cta` | `npm install @sociallane/widget-feature-list-cta` |
@@ -62,25 +70,34 @@ Every widget and its npm package / add command:
 | form-contact | `@sociallane/widget-form-contact` | `npm install @sociallane/widget-form-contact` |
 | grid-case-studies | `@sociallane/widget-grid-case-studies` | `npm install @sociallane/widget-grid-case-studies` |
 | grid-components | `@sociallane/widget-grid-components` | `npm install @sociallane/widget-grid-components` |
-| grid-posts | `@sociallane/widget-grid-posts` | `npm install @sociallane/widget-grid-posts` |
+| posts-grid | `@sociallane/widget-posts-grid` | `npm install @sociallane/widget-posts-grid` |
+| posts-grid-overlay | `@sociallane/widget-posts-grid-overlay` | `npm install @sociallane/widget-posts-grid-overlay` |
 | grid-team | `@sociallane/widget-grid-team` | `npm install @sociallane/widget-grid-team` |
-| grid-testimonials | `@sociallane/widget-grid-testimonials` | `npm install @sociallane/widget-grid-testimonials` |
+| testimonials-grid | `@sociallane/widget-testimonials-grid` | `npm install @sociallane/widget-testimonials-grid` |
+| testimonials-masonry | `@sociallane/widget-testimonials-masonry` | `npm install @sociallane/widget-testimonials-masonry` |
+| testimonials-bento | `@sociallane/widget-testimonials-bento` | `npm install @sociallane/widget-testimonials-bento` |
 | hero-announcement | `@sociallane/widget-hero-announcement` | `npm install @sociallane/widget-hero-announcement` |
 | hero-centered-image | `@sociallane/widget-hero-centered-image` | `npm install @sociallane/widget-hero-centered-image` |
 | hero-collage | `@sociallane/widget-hero-collage` | `npm install @sociallane/widget-hero-collage` |
 | hero-overlay | `@sociallane/widget-hero-overlay` | `npm install @sociallane/widget-hero-overlay` |
-| hero-saas | `@sociallane/widget-hero-saas` | `npm install @sociallane/widget-hero-saas` |
+| hero-saas-split | `@sociallane/widget-hero-saas-split` | `npm install @sociallane/widget-hero-saas-split` |
+| hero-saas-stacked | `@sociallane/widget-hero-saas-stacked` | `npm install @sociallane/widget-hero-saas-stacked` |
+| hero-saas-centered | `@sociallane/widget-hero-saas-centered` | `npm install @sociallane/widget-hero-saas-centered` |
 | hero-split | `@sociallane/widget-hero-split` | `npm install @sociallane/widget-hero-split` |
 | hero-stacked-image | `@sociallane/widget-hero-stacked-image` | `npm install @sociallane/widget-hero-stacked-image` |
 | intro-pattern | `@sociallane/widget-intro-pattern` | `npm install @sociallane/widget-intro-pattern` |
 | intro-text | `@sociallane/widget-intro-text` | `npm install @sociallane/widget-intro-text` |
-| logo-grid | `@sociallane/widget-logo-grid` | `npm install @sociallane/widget-logo-grid` |
+| logo-grid-centered | `@sociallane/widget-logo-grid-centered` | `npm install @sociallane/widget-logo-grid-centered` |
+| logo-grid-row | `@sociallane/widget-logo-grid-row` | `npm install @sociallane/widget-logo-grid-row` |
+| logo-grid-split | `@sociallane/widget-logo-grid-split` | `npm install @sociallane/widget-logo-grid-split` |
 | nav-default | `@sociallane/widget-nav-default` | `npm install @sociallane/widget-nav-default` |
 | nav-centered | `@sociallane/widget-nav-centered` | `npm install @sociallane/widget-nav-centered` |
 | nav-minimal | `@sociallane/widget-nav-minimal` | `npm install @sociallane/widget-nav-minimal` |
 | nav-compact | `@sociallane/widget-nav-compact` | `npm install @sociallane/widget-nav-compact` |
 | nav-floating | `@sociallane/widget-nav-floating` | `npm install @sociallane/widget-nav-floating` |
 | newsletter | `@sociallane/widget-newsletter` | `npm install @sociallane/widget-newsletter` |
+| newsletter-card | `@sociallane/widget-newsletter-card` | `npm install @sociallane/widget-newsletter-card` |
+| newsletter-section | `@sociallane/widget-newsletter-section` | `npm install @sociallane/widget-newsletter-section` |
 | outreach-dashboard | `@sociallane/widget-outreach-dashboard` | `npm install @sociallane/widget-outreach-dashboard` |
 | pipeline-dashboard | `@sociallane/widget-pipeline-dashboard` | `npm install @sociallane/widget-pipeline-dashboard` |
 | pricing-table | `@sociallane/widget-pricing-table` | `npm install @sociallane/widget-pricing-table` |
@@ -89,7 +106,9 @@ Every widget and its npm package / add command:
 | services | `@sociallane/widget-services` | `npm install @sociallane/widget-services` |
 | simple-page-hero | `@sociallane/widget-simple-page-hero` | `npm install @sociallane/widget-simple-page-hero` |
 | social-proof | `@sociallane/widget-social-proof` | `npm install @sociallane/widget-social-proof` |
+| social-proof-trust | `@sociallane/widget-social-proof-trust` | `npm install @sociallane/widget-social-proof-trust` |
 | testimonial-quote | `@sociallane/widget-testimonial-quote` | `npm install @sociallane/widget-testimonial-quote` |
+| widget-filter | `@sociallane/widget-widget-filter` | `npm install @sociallane/widget-widget-filter` |
 
 Then add the slug to `widgets.json`.
 
@@ -99,12 +118,12 @@ Then add the slug to `widgets.json`.
 
 | Category | Slugs |
 |----------|-------|
-| Heroes | `hero-split`, `hero-overlay`, `hero-saas`, `hero-collage`, `hero-centered-image`, `hero-stacked-image`, `hero-announcement`, `simple-page-hero` |
-| Content | `content-block`, `intro-text`, `intro-pattern`, `faq`, `feature-list`, `feature-list-cta`, `feature-grid` |
-| Cards & Grids | `card-hover-reveal`, `bento-grid`, `bento-portfolio`, `grid-posts`, `grid-team`, `grid-testimonials`, `grid-case-studies`, `grid-components`, `logo-grid`, `client-logos` |
-| Forms & CTAs | `cta-banner`, `cta-split`, `cta-notify`, `newsletter`, `form-contact`, `pricing-table` |
+| Heroes | `hero-split`, `hero-overlay`, `hero-overlay-single`, `hero-overlay-slider`, `hero-saas-split`, `hero-saas-stacked`, `hero-saas-centered`, `hero-collage`, `hero-centered-image`, `hero-stacked-image`, `hero-announcement`, `simple-page-hero`, `page-hero-left`, `page-hero-center` |
+| Content | `content-block`, `intro-text`, `intro-pattern`, `faq-stacked`, `faq-split`, `faq-centered`, `feature-list`, `feature-list-cta`, `feature-grid` |
+| Cards & Grids | `card-hover-reveal`, `bento-grid`, `bento-portfolio`, `posts-grid`, `posts-grid-overlay`, `grid-team`, `testimonials-grid`, `testimonials-masonry`, `testimonials-bento`, `grid-case-studies`, `grid-components`, `logo-grid-centered`, `logo-grid-row`, `logo-grid-split`, `client-logos` |
+| Forms & CTAs | `cta-banner`, `cta-split`, `cta-notify`, `newsletter`, `newsletter-card`, `newsletter-section`, `form-contact`, `pricing-table` |
 | Navigation | `nav-default`, `nav-centered`, `nav-minimal`, `nav-compact`, `nav-floating`, `footer`, `footer-brand`, `footer-links-contact` |
-| Other | `section-stats`, `social-proof`, `services`, `blog-grid`, `outreach-dashboard`, `pipeline-dashboard`, `sales-dashboard`, `testimonial-quote` |
+| Other | `section-stats`, `social-proof`, `social-proof-trust`, `services`, `blog-grid`, `outreach-dashboard`, `pipeline-dashboard`, `sales-dashboard`, `testimonial-quote`, `widget-filter` |
 
 ---
 

package/docs/package-installation.md

@@ -29,7 +29,8 @@ Edit `widgets.json` to include only the widget slugs you want. You can also let
 
 Adding or removing widget directories is reflected in `widgets.json` automatically:
 
-- **On `npm install`** — The postinstall script runs `sync-widgets` then `build`. Any new folder under `packages/widgets/{slug}` with `{slug}.php` is added to `widgets.json`; removed folders are removed from the list. Existing order is preserved; new slugs are appended sorted.
+- **On `npm install`** — The postinstall script runs `sync-widgets` then `build` by default. Any new folder under `packages/widgets/{slug}` with `{slug}.php` is added to `widgets.json`; removed folders are removed from the list. Existing order is preserved; new slugs are appended sorted.  
+  The installers use `SOCIALLANE_SKIP_SYNC_WIDGETS=1` for base/cherry-pick flows so `widgets.json` is not expanded unintentionally.
 - **Manual sync** — From the plugin root run:
   ```bash
   npm run sync-widgets
@@ -42,7 +43,7 @@ Adding or removing widget directories is reflected in `widgets.json` automatical
     "hero-split",
     "hero-overlay",
     "content-block",
-    "faq"
+    "faq-stacked"
   ]
 }
 ```
@@ -65,10 +66,10 @@ Use submodules so each WordPress instance only has the core package and the widg
 
    # Add only the widgets you want
    git submodule add <url-to-widget-hero-split> packages/widgets/hero-split
-   git submodule add <url-to-widget-faq> packages/widgets/faq
+   git submodule add <url-to-widget-faq-stacked> packages/widgets/faq-stacked
    ```
 
-3. Update **widgets.json** so its `widgets` array lists only the slugs you added (e.g. `hero-split`, `faq`).
+3. Update **widgets.json** so its `widgets` array lists only the slugs you added (e.g. `hero-split`, `faq-stacked`).
 
 4. Install and build from plugin root (both required for styled widgets):
 
@@ -123,13 +124,13 @@ The plugin is published as `@sociallane/elements`. To publish:
 
 ## Per-widget npm packages
 
-Individual widgets are published as `@sociallane/widget-<slug>` (e.g. `@sociallane/widget-hero-overlay`). Run from your WordPress root or `wp-content/plugins`:
+Individual widgets are published as `@sociallane/widget-<slug>` (for example `@sociallane/widget-faq-stacked`). Run from your WordPress root or `wp-content/plugins`:
 
 ```bash
-npx @sociallane/widget-hero-overlay
+npx @sociallane/widget-faq-stacked
 ```
 
-The installer installs the base plugin (`@sociallane/elements`) with `--minimal` if it is not present, then copies the widget into the plugin, runs `sync-widgets`, and `npm install`. Use these when you want a one-command install for a single widget. To add multiple widgets, `npx @sociallane/elements add slug1 slug2` is usually simpler.
+The installer installs the base plugin (`@sociallane/elements`) with `--base` if it is not present, then delegates to `npx @sociallane/elements add --target <pluginDir> <slug>`. Use these when you want a one-command install for a single widget. To add multiple widgets, `npx @sociallane/elements add --target <pluginDir> slug1 slug2` is usually simpler.
 
 ## Adding a new widget package
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sociallane/elements",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "Elementor widgets and elements with Tailwind CSS for SocialLane. WordPress plugin.",
   "type": "module",
   "private": false,
@@ -30,8 +30,13 @@
     "postinstall": "node scripts/postinstall.js",
     "setup": "bash scripts/setup.sh",
     "sync-widgets": "node scripts/sync-widgets.js",
+    "manifest:widgets": "node scripts/generate-widget-manifest.js",
+    "generate:widget-table": "node scripts/generate-widget-table.js",
     "build:widget-packages": "node scripts/build-widget-packages.js",
     "publish:widgets": "node scripts/build-widget-packages.js && node scripts/publish-widget-packages.js",
+    "test:cli-smoke": "node scripts/test-cli-smoke.js",
+    "release:check": "node scripts/release-gate.js --strict",
+    "release:check:local": "node scripts/release-gate.js --strict --skip-registry",
     "reinstall": "rm -rf node_modules && npm install",
     "format": "prettier --write .",
     "format:check": "prettier --check ."

package/packages/widget-manifest.json

@@ -0,0 +1,291 @@
+{
+  "schema_version": 1,
+  "generated_at": "2026-02-10T09:16:15.290Z",
+  "source": "packages/widgets",
+  "widgets": [
+    {
+      "slug": "bento-grid",
+      "package": "@sociallane/widget-bento-grid"
+    },
+    {
+      "slug": "bento-grid-4",
+      "package": "@sociallane/widget-bento-grid-4"
+    },
+    {
+      "slug": "bento-grid-5",
+      "package": "@sociallane/widget-bento-grid-5"
+    },
+    {
+      "slug": "bento-grid-6",
+      "package": "@sociallane/widget-bento-grid-6"
+    },
+    {
+      "slug": "bento-portfolio",
+      "package": "@sociallane/widget-bento-portfolio"
+    },
+    {
+      "slug": "bento-portfolio-4",
+      "package": "@sociallane/widget-bento-portfolio-4"
+    },
+    {
+      "slug": "bento-portfolio-5",
+      "package": "@sociallane/widget-bento-portfolio-5"
+    },
+    {
+      "slug": "bento-portfolio-6",
+      "package": "@sociallane/widget-bento-portfolio-6"
+    },
+    {
+      "slug": "blog-grid",
+      "package": "@sociallane/widget-blog-grid"
+    },
+    {
+      "slug": "card-hover-reveal",
+      "package": "@sociallane/widget-card-hover-reveal"
+    },
+    {
+      "slug": "client-logos",
+      "package": "@sociallane/widget-client-logos"
+    },
+    {
+      "slug": "content-block",
+      "package": "@sociallane/widget-content-block"
+    },
+    {
+      "slug": "cta-banner",
+      "package": "@sociallane/widget-cta-banner"
+    },
+    {
+      "slug": "cta-notify",
+      "package": "@sociallane/widget-cta-notify"
+    },
+    {
+      "slug": "cta-split",
+      "package": "@sociallane/widget-cta-split"
+    },
+    {
+      "slug": "faq-centered",
+      "package": "@sociallane/widget-faq-centered"
+    },
+    {
+      "slug": "faq-split",
+      "package": "@sociallane/widget-faq-split"
+    },
+    {
+      "slug": "faq-stacked",
+      "package": "@sociallane/widget-faq-stacked"
+    },
+    {
+      "slug": "feature-grid",
+      "package": "@sociallane/widget-feature-grid"
+    },
+    {
+      "slug": "feature-grid-centered",
+      "package": "@sociallane/widget-feature-grid-centered"
+    },
+    {
+      "slug": "feature-list",
+      "package": "@sociallane/widget-feature-list"
+    },
+    {
+      "slug": "feature-list-cta",
+      "package": "@sociallane/widget-feature-list-cta"
+    },
+    {
+      "slug": "footer",
+      "package": "@sociallane/widget-footer"
+    },
+    {
+      "slug": "footer-brand",
+      "package": "@sociallane/widget-footer-brand"
+    },
+    {
+      "slug": "footer-links-contact",
+      "package": "@sociallane/widget-footer-links-contact"
+    },
+    {
+      "slug": "form-contact",
+      "package": "@sociallane/widget-form-contact"
+    },
+    {
+      "slug": "grid-case-studies",
+      "package": "@sociallane/widget-grid-case-studies"
+    },
+    {
+      "slug": "grid-components",
+      "package": "@sociallane/widget-grid-components"
+    },
+    {
+      "slug": "grid-team",
+      "package": "@sociallane/widget-grid-team"
+    },
+    {
+      "slug": "hero-announcement",
+      "package": "@sociallane/widget-hero-announcement"
+    },
+    {
+      "slug": "hero-centered-image",
+      "package": "@sociallane/widget-hero-centered-image"
+    },
+    {
+      "slug": "hero-collage",
+      "package": "@sociallane/widget-hero-collage"
+    },
+    {
+      "slug": "hero-overlay",
+      "package": "@sociallane/widget-hero-overlay"
+    },
+    {
+      "slug": "hero-overlay-single",
+      "package": "@sociallane/widget-hero-overlay-single"
+    },
+    {
+      "slug": "hero-overlay-slider",
+      "package": "@sociallane/widget-hero-overlay-slider"
+    },
+    {
+      "slug": "hero-saas-centered",
+      "package": "@sociallane/widget-hero-saas-centered"
+    },
+    {
+      "slug": "hero-saas-split",
+      "package": "@sociallane/widget-hero-saas-split"
+    },
+    {
+      "slug": "hero-saas-stacked",
+      "package": "@sociallane/widget-hero-saas-stacked"
+    },
+    {
+      "slug": "hero-split",
+      "package": "@sociallane/widget-hero-split"
+    },
+    {
+      "slug": "hero-stacked-image",
+      "package": "@sociallane/widget-hero-stacked-image"
+    },
+    {
+      "slug": "intro-pattern",
+      "package": "@sociallane/widget-intro-pattern"
+    },
+    {
+      "slug": "intro-text",
+      "package": "@sociallane/widget-intro-text"
+    },
+    {
+      "slug": "logo-grid-centered",
+      "package": "@sociallane/widget-logo-grid-centered"
+    },
+    {
+      "slug": "logo-grid-row",
+      "package": "@sociallane/widget-logo-grid-row"
+    },
+    {
+      "slug": "logo-grid-split",
+      "package": "@sociallane/widget-logo-grid-split"
+    },
+    {
+      "slug": "nav-centered",
+      "package": "@sociallane/widget-nav-centered"
+    },
+    {
+      "slug": "nav-compact",
+      "package": "@sociallane/widget-nav-compact"
+    },
+    {
+      "slug": "nav-default",
+      "package": "@sociallane/widget-nav-default"
+    },
+    {
+      "slug": "nav-floating",
+      "package": "@sociallane/widget-nav-floating"
+    },
+    {
+      "slug": "nav-minimal",
+      "package": "@sociallane/widget-nav-minimal"
+    },
+    {
+      "slug": "newsletter",
+      "package": "@sociallane/widget-newsletter"
+    },
+    {
+      "slug": "newsletter-card",
+      "package": "@sociallane/widget-newsletter-card"
+    },
+    {
+      "slug": "newsletter-section",
+      "package": "@sociallane/widget-newsletter-section"
+    },
+    {
+      "slug": "outreach-dashboard",
+      "package": "@sociallane/widget-outreach-dashboard"
+    },
+    {
+      "slug": "page-hero-center",
+      "package": "@sociallane/widget-page-hero-center"
+    },
+    {
+      "slug": "page-hero-left",
+      "package": "@sociallane/widget-page-hero-left"
+    },
+    {
+      "slug": "pipeline-dashboard",
+      "package": "@sociallane/widget-pipeline-dashboard"
+    },
+    {
+      "slug": "posts-grid",
+      "package": "@sociallane/widget-posts-grid"
+    },
+    {
+      "slug": "posts-grid-overlay",
+      "package": "@sociallane/widget-posts-grid-overlay"
+    },
+    {
+      "slug": "pricing-table",
+      "package": "@sociallane/widget-pricing-table"
+    },
+    {
+      "slug": "sales-dashboard",
+      "package": "@sociallane/widget-sales-dashboard"
+    },
+    {
+      "slug": "section-stats",
+      "package": "@sociallane/widget-section-stats"
+    },
+    {
+      "slug": "services",
+      "package": "@sociallane/widget-services"
+    },
+    {
+      "slug": "simple-page-hero",
+      "package": "@sociallane/widget-simple-page-hero"
+    },
+    {
+      "slug": "social-proof",
+      "package": "@sociallane/widget-social-proof"
+    },
+    {
+      "slug": "social-proof-trust",
+      "package": "@sociallane/widget-social-proof-trust"
+    },
+    {
+      "slug": "testimonial-quote",
+      "package": "@sociallane/widget-testimonial-quote"
+    },
+    {
+      "slug": "testimonials-bento",
+      "package": "@sociallane/widget-testimonials-bento"
+    },
+    {
+      "slug": "testimonials-grid",
+      "package": "@sociallane/widget-testimonials-grid"
+    },
+    {
+      "slug": "testimonials-masonry",
+      "package": "@sociallane/widget-testimonials-masonry"
+    },
+    {
+      "slug": "widget-filter",
+      "package": "@sociallane/widget-widget-filter"
+    }
+  ]
+}

package/packages/widgets/widget-filter/data/view.php

@@ -484,8 +484,8 @@ function prepare_widget_filter_view( array $settings, string $widget_id ): array
 	// Grid columns class
 	$grid_columns = [
 		'2' => 'grid-cols-1 sm:grid-cols-2',
-		'3' => 'grid-cols-1 sm:grid-cols-2 lg:grid-cols-3',
-		'4' => 'grid-cols-1 sm:grid-cols-2 lg:grid-cols-4',
+		'3' => 'grid-cols-1 sm:grid-cols-2 md:grid-cols-3',
+		'4' => 'grid-cols-1 sm:grid-cols-2 md:grid-cols-3 xl:grid-cols-4',
 	];
 	$grid_class = $grid_columns[ $columns ] ?? $grid_columns['3'];
 

package/scripts/build-widget-packages.js

@@ -5,27 +5,15 @@
  * Run from plugin root: npm run build:widget-packages
  */
 
-import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'fs';
+import { cpSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
+import { getWidgetSourceDir, syncWidgetManifest } from './lib/widgets-manifest.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const pluginRoot = path.resolve(__dirname, '..');
-const widgetsDir = path.join(pluginRoot, 'packages', 'widgets');
 const npmWidgetsDir = path.join(pluginRoot, 'packages', 'npm-widgets');
-
-function getWidgetSlugs() {
-  if (!existsSync(widgetsDir)) return [];
-  const entries = readdirSync(widgetsDir, { withFileTypes: true });
-  const slugs = [];
-  for (const ent of entries) {
-    if (!ent.isDirectory()) continue;
-    const slug = ent.name;
-    const phpFile = path.join(widgetsDir, slug, `${slug}.php`);
-    if (existsSync(phpFile)) slugs.push(slug);
-  }
-  return slugs.sort((a, b) => a.localeCompare(b));
-}
+const widgetsDir = getWidgetSourceDir(pluginRoot);
 
 function getRootVersion() {
   const pkgPath = path.join(pluginRoot, 'package.json');
@@ -79,7 +67,8 @@ This installs the SocialLane Elements plugin if needed, then adds this widget an
 }
 
 function main() {
-  const slugs = getWidgetSlugs();
+  const manifest = syncWidgetManifest(pluginRoot);
+  const slugs = manifest.widgets.map((widget) => widget.slug);
   const version = getRootVersion();
   if (!existsSync(npmWidgetsDir)) mkdirSync(npmWidgetsDir, { recursive: true });
   for (const slug of slugs) {

package/scripts/generate-widget-manifest.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * Generate packages/widget-manifest.json from widget sources on disk.
+ * Run from plugin root: npm run manifest:widgets
+ */
+
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { syncWidgetManifest, getWidgetManifestPath } from './lib/widgets-manifest.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const pluginRoot = path.resolve(__dirname, '..');
+
+const manifest = syncWidgetManifest(pluginRoot);
+const manifestPath = getWidgetManifestPath(pluginRoot);
+
+console.log(
+  `Widget manifest updated: ${manifest.widgets.length} widgets (${manifest.source}) -> ${manifestPath}`
+);