@openstack_dev/gatsby-theme-marketing-oif-core 1.0.41 → 1.0.42

package/.codegraph/config.json

@@ -0,0 +1,140 @@
+{
+  "version": 1,
+  "include": [
+    "**/*.ts",
+    "**/*.tsx",
+    "**/*.js",
+    "**/*.jsx",
+    "**/*.py",
+    "**/*.go",
+    "**/*.rs",
+    "**/*.java",
+    "**/*.c",
+    "**/*.h",
+    "**/*.cpp",
+    "**/*.hpp",
+    "**/*.cc",
+    "**/*.cxx",
+    "**/*.cs",
+    "**/*.php",
+    "**/*.rb",
+    "**/*.swift",
+    "**/*.kt",
+    "**/*.kts",
+    "**/*.dart",
+    "**/*.svelte",
+    "**/*.liquid",
+    "**/*.pas",
+    "**/*.dpr",
+    "**/*.dpk",
+    "**/*.lpr",
+    "**/*.dfm",
+    "**/*.fmx"
+  ],
+  "exclude": [
+    "**/.git/**",
+    "**/node_modules/**",
+    "**/vendor/**",
+    "**/Pods/**",
+    "**/dist/**",
+    "**/build/**",
+    "**/out/**",
+    "**/bin/**",
+    "**/obj/**",
+    "**/target/**",
+    "**/*.min.js",
+    "**/*.bundle.js",
+    "**/.next/**",
+    "**/.nuxt/**",
+    "**/.svelte-kit/**",
+    "**/.output/**",
+    "**/.turbo/**",
+    "**/.cache/**",
+    "**/.parcel-cache/**",
+    "**/.vite/**",
+    "**/.astro/**",
+    "**/.docusaurus/**",
+    "**/.gatsby/**",
+    "**/.webpack/**",
+    "**/.nx/**",
+    "**/.yarn/cache/**",
+    "**/.pnpm-store/**",
+    "**/storybook-static/**",
+    "**/.expo/**",
+    "**/web-build/**",
+    "**/ios/Pods/**",
+    "**/ios/build/**",
+    "**/android/build/**",
+    "**/android/.gradle/**",
+    "**/__pycache__/**",
+    "**/.venv/**",
+    "**/venv/**",
+    "**/site-packages/**",
+    "**/dist-packages/**",
+    "**/.pytest_cache/**",
+    "**/.mypy_cache/**",
+    "**/.ruff_cache/**",
+    "**/.tox/**",
+    "**/.nox/**",
+    "**/*.egg-info/**",
+    "**/.eggs/**",
+    "**/go/pkg/mod/**",
+    "**/target/debug/**",
+    "**/target/release/**",
+    "**/.gradle/**",
+    "**/.m2/**",
+    "**/generated-sources/**",
+    "**/.kotlin/**",
+    "**/.dart_tool/**",
+    "**/.vs/**",
+    "**/.nuget/**",
+    "**/artifacts/**",
+    "**/publish/**",
+    "**/cmake-build-*/**",
+    "**/CMakeFiles/**",
+    "**/bazel-*/**",
+    "**/vcpkg_installed/**",
+    "**/.conan/**",
+    "**/Debug/**",
+    "**/Release/**",
+    "**/x64/**",
+    "**/release/**",
+    "**/*.app/**",
+    "**/*.asar",
+    "**/DerivedData/**",
+    "**/.build/**",
+    "**/.swiftpm/**",
+    "**/xcuserdata/**",
+    "**/Carthage/Build/**",
+    "**/SourcePackages/**",
+    "**/__history/**",
+    "**/__recovery/**",
+    "**/*.dcu",
+    "**/.composer/**",
+    "**/storage/framework/**",
+    "**/bootstrap/cache/**",
+    "**/.bundle/**",
+    "**/tmp/cache/**",
+    "**/public/assets/**",
+    "**/public/packs/**",
+    "**/.yardoc/**",
+    "**/coverage/**",
+    "**/htmlcov/**",
+    "**/.nyc_output/**",
+    "**/test-results/**",
+    "**/.coverage/**",
+    "**/.idea/**",
+    "**/logs/**",
+    "**/tmp/**",
+    "**/temp/**",
+    "**/_build/**",
+    "**/docs/_build/**",
+    "**/site/**"
+  ],
+  "languages": [],
+  "frameworks": [],
+  "maxFileSize": 1048576,
+  "extractDocstrings": true,
+  "trackCallSites": true,
+  "enableEmbeddings": true
+}

package/docs/plans/2026-03-31-sass-loader-modern-compiler.md

@@ -0,0 +1,144 @@
+# Sass-Loader Modern Compiler API Configuration Plan
+
+Created: 2026-03-31
+Author: smarcet@gmail.com
+Status: COMPLETE
+Approved: Yes
+Iterations: 0
+Worktree: No
+Type: Feature
+
+## Summary
+
+**Goal:** Upgrade sass-loader from 10.5.2 to v16 and configure it to use the `modern-compiler` API for faster Sass compilation.
+**Architecture:** Use yarn resolutions to override gatsby-plugin-sass's pinned sass-loader dependency, then pass the `api: "modern-compiler"` option through gatsby-plugin-sass's config in gatsby-config.js.
+**Tech Stack:** sass-loader v16, sass 1.98.0 (already installed), gatsby-plugin-sass 6.16.0
+
+## Scope
+
+### In Scope
+
+- Upgrade sass-loader from 10.5.2 to v16 via yarn resolutions
+- Configure `api: "modern-compiler"` in gatsby-plugin-sass options
+- Verify build works with the new configuration
+
+### Out of Scope
+
+- Upgrading gatsby-plugin-sass itself (stays at 6.16.0)
+- Installing sass-embedded (sass 1.98.0 already supports the modern-compiler API)
+- Custom sassOptions beyond the API selection
+- Changes to SCSS files
+
+## Approach
+
+**Chosen:** Yarn resolutions to force sass-loader v16 + gatsby-config.js plugin options
+**Why:** Simplest approach — 2 file edits, no webpack config manipulation needed. gatsby-plugin-sass's source code already spreads `...sassLoaderOptions` into the sass-loader options object, so passing `api: "modern-compiler"` through the plugin config naturally flows to sass-loader.
+**Alternatives considered:**
+- **gatsby-node.js webpack override** — Install sass-loader v16 as direct dependency, use `getConfig()` in `onCreateWebpackConfig` to find and replace sass-loader entries. Rejected: more complex, fragile (depends on webpack rule structure), and unnecessary given the rest-spread passthrough in gatsby-plugin-sass.
+- **gatsby-node.js + resolutions** — Combine both approaches. Rejected: redundant, since resolutions alone handle the version upgrade cleanly.
+
+## Context for Implementer
+
+> Write for an implementer who has never seen the codebase.
+
+- **Patterns to follow:** gatsby-config.js plugin configuration pattern at `gatsby-config.js:141-149`
+- **Conventions:** Plugin options are objects passed in the `options` key of each plugin entry
+- **Key files:**
+  - `package.json` — add resolutions field
+  - `gatsby-config.js:141-149` — gatsby-plugin-sass options (currently has `cssLoaderOptions` only)
+  - `node_modules/gatsby-plugin-sass/gatsby-node.js:15-33` — how the plugin constructs sass-loader options (the `...sassLoaderOptions` rest spread on line 19 captures `api` and spreads it into sass-loader options on line 32)
+- **Gotchas:**
+  - `gatsby-plugin-sass@6.16.0` pins `sass-loader@^10.4.1` in its own dependencies. Without resolutions, yarn will always install 10.5.2 regardless of what's in the project's package.json.
+  - sass-loader v16 defaults to `modern-compiler` API, but we explicitly set it for clarity and to survive potential future default changes.
+  - In the modern-compiler API, the `sassOptions` format differs from legacy: `outputStyle` → `style`, `includePaths` → `loadPaths`. This project doesn't pass custom sassOptions, so no migration needed.
+  - The plugin's Joi schema uses `.unknown(true)` so it accepts the `api` key without validation errors.
+
+## Assumptions
+
+- sass 1.98.0 (declared in package.json) is compatible with sass-loader v16's modern-compiler API — supported by [sass-loader docs](https://webpack.js.org/loaders/sass-loader/#api) stating `sass >= 1.3.0` is a valid peer dependency — Task 1, Task 2 depend on this
+- gatsby-plugin-sass's rest-spread pattern (`...sassLoaderOptions`) correctly forwards the `api` option to sass-loader — supported by reading `node_modules/gatsby-plugin-sass/gatsby-node.js:19,32` — Task 2 depends on this
+- sass-loader v16 is compatible with webpack 5 (Gatsby 5's bundler) — supported by sass-loader's peer deps declaring `webpack ^5.0.0` — Task 1 depends on this
+
+## Risks and Mitigations
+
+| Risk | Likelihood | Impact | Mitigation |
+|------|-----------|--------|------------|
+| sass-loader v16 introduces breaking changes incompatible with gatsby-plugin-sass's loader construction | Low | High | The plugin only passes `sourceMap`, `sassOptions`, `additionalData` — all valid in v16. Verify with `gatsby build`. |
+| yarn resolutions cause other packages to get unexpected sass-loader version | Low | Medium | Scope the resolution to `gatsby-plugin-sass/sass-loader` only, not a global override |
+
+## Goal Verification
+
+### Truths
+
+1. `yarn install` resolves sass-loader to v16.x (not 10.x)
+2. `gatsby build` completes without sass-loader errors
+3. The sass-loader config in the webpack output includes `api: "modern-compiler"`
+
+### Artifacts
+
+- `package.json` — contains `resolutions` field with sass-loader override
+- `gatsby-config.js` — gatsby-plugin-sass options include `api: "modern-compiler"`
+
+## Progress Tracking
+
+- [x] Task 1: Add yarn resolutions for sass-loader v16
+- [x] Task 2: Configure modern-compiler API in gatsby-plugin-sass options
+      **Total Tasks:** 2 | **Completed:** 2 | **Remaining:** 0
+
+## Implementation Tasks
+
+### Task 1: Add yarn resolutions for sass-loader v16
+
+**Objective:** Force sass-loader to v16.x via yarn resolutions, overriding gatsby-plugin-sass's `^10.4.1` pin.
+**Dependencies:** None
+
+**Files:**
+
+- Modify: `package.json`
+
+**Key Decisions / Notes:**
+
+- Use scoped resolution `"gatsby-plugin-sass/sass-loader": "^16.0.0"` to only affect the sass-loader resolved through gatsby-plugin-sass
+- Add `resolutions` field at top level of package.json (doesn't exist yet). If it exists in the future, merge the sass-loader entry into the existing object.
+- Run `yarn install` after adding the resolution to apply it
+
+**Definition of Done:**
+
+- [ ] `package.json` has a `resolutions` field with `"gatsby-plugin-sass/sass-loader": "^16.0.0"`
+- [ ] `yarn install` completes without errors
+- [ ] `node -e "console.log(require('sass-loader/package.json').version)"` outputs 16.x
+
+**Verify:**
+
+- `node -e "console.log(require('sass-loader/package.json').version)"` — should output 16.x
+- `grep -A 2 'sass-loader@' yarn.lock | head -6` — confirm resolved version in dependency graph
+
+### Task 2: Configure modern-compiler API in gatsby-plugin-sass options
+
+**Objective:** Pass `api: "modern-compiler"` through gatsby-plugin-sass's plugin options so it reaches sass-loader via the rest-spread pattern.
+**Dependencies:** Task 1
+
+**Files:**
+
+- Modify: `gatsby-config.js`
+
+**Key Decisions / Notes:**
+
+- Add `api: "modern-compiler"` to the existing gatsby-plugin-sass options object at `gatsby-config.js:142-149`
+- The option goes alongside the existing `cssLoaderOptions` — NOT inside it
+- gatsby-plugin-sass destructures known options (`cssLoaderOptions`, `sassOptions`, `postCssPlugins`, etc.) and passes the rest (`...sassLoaderOptions`) directly to sass-loader (see `node_modules/gatsby-plugin-sass/gatsby-node.js:19,32`)
+- The plugin's Joi schema at line 120 uses `.unknown(true)`, so `api` passes validation
+
+**Definition of Done:**
+
+- [ ] gatsby-config.js gatsby-plugin-sass options include `api: "modern-compiler"` alongside existing `cssLoaderOptions`
+- [ ] `gatsby build` passes through webpack config phase without sass-loader errors (full build requires API data, so config initialization is the meaningful check)
+- [ ] SCSS files compile successfully during build
+
+**Verify:**
+
+- `node --trace-warnings node_modules/.bin/gatsby build` (verify build passes webpack config and SCSS compilation; an axios error in onPreBootstrap is expected and unrelated — it's a data fetch issue)
+
+## Open Questions
+
+None — the path is clear.

package/gatsby-config.js

@@ -140,15 +140,12 @@ const plugins = [
      */
     resolve: "gatsby-plugin-sass",
     options: {
+      api: "modern-compiler",
       cssLoaderOptions: {
         esModule: false,
         modules: {
           namedExport: false
         }
-      },
-      sassLoaderOptions: {
-        api: "modern-compiler",
-        silenceDeprecations: ["legacy-js-api"]
       }
     }
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openstack_dev/gatsby-theme-marketing-oif-core",
-  "version": "1.0.41",
+  "version": "1.0.42",
   "description": "Base theme for Marketing Sites",
   "author": "smarcet",
   "keywords": [
@@ -22,6 +22,9 @@
     "*.{js,jsx}": "eslint --fix",
     "**/*": "prettier --write --ignore-unknown"
   },
+  "resolutions": {
+    "gatsby-plugin-sass/sass-loader": "^16.0.0"
+  },
   "dependencies": {
     "@babel/core": "^7.26.10",
     "@babel/preset-env": "^7.26.9",

package/src/content/site-settings/index.json

@@ -1 +1 @@
-{"staticJsonFilesBuildTime":[],"lastBuild":1774023818781}
+{"staticJsonFilesBuildTime":[],"lastBuild":1774934531441}