@kywi-software/core 0.10.0 → 0.11.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.
Files changed (53) hide show
  1. package/AGENT-PATTERNS.md +15 -13
  2. package/README.md +67 -0
  3. package/dist/admin/layout-editor/editor-canvas.d.ts +20 -7
  4. package/dist/admin/layout-editor/editor-canvas.d.ts.map +1 -1
  5. package/dist/admin/layout-editor/editor-canvas.js +31 -26
  6. package/dist/admin/layout-editor/editor-canvas.js.map +1 -1
  7. package/dist/admin/layout-editor/editor.css +87 -2
  8. package/dist/admin/layout-editor/inline-text.d.ts +56 -4
  9. package/dist/admin/layout-editor/inline-text.d.ts.map +1 -1
  10. package/dist/admin/layout-editor/inline-text.js +134 -11
  11. package/dist/admin/layout-editor/inline-text.js.map +1 -1
  12. package/dist/admin/layout-editor/module-overlay.d.ts +26 -13
  13. package/dist/admin/layout-editor/module-overlay.d.ts.map +1 -1
  14. package/dist/admin/layout-editor/module-overlay.js +200 -21
  15. package/dist/admin/layout-editor/module-overlay.js.map +1 -1
  16. package/dist/admin/layout-editor/overlay-shell.d.ts.map +1 -1
  17. package/dist/admin/layout-editor/overlay-shell.js +38 -11
  18. package/dist/admin/layout-editor/overlay-shell.js.map +1 -1
  19. package/dist/admin/layout-editor/props-panel.js +1 -1
  20. package/dist/admin/layout-editor/props-panel.js.map +1 -1
  21. package/dist/admin/layout-editor/section-overlay.d.ts +8 -1
  22. package/dist/admin/layout-editor/section-overlay.d.ts.map +1 -1
  23. package/dist/admin/layout-editor/section-overlay.js +8 -8
  24. package/dist/admin/layout-editor/section-overlay.js.map +1 -1
  25. package/dist/admin/layout-editor/section-variant-container-config.js +5 -5
  26. package/dist/admin/layout-editor/section-variant-container-config.js.map +1 -1
  27. package/dist/admin/layout-editor/use-chrome-flip.d.ts +111 -11
  28. package/dist/admin/layout-editor/use-chrome-flip.d.ts.map +1 -1
  29. package/dist/admin/layout-editor/use-chrome-flip.js +233 -33
  30. package/dist/admin/layout-editor/use-chrome-flip.js.map +1 -1
  31. package/dist/admin/styles/admin.css +14 -1
  32. package/dist/layout/comments-module.d.ts.map +1 -1
  33. package/dist/layout/comments-module.js +6 -2
  34. package/dist/layout/comments-module.js.map +1 -1
  35. package/dist/layout/module-render-context.d.ts +32 -0
  36. package/dist/layout/module-render-context.d.ts.map +1 -1
  37. package/dist/layout/module-render-context.js +32 -1
  38. package/dist/layout/module-render-context.js.map +1 -1
  39. package/dist/layout/modules-extended.d.ts.map +1 -1
  40. package/dist/layout/modules-extended.js +21 -11
  41. package/dist/layout/modules-extended.js.map +1 -1
  42. package/dist/layout/modules.d.ts.map +1 -1
  43. package/dist/layout/modules.js +15 -10
  44. package/dist/layout/modules.js.map +1 -1
  45. package/dist/scope/inline-editing.d.ts.map +1 -1
  46. package/dist/scope/inline-editing.js +10 -0
  47. package/dist/scope/inline-editing.js.map +1 -1
  48. package/dist/scope/sticky-offset.d.ts +185 -0
  49. package/dist/scope/sticky-offset.d.ts.map +1 -0
  50. package/dist/scope/sticky-offset.js +432 -0
  51. package/dist/scope/sticky-offset.js.map +1 -0
  52. package/dist/site/styles.css +41 -3
  53. package/package.json +1 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sticky-offset.js","sourceRoot":"","sources":["../../src/scope/sticky-offset.ts"],"names":[],"mappings":"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"}
@@ -701,6 +701,32 @@
701
701
  * (renders nothing for non-editors), so these rules only ever apply for an
702
702
  * authenticated admin who opted into edit mode. */
703
703
 
704
+ /* Both front-of-site bar heights, declared HERE as well as in editor.css.
705
+ *
706
+ * They are an ecosystem contract — documented for theme authors in
707
+ * packages/core/README.md ("Sticky site headers and the editor's bars"), read
708
+ * by `scope/sticky-offset.ts` to offset a theme's sticky header for an editing
709
+ * session (kywi-cms#146), and offered to a theme's own `.kywi-frontend-edit--*`
710
+ * rules — so a page that can show a bar has to have them defined.
711
+ *
712
+ * editor.css alone does not deliver that. A generated app pulls the admin
713
+ * design system in behind `next/dynamic`, so it is loaded only once someone
714
+ * OPENS the overlay editor and is deliberately absent from the public browse
715
+ * bundle (create-kywi-app/lib/templates.mjs) — the exact lazy-load trap
716
+ * kywi-cms#144 hit from the other side. The BROWSE bar ships in this
717
+ * stylesheet's own bundle and renders with editor.css nowhere in the document,
718
+ * so anything resolving these tokens then would get nothing at all. Every
719
+ * public page loads THIS sheet, so declaring them here closes that window.
720
+ *
721
+ * The values are identical to editor.css's (44/46), which is what makes two
722
+ * declaration sites safe: whichever sheet a host loads last, `:root` resolves
723
+ * to the same number. A theme that overrides either token still wins by loading
724
+ * after core's stylesheet, as it already had to. */
725
+ :root {
726
+ --kywi-browse-bar-height: 44px;
727
+ --kywi-overlay-bar-height: 46px;
728
+ }
729
+
704
730
  .kywi-edit-toolbar {
705
731
  position: fixed;
706
732
  top: 0;
@@ -710,7 +736,7 @@
710
736
  display: flex;
711
737
  align-items: center;
712
738
  gap: var(--_kywi-sm, 0.5rem);
713
- height: 44px;
739
+ height: var(--kywi-browse-bar-height, 44px);
714
740
  padding: 0 var(--kywi-spacing-md, 1rem);
715
741
  background: #0f172a;
716
742
  color: #f8fafc;
@@ -718,8 +744,20 @@
718
744
  box-shadow: 0 1px 4px rgba(0, 0, 0, 0.25);
719
745
  }
720
746
  /* Push the page down while the browse-mode bar is visible so it never overlaps
721
- * the site's own header (class toggled by KywiEditToolbar). */
722
- .kywi-frontend-edit--browsing body { padding-top: 44px; }
747
+ * the site's own header (class toggled by KywiEditToolbar, which puts it on
748
+ * `documentElement`).
749
+ *
750
+ * This rule targets the CLASS-CARRYING element and uses the bar's own token,
751
+ * so it is byte-for-byte the same declaration editor.css makes — deliberately,
752
+ * because a site that mounts the overlay editor loads BOTH sheets. It used to
753
+ * read `.kywi-frontend-edit--browsing body`, a different element, and two
754
+ * different elements each padded 44px pushed the page down 88px for a 44px
755
+ * bar: the seam of body background above the site's nav in kywi-cms#146(1)
756
+ * (reproduced on the reference app — header at y=88, bar 0–44). Two identical
757
+ * declarations collapse; two different ones stack. The `44px` fallback keeps
758
+ * this correct for a host that ships the browse toolbar without ever importing
759
+ * the editor, which is the only reason this copy exists at all. */
760
+ .kywi-frontend-edit--browsing { padding-top: var(--kywi-browse-bar-height, 44px); }
723
761
  .kywi-edit-toolbar-spacer { flex: 1; }
724
762
  .kywi-edit-toolbar-title { font-weight: 600; }
725
763
  .kywi-edit-toolbar-status {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kywi-software/core",
3
- "version": "0.10.0",
3
+ "version": "0.11.0",
4
4
  "description": "Kywi CMS core — schema generator, REST API, and admin UI for Next.js.",
5
5
  "type": "module",
6
6
  "license": "AGPL-3.0-only",