@marvalt/digivalt-core 0.2.16 → 0.2.17
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +9 -0
- package/README.md +1 -1
- package/docs/ENVIRONMENT.md +12 -0
- package/docs/README.md +25 -0
- package/package.json +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,15 @@ All notable changes to this project will be documented in this file.
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
|
6
6
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
7
|
|
|
8
|
+
## [0.2.17] - 2026-05-29
|
|
9
|
+
|
|
10
|
+
### Added
|
|
11
|
+
- **`docs/README.md`:** documentation index for developers and AI agents (links ENVIRONMENT, SEO, bootstrap docs, and adapter packages).
|
|
12
|
+
- Publish **`verify-pack`** guard ensures README and docs ship in npm tarball.
|
|
13
|
+
|
|
14
|
+
### Changed
|
|
15
|
+
- **`docs/ENVIRONMENT.md`:** React 19 install note (`legacy-peer-deps` / `.npmrc`) for `react-helmet-async` peer resolution.
|
|
16
|
+
|
|
8
17
|
## [0.2.16] - 2026-05-29
|
|
9
18
|
|
|
10
19
|
### Changed
|
package/README.md
CHANGED
|
@@ -8,7 +8,7 @@ Core DigiVAlt package for static data generation, runtime service wiring, and Cl
|
|
|
8
8
|
npm install @marvalt/digivalt-core
|
|
9
9
|
```
|
|
10
10
|
|
|
11
|
-
Full handover
|
|
11
|
+
Full handover docs: **[docs/README.md](./docs/README.md)** and **[docs/ENVIRONMENT.md](./docs/ENVIRONMENT.md)**. After install: `node_modules/@marvalt/digivalt-core/docs/README.md`.
|
|
12
12
|
|
|
13
13
|
In the **DigiVAlt monorepo**, **`digivalt-landing`** is the reference Vite app used to test this package with WordPress plugins and Cloudflare Pages.
|
|
14
14
|
|
package/docs/ENVIRONMENT.md
CHANGED
|
@@ -18,6 +18,18 @@ The command **creates or updates** `.env.example` and `.env.local.example`. The
|
|
|
18
18
|
|
|
19
19
|
**`VITE_IS_LOVABLE` (generators only):** Used in hosted Lovable/CI “fixture” flows to skip live API fetches. **Do not set this in local full-data development.** See [SEO-PERFORMANCE.md](./SEO-PERFORMANCE.md) and your app’s `DIGIVALT_SETUP.md`. It is **not** part of the managed example block; it is listed in `deploy-secrets` excluded keys (below).
|
|
20
20
|
|
|
21
|
+
## React 19 install (consumer apps)
|
|
22
|
+
|
|
23
|
+
`@marvalt/digivalt-core` peers **`react-helmet-async`** for SEO (`@marvalt/digivalt-core/seo`). That package currently declares peer support for React 16–18 only. If your app uses **React 19**, npm may fail with `ERESOLVE`:
|
|
24
|
+
|
|
25
|
+
**Fix:** add a project **`.npmrc`** file:
|
|
26
|
+
|
|
27
|
+
```ini
|
|
28
|
+
legacy-peer-deps=true
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Or install once with `npm install --legacy-peer-deps`. Runtime behavior with React 19 is fine; this is an npm peer-range mismatch until upstream updates.
|
|
32
|
+
|
|
21
33
|
## Handover to DevOps (Cloudflare and secrets)
|
|
22
34
|
|
|
23
35
|
### `node scripts/deploy-secrets.js`
|
package/docs/README.md
ADDED
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# @marvalt/digivalt-core documentation
|
|
2
|
+
|
|
3
|
+
Read these in order for DigiValt app setup, deploy, and SEO.
|
|
4
|
+
|
|
5
|
+
| Doc | Audience | Purpose |
|
|
6
|
+
|-----|----------|---------|
|
|
7
|
+
| [ENVIRONMENT.md](./ENVIRONMENT.md) | Devs + DevOps | Env vars, `.env` model, Cloudflare secrets, React 19 install |
|
|
8
|
+
| [AI-LOCAL-WORDPRESS-BOOTSTRAP.md](./AI-LOCAL-WORDPRESS-BOOTSTRAP.md) | Humans | Local WordPress handover runbook |
|
|
9
|
+
| [LOVABLE-MASTER-PROMPT.md](./LOVABLE-MASTER-PROMPT.md) | AI tools | Tool-agnostic scaffold prompt |
|
|
10
|
+
| [SEO-PERFORMANCE.md](./SEO-PERFORMANCE.md) | Devs | `DigiValtSeoHead`, sitemap, `VITE_SEO_*`, performance |
|
|
11
|
+
|
|
12
|
+
Package root [README.md](../README.md) covers `digivalt-init`, generators, and entry points.
|
|
13
|
+
|
|
14
|
+
## Adapter packages (installed as dependencies)
|
|
15
|
+
|
|
16
|
+
Each ships its own `docs/README.md` under `node_modules/@marvalt/<package>/docs/`:
|
|
17
|
+
|
|
18
|
+
- `@marvalt/wadapter` — WordPress + Gravity Forms
|
|
19
|
+
- `@marvalt/madapter` — Mautic
|
|
20
|
+
- `@marvalt/wparser` — Gutenberg block rendering
|
|
21
|
+
- `@marvalt/dstyler` — Theme / section styling
|
|
22
|
+
- `@marvalt/shcoder` — CPT shortcode components
|
|
23
|
+
- `@marvalt/tadapter` — Testimonial submission
|
|
24
|
+
- `@marvalt/sadapter` — SuiteCRM
|
|
25
|
+
- `@marvalt/cadapter` — Calendly embeds
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@marvalt/digivalt-core",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.17",
|
|
4
4
|
"description": "Core glue logic and shared context for DigiVAlt frontend applications",
|
|
5
5
|
"license": "GPL-3.0-or-later",
|
|
6
6
|
"main": "dist/index.cjs",
|
|
@@ -68,7 +68,7 @@
|
|
|
68
68
|
"smoke:sitemap": "node ./scripts/test-sitemap-paths.cjs",
|
|
69
69
|
"smoke:google-reviews-gate": "node ./scripts/test-google-reviews-gate.cjs",
|
|
70
70
|
"smoke": "npm run smoke:imports && npm run smoke:init && npm run smoke:sitemap && npm run smoke:google-reviews-gate",
|
|
71
|
-
"prepublishOnly": "npm run clean && npm run build && npm run smoke"
|
|
71
|
+
"prepublishOnly": "npm run clean && npm run build && npm run smoke && node ../scripts/verify-pack.cjs"
|
|
72
72
|
},
|
|
73
73
|
"devDependencies": {
|
|
74
74
|
"react": "^18.3.1",
|