editlet 0.0.0-stage → 0.1.0-alpha.1

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 (146) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +140 -2
  3. package/dist/admin/config.d.ts +22 -0
  4. package/dist/admin/config.js +75 -0
  5. package/dist/admin/dist/assets/RichEditor-BlaCRrEX.css +1 -0
  6. package/dist/admin/dist/assets/RichEditor-IZKdt6MK.js +42 -0
  7. package/dist/admin/dist/assets/blank-line-CbGzlqBI.js +1 -0
  8. package/dist/admin/dist/assets/channel-CljeMIwA.js +1 -0
  9. package/dist/admin/dist/assets/db-CCMyPgQa.js +1 -0
  10. package/dist/admin/dist/assets/index-CWoJh4H8.js +257 -0
  11. package/dist/admin/dist/assets/index-DkRMnD_M.css +1 -0
  12. package/dist/admin/dist/assets/mdast-util-from-markdown-C79q1_d8.js +3 -0
  13. package/dist/admin/dist/assets/mdast-util-gfm-cM-_xFJE.js +19 -0
  14. package/dist/admin/dist/assets/micromark-extension-gfm-Wz6-oszS.js +1 -0
  15. package/dist/admin/dist/assets/micromark-util-classify-character-BgXaGAja.js +1 -0
  16. package/dist/admin/dist/assets/micromark-util-html-tag-name-B61T18yC.js +1 -0
  17. package/dist/admin/dist/assets/rolldown-runtime-XKyaHtl9.js +1 -0
  18. package/dist/admin/dist/index.html +16 -0
  19. package/dist/admin/dist/preview.js +1 -0
  20. package/dist/admin/dist/window.js +1 -0
  21. package/dist/astro/content.d.ts +21 -0
  22. package/dist/astro/content.js +235 -0
  23. package/dist/astro/devServer.js +89 -0
  24. package/dist/astro/index.d.ts +15 -0
  25. package/dist/astro/index.js +98 -0
  26. package/dist/astro/nodeBridge.js +36 -0
  27. package/dist/astro/shared.js +10 -0
  28. package/dist/astro/stub/index.html +71 -0
  29. package/dist/auth/client.d.ts +24 -0
  30. package/dist/auth/client.js +120 -0
  31. package/dist/auth/handler.d.ts +16 -0
  32. package/dist/auth/handler.js +281 -0
  33. package/dist/auth/protocol.d.ts +25 -0
  34. package/dist/auth/protocol.js +3 -0
  35. package/dist/core/assets.d.ts +73 -0
  36. package/dist/core/assets.js +405 -0
  37. package/dist/core/devApi.d.ts +28 -0
  38. package/dist/core/devApi.js +3 -0
  39. package/dist/core/entryFile.d.ts +13 -0
  40. package/dist/core/entryFile.js +81 -0
  41. package/dist/core/fields.js +147 -0
  42. package/dist/core/generate.d.ts +3 -0
  43. package/dist/core/generate.js +70 -0
  44. package/dist/core/gitStyle.d.ts +92 -0
  45. package/dist/core/gitStyle.js +206 -0
  46. package/dist/core/index.d.ts +16 -0
  47. package/dist/core/index.js +16 -0
  48. package/dist/core/issues.d.ts +10 -0
  49. package/dist/core/issues.js +10 -0
  50. package/dist/core/paths.d.ts +31 -0
  51. package/dist/core/paths.js +114 -0
  52. package/dist/core/project.js +56 -0
  53. package/dist/core/references.d.ts +68 -0
  54. package/dist/core/references.js +103 -0
  55. package/dist/core/rename.d.ts +60 -0
  56. package/dist/core/rename.js +133 -0
  57. package/dist/core/schema.d.ts +117 -0
  58. package/dist/core/schema.js +299 -0
  59. package/dist/core/sha.d.ts +2 -0
  60. package/dist/core/sha.js +13 -0
  61. package/dist/core/source.d.ts +48 -0
  62. package/dist/core/source.js +57 -0
  63. package/dist/core/validate.d.ts +22 -0
  64. package/dist/core/validate.js +148 -0
  65. package/dist/core/walk.d.ts +23 -0
  66. package/dist/core/walk.js +94 -0
  67. package/dist/core/writes.d.ts +37 -0
  68. package/dist/core/writes.js +166 -0
  69. package/dist/github/base64.js +16 -0
  70. package/dist/github/cache.d.ts +34 -0
  71. package/dist/github/cache.js +126 -0
  72. package/dist/github/client.d.ts +38 -0
  73. package/dist/github/client.js +228 -0
  74. package/dist/github/codeowners.d.ts +23 -0
  75. package/dist/github/codeowners.js +96 -0
  76. package/dist/github/commitReader.d.ts +25 -0
  77. package/dist/github/commitReader.js +38 -0
  78. package/dist/github/deploy.d.ts +15 -0
  79. package/dist/github/deploy.js +33 -0
  80. package/dist/github/index.d.ts +9 -0
  81. package/dist/github/index.js +8 -0
  82. package/dist/github/repo.d.ts +95 -0
  83. package/dist/github/repo.js +375 -0
  84. package/dist/github/source.d.ts +115 -0
  85. package/dist/github/source.js +558 -0
  86. package/dist/loader/index.d.ts +27 -0
  87. package/dist/loader/index.js +151 -0
  88. package/dist/loader/protocol.d.ts +95 -0
  89. package/dist/loader/protocol.js +120 -0
  90. package/dist/loader/window/geometry.js +9 -0
  91. package/dist/next/EditletLoader.d.ts +5 -0
  92. package/dist/next/EditletLoader.js +33 -0
  93. package/dist/next/assetUrl.d.ts +9 -0
  94. package/dist/next/assetUrl.js +13 -0
  95. package/dist/next/buildGuard.js +26 -0
  96. package/dist/next/config.d.ts +18 -0
  97. package/dist/next/config.js +255 -0
  98. package/dist/next/devServer.js +70 -0
  99. package/dist/next/editletField.d.ts +7 -0
  100. package/dist/next/editletField.js +7 -0
  101. package/dist/next/index.d.ts +8 -0
  102. package/dist/next/index.js +6 -0
  103. package/dist/next/preview.d.ts +18 -0
  104. package/dist/next/preview.js +100 -0
  105. package/dist/next/previewCookie.d.ts +5 -0
  106. package/dist/next/previewCookie.js +72 -0
  107. package/dist/next/previewEnv.js +25 -0
  108. package/dist/next/previewRef.d.ts +8 -0
  109. package/dist/next/previewRef.js +17 -0
  110. package/dist/next/publicDir.js +65 -0
  111. package/dist/next/reader.d.ts +49 -0
  112. package/dist/next/reader.js +161 -0
  113. package/dist/next/stub/index.html +56 -0
  114. package/dist/node/devHandler.d.ts +6 -0
  115. package/dist/node/devHandler.js +430 -0
  116. package/dist/node/fs.js +37 -0
  117. package/dist/node/index.d.ts +3 -0
  118. package/dist/node/index.js +3 -0
  119. package/dist/node/project.d.ts +12 -0
  120. package/dist/node/project.js +43 -0
  121. package/package.json +187 -4
  122. package/skills/README.md +84 -0
  123. package/skills/editlet/SKILL.md +119 -0
  124. package/skills/editlet/references/content-format.md +191 -0
  125. package/skills/editlet/references/preview.md +75 -0
  126. package/skills/editlet/references/publishing.md +137 -0
  127. package/skills/editlet/references/schema-changes.md +127 -0
  128. package/skills/editlet/scripts/guard.mjs +1061 -0
  129. package/skills/editlet/scripts/link.mjs +193 -0
  130. package/skills/editlet/scripts/refs.mjs +1480 -0
  131. package/skills/editlet/scripts/schema.mjs +1340 -0
  132. package/skills/editlet/scripts/style.mjs +657 -0
  133. package/skills/editlet/scripts/types.mjs +525 -0
  134. package/skills/editlet/scripts/validate.mjs +724 -0
  135. package/skills/editlet-migrate/SKILL.md +92 -0
  136. package/skills/editlet-migrate/references/mapping.md +73 -0
  137. package/skills/editlet-migrate/references/sources.md +70 -0
  138. package/skills/editlet-setup/SKILL.md +108 -0
  139. package/skills/editlet-setup/references/astro.md +83 -0
  140. package/skills/editlet-setup/references/doctor.md +89 -0
  141. package/skills/editlet-setup/references/next.md +140 -0
  142. package/skills/editlet-setup/references/preview.md +54 -0
  143. package/skills/editlet-setup/references/production.md +153 -0
  144. package/skills/editlet-setup/references/roles.md +238 -0
  145. package/skills/editlet-setup/references/skills.md +99 -0
  146. package/skills/editlet-setup/scripts/doctor.mjs +1378 -0
@@ -0,0 +1,151 @@
1
+ import { DEFAULT_ADMIN_URL, EDITLET_PARAM, EDITLET_PROTOCOL_VERSION, EDITLET_SOURCE, ENTRY_ATTR, FIELD_ATTR, HIGHLIGHT_ATTR, PREVIEW_CHANNEL, PREVIEW_DB, PREVIEW_FLAG_KEY, PREVIEW_KEY, PREVIEW_ROUTE, PREVIEW_SCRIPT, PREVIEW_STORE, WINDOW_SCRIPT, adminMessage, fieldMark, isAdminToSiteMessage, isPreviewChannelMessage, isPreviewSnapshot, isSiteToAdminMessage, readEditletRoute, siteMessage, withEditletRoute } from "./protocol.js";
2
+ import { SHEET_MEDIA } from "./window/geometry.js";
3
+ // loader/index.ts
4
+ const KEY = Symbol.for("editlet.loader");
5
+ const CSS = `dialog[data-editlet]{position:fixed;z-index:2147483000;inset:20px 20px auto auto;width:min(600px,100vw - 40px);height:min(800px,100vh - 40px);max-width:none;max-height:none;margin:0;padding:0;border:0;background:transparent;overflow:hidden;border-radius:20px;box-shadow:0 0 0 2px #80808031}@media ${SHEET_MEDIA}{dialog[data-editlet]{inset:auto 0 0;width:100%;height:70dvh;border-radius:20px 20px 0 0}}dialog[data-editlet]>iframe{display:block;width:100%;height:100%;border:0}dialog[data-editlet]>button{position:absolute;top:8px;right:8px;z-index:1;width:32px;height:32px;padding:0;border:0;border-radius:8px;background:#fff;color:#111;font:24px/32px sans-serif;box-shadow:0 1px 4px #0006;cursor:pointer}[${HIGHLIGHT_ATTR}]{outline:3px solid #fa0!important;outline-offset:2px}`;
6
+ const clearHighlights = () => document.querySelectorAll(`[${HIGHLIGHT_ATTR}]`).forEach((el) => el.removeAttribute(HIGHLIGHT_ATTR));
7
+ function mountEditletLoader(options = {}) {
8
+ const g = globalThis;
9
+ const existing = g[KEY];
10
+ if (existing) return existing;
11
+ const adminUrl = new URL(options.adminUrl ?? "/editlet/", location.href);
12
+ const replaceUrl = options.replaceUrl ?? ((url) => history.replaceState(history.state, "", url));
13
+ const param = options.param || "editlet";
14
+ const setUrl = (route) => replaceUrl(withEditletRoute(location.href, route, param));
15
+ const s = {
16
+ dialog: null,
17
+ iframe: null,
18
+ route: "",
19
+ ready: false
20
+ };
21
+ const post = (body) => s.iframe?.contentWindow?.postMessage(siteMessage(body), adminUrl.origin);
22
+ const teardown = () => {
23
+ const d = s.dialog;
24
+ if (!d) return;
25
+ s.dialog = s.iframe = null;
26
+ s.ready = false;
27
+ d.close();
28
+ d.remove();
29
+ clearHighlights();
30
+ };
31
+ const open = () => {
32
+ if (!document.querySelector("style[data-editlet]")) {
33
+ const style = document.createElement("style");
34
+ style.dataset.editlet = "";
35
+ style.textContent = CSS;
36
+ document.head.append(style);
37
+ }
38
+ const d = document.createElement("dialog");
39
+ d.dataset.editlet = "";
40
+ d.ariaLabel = "Editlet";
41
+ const f = document.createElement("iframe");
42
+ f.title = "Editlet";
43
+ f.setAttribute("allow", "clipboard-write");
44
+ f.src = withEditletRoute(adminUrl, s.route);
45
+ f.addEventListener("load", () => f.focus());
46
+ const b = document.createElement("button");
47
+ b.type = "button";
48
+ b.ariaLabel = "Close Editlet";
49
+ b.dataset.editletClose = "";
50
+ b.textContent = "×";
51
+ b.addEventListener("click", close);
52
+ d.append(f, b);
53
+ s.dialog = d;
54
+ s.iframe = f;
55
+ document.body.append(d);
56
+ d.show();
57
+ inject(WINDOW_SCRIPT);
58
+ };
59
+ const inject = (file) => {
60
+ const attr = `data-${EDITLET_SOURCE}-${file.split(".")[0]}`;
61
+ if (document.querySelector(`script[${attr}]`)) return;
62
+ const el = document.createElement("script");
63
+ el.type = "module";
64
+ el.setAttribute(attr, "");
65
+ el.src = new URL(file, adminUrl).href;
66
+ document.head.append(el);
67
+ };
68
+ const sync = () => {
69
+ if (!document.body) return;
70
+ const route = readEditletRoute(location.href, param);
71
+ let flag = null;
72
+ try {
73
+ flag = localStorage.getItem(PREVIEW_FLAG_KEY);
74
+ } catch {}
75
+ if (flag !== null || route !== null) inject(PREVIEW_SCRIPT);
76
+ if (route === null) return teardown();
77
+ if (s.dialog && !s.dialog.isConnected) teardown();
78
+ if (s.dialog && route !== s.route && s.ready) post({
79
+ type: "navigate",
80
+ route
81
+ });
82
+ s.route = route;
83
+ if (!s.dialog) open();
84
+ };
85
+ const close = () => {
86
+ setUrl(null);
87
+ teardown();
88
+ };
89
+ const onMessage = (e) => {
90
+ if (e.source !== s.iframe?.contentWindow || e.origin !== adminUrl.origin || !isAdminToSiteMessage(e.data)) return;
91
+ const m = e.data;
92
+ switch (m.type) {
93
+ case "ready":
94
+ s.ready = true;
95
+ s.dialog.querySelector("button")?.remove();
96
+ post({
97
+ type: "init",
98
+ route: s.route,
99
+ site: {
100
+ origin: location.origin,
101
+ href: withEditletRoute(location.href, null, param)
102
+ }
103
+ });
104
+ break;
105
+ case "navigate":
106
+ s.route = m.route;
107
+ setUrl(m.route);
108
+ break;
109
+ case "close":
110
+ close();
111
+ break;
112
+ case "refresh":
113
+ (options.onRefresh ?? (() => location.reload()))();
114
+ break;
115
+ case "highlight": {
116
+ clearHighlights();
117
+ if (m.entry === null) break;
118
+ let first;
119
+ document.querySelectorAll(`[${ENTRY_ATTR}]`).forEach((el) => {
120
+ if (el.getAttribute("data-editlet-entry") !== m.entry) return;
121
+ el.setAttribute(HIGHLIGHT_ATTR, "");
122
+ first ??= el;
123
+ });
124
+ first?.scrollIntoView({
125
+ block: "center",
126
+ behavior: "smooth"
127
+ });
128
+ break;
129
+ }
130
+ }
131
+ };
132
+ window.addEventListener("popstate", sync);
133
+ window.addEventListener("message", onMessage);
134
+ if (document.body) sync();
135
+ else document.addEventListener("DOMContentLoaded", sync, { once: true });
136
+ const handle = {
137
+ sync,
138
+ close,
139
+ destroy() {
140
+ window.removeEventListener("popstate", sync);
141
+ window.removeEventListener("message", onMessage);
142
+ document.removeEventListener("DOMContentLoaded", sync);
143
+ teardown();
144
+ document.querySelector("style[data-editlet]")?.remove();
145
+ delete g[KEY];
146
+ }
147
+ };
148
+ g[KEY] = handle;
149
+ return handle;
150
+ }
151
+ export { DEFAULT_ADMIN_URL, EDITLET_PARAM, EDITLET_PROTOCOL_VERSION, EDITLET_SOURCE, ENTRY_ATTR, FIELD_ATTR, HIGHLIGHT_ATTR, PREVIEW_CHANNEL, PREVIEW_DB, PREVIEW_FLAG_KEY, PREVIEW_KEY, PREVIEW_ROUTE, PREVIEW_SCRIPT, PREVIEW_STORE, WINDOW_SCRIPT, adminMessage, fieldMark, isAdminToSiteMessage, isPreviewChannelMessage, isPreviewSnapshot, isSiteToAdminMessage, mountEditletLoader, readEditletRoute, siteMessage, withEditletRoute };
@@ -0,0 +1,95 @@
1
+ export declare const EDITLET_SOURCE: 'editlet';
2
+ export declare const EDITLET_PROTOCOL_VERSION: 1;
3
+ /** Default query parameter that opens the editor on a site page; sites may set another (`EDITLET_PARAM` env). */
4
+ export declare const EDITLET_PARAM: 'editlet';
5
+ export declare const DEFAULT_ADMIN_URL: '/editlet/';
6
+ export declare const ENTRY_ATTR: 'data-editlet-entry';
7
+ export declare const HIGHLIGHT_ATTR: 'data-editlet-highlight';
8
+ export declare const FIELD_ATTR: 'data-editlet-field';
9
+ export declare const PREVIEW_FLAG_KEY: 'editlet:preview';
10
+ export declare const PREVIEW_CHANNEL: 'editlet:preview';
11
+ export declare const PREVIEW_DB: 'editlet-preview';
12
+ export declare const PREVIEW_STORE: 'snapshot';
13
+ export declare const PREVIEW_KEY: 'current';
14
+ export declare const PREVIEW_SCRIPT: 'preview.js';
15
+ export declare const WINDOW_SCRIPT: 'window.js';
16
+ export declare const PREVIEW_ROUTE: '/api/editlet/preview';
17
+ export type AdminLayout = 'full' | 'side';
18
+ type Envelope<T extends string> = {
19
+ source: typeof EDITLET_SOURCE;
20
+ v: typeof EDITLET_PROTOCOL_VERSION;
21
+ type: T;
22
+ };
23
+ export type ReadyMessage = Envelope<'ready'>;
24
+ export type AdminNavigateMessage = Envelope<'navigate'> & {
25
+ route: string;
26
+ };
27
+ export type CloseMessage = Envelope<'close'>;
28
+ export type RefreshMessage = Envelope<'refresh'>;
29
+ export type HighlightMessage = Envelope<'highlight'> & {
30
+ entry: string | null;
31
+ };
32
+ export type LayoutMessage = Envelope<'layout'> & {
33
+ layout: AdminLayout;
34
+ };
35
+ export type AdminToSiteMessage = ReadyMessage | AdminNavigateMessage | CloseMessage | RefreshMessage | HighlightMessage | LayoutMessage;
36
+ export type InitMessage = Envelope<'init'> & {
37
+ route: string;
38
+ site: {
39
+ origin: string;
40
+ href: string;
41
+ };
42
+ };
43
+ export type SiteNavigateMessage = Envelope<'navigate'> & {
44
+ route: string;
45
+ };
46
+ export type CloseRequestMessage = Envelope<'close-request'>;
47
+ export type SiteToAdminMessage = InitMessage | SiteNavigateMessage | CloseRequestMessage;
48
+ export type MessageBody<M> = M extends unknown ? Omit<M, 'source' | 'v'> : never;
49
+ export declare function adminMessage(body: MessageBody<AdminToSiteMessage>): AdminToSiteMessage;
50
+ export declare function siteMessage(body: MessageBody<SiteToAdminMessage>): SiteToAdminMessage;
51
+ export declare function isAdminToSiteMessage(data: unknown): data is AdminToSiteMessage;
52
+ export declare function isSiteToAdminMessage(data: unknown): data is SiteToAdminMessage;
53
+ /**
54
+ * The `param` param of `url` (default `editlet`): `null` when absent, `''` for `?editlet` / `?editlet=`. Relative
55
+ * inputs are resolved as root-relative (against `/`, not against any page); pass absolute URLs or `URL` objects for
56
+ * anything else.
57
+ */
58
+ export declare function readEditletRoute(url: string | URL, param?: string): string | null;
59
+ /**
60
+ * `url` with `param` (default `editlet`) set to `route` (`null` removes it), other params and the hash kept. Absolute in → absolute out;
61
+ * relative in → root-relative out. Relative inputs are resolved as root-relative (`'admin/'` → `/admin/`); pass
62
+ * absolute URLs or `URL` objects for anything else.
63
+ */
64
+ export declare function withEditletRoute(url: string | URL, route: string | null, param?: string): string;
65
+ export type PreviewValue = {
66
+ text: {
67
+ from: string;
68
+ to: string;
69
+ };
70
+ } | {
71
+ image: {
72
+ from: string;
73
+ to: Blob;
74
+ alt?: {
75
+ from: string;
76
+ to: string;
77
+ };
78
+ };
79
+ } | {
80
+ stale: true;
81
+ };
82
+ export interface PreviewSnapshot {
83
+ v: 1;
84
+ branch: string;
85
+ expiresAt: number;
86
+ entries: Record<string, Record<string, PreviewValue>>;
87
+ }
88
+ export type PreviewChannelMessage = {
89
+ source: typeof EDITLET_SOURCE;
90
+ type: 'snapshot';
91
+ };
92
+ export declare function fieldMark(entry: string, field: string): string;
93
+ export declare function isPreviewSnapshot(v: unknown): v is PreviewSnapshot;
94
+ export declare function isPreviewChannelMessage(v: unknown): v is PreviewChannelMessage;
95
+ export {};
@@ -0,0 +1,120 @@
1
+ // loader/protocol.ts
2
+ const EDITLET_SOURCE = "editlet";
3
+ const EDITLET_PROTOCOL_VERSION = 1;
4
+ /** Default query parameter that opens the editor on a site page; sites may set another (`EDITLET_PARAM` env). */
5
+ const EDITLET_PARAM = "editlet";
6
+ const DEFAULT_ADMIN_URL = "/editlet/";
7
+ const ENTRY_ATTR = "data-editlet-entry";
8
+ const HIGHLIGHT_ATTR = "data-editlet-highlight";
9
+ const FIELD_ATTR = "data-editlet-field";
10
+ const PREVIEW_FLAG_KEY = "editlet:preview";
11
+ const PREVIEW_CHANNEL = "editlet:preview";
12
+ const PREVIEW_DB = "editlet-preview";
13
+ const PREVIEW_STORE = "snapshot";
14
+ const PREVIEW_KEY = "current";
15
+ const PREVIEW_SCRIPT = "preview.js";
16
+ const WINDOW_SCRIPT = "window.js";
17
+ const PREVIEW_ROUTE = "/api/editlet/preview";
18
+ function adminMessage(body) {
19
+ return {
20
+ source: EDITLET_SOURCE,
21
+ v: 1,
22
+ ...body
23
+ };
24
+ }
25
+ function siteMessage(body) {
26
+ return {
27
+ source: EDITLET_SOURCE,
28
+ v: 1,
29
+ ...body
30
+ };
31
+ }
32
+ function envelope(data) {
33
+ if (typeof data !== "object" || data === null) return null;
34
+ const d = data;
35
+ return d.source === "editlet" && d.v === 1 && typeof d.type === "string" ? d : null;
36
+ }
37
+ function isAdminToSiteMessage(data) {
38
+ const d = envelope(data);
39
+ if (!d) return false;
40
+ switch (d.type) {
41
+ case "ready":
42
+ case "close":
43
+ case "refresh": return true;
44
+ case "navigate": return typeof d.route === "string";
45
+ case "highlight": return d.entry === null || typeof d.entry === "string";
46
+ case "layout": return d.layout === "full" || d.layout === "side";
47
+ default: return false;
48
+ }
49
+ }
50
+ function isSiteToAdminMessage(data) {
51
+ const d = envelope(data);
52
+ if (!d) return false;
53
+ switch (d.type) {
54
+ case "init": {
55
+ const site = d.site;
56
+ return typeof d.route === "string" && typeof site === "object" && site !== null && typeof site.origin === "string" && typeof site.href === "string";
57
+ }
58
+ case "navigate": return typeof d.route === "string";
59
+ case "close-request": return true;
60
+ default: return false;
61
+ }
62
+ }
63
+ const BASE = "http://x";
64
+ const ABSOLUTE = /^[a-z][a-z0-9+.-]*:/i;
65
+ function paramName(segment) {
66
+ const raw = segment.split("=")[0].replace(/\+/g, " ");
67
+ try {
68
+ return decodeURIComponent(raw);
69
+ } catch {
70
+ return raw;
71
+ }
72
+ }
73
+ /**
74
+ * The `param` param of `url` (default `editlet`): `null` when absent, `''` for `?editlet` / `?editlet=`. Relative
75
+ * inputs are resolved as root-relative (against `/`, not against any page); pass absolute URLs or `URL` objects for
76
+ * anything else.
77
+ */
78
+ function readEditletRoute(url, param = EDITLET_PARAM) {
79
+ return new URL(url, BASE).searchParams.get(param);
80
+ }
81
+ /**
82
+ * `url` with `param` (default `editlet`) set to `route` (`null` removes it), other params and the hash kept. Absolute in → absolute out;
83
+ * relative in → root-relative out. Relative inputs are resolved as root-relative (`'admin/'` → `/admin/`); pass
84
+ * absolute URLs or `URL` objects for anything else.
85
+ */
86
+ function withEditletRoute(url, route, param = EDITLET_PARAM) {
87
+ const protocolRelative = typeof url === "string" && url.startsWith("//");
88
+ const absolute = typeof url !== "string" || ABSOLUTE.test(url);
89
+ const u = new URL(url, BASE);
90
+ const segments = u.search.slice(1).split("&").filter((seg) => seg !== "" && paramName(seg) !== param);
91
+ if (route !== null) {
92
+ const encoded = encodeURIComponent(route).replace(/%2F/gi, "/").replace(/%3A/gi, ":");
93
+ segments.push(route === "" ? param : `${param}=${encoded}`);
94
+ }
95
+ u.search = segments.join("&");
96
+ if (protocolRelative) return `//${u.host}${u.pathname}${u.search}${u.hash}`;
97
+ return absolute ? u.href : `${u.pathname}${u.search}${u.hash}`;
98
+ }
99
+ function fieldMark(entry, field) {
100
+ return `${entry}#${field}`;
101
+ }
102
+ function isRecord(v) {
103
+ return typeof v === "object" && v !== null;
104
+ }
105
+ function isPreviewValue(v) {
106
+ if (!isRecord(v)) return false;
107
+ if (v.stale === true) return true;
108
+ if (isRecord(v.text)) return typeof v.text.from === "string" && typeof v.text.to === "string";
109
+ if (isRecord(v.image)) return typeof v.image.from === "string" && v.image.to instanceof Blob;
110
+ return false;
111
+ }
112
+ function isPreviewSnapshot(v) {
113
+ if (!isRecord(v) || v.v !== 1 || typeof v.branch !== "string" || typeof v.expiresAt !== "number") return false;
114
+ if (!isRecord(v.entries)) return false;
115
+ return Object.values(v.entries).every((fields) => isRecord(fields) && Object.values(fields).every(isPreviewValue));
116
+ }
117
+ function isPreviewChannelMessage(v) {
118
+ return isRecord(v) && v.source === "editlet" && v.type === "snapshot";
119
+ }
120
+ export { DEFAULT_ADMIN_URL, EDITLET_PARAM, EDITLET_PROTOCOL_VERSION, EDITLET_SOURCE, ENTRY_ATTR, FIELD_ATTR, HIGHLIGHT_ATTR, PREVIEW_CHANNEL, PREVIEW_DB, PREVIEW_FLAG_KEY, PREVIEW_KEY, PREVIEW_ROUTE, PREVIEW_SCRIPT, PREVIEW_STORE, WINDOW_SCRIPT, adminMessage, fieldMark, isAdminToSiteMessage, isPreviewChannelMessage, isPreviewSnapshot, isSiteToAdminMessage, readEditletRoute, siteMessage, withEditletRoute };
@@ -0,0 +1,9 @@
1
+ // loader/window/geometry.ts
2
+ /**
3
+ * Below this page width the window is a bottom sheet: full width, 70% of the screen high, fixed to the bottom. It does
4
+ * not move; only window.js's grab handle on its top edge resizes it (`sheetHeight`). 640 px is the default width (600)
5
+ * plus both margins, so the floating window never fits there anyway. The loader's CSS draws the sheet; window.js sets
6
+ * only a pulled height; the admin hides the move button and the resize edges.
7
+ */
8
+ const SHEET_MEDIA = "(width < 640px)";
9
+ export { SHEET_MEDIA };
@@ -0,0 +1,5 @@
1
+ export interface EditletLoaderProps {
2
+ /** Admin page URL. Default `/editlet/index.html`. */
3
+ adminUrl?: string;
4
+ }
5
+ export declare function EditletLoader(props: EditletLoaderProps): import("react").JSX.Element;
@@ -0,0 +1,33 @@
1
+ "use client";
2
+ import { mountEditletLoader } from "../loader/index.js";
3
+ import { Suspense, useEffect } from "react";
4
+ import { usePathname, useRouter, useSearchParams } from "next/navigation";
5
+ import { jsx } from "react/jsx-runtime";
6
+ // next/EditletLoader.tsx
7
+ const DEFAULT_ADMIN_URL = "/editlet/index.html";
8
+ function EditletLoaderInner({ adminUrl = DEFAULT_ADMIN_URL }) {
9
+ const router = useRouter();
10
+ const pathname = usePathname();
11
+ const searchParams = useSearchParams();
12
+ useEffect(() => {
13
+ mountEditletLoader({
14
+ adminUrl,
15
+ param: process.env.EDITLET_PARAM,
16
+ onRefresh: () => router.refresh(),
17
+ replaceUrl: (url) => history.replaceState(null, "", url)
18
+ }).sync();
19
+ }, [
20
+ pathname,
21
+ searchParams,
22
+ router,
23
+ adminUrl
24
+ ]);
25
+ return null;
26
+ }
27
+ function EditletLoader(props) {
28
+ return /* @__PURE__ */ jsx(Suspense, {
29
+ fallback: null,
30
+ children: /* @__PURE__ */ jsx(EditletLoaderInner, { ...props })
31
+ });
32
+ }
33
+ export { EditletLoader };
@@ -0,0 +1,9 @@
1
+ /** Public URL prefix under which the dev server and the build copy serve content-directory files. */
2
+ export declare const CONTENT_URL = "/editlet/content/";
3
+ /**
4
+ * Turns an image `src` (relative to the entry's folder) into its public URL. Absolute URLs, root-relative paths,
5
+ * fragments and sources escaping the content directory are returned unchanged.
6
+ */
7
+ export declare function assetUrl(entry: {
8
+ collection: string;
9
+ }, src: string): string;
@@ -0,0 +1,13 @@
1
+ // next/assetUrl.ts
2
+ /** Public URL prefix under which the dev server and the build copy serve content-directory files. */
3
+ const CONTENT_URL = "/editlet/content/";
4
+ /**
5
+ * Turns an image `src` (relative to the entry's folder) into its public URL. Absolute URLs, root-relative paths,
6
+ * fragments and sources escaping the content directory are returned unchanged.
7
+ */
8
+ function assetUrl(entry, src) {
9
+ if (src === "" || /^([a-z][a-z0-9+.-]*:|\/|#)/i.test(src)) return src;
10
+ const url = new URL(src, `http://x${CONTENT_URL}${entry.collection}/`);
11
+ return url.pathname.startsWith("/editlet/content/") ? url.pathname : src;
12
+ }
13
+ export { CONTENT_URL, assetUrl };
@@ -0,0 +1,26 @@
1
+ import { readFile, readdir } from "node:fs/promises";
2
+ import { join, relative, sep } from "node:path";
3
+ // next/buildGuard.ts
4
+ const DEV_HANDLER_MARKER = "File changed since it was read";
5
+ const CODE_FILE = /\.(?:js|mjs|cjs|json)$/;
6
+ /** First built file under `distDir` that contains the dev-handler marker, or `null`. */
7
+ async function findDevHandlerCode(distDir) {
8
+ let dirents;
9
+ try {
10
+ dirents = await readdir(distDir, {
11
+ recursive: true,
12
+ withFileTypes: true
13
+ });
14
+ } catch {
15
+ return null;
16
+ }
17
+ for (const d of dirents) {
18
+ if (!d.isFile() || !CODE_FILE.test(d.name)) continue;
19
+ const top = relative(distDir, d.parentPath).split(sep)[0];
20
+ if (top === "cache" || top === "dev") continue;
21
+ const file = join(d.parentPath, d.name);
22
+ if ((await readFile(file, "utf8")).includes("File changed since it was read")) return file;
23
+ }
24
+ return null;
25
+ }
26
+ export { DEV_HANDLER_MARKER, findDevHandlerCode };
@@ -0,0 +1,18 @@
1
+ import { AdminConfigOptions } from "../admin/config.js";
2
+ import { NextConfig } from "next";
3
+ export interface WithEditletOptions {
4
+ root?: string;
5
+ schemaPath?: string;
6
+ typesFile?: string;
7
+ /** Public admin config (`config.json`). Everything here ends up public. */
8
+ admin?: AdminConfigOptions;
9
+ /** Internal: the package directory, when it cannot be resolved from `root` (tests). */
10
+ packageDir?: string;
11
+ }
12
+ type ConfigInput = NextConfig | ((phase: string, ctx: {
13
+ defaultConfig: NextConfig;
14
+ }) => NextConfig | Promise<NextConfig>);
15
+ export declare function withEditlet(nextConfig?: ConfigInput, options?: WithEditletOptions): (phase: string, ctx: {
16
+ defaultConfig: NextConfig;
17
+ }) => Promise<NextConfig>;
18
+ export {};