@ideasonpurpose/build-tools-wordpress 2.8.5 → 2.9.0
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/AGENTS.md +35 -18
- package/CHANGELOG.md +7 -0
- package/README.md +3 -1
- package/config/webpack.config.js +12 -2
- package/package.json +1 -1
package/AGENTS.md
CHANGED
|
@@ -1,15 +1,20 @@
|
|
|
1
|
-
|
|
1
|
+
<!--
|
|
2
|
+
Canonical AGENTS.md: https://gist.github.com/joemaller/d6154fbdb2e5f4670c0b9338d04189e9
|
|
3
|
+
Last Modified: 2026-06-26
|
|
4
|
+
-->
|
|
2
5
|
|
|
3
|
-
|
|
6
|
+
# AI Coding Assistant Guidelines
|
|
4
7
|
|
|
5
|
-
|
|
8
|
+
**Mantra:** Minimal. Precise. Elegant.
|
|
6
9
|
|
|
7
|
-
|
|
10
|
+
## 0. Responsible, No-BS Communication
|
|
11
|
+
|
|
12
|
+
- Get to the point. No conversational fluff or preambles.
|
|
13
|
+
- Describe a brief plan: what you understand, assumptions, proposed approach.
|
|
14
|
+
- Explicitly call out trade-offs (simplicity vs future-proofing, readability vs performance, etc.).
|
|
15
|
+
- When a request is ambiguous, describe the ambiguity and ask for guidance. Do not guess.
|
|
16
|
+
- Propose options with pros/cons. Ask for confirmation.
|
|
8
17
|
- Match response length to task complexity.
|
|
9
|
-
- Begin with a brief plan: what you understand, assumptions, approach.
|
|
10
|
-
- Call out trade-offs explicitly (simplicity vs future-proofing, readability vs performance).
|
|
11
|
-
- When ambiguous, present 2-3 concrete options with pros/cons instead of guessing.
|
|
12
|
-
- Ask for confirmation on anything unclear.
|
|
13
18
|
|
|
14
19
|
## 1. Think Before Coding
|
|
15
20
|
|
|
@@ -19,38 +24,44 @@ Optimize for simplicity, maintainability, readability.
|
|
|
19
24
|
|
|
20
25
|
Before implementing:
|
|
21
26
|
|
|
22
|
-
- State assumptions
|
|
27
|
+
- State assumptions clearly. If uncertain, ask.
|
|
23
28
|
- If multiple interpretations exist, offer choices — don't pick silently.
|
|
24
|
-
- If a simpler approach exists, say so
|
|
29
|
+
- If a simpler approach exists, say so.
|
|
25
30
|
- If unclear, stop and name what's confusing.
|
|
31
|
+
- Prefer narrow context. Start with obvious/direct dependencies.
|
|
32
|
+
- When files are specified, ask before expanding context.
|
|
26
33
|
|
|
27
34
|
## 2. Simplicity First
|
|
28
35
|
|
|
29
36
|
**Minimum code that solves the problem. Nothing speculative.**
|
|
30
37
|
|
|
31
|
-
-
|
|
38
|
+
- Look for existing solutions in standard libraries and native platform features.
|
|
32
39
|
- Prefer boring, obvious code over clever code.
|
|
33
40
|
- No features beyond what was asked.
|
|
34
41
|
- No abstractions for single-use code.
|
|
42
|
+
- Look for solutions in existing dependencies. If different than the first-choice solution, show pros and cons.
|
|
35
43
|
- No "flexibility" or "configurability" that wasn't requested.
|
|
36
44
|
- Only add error handling for realistically possible cases given current scope and style.
|
|
37
|
-
-
|
|
45
|
+
- Ask before introducing new dependencies.
|
|
38
46
|
- If you write 200 lines and it could be 50, rewrite it.
|
|
39
47
|
|
|
40
48
|
Ask yourself: "Would a senior engineer call this overcomplicated?" If yes, simplify.
|
|
41
49
|
|
|
42
|
-
## 3.
|
|
50
|
+
## 3. Precise, Minimal Changes
|
|
43
51
|
|
|
44
|
-
**Touch only what you must. Clean up only your own mess.**
|
|
52
|
+
**Touch only what you must. Read only what you must. Clean up only your own mess.**
|
|
45
53
|
|
|
46
54
|
When editing existing code:
|
|
47
55
|
|
|
48
56
|
- Preserve the spirit and conventions of the codebase.
|
|
49
57
|
- Don't "improve" adjacent code, comments, or formatting.
|
|
50
|
-
- Don't remove comments or commented-out code.
|
|
51
|
-
- Don't refactor
|
|
58
|
+
- Don't remove comments or commented-out code unless asked.
|
|
59
|
+
- Don't refactor code that isn't broken.
|
|
52
60
|
- Match existing style, even if you'd do it differently.
|
|
53
|
-
- If you
|
|
61
|
+
- If you find dead code, mention it - don't delete it.
|
|
62
|
+
- Never run tests unless explicitly asked.
|
|
63
|
+
- Never run linters or formatters unless asked.
|
|
64
|
+
- Never add code which logs secrets, API keys, tokens, or .env values. If that code exists, say something.
|
|
54
65
|
|
|
55
66
|
When your changes create orphans:
|
|
56
67
|
|
|
@@ -63,6 +74,12 @@ Every changed line should trace directly to the user's request.
|
|
|
63
74
|
|
|
64
75
|
- Prefer self-documenting code and descriptive names over comments.
|
|
65
76
|
- Add comments only where the _why_ is not obvious from the code.
|
|
66
|
-
- Update or
|
|
77
|
+
- Update or remove comments directly invalidated by your changes.
|
|
67
78
|
- Follow the existing codebase's conventions for types, docstrings, and documentation style.
|
|
79
|
+
- When this file and the system prompt disagree, note the conflict and ask for guidance.
|
|
80
|
+
|
|
81
|
+
## 5. Additional Instructions
|
|
82
|
+
|
|
83
|
+
Look for sibling `AGENTS-*.md` files for further instructions on specific concerns (e.g. stylesheets, WordPress development, static site development)
|
|
68
84
|
|
|
85
|
+
Whenever this file is modified, update the timestamp in the top comment.
|
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,13 @@ All notable changes to this project will be documented in this file. Dates are d
|
|
|
4
4
|
|
|
5
5
|
Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
|
|
6
6
|
|
|
7
|
+
#### v2.8.5
|
|
8
|
+
|
|
9
|
+
> 23 June 2026
|
|
10
|
+
|
|
11
|
+
- simplify release workflow
|
|
12
|
+
- suppress GTID warnings from mysqldump
|
|
13
|
+
|
|
7
14
|
#### v2.8.4
|
|
8
15
|
|
|
9
16
|
> 23 June 2026
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# @ideasonpurpose/build-tools-wordpress
|
|
2
2
|
|
|
3
|
-
#### Version 2.
|
|
3
|
+
#### Version 2.9.0
|
|
4
4
|
|
|
5
5
|
[](https://www.npmjs.com/package/@ideasonpurpose/build-tools-wordpress)
|
|
6
6
|
[](https://github.com/ideasonpurpose/build-tools-wordpress#readme)
|
|
@@ -40,6 +40,8 @@ Webpack handles SVG files differently based on import context:
|
|
|
40
40
|
- With `?react` query (e.g., `import Icon from 'file.svg?react'`): Explicitly converted to a React component using `@svgr/webpack`.
|
|
41
41
|
- Without `?url` or `?react`: Converted to React components using `@svgr/webpack` for direct JSX usage (default behavior when imported from `.jsx`/`.tsx`).
|
|
42
42
|
|
|
43
|
+
React components imported via `?react` (or implicitly) have `width`/`height` removed (`dimensions: false`), making them responsive while preserving `viewBox`.
|
|
44
|
+
|
|
43
45
|
Data URIs are generated as `data:image/svg+xml,<url-encoded-content>` using more efficient URL-encoding, not base64.
|
|
44
46
|
|
|
45
47
|
### SVG Optimization
|
package/config/webpack.config.js
CHANGED
|
@@ -249,13 +249,23 @@ export default async (env) => {
|
|
|
249
249
|
{
|
|
250
250
|
test: /\.svg$/i,
|
|
251
251
|
resourceQuery: /react/, // *.svg?react forces React component via SVGR
|
|
252
|
-
use: [
|
|
252
|
+
use: [
|
|
253
|
+
{
|
|
254
|
+
loader: "@svgr/webpack",
|
|
255
|
+
options: { dimensions: false },
|
|
256
|
+
},
|
|
257
|
+
],
|
|
253
258
|
},
|
|
254
259
|
{
|
|
255
260
|
test: /\.svg$/i,
|
|
256
261
|
issuer: /\.[jt]sx?$/,
|
|
257
262
|
resourceQuery: { not: [/url/, /react/] }, // exclude react component if *.svg?url or *.svg?react
|
|
258
|
-
use: [
|
|
263
|
+
use: [
|
|
264
|
+
{
|
|
265
|
+
loader: "@svgr/webpack",
|
|
266
|
+
options: { dimensions: false },
|
|
267
|
+
},
|
|
268
|
+
],
|
|
259
269
|
},
|
|
260
270
|
{
|
|
261
271
|
test: /fonts\/.*\.(ttf|eot|woff2?)$/i,
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ideasonpurpose/build-tools-wordpress",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.9.0",
|
|
4
4
|
"description": "Build scripts and dependencies for IOP's WordPress development environments.",
|
|
5
5
|
"homepage": "https://github.com/ideasonpurpose/build-tools-wordpress#readme",
|
|
6
6
|
"bugs": {
|