@jossuealcala/madre 1.0.3 → 1.0.5

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.
Files changed (106) hide show
  1. package/CHANGELOG.en.md +113 -1
  2. package/CHANGELOG.md +113 -1
  3. package/NOTICE +30 -0
  4. package/README.en.md +59 -156
  5. package/README.md +60 -161
  6. package/TRADEMARKS.md +18 -0
  7. package/bin/madre.mjs +2 -2
  8. package/docs/REFERENCE.md +1 -1
  9. package/docs/SDK.md +25 -4
  10. package/docs/en/REFERENCE.md +1 -1
  11. package/docs/en/SDK.md +22 -2
  12. package/docs/madre-banner.png +0 -0
  13. package/package.json +1 -1
  14. package/public/app.js +1087 -247
  15. package/public/assets/manual/madre-manual-en.pdf +0 -0
  16. package/public/assets/manual/madre-manual-es.pdf +0 -0
  17. package/public/assets/manual/shots/en-agents.webp +0 -0
  18. package/public/assets/manual/shots/en-code.webp +0 -0
  19. package/public/assets/manual/shots/en-composer.webp +0 -0
  20. package/public/assets/manual/shots/en-connectors.webp +0 -0
  21. package/public/assets/manual/shots/en-continuity.webp +0 -0
  22. package/public/assets/manual/shots/en-coordinator.webp +0 -0
  23. package/public/assets/manual/shots/en-copilot.webp +0 -0
  24. package/public/assets/manual/shots/en-diagnostics.webp +0 -0
  25. package/public/assets/manual/shots/en-home.webp +0 -0
  26. package/public/assets/manual/shots/en-local.webp +0 -0
  27. package/public/assets/manual/shots/en-memory.webp +0 -0
  28. package/public/assets/manual/shots/en-modes.webp +0 -0
  29. package/public/assets/manual/shots/en-modules.webp +0 -0
  30. package/public/assets/manual/shots/en-notes.webp +0 -0
  31. package/public/assets/manual/shots/en-settings.webp +0 -0
  32. package/public/assets/manual/shots/en-windows.webp +0 -0
  33. package/public/assets/manual/shots/es-agents.webp +0 -0
  34. package/public/assets/manual/shots/es-code.webp +0 -0
  35. package/public/assets/manual/shots/es-composer.webp +0 -0
  36. package/public/assets/manual/shots/es-connectors.webp +0 -0
  37. package/public/assets/manual/shots/es-continuity.webp +0 -0
  38. package/public/assets/manual/shots/es-coordinator.webp +0 -0
  39. package/public/assets/manual/shots/es-copilot.webp +0 -0
  40. package/public/assets/manual/shots/es-diagnostics.webp +0 -0
  41. package/public/assets/manual/shots/es-home.webp +0 -0
  42. package/public/assets/manual/shots/es-local.webp +0 -0
  43. package/public/assets/manual/shots/es-memory.webp +0 -0
  44. package/public/assets/manual/shots/es-modes.webp +0 -0
  45. package/public/assets/manual/shots/es-modules.webp +0 -0
  46. package/public/assets/manual/shots/es-notes.webp +0 -0
  47. package/public/assets/manual/shots/es-settings.webp +0 -0
  48. package/public/assets/manual/shots/es-windows.webp +0 -0
  49. package/public/en.js +74 -0
  50. package/public/es.js +495 -137
  51. package/public/i18n.js +45 -7
  52. package/public/index.html +2 -3
  53. package/public/manual-content.js +657 -0
  54. package/public/manual-shots.js +43 -0
  55. package/public/manual.css +228 -0
  56. package/public/manual.html +15 -0
  57. package/public/manual.js +398 -0
  58. package/public/market-art.js +56 -0
  59. package/public/market-view.js +140 -22
  60. package/public/market.js +25 -14
  61. package/public/mcp-catalog.js +62 -0
  62. package/public/resay.js +1 -0
  63. package/public/salas-mac.css +185 -30
  64. package/public/salas-mac.html +5 -5
  65. package/public/salas-mac.js +475 -68
  66. package/public/styles.css +306 -42
  67. package/public/tour-chapters.js +98 -90
  68. package/public/tour.js +63 -21
  69. package/public/troubleshooting.js +145 -10
  70. package/src/adapters/cursor.mjs +56 -7
  71. package/src/adapters/gemini.mjs +12 -1
  72. package/src/adapters/madre.mjs +27 -6
  73. package/src/adapters/process.mjs +5 -2
  74. package/src/auth-probe.mjs +22 -3
  75. package/src/bridge/policy.mjs +1 -1
  76. package/src/bridge/server.mjs +1 -1
  77. package/src/capabilities.mjs +3 -3
  78. package/src/credentials.mjs +24 -2
  79. package/src/history.mjs +76 -0
  80. package/src/i18n.mjs +23 -1
  81. package/src/local-ai.mjs +10 -2
  82. package/src/looks.mjs +17 -5
  83. package/src/market-license.mjs +104 -0
  84. package/src/market-remote.mjs +17 -1
  85. package/src/mcp/notes-server.mjs +120 -0
  86. package/src/mcp/proxy.mjs +14 -3
  87. package/src/models.mjs +82 -9
  88. package/src/modules/index.mjs +3 -1
  89. package/src/modules/local-models.mjs +28 -0
  90. package/src/modules/notes.mjs +142 -0
  91. package/src/modules/ollama.mjs +39 -10
  92. package/src/modules/playwright.mjs +14 -3
  93. package/src/modules/reminders.mjs +345 -0
  94. package/src/modules/sdk.mjs +21 -5
  95. package/src/mother.mjs +11 -1
  96. package/src/ollama.mjs +2 -2
  97. package/src/opencode-health.mjs +63 -0
  98. package/src/outbound.mjs +25 -1
  99. package/src/ports.mjs +4 -6
  100. package/src/reminder-time.mjs +127 -0
  101. package/src/room.mjs +19 -7
  102. package/src/runtime-detection.mjs +6 -2
  103. package/src/sentinel-errors.mjs +4 -3
  104. package/src/server-sentinel.mjs +7 -3
  105. package/src/server.mjs +302 -70
  106. package/src/tour.mjs +24 -5
@@ -0,0 +1,43 @@
1
+ // SPDX-License-Identifier: AGPL-3.0-only
2
+ // MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
3
+ // Written by scripts/manual-shots.mjs: the size of each picture of the manual and where its marks
4
+ // stand — [left, top, width, height] in hundredths of the picture, one per step. Not edited by hand.
5
+
6
+ export const SHOTS = {
7
+ es: {
8
+ home: {"width":1600,"height":1135,"marks":[[83.5,3.5,12.2,4.5],[2.5,11.5,30.2,30.2],[49.8,56.8,47.7,39.7]]},
9
+ agents: {"width":1192,"height":820,"marks":[[4.7,6.8,90.6,6.8],[14.8,86.1,20.6,6.8],[76.5,42,10.4,4.2]]},
10
+ memory: {"width":1600,"height":917,"marks":[[1.3,2.4,10.7,2],[1.3,6.3,97.3,1.9],null]},
11
+ continuity: {"width":1600,"height":1133,"marks":[[27.5,31.9,21.9,19.2],[47.7,63.1,46.4,2.4],[49.2,51.9,6.5,3.9]]},
12
+ composer: {"width":1600,"height":904,"marks":[[21.6,80.3,64.9,6.1],[3.4,79.8,3.9,7],[3.1,89.9,16.2,4.5],[19.3,89.9,29.3,4.5]]},
13
+ modes: {"width":1600,"height":756,"marks":[[3.9,21.6,40.6,15.1,"right"],[3.9,37.4,40.6,15.1,"right"],[3.9,53.1,40.6,15.1,"right"],[3.9,68.9,40.6,15.1,"right"]]},
14
+ copilot: {"width":1600,"height":635,"marks":[[48.5,85.7,3.2,6.5],[52.5,61.2,24.1,8.9],[75.6,10.2,3.1,4.7]]},
15
+ code: {"width":1600,"height":1175,"marks":[[2.3,2.2,2.8,3.9],[54.7,69.9,3.3,2.3],[89,95.3,9,2.7],[74.9,58.6,23.2,11.1]]},
16
+ notes: {"width":1600,"height":1062,"marks":[[61.7,2.4,2.9,4.3],[70.5,15.8,23.7,33.2],[69.5,70.3,28.8,17.5]]},
17
+ modules: {"width":1600,"height":1192,"marks":[[62.6,2.3,3.1,4.2],[73.6,35.3,22,18.3],[91.4,37.4,2.9,2.3]]},
18
+ connectors: {"width":1600,"height":1853,"marks":[[43.1,8.5,52.1,2.3],[46,76.2,7.8,2.5],[44.7,31.6,12.2,2.5]]},
19
+ local: {"width":1600,"height":1654,"marks":[[44.1,7.6,45.8,2.3],[44.1,29.6,45.8,7.1],[67.5,59.1,21,3]]},
20
+ coordinator: {"width":1600,"height":929,"marks":[[78.1,5.9,16.2,4.6],[85.4,91.3,12.1,4.3]]},
21
+ windows: {"width":1600,"height":966,"marks":[[69.5,4.2,24.4,5.4,"left"],[70.3,10,29,16.2,"below"],[2.5,12.2,19.3,20.4]]},
22
+ settings: {"width":1600,"height":559,"marks":[[94.1,5.2,3.3,9.3],[13,23.8,36.1,5.5],[2.7,55.9,28.9,36.2]]},
23
+ diagnostics: {"width":1600,"height":1177,"marks":[[66.7,2.3,3,4.1],[16.7,10.6,34.9,2.4],[4,26.1,30.9,4.8]]},
24
+ },
25
+ en: {
26
+ home: {"width":1600,"height":1135,"marks":[[85.7,3.5,10,4.5],[2.5,11.5,30.2,30.2],[49.8,56.8,47.7,39.7]]},
27
+ agents: {"width":1192,"height":820,"marks":[[4.7,6.8,90.6,6.8],[14.8,86.1,18.6,6.8],[76.5,42,10.4,4.2]]},
28
+ memory: {"width":1600,"height":917,"marks":[[1.3,2.4,7.1,2],[1.3,6.3,97.3,1.9],null]},
29
+ continuity: {"width":1600,"height":1133,"marks":[[27.5,34.1,21.9,16.9],[47.7,63.1,46.4,2.4],[49.2,51.9,5.7,3.9]]},
30
+ composer: {"width":1600,"height":816,"marks":[[20.8,78.1,65.6,6.8],[3.4,77.7,3.9,7.7],[3.1,88.9,12.6,5],[15.6,88.9,24.4,5]]},
31
+ modes: {"width":1600,"height":756,"marks":[[3.9,21.6,40.6,15.1,"right"],[3.9,37.4,40.6,15.1,"right"],[3.9,53.1,40.6,15.1,"right"],[3.9,68.9,40.6,15.1,"right"]]},
32
+ copilot: {"width":1600,"height":609,"marks":[[40,85.1,3.2,6.7],[43.9,63.7,23.9,9.3],[67.1,10.7,3.1,4.9]]},
33
+ code: {"width":1600,"height":1175,"marks":[[2.3,2.2,2.8,3.9],[54.7,65.3,3.3,2.3],[92.5,95.3,5.4,2.7],[74.9,58.6,23.2,11.1]]},
34
+ notes: {"width":1600,"height":1062,"marks":[[61.7,2.4,2.9,4.3],[70.5,15.8,23.7,33.2],[69.5,70.3,28.8,17.5]]},
35
+ modules: {"width":1600,"height":1192,"marks":[[62.6,2.3,3.1,4.2],[73.6,37.4,22,16.1],[91.4,39.6,2.9,2.3]]},
36
+ connectors: {"width":1600,"height":1853,"marks":[[43.1,8.5,52.1,2.3],[46,73.1,7.3,2.5],[44.7,31.6,15,2.5]]},
37
+ local: {"width":1600,"height":1654,"marks":[[44.1,7.6,45.8,2.3],[44.1,29.6,45.8,7.1],[67.5,59.1,20.9,3]]},
38
+ coordinator: {"width":1600,"height":929,"marks":[[79.7,5.9,14.6,4.6],[86.7,91.3,10.7,4.3]]},
39
+ windows: {"width":1600,"height":966,"marks":[[69.5,4.2,24.4,5.4,"left"],[70.3,10,29,16.2,"below"],[2.5,12.2,19.3,20.4]]},
40
+ settings: {"width":1600,"height":559,"marks":[[94.1,5.2,3.3,9.3],[13.9,23.8,36.1,5.5],[2.7,55.9,28.9,36.2]]},
41
+ diagnostics: {"width":1600,"height":1177,"marks":[[66.7,2.3,3,4.1],[16.7,10.6,34.9,2.4],[4,26.1,30.9,4.8]]},
42
+ },
43
+ };
@@ -0,0 +1,228 @@
1
+ /* SPDX-License-Identifier: AGPL-3.0-only
2
+ MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
3
+ The user manual (manual.js), in the room's own look: its ground, its glass, its cards, its keys
4
+ and its mono labels, so what the page shows is what MADRE looks like. Light on paper, as the brand
5
+ asks of long documents, with a cover of its own and every section starting cleanly. */
6
+
7
+ @font-face { font-family: 'Sora'; src: url('/assets/brand/Sora-latin.woff2') format('woff2'); font-weight: 100 800; font-display: swap; unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD; }
8
+ @font-face { font-family: 'Sora'; src: url('/assets/brand/Sora-latin-ext.woff2') format('woff2'); font-weight: 100 800; font-display: swap; unicode-range: U+0100-02AF, U+1E00-1EFF, U+2020, U+20A0-20AB, U+20AD-20CF, U+2113, U+2C60-2C7F, U+A720-A7FF; }
9
+ @font-face { font-family: 'Geist'; src: url('/assets/brand/Geist-latin.woff2') format('woff2'); font-weight: 100 900; font-display: swap; unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD; }
10
+ @font-face { font-family: 'Geist'; src: url('/assets/brand/Geist-latin-ext.woff2') format('woff2'); font-weight: 100 900; font-display: swap; unicode-range: U+0100-02AF, U+1E00-1EFF, U+2020, U+20A0-20AB, U+20AD-20CF, U+2113, U+2C60-2C7F, U+A720-A7FF; }
11
+ @font-face { font-family: 'JetBrains Mono'; src: url('/assets/brand/JetBrainsMono-latin.woff2') format('woff2'); font-weight: 100 800; font-display: swap; }
12
+
13
+
14
+ :root {
15
+ --green: #9bff66;
16
+ --green-ink: #0a1405;
17
+ --bg: #050605;
18
+ --ground: radial-gradient(120% 80% at 50% -10%, rgba(155, 255, 102, .07), transparent 60%), #050605;
19
+ --glass: rgba(22, 26, 22, .72);
20
+ --card: #111411;
21
+ --card-2: #171b17;
22
+ --line: rgba(255, 255, 255, .08);
23
+ --line-2: rgba(255, 255, 255, .14);
24
+ --text: #f1f4ef;
25
+ --text-2: rgba(241, 244, 239, .72);
26
+ --text-3: rgba(241, 244, 239, .5);
27
+ --tint: rgba(155, 255, 102, .1);
28
+ --lift: 0 1px 2px rgba(0, 0, 0, .4), 0 12px 32px -12px rgba(0, 0, 0, .6);
29
+ --bubble: #2f8a1c;
30
+ --bubble-ink: #ffffff;
31
+ color-scheme: dark;
32
+ }
33
+ @media (prefers-color-scheme: light) {
34
+ :root:not(.printing) {
35
+ --green: #2f8a1c; --green-ink: #ffffff; --bg: #e9ece6;
36
+ --ground: radial-gradient(120% 70% at 50% -10%, rgba(255, 255, 255, .9), transparent 60%), linear-gradient(180deg, #eef0eb, #e3e7df);
37
+ --glass: rgba(255, 255, 255, .72); --card: #ffffff; --card-2: #f4f5f2;
38
+ --line: rgba(0, 0, 0, .07); --line-2: rgba(0, 0, 0, .13);
39
+ --text: #121512; --text-2: #4f564f; --text-3: #767d75; --tint: rgba(47, 138, 28, .09);
40
+ --lift: 0 1px 2px rgba(0, 0, 0, .05), 0 10px 30px -14px rgba(20, 30, 20, .22);
41
+ color-scheme: light;
42
+ }
43
+ }
44
+ :root.printing {
45
+ --green: #2f8a1c; --green-ink: #ffffff; --bg: #ffffff; --ground: #ffffff; --glass: #ffffff; --card: #ffffff; --card-2: #f4f6f2;
46
+ --line: rgba(10, 20, 10, .12); --line-2: rgba(10, 20, 10, .18); --text: #121512; --text-2: rgba(18, 21, 18, .76); --text-3: rgba(18, 21, 18, .55);
47
+ --tint: rgba(47, 138, 28, .09); --lift: none; color-scheme: light;
48
+ }
49
+
50
+ * { box-sizing: border-box; }
51
+ html { background: var(--bg); color: var(--text); scroll-behavior: smooth; }
52
+ body { margin: 0; min-height: 100vh; background: var(--ground); background-attachment: fixed; font-family: 'Geist', system-ui, sans-serif; font-size: 16px; line-height: 1.6; -webkit-font-smoothing: antialiased; }
53
+ a { color: var(--green); }
54
+ .manual { max-width: 1040px; margin: 0 auto; padding: 0 24px 96px; }
55
+ .manual-label, .manual-number, .manual-contents h2, .manual-words h2 { font-family: 'JetBrains Mono', monospace; font-size: 11.5px; font-weight: 600; letter-spacing: .14em; text-transform: uppercase; }
56
+
57
+ /* The bar: the room's, floating glass, with the brand on the left and two keys on the right. */
58
+ .manual-bar { position: sticky; top: 12px; z-index: 3; display: flex; align-items: center; justify-content: space-between; gap: 12px; margin: 12px 0 0; padding: 8px 8px 8px 16px; border-radius: 20px; background: var(--glass); backdrop-filter: blur(18px) saturate(1.4); -webkit-backdrop-filter: blur(18px) saturate(1.4); box-shadow: var(--lift), inset 0 0 0 1px var(--line); }
59
+ .manual-brand { display: inline-flex; align-items: center; gap: 10px; font-family: 'JetBrains Mono', monospace; font-size: 13px; color: var(--text-2); }
60
+ .manual-brand img { border-radius: 7px; }
61
+ .manual-brand b { font-family: 'Sora', sans-serif; font-weight: 700; letter-spacing: .06em; color: var(--text); }
62
+ .manual-keys { display: flex; gap: 8px; }
63
+ .manual-key { display: inline-flex; align-items: center; height: 36px; padding: 0 14px; border-radius: 12px; font-family: 'JetBrains Mono', monospace; font-size: 12px; font-weight: 600; letter-spacing: .1em; text-transform: uppercase; text-decoration: none; color: var(--text); background: var(--card); box-shadow: inset 0 0 0 1px var(--line-2), 0 1px 2px rgba(0, 0, 0, .06); }
64
+ .manual-key:hover { box-shadow: inset 0 0 0 1px var(--green), 0 0 0 3px var(--tint); }
65
+ .manual-key.primary { background: var(--green); color: var(--green-ink); box-shadow: none; }
66
+ .manual-key.primary:hover { filter: brightness(1.06); }
67
+
68
+ /* The cover. */
69
+ .manual-cover { display: grid; justify-items: start; margin-top: 28px; padding: 56px 48px 48px; border-radius: 28px; background: var(--card); box-shadow: var(--lift), inset 0 0 0 1px var(--line); }
70
+ .manual-mark { width: 76px; height: 76px; border-radius: 20px; box-shadow: 0 18px 40px -18px rgba(47, 138, 28, .55); }
71
+ .manual-cover h1 { margin: 28px 0 6px; font-family: 'Sora', sans-serif; font-size: clamp(36px, 6vw, 58px); font-weight: 760; letter-spacing: -.03em; line-height: 1.04; }
72
+ .manual-subtitle { margin: 0; font-size: 19px; color: var(--text-2); }
73
+ .manual-version { margin: 18px 0 0; padding: 4px 10px; border-radius: 999px; font-family: 'JetBrains Mono', monospace; font-size: 12px; letter-spacing: .08em; color: var(--green); background: var(--tint); }
74
+ .manual-intro { margin-top: 28px; display: grid; gap: 12px; max-width: 680px; font-size: 17.5px; }
75
+ .manual-intro p { margin: 0; }
76
+
77
+ /* The four words, as the cards of Settings. */
78
+ .manual-words { margin-top: 20px; }
79
+ .manual-words h2 { margin: 0 0 12px 4px; color: var(--text-3); }
80
+ .manual-words dl { display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); gap: 12px; margin: 0; }
81
+ .manual-words dl > div { padding: 16px 18px; border-radius: 18px; background: var(--card); box-shadow: var(--lift), inset 0 0 0 1px var(--line); }
82
+ .manual-words dt { font-family: 'Sora', sans-serif; font-weight: 700; font-size: 16.5px; }
83
+ .manual-words dd { margin: 4px 0 0; font-size: 14.5px; color: var(--text-2); line-height: 1.5; }
84
+
85
+ /* The contents, as the tiles of Modules. */
86
+ .manual-contents { margin-top: 32px; }
87
+ .manual-contents h2 { margin: 0 0 12px 4px; color: var(--text-3); }
88
+ .manual-contents ol { display: grid; grid-template-columns: repeat(auto-fill, minmax(230px, 1fr)); gap: 10px; margin: 0; padding: 0; list-style: none; }
89
+ .manual-contents a { display: flex; align-items: center; gap: 12px; height: 100%; padding: 12px 14px; border-radius: 16px; color: var(--text); text-decoration: none; font-weight: 600; font-size: 15px; line-height: 1.3; background: var(--card); box-shadow: inset 0 0 0 1px var(--line); transition: box-shadow .18s, transform .18s; }
90
+ .manual-contents a:hover { box-shadow: inset 0 0 0 1px var(--green), 0 0 0 3px var(--tint); transform: translateY(-1px); }
91
+ .manual-contents .manual-icon { width: 34px; height: 34px; border-radius: 10px; }
92
+ .manual-contents .manual-icon svg { width: 18px; height: 18px; }
93
+
94
+ /* A section: its head, its line, MADRE photographed beside its steps, then what to try. */
95
+ .manual-section { margin-top: 28px; padding: 32px 32px 28px; border-radius: 28px; background: var(--card); box-shadow: var(--lift), inset 0 0 0 1px var(--line); scroll-margin-top: 84px; }
96
+ .manual-section-head { display: flex; align-items: center; gap: 14px; }
97
+ .manual-icon { display: grid; place-items: center; flex: none; width: 44px; height: 44px; border-radius: 13px; color: var(--green); background: var(--tint); box-shadow: inset 0 0 0 1px color-mix(in srgb, var(--green) 20%, transparent); }
98
+ .manual-icon svg { width: 22px; height: 22px; }
99
+ .manual-number { display: block; color: var(--text-3); }
100
+ .manual-section h2 { margin: 0; font-family: 'Sora', sans-serif; font-size: 26px; font-weight: 700; letter-spacing: -.015em; line-height: 1.2; }
101
+ .manual-lead { margin: 14px 0 22px; max-width: 720px; font-size: 17.5px; color: var(--text-2); }
102
+ .manual-body { display: grid; gap: 20px; }
103
+
104
+ /* The picture: MADRE itself, framed as one of its windows, with a ring and a number on each step. */
105
+ .manual-shot { margin: 0; }
106
+ .manual-shot.tall { width: min(100%, 620px); justify-self: center; }
107
+ .manual-shot-frame { position: relative; overflow: hidden; border-radius: 18px; background: var(--card-2); box-shadow: 0 1px 2px rgba(0, 0, 0, .06), 0 18px 40px -22px rgba(20, 30, 20, .45), inset 0 0 0 1px var(--line); }
108
+ .manual-shot-frame img { display: block; width: 100%; height: auto; }
109
+ .manual-pin { position: absolute; border-radius: 8px; background: color-mix(in srgb, var(--green) 7%, transparent); box-shadow: 0 0 0 2px var(--green), 0 0 0 4px color-mix(in srgb, var(--green) 16%, transparent); opacity: 0; transform: scale(.94); transition: opacity .35s ease, transform .35s cubic-bezier(.2, .9, .3, 1.3), box-shadow .2s; transition-delay: calc(var(--at) * 260ms + 150ms); pointer-events: auto; }
110
+ .manual-pin b { position: absolute; left: 50%; top: 0; translate: -50% -85%; display: grid; place-items: center; width: 26px; height: 26px; border-radius: 50%; font-size: 13px; font-weight: 750; color: var(--green-ink); background: var(--green); box-shadow: 0 0 0 3px var(--card), 0 4px 10px -2px rgba(0, 0, 0, .35); }
111
+ .manual-pin.below b { top: 100%; translate: -50% -15%; }
112
+ .manual-pin.left b { left: 0; top: 50%; translate: -55% -50%; }
113
+ .manual-shot.shown .manual-pin { opacity: 1; transform: none; }
114
+ .manual-shot.shown .manual-pin b { animation: manual-ping 1.6s ease-out calc(var(--at) * 260ms + 400ms) 1 both; }
115
+ @keyframes manual-ping { 0% { box-shadow: 0 0 0 3px var(--card), 0 0 0 3px color-mix(in srgb, var(--green) 60%, transparent); } 100% { box-shadow: 0 0 0 3px var(--card), 0 0 0 16px transparent; } }
116
+ .manual-section.pointing .manual-pin { opacity: .25; transition-delay: 0s; }
117
+ .manual-section.pointing .manual-pin.lit { opacity: 1; box-shadow: 0 0 0 3px var(--green), 0 0 0 10px color-mix(in srgb, var(--green) 26%, transparent); }
118
+
119
+ /* The steps, numbered as the marks. */
120
+ .manual-side { display: grid; grid-template-columns: minmax(0, 1.4fr) minmax(240px, 1fr); gap: 16px; align-items: start; }
121
+ .manual-steps { margin: 0; padding: 0; list-style: none; display: grid; gap: 8px; }
122
+ .manual-steps li { display: grid; grid-template-columns: 26px 1fr; gap: 12px; align-items: start; padding: 11px 14px; border-radius: 14px; background: var(--card-2); box-shadow: inset 0 0 0 1px var(--line); font-size: 15.5px; line-height: 1.5; transition: box-shadow .18s, background .18s; }
123
+ .manual-steps li > b { display: grid; place-items: center; width: 26px; height: 26px; margin-top: -1px; border-radius: 50%; font-size: 13px; font-weight: 750; color: var(--green-ink); background: var(--green); }
124
+ .manual-steps li.lit { background: var(--tint); box-shadow: inset 0 0 0 1px color-mix(in srgb, var(--green) 45%, transparent); }
125
+
126
+ /* One thing to try, and what is worth knowing later. */
127
+ .manual-try, .manual-expert { display: grid; gap: 6px; padding: 14px 16px; border-radius: 16px; font-size: 15px; line-height: 1.55; }
128
+ .manual-try { background: var(--tint); box-shadow: inset 0 0 0 1px color-mix(in srgb, var(--green) 26%, transparent); }
129
+ .manual-try .manual-label { color: var(--green); }
130
+ .manual-expert { margin-top: 16px; background: var(--card-2); box-shadow: inset 0 0 0 1px var(--line); color: var(--text-2); }
131
+ .manual-expert .manual-label { color: var(--text-3); }
132
+ .manual-say { display: inline; padding: 2px 10px; border-radius: 12px; color: var(--bubble-ink); background: var(--bubble); quotes: none; font-weight: 500; -webkit-box-decoration-break: clone; box-decoration-break: clone; line-height: 1.9; }
133
+ .manual-say::before, .manual-say::after { content: none; }
134
+ kbd { display: inline-block; padding: 1px 7px; border-radius: 7px; font-family: 'JetBrains Mono', monospace; font-size: 12.5px; line-height: 1.5; color: var(--text); background: var(--card); box-shadow: inset 0 0 0 1px var(--line-2), inset 0 -1.5px 0 var(--line-2); white-space: nowrap; }
135
+
136
+ /* The contents in four parts. */
137
+ .manual-contents .manual-part + .manual-part { margin-top: 18px; }
138
+ .manual-part h3 { margin: 0 0 8px 4px; font-family: 'Sora', sans-serif; font-size: 15px; }
139
+
140
+ /* What to paste in the Terminal: a small window of its own, with a key to copy each line. */
141
+ .manual-terminal { padding: 12px 14px 14px; border-radius: 16px; background: #0b0d0b; color: #e8ece6; box-shadow: 0 18px 40px -22px rgba(0, 0, 0, .6), inset 0 0 0 1px rgba(255, 255, 255, .08); }
142
+ .manual-terminal-dots { display: block; width: 46px; height: 10px; margin-bottom: 12px; background: radial-gradient(circle at 5px 5px, #ff5f57 4px, transparent 4.5px), radial-gradient(circle at 23px 5px, #febc2e 4px, transparent 4.5px), radial-gradient(circle at 41px 5px, #28c840 4px, transparent 4.5px); }
143
+ .manual-terminal-line { display: flex; align-items: center; gap: 10px; font-family: 'JetBrains Mono', monospace; font-size: 15px; }
144
+ .manual-terminal-line code { flex: 1; min-width: 0; overflow-wrap: anywhere; color: #9bff66; background: none; padding: 0; box-shadow: none; }
145
+ .manual-terminal-prompt { color: rgba(232, 236, 230, .45); }
146
+ .manual-copy { flex: none; height: 30px; padding: 0 12px; border: 0; border-radius: 9px; font-family: 'JetBrains Mono', monospace; font-size: 11px; font-weight: 600; letter-spacing: .1em; text-transform: uppercase; color: #0a1405; background: #9bff66; cursor: pointer; }
147
+ .manual-copy:hover { filter: brightness(1.06); }
148
+ code { font-family: 'JetBrains Mono', monospace; font-size: .9em; padding: 1px 6px; border-radius: 6px; background: var(--card-2); box-shadow: inset 0 0 0 1px var(--line); overflow-wrap: anywhere; }
149
+
150
+ /* Common problems: what you see, and what to do. */
151
+ .manual-problems { display: grid; border-radius: 16px; overflow: hidden; box-shadow: inset 0 0 0 1px var(--line); }
152
+ .manual-problem { display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1.25fr); gap: 16px; padding: 12px 16px; font-size: 15px; line-height: 1.5; }
153
+ .manual-problem + .manual-problem { border-top: 1px solid var(--line); }
154
+ .manual-problem.head { background: var(--card-2); padding: 9px 16px; }
155
+ .manual-problem.head .manual-label { color: var(--text-3); }
156
+ .manual-problem b { font-weight: 600; }
157
+ .manual-problem > span:last-child { color: var(--text-2); }
158
+ @media (max-width: 640px) { .manual-problem { grid-template-columns: 1fr; gap: 4px; } .manual-problem.head { display: none; } }
159
+
160
+ /* Every shortcut. */
161
+ .manual-keys-table { display: grid; grid-template-columns: minmax(0, 1fr) auto; gap: 8px 18px; margin: 4px 0 16px; padding: 14px 18px; border-radius: 16px; background: var(--card-2); box-shadow: inset 0 0 0 1px var(--line); }
162
+ .manual-keys-table dt { color: var(--text-2); }
163
+ .manual-keys-table dd { margin: 0; text-align: right; max-width: 13em; }
164
+ .manual-keys-table kbd { white-space: normal; overflow-wrap: anywhere; text-align: right; max-width: 100%; }
165
+ .manual-shortcut-groups { display: grid; grid-template-columns: repeat(auto-fill, minmax(min(100%, 380px), 1fr)); gap: 0 24px; margin-top: 18px; }
166
+ .manual-shortcut-group h3 { margin: 10px 0 6px; font-family: 'Sora', sans-serif; font-size: 15px; }
167
+ .manual-foot { margin-top: 40px; padding: 0 8px; color: var(--text-3); font-size: 14px; }
168
+ .manual-foot p { margin: 0 0 6px; }
169
+
170
+ @media (max-width: 900px) {
171
+ .manual-side { grid-template-columns: 1fr; }
172
+ .manual-words dl { grid-template-columns: repeat(2, minmax(0, 1fr)); }
173
+ }
174
+ @media (max-width: 640px) {
175
+ .manual { padding: 0 16px 64px; }
176
+ .manual-bar { padding-left: 12px; }
177
+ .manual-key { padding: 0 10px; letter-spacing: .06em; }
178
+ .manual-cover { padding: 36px 22px 28px; border-radius: 22px; }
179
+ .manual-section { padding: 22px 16px 18px; border-radius: 22px; }
180
+ .manual-section h2 { font-size: 22px; }
181
+ .manual-words dl { grid-template-columns: 1fr; }
182
+ .manual-pin b { width: 22px; height: 22px; font-size: 12px; }
183
+ }
184
+ @media (prefers-reduced-motion: reduce) {
185
+ .manual-pin { transition: none; }
186
+ .manual-shot.shown .manual-pin b { animation: none; }
187
+ }
188
+
189
+ /* Paper: light, one section after another, the picture over its steps, every mark already there. */
190
+ @page { size: A4; margin: 18mm 16mm 20mm; }
191
+ @media print {
192
+ html, body { background: #fff; }
193
+ .manual { max-width: none; padding: 0; }
194
+ .manual-bar { display: none; }
195
+ .manual-cover { min-height: 240mm; align-content: center; margin: 0; padding: 0; border-radius: 0; box-shadow: none; break-after: page; }
196
+ .manual-cover .manual-mark { width: 96px; height: 96px; box-shadow: none; }
197
+ .manual-cover h1 { font-size: 54px; }
198
+ .manual-words { margin: 0 0 8mm; }
199
+ .manual-words dl > div, .manual-contents a, .manual-steps li, .manual-try, .manual-expert, .manual-keys-table { box-shadow: inset 0 0 0 1px var(--line); }
200
+ .manual-contents { margin: 0; break-after: page; }
201
+ .manual-contents a { padding: 8px 12px; }
202
+ .manual-section { margin: 0; padding: 0 0 8mm; border-radius: 0; box-shadow: none; break-before: page; }
203
+ .manual-body { gap: 12px; }
204
+ .manual-side { grid-template-columns: 1fr; gap: 10px; }
205
+ /* One section a page: the picture no taller than 112 mm, narrower when it would be. */
206
+ .manual-shot, .manual-shot.tall { width: auto; justify-self: stretch; }
207
+ .manual-shot-frame { width: min(100%, calc(112mm * var(--ratio))); margin-inline: auto; box-shadow: inset 0 0 0 1px var(--line); break-inside: avoid; }
208
+ .manual-section h2 { font-size: 22px; }
209
+ .manual-lead { margin: 8px 0 12px; font-size: 14.5px; }
210
+ .manual-steps { gap: 5px; }
211
+ .manual-steps li { padding: 7px 12px; font-size: 13px; gap: 10px; grid-template-columns: 22px 1fr; }
212
+ .manual-steps li > b { width: 22px; height: 22px; font-size: 12px; }
213
+ .manual-try, .manual-expert { padding: 9px 12px; font-size: 13px; gap: 3px; }
214
+ .manual-expert { margin-top: 10px; }
215
+ .manual-pin { opacity: 1; transform: none; transition: none; }
216
+ .manual-pin b { box-shadow: 0 0 0 2px #fff; }
217
+ .manual-section-head, .manual-steps li, .manual-try, .manual-expert, .manual-keys-table, .manual-shortcut-group { break-inside: avoid; }
218
+ .manual-section-head, .manual-lead { break-after: avoid; }
219
+ .manual-shortcuts { break-before: page; }
220
+ .manual-shortcut-groups { grid-template-columns: 1fr 1fr; gap: 0 18px; }
221
+ .manual-shortcut-group .manual-keys-table { grid-template-columns: 1fr; gap: 2px 0; }
222
+ .manual-shortcut-group .manual-keys-table dd { max-width: none; text-align: left; margin-bottom: 6px; }
223
+ .manual-shortcut-group .manual-keys-table kbd { text-align: left; }
224
+ .manual-say { color: #fff; background: #2f8a1c; }
225
+ .manual-terminal { box-shadow: none; }
226
+ .manual-problem { break-inside: avoid; }
227
+ a { color: inherit; text-decoration: none; }
228
+ }
@@ -0,0 +1,15 @@
1
+ <!doctype html>
2
+ <!-- SPDX-License-Identifier: AGPL-3.0-only · MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md -->
3
+ <html lang="es">
4
+ <head>
5
+ <meta charset="utf-8">
6
+ <meta name="viewport" content="width=device-width, initial-scale=1">
7
+ <title>MADRE · Manual</title>
8
+ <link rel="icon" type="image/svg+xml" href="/assets/brand/madre-favicon.svg">
9
+ <link rel="stylesheet" href="/manual.css">
10
+ </head>
11
+ <body>
12
+ <main id="manual" class="manual" aria-live="polite"></main>
13
+ <script type="module" src="/manual.js"></script>
14
+ </body>
15
+ </html>