@kitcms/ui 0.0.0-stage → 0.1.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 (54) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +69 -2
  3. package/package.json +47 -3
  4. package/src/index.ts +1 -0
  5. package/src/lib/Admin.svelte +345 -0
  6. package/src/lib/fields/ArrayField.svelte +134 -0
  7. package/src/lib/fields/BlocksField.svelte +201 -0
  8. package/src/lib/fields/CheckboxField.svelte +48 -0
  9. package/src/lib/fields/DateField.svelte +70 -0
  10. package/src/lib/fields/EmailField.svelte +39 -0
  11. package/src/lib/fields/FieldShell.svelte +70 -0
  12. package/src/lib/fields/GroupField.svelte +40 -0
  13. package/src/lib/fields/JsonField.svelte +74 -0
  14. package/src/lib/fields/NumberField.svelte +51 -0
  15. package/src/lib/fields/RelationshipField.svelte +11 -0
  16. package/src/lib/fields/RenderFields.svelte +32 -0
  17. package/src/lib/fields/RenderNodes.svelte +147 -0
  18. package/src/lib/fields/RichTextField.svelte +310 -0
  19. package/src/lib/fields/RowCard.svelte +229 -0
  20. package/src/lib/fields/SelectField.svelte +43 -0
  21. package/src/lib/fields/SlugField.svelte +85 -0
  22. package/src/lib/fields/TextField.svelte +41 -0
  23. package/src/lib/fields/TextareaField.svelte +40 -0
  24. package/src/lib/fields/UploadField.svelte +26 -0
  25. package/src/lib/fields/registry.ts +41 -0
  26. package/src/lib/fields/relation/RelationField.svelte +256 -0
  27. package/src/lib/fields/relation/RelationPicker.svelte +246 -0
  28. package/src/lib/fields/relation/api.ts +66 -0
  29. package/src/lib/fields/rowDrag.svelte.ts +41 -0
  30. package/src/lib/fields/rows.ts +70 -0
  31. package/src/lib/fields/types.ts +35 -0
  32. package/src/lib/form/context.ts +26 -0
  33. package/src/lib/format.ts +106 -0
  34. package/src/lib/index.ts +20 -0
  35. package/src/lib/links.ts +32 -0
  36. package/src/lib/media/MediaPicker.svelte +327 -0
  37. package/src/lib/media/util.ts +36 -0
  38. package/src/lib/preview/BlocksPreview.svelte +37 -0
  39. package/src/lib/preview/LazyPreview.svelte +75 -0
  40. package/src/lib/preview/PreviewPane.svelte +98 -0
  41. package/src/lib/preview/blocks.ts +39 -0
  42. package/src/lib/preview/load.ts +21 -0
  43. package/src/lib/preview/relations.ts +70 -0
  44. package/src/lib/preview/types.ts +75 -0
  45. package/src/lib/preview/useRelation.svelte.ts +58 -0
  46. package/src/lib/theme.css +193 -0
  47. package/src/lib/upload/FileUpload.svelte +216 -0
  48. package/src/lib/views/Dashboard.svelte +64 -0
  49. package/src/lib/views/Edit.svelte +557 -0
  50. package/src/lib/views/FirstUser.svelte +63 -0
  51. package/src/lib/views/List.svelte +557 -0
  52. package/src/lib/views/Login.svelte +58 -0
  53. package/src/lib/views/Panel.svelte +175 -0
  54. package/src/lib/views/Versions.svelte +144 -0
@@ -0,0 +1,246 @@
1
+ <script lang="ts">
2
+ // Search box + results popup (ARIA combobox pattern). Used by relationship and upload fields.
3
+ // Results render as a list, or as a thumbnail grid for uploads.
4
+ import { searchDocs, isImage, type PickerDoc } from './api';
5
+
6
+ let {
7
+ id,
8
+ collection,
9
+ kind,
10
+ exclude = [],
11
+ disabled = false,
12
+ placeholder = 'Search...',
13
+ describedBy,
14
+ invalid = false,
15
+ onselect,
16
+ }: {
17
+ id: string;
18
+ collection: string;
19
+ kind: 'relationship' | 'upload';
20
+ /** Ids not offered (already selected in a hasMany field). */
21
+ exclude?: string[];
22
+ disabled?: boolean;
23
+ placeholder?: string;
24
+ describedBy?: string;
25
+ invalid?: boolean;
26
+ onselect: (doc: PickerDoc) => void;
27
+ } = $props();
28
+
29
+ let query = $state('');
30
+ let open = $state(false);
31
+ let loading = $state(false);
32
+ let failed = $state(false);
33
+ let results = $state<PickerDoc[]>([]);
34
+ let active = $state(-1);
35
+
36
+ const listId = $derived(`${id}-list`);
37
+ const optionId = (i: number) => `${id}-opt-${i}`;
38
+ const shown = $derived(results.filter((d) => !exclude.includes(d.id)));
39
+
40
+ let timer: ReturnType<typeof setTimeout> | undefined;
41
+ let controller: AbortController | undefined;
42
+
43
+ async function run(q: string) {
44
+ controller?.abort();
45
+ controller = new AbortController();
46
+ const signal = controller.signal;
47
+ loading = true;
48
+ failed = false;
49
+ try {
50
+ // Over-fetch a little so excluded ids don't empty the list.
51
+ results = await searchDocs(collection, q, 10 + exclude.length, signal);
52
+ active = results.length ? 0 : -1;
53
+ } catch {
54
+ if (signal.aborted) return;
55
+ failed = true;
56
+ results = [];
57
+ } finally {
58
+ if (!signal.aborted) loading = false;
59
+ }
60
+ }
61
+
62
+ function schedule(q: string, delay = 200) {
63
+ clearTimeout(timer);
64
+ timer = setTimeout(() => void run(q), delay);
65
+ }
66
+
67
+ function oninput() {
68
+ open = true;
69
+ schedule(query);
70
+ }
71
+ function onfocus() {
72
+ if (disabled) return;
73
+ open = true;
74
+ if (!results.length && !loading) schedule(query, 0);
75
+ }
76
+ function close() {
77
+ open = false;
78
+ active = -1;
79
+ }
80
+ function choose(doc: PickerDoc | undefined) {
81
+ if (!doc) return;
82
+ onselect(doc);
83
+ query = '';
84
+ close();
85
+ results = [];
86
+ }
87
+ function onkeydown(e: KeyboardEvent) {
88
+ if (e.key === 'ArrowDown') {
89
+ e.preventDefault();
90
+ if (!open) {
91
+ open = true;
92
+ if (!results.length) schedule(query, 0);
93
+ } else if (shown.length) active = (active + 1) % shown.length;
94
+ } else if (e.key === 'ArrowUp') {
95
+ e.preventDefault();
96
+ if (shown.length) active = (active - 1 + shown.length) % shown.length;
97
+ } else if (e.key === 'Home' && open && shown.length) {
98
+ e.preventDefault();
99
+ active = 0;
100
+ } else if (e.key === 'End' && open && shown.length) {
101
+ e.preventDefault();
102
+ active = shown.length - 1;
103
+ } else if (e.key === 'Enter') {
104
+ // Never submit the form from the search box.
105
+ e.preventDefault();
106
+ if (open && active >= 0) choose(shown[active]);
107
+ } else if (e.key === 'Escape' && open) {
108
+ e.preventDefault();
109
+ close();
110
+ }
111
+ }
112
+ function onblur() {
113
+ // Options use mousedown + preventDefault, so a blur always means "leave".
114
+ close();
115
+ }
116
+ </script>
117
+
118
+ <div class="kc-picker">
119
+ <!-- No `name`: the field renders its own hidden inputs; the search text is never submitted. -->
120
+ <input
121
+ {id}
122
+ class="kc-input"
123
+ type="text"
124
+ role="combobox"
125
+ autocomplete="off"
126
+ aria-autocomplete="list"
127
+ aria-expanded={open}
128
+ aria-controls={listId}
129
+ aria-activedescendant={open && active >= 0 ? optionId(active) : undefined}
130
+ aria-invalid={invalid ? 'true' : undefined}
131
+ aria-describedby={describedBy}
132
+ {placeholder}
133
+ {disabled}
134
+ bind:value={query}
135
+ {oninput}
136
+ {onfocus}
137
+ {onkeydown}
138
+ {onblur}
139
+ />
140
+ {#if open}
141
+ <ul
142
+ id={listId}
143
+ class="kc-card kc-picker__list"
144
+ class:kc-picker__grid={kind === 'upload'}
145
+ role="listbox"
146
+ aria-label="Results"
147
+ >
148
+ {#each shown as doc, i (doc.id)}
149
+ <li
150
+ id={optionId(i)}
151
+ role="option"
152
+ aria-selected={active === i}
153
+ class:kc-picker__active={active === i}
154
+ onmousedown={(e) => {
155
+ e.preventDefault();
156
+ choose(doc);
157
+ }}
158
+ onmousemove={() => (active = i)}
159
+ >
160
+ {#if kind === 'upload'}
161
+ {#if isImage(doc)}
162
+ <img src={doc.url} alt="" loading="lazy" />
163
+ {:else}
164
+ <span class="kc-picker__file" aria-hidden="true">&#128196;</span>
165
+ {/if}
166
+ <span class="kc-picker__name">{doc.filename ?? doc.title}</span>
167
+ {:else}
168
+ <span>{doc.title}</span>
169
+ {/if}
170
+ </li>
171
+ {/each}
172
+ {#if loading}
173
+ <li class="kc-muted kc-picker__status" role="presentation">Searching...</li>
174
+ {:else if failed}
175
+ <li class="kc-picker__status kc-picker__failed" role="presentation">Search failed. Try again.</li>
176
+ {:else if shown.length === 0}
177
+ <li class="kc-muted kc-picker__status" role="presentation">No results.</li>
178
+ {/if}
179
+ </ul>
180
+ {/if}
181
+ </div>
182
+
183
+ <style>
184
+ .kc-picker {
185
+ position: relative;
186
+ }
187
+ .kc-picker__list {
188
+ position: absolute;
189
+ z-index: 10;
190
+ inset-inline: 0;
191
+ top: calc(100% + 0.25rem);
192
+ margin: 0;
193
+ padding: 0.25rem;
194
+ list-style: none;
195
+ max-height: 18rem;
196
+ overflow: auto;
197
+ box-shadow: 0 8px 24px rgb(0 0 0 / 0.15);
198
+ }
199
+ .kc-picker__list li[role='option'] {
200
+ padding: 0.4rem 0.5rem;
201
+ border-radius: calc(var(--kc-radius) - 2px);
202
+ cursor: pointer;
203
+ }
204
+ .kc-picker__active {
205
+ background: color-mix(in srgb, var(--kc-accent) 15%, transparent);
206
+ }
207
+ .kc-picker__status {
208
+ padding: 0.4rem 0.5rem;
209
+ font-size: 0.875rem;
210
+ }
211
+ .kc-picker__failed {
212
+ color: var(--kc-danger);
213
+ }
214
+ .kc-picker__grid {
215
+ display: grid;
216
+ grid-template-columns: repeat(auto-fill, minmax(6rem, 1fr));
217
+ gap: 0.25rem;
218
+ }
219
+ .kc-picker__grid li[role='option'] {
220
+ display: grid;
221
+ gap: 0.25rem;
222
+ justify-items: center;
223
+ text-align: center;
224
+ }
225
+ .kc-picker__grid img,
226
+ .kc-picker__file {
227
+ width: 100%;
228
+ aspect-ratio: 1;
229
+ object-fit: cover;
230
+ border-radius: calc(var(--kc-radius) - 2px);
231
+ background: var(--kc-bg);
232
+ display: grid;
233
+ place-items: center;
234
+ font-size: 2rem;
235
+ }
236
+ .kc-picker__name {
237
+ font-size: 0.75rem;
238
+ overflow: hidden;
239
+ text-overflow: ellipsis;
240
+ white-space: nowrap;
241
+ max-width: 100%;
242
+ }
243
+ .kc-picker__grid .kc-picker__status {
244
+ grid-column: 1 / -1;
245
+ }
246
+ </style>
@@ -0,0 +1,66 @@
1
+ // Client for the admin picker endpoints (packages/core/src/sveltekit/api.ts).
2
+ import { resolve } from '$app/paths';
3
+
4
+ /** Mirrors `PickerDoc` in @kitcms/core's sveltekit/api (kept local so the UI doesn't import server code). */
5
+ export interface PickerDoc {
6
+ id: string;
7
+ title: string;
8
+ url?: string;
9
+ mimeType?: string;
10
+ filename?: string;
11
+ width?: number | null;
12
+ height?: number | null;
13
+ filesize?: number;
14
+ }
15
+
16
+ const API = '/(kitcms)/api/[...path]';
17
+
18
+ export function searchUrl(collection: string, q: string, limit = 10, page?: number): string {
19
+ const base = resolve(API, { path: `admin/search/${encodeURIComponent(collection)}` });
20
+ const params = new URLSearchParams();
21
+ if (q) params.set('q', q);
22
+ params.set('limit', String(limit));
23
+ if (page !== undefined) params.set('page', String(page));
24
+ return `${base}?${params}`;
25
+ }
26
+
27
+ export function lookupUrl(collection: string, ids: string[]): string {
28
+ const base = resolve(API, { path: `admin/lookup/${encodeURIComponent(collection)}` });
29
+ return `${base}?${new URLSearchParams({ ids: ids.join(',') })}`;
30
+ }
31
+
32
+ async function getDocs(url: string, signal?: AbortSignal): Promise<PickerDoc[]> {
33
+ const res = await fetch(url, { signal, headers: { accept: 'application/json' } });
34
+ if (!res.ok) throw new Error(`Request failed (${res.status})`);
35
+ const body = (await res.json()) as { docs?: PickerDoc[] };
36
+ return body.docs ?? [];
37
+ }
38
+
39
+ export const searchDocs = (collection: string, q: string, limit?: number, signal?: AbortSignal) =>
40
+ getDocs(searchUrl(collection, q, limit), signal);
41
+
42
+ /** Lookup in chunks (the endpoint caps the id count). */
43
+ export async function lookupDocs(collection: string, ids: string[], signal?: AbortSignal): Promise<PickerDoc[]> {
44
+ const out: PickerDoc[] = [];
45
+ for (let i = 0; i < ids.length; i += 50) {
46
+ out.push(...(await getDocs(lookupUrl(collection, ids.slice(i, i + 50)), signal)));
47
+ }
48
+ return out;
49
+ }
50
+
51
+ export const isImage = (doc: PickerDoc | undefined): doc is PickerDoc & { url: string } =>
52
+ Boolean(doc?.url && doc.mimeType?.startsWith('image/'));
53
+
54
+ /** Paged search (media picker): newest first, with `hasNextPage` for "Load more". */
55
+ export async function searchPage(
56
+ collection: string,
57
+ q: string,
58
+ page: number,
59
+ limit = 24,
60
+ signal?: AbortSignal,
61
+ ): Promise<{ docs: PickerDoc[]; hasNextPage: boolean }> {
62
+ const res = await fetch(searchUrl(collection, q, limit, page), { signal, headers: { accept: 'application/json' } });
63
+ if (!res.ok) throw new Error(`Request failed (${res.status})`);
64
+ const body = (await res.json()) as { docs?: PickerDoc[]; hasNextPage?: boolean };
65
+ return { docs: body.docs ?? [], hasNextPage: Boolean(body.hasNextPage) };
66
+ }
@@ -0,0 +1,41 @@
1
+ // Native HTML5 drag-and-drop state for reordering rows (no library). Keyboard users use the
2
+ // move up/down buttons on each row.
3
+ export class RowDrag {
4
+ from = $state<number | null>(null);
5
+ over = $state<number | null>(null);
6
+ moveRow: (from: number, to: number) => void;
7
+
8
+ constructor(move: (from: number, to: number) => void) {
9
+ this.moveRow = move;
10
+ }
11
+
12
+ start = (i: number, e: DragEvent, card?: Element | null) => {
13
+ this.from = i;
14
+ if (e.dataTransfer) {
15
+ e.dataTransfer.effectAllowed = 'move';
16
+ e.dataTransfer.setData('text/plain', String(i));
17
+ const el = card ?? (e.currentTarget as HTMLElement | null)?.closest('[data-row-id]');
18
+ if (el) e.dataTransfer.setDragImage(el, 16, 16);
19
+ }
20
+ };
21
+
22
+ end = () => {
23
+ this.from = null;
24
+ this.over = null;
25
+ };
26
+
27
+ dragover = (i: number, e: DragEvent) => {
28
+ if (this.from === null) return;
29
+ e.preventDefault();
30
+ if (e.dataTransfer) e.dataTransfer.dropEffect = 'move';
31
+ this.over = i;
32
+ };
33
+
34
+ drop = (i: number, e: DragEvent) => {
35
+ if (this.from === null) return;
36
+ e.preventDefault();
37
+ const from = this.from;
38
+ this.end();
39
+ if (from !== i) this.moveRow(from, i);
40
+ };
41
+ }
@@ -0,0 +1,70 @@
1
+ // Shared helpers for repeating containers (array rows, blocks).
2
+ import type { ClientField } from '@kitcms/core/client';
3
+
4
+ export type Row = Record<string, unknown>;
5
+
6
+ export function newId(): string {
7
+ return globalThis.crypto.randomUUID();
8
+ }
9
+
10
+ /** The empty value for a field in a new row. Containers initialise themselves, so they get an empty shell. */
11
+ export function emptyValue(field: ClientField): unknown {
12
+ switch (field.type) {
13
+ case 'checkbox':
14
+ return false;
15
+ case 'group':
16
+ return {};
17
+ case 'array':
18
+ case 'blocks':
19
+ return [];
20
+ case 'relationship':
21
+ case 'upload':
22
+ return field.hasMany ? [] : null;
23
+ default:
24
+ return null;
25
+ }
26
+ }
27
+
28
+ export function emptyRow(fields: ClientField[], extra: Row = {}): Row {
29
+ const row: Row = { id: newId(), ...extra };
30
+ for (const f of fields) row[f.name] = emptyValue(f);
31
+ return row;
32
+ }
33
+
34
+ /**
35
+ * A deep copy of a row with a fresh id (nested rows keep theirs; ids only need to be unique per
36
+ * container). Pass `$state.snapshot(row)`, a plain object.
37
+ */
38
+ export function cloneRow(snapshot: Row): Row {
39
+ return { ...structuredClone(snapshot), id: newId() };
40
+ }
41
+
42
+ export function moveItem<T>(list: readonly T[], from: number, to: number): T[] {
43
+ if (from === to || from < 0 || to < 0 || from >= list.length || to >= list.length) return [...list];
44
+ const next = [...list];
45
+ const [item] = next.splice(from, 1);
46
+ next.splice(to, 0, item as T);
47
+ return next;
48
+ }
49
+
50
+ /** A short row label from the first text-like field that has a value. */
51
+ export function rowSummary(fields: ClientField[], row: Row): string {
52
+ for (const f of fields) {
53
+ if (f.type === 'text' || f.type === 'textarea' || f.type === 'email' || f.type === 'slug') {
54
+ const v = row[f.name];
55
+ if (typeof v === 'string' && v.trim()) {
56
+ const t = v.trim().replace(/\s+/g, ' ');
57
+ return t.length > 60 ? `${t.slice(0, 57)}...` : t;
58
+ }
59
+ }
60
+ }
61
+ return '';
62
+ }
63
+
64
+ export function idOf(v: unknown): string | null {
65
+ if (typeof v === 'string') return v || null;
66
+ if (v && typeof v === 'object' && 'id' in v && typeof (v as { id: unknown }).id === 'string') {
67
+ return (v as { id: string }).id || null;
68
+ }
69
+ return null;
70
+ }
@@ -0,0 +1,35 @@
1
+ // THE FIELD COMPONENT CONTRACT (plan §7 "Admin architecture").
2
+ //
3
+ // One Svelte 5 component per field type, registered in ./registry.ts. Each receives:
4
+ // field the client field config (`FieldOf<'text', 'client'>` etc.)
5
+ // path the dot path from the document root. It is the input `name` AND the error key:
6
+ // `title`, `seo.metaTitle`, `sections.0.heading`.
7
+ // value the current value, `$bindable()`. The edit view owns the form state (one `$state`
8
+ // object seeded from the document at creation); components read and write it through
9
+ // `bind:value`. Never copy it into local state in an `$effect`.
10
+ // and reads the rest from `getFormContext()` (errors, read-only, mode).
11
+ //
12
+ // Rules (see @kitcms/core/src/admin/form.ts for the server side):
13
+ // - Submit real form inputs named `path`, so the form works without JS. Values are coerced on
14
+ // the server by field type; complex widgets submit a hidden input with the serialized value
15
+ // (JSON for json/richText, one hidden input per id for hasMany).
16
+ // - Checkboxes, hasMany relationships and containers also render the presence marker
17
+ // `<input type="hidden" name={FORM.marker(path)}>`, so "unchecked"/"empty" isn't "absent".
18
+ // - Read-only (`field.admin.readOnly || ctx.readOnly`): render `disabled` inputs. Disabled inputs
19
+ // aren't submitted, so the stored value is kept.
20
+ // - Wrap the input in <FieldShell> (label, required mark, description, error, ids for a11y).
21
+ // The input's `id` is `fieldId(path)`; the error/description are linked via aria-describedby.
22
+ // - Use only the admin CSS variables (`--kc-*`) for styling; never global selectors.
23
+
24
+ import type { ClientField } from '@kitcms/core/client';
25
+
26
+ export interface FieldProps<F extends ClientField = ClientField> {
27
+ field: F;
28
+ path: string;
29
+ value: unknown;
30
+ }
31
+
32
+ /** A DOM id for a field path (paths contain dots, which are valid in ids but awkward in CSS). */
33
+ export function fieldId(path: string): string {
34
+ return `kc-f-${path.replaceAll('.', '-')}`;
35
+ }
@@ -0,0 +1,26 @@
1
+ // The edit form's shared state, provided by the edit view and read by every field component.
2
+ import { getContext, setContext } from 'svelte';
3
+ import type { ClientCollection } from '@kitcms/core/client';
4
+
5
+ export interface FormContext {
6
+ collection: ClientCollection;
7
+ mode: 'create' | 'edit' | 'global';
8
+ /** The whole form is read-only (the user may not update this document). */
9
+ readOnly: boolean;
10
+ /** Error message per dot path (`sections.0.heading`). A `$state` object owned by the edit view. */
11
+ errors: Record<string, string>;
12
+ /** Top-level fields hidden by a server-side `admin.condition` (Decision 19). */
13
+ hidden: ReadonlySet<string>;
14
+ }
15
+
16
+ const KEY = Symbol('kitcms-form');
17
+
18
+ export function setFormContext(ctx: FormContext): FormContext {
19
+ return setContext(KEY, ctx);
20
+ }
21
+
22
+ export function getFormContext(): FormContext {
23
+ const ctx = getContext<FormContext | undefined>(KEY);
24
+ if (!ctx) throw new Error('kitcms: field components must be rendered inside the edit form');
25
+ return ctx;
26
+ }
@@ -0,0 +1,106 @@
1
+ // Cell formatting for the list view.
2
+ import type { ClientCollection, ClientField } from '@kitcms/core/client';
3
+
4
+ const SYSTEM_LABELS: Record<string, string> = {
5
+ id: 'ID',
6
+ createdAt: 'Created',
7
+ updatedAt: 'Updated',
8
+ _status: 'Status',
9
+ };
10
+
11
+ /** Collections/globals with drafts (§13.4). `versions` is absent on hand-built test fixtures. */
12
+ export function hasDrafts(collection: ClientCollection): boolean {
13
+ const v = collection.versions as ClientCollection['versions'] | undefined;
14
+ return v !== undefined && v !== false && v.drafts !== false;
15
+ }
16
+
17
+ /** The autosave interval in ms, or 0 when autosave is off. */
18
+ export function autosaveInterval(collection: ClientCollection): number {
19
+ const v = collection.versions as ClientCollection['versions'] | undefined;
20
+ if (!v || v.drafts === false || v.drafts.autosave === false) return 0;
21
+ return v.drafts.autosave.interval;
22
+ }
23
+
24
+ export function columnLabel(collection: ClientCollection, name: string): string {
25
+ const field = collection.fields.find((f) => f.name === name);
26
+ return field?.label ?? SYSTEM_LABELS[name] ?? name;
27
+ }
28
+
29
+ /** System columns and column-stored fields can be sorted; JSON-ish fields can't. */
30
+ export function isSortable(collection: ClientCollection, name: string): boolean {
31
+ if (name in SYSTEM_LABELS) return true;
32
+ const t = collection.fields.find((f) => f.name === name)?.type;
33
+ return (
34
+ t === 'text' ||
35
+ t === 'textarea' ||
36
+ t === 'email' ||
37
+ t === 'slug' ||
38
+ t === 'number' ||
39
+ t === 'checkbox' ||
40
+ t === 'select' ||
41
+ t === 'date'
42
+ );
43
+ }
44
+
45
+ // Fixed locale and zone so server-rendered and hydrated output match.
46
+ const dateFmt = new Intl.DateTimeFormat('en', { dateStyle: 'medium', timeZone: 'UTC' });
47
+ const dateTimeFmt = new Intl.DateTimeFormat('en', {
48
+ dateStyle: 'medium',
49
+ timeStyle: 'short',
50
+ timeZone: 'UTC',
51
+ });
52
+
53
+ function formatDate(v: unknown, withTime: boolean): string {
54
+ const d = new Date(typeof v === 'number' ? v : String(v));
55
+ if (Number.isNaN(d.getTime())) return String(v);
56
+ return (withTime ? dateTimeFmt : dateFmt).format(d);
57
+ }
58
+
59
+ export function shortId(id: unknown): string {
60
+ const s = String(id);
61
+ return s.length > 8 ? `${s.slice(0, 4)}…${s.slice(-4)}` : s;
62
+ }
63
+
64
+ export function formatCell(collection: ClientCollection, name: string, value: unknown): string {
65
+ if (value === null || value === undefined || value === '') return '—';
66
+ if (name === 'id') return shortId(value);
67
+ if (name === '_status') return value === 'published' ? 'Published' : value === 'changed' ? 'Changed' : 'Draft';
68
+ if (name === 'createdAt' || name === 'updatedAt') return formatDate(value, true);
69
+ const field: ClientField | undefined = collection.fields.find((f) => f.name === name);
70
+ if (!field) return String(value);
71
+ switch (field.type) {
72
+ case 'date':
73
+ return formatDate(value, field.admin.picker === 'dayAndTime');
74
+ case 'checkbox':
75
+ return value ? '✓' : '';
76
+ case 'select':
77
+ return field.options.find((o) => o.value === value)?.label ?? String(value);
78
+ case 'relationship':
79
+ case 'upload':
80
+ return Array.isArray(value) ? value.map(shortId).join(', ') || '—' : shortId(value);
81
+ case 'group':
82
+ case 'array':
83
+ case 'blocks':
84
+ case 'json':
85
+ case 'richText':
86
+ return '—';
87
+ default: {
88
+ const s = String(value);
89
+ return s.length > 80 ? `${s.slice(0, 80)}…` : s;
90
+ }
91
+ }
92
+ }
93
+
94
+ /** `1536` → `1.5 KB`. Binary units, one decimal at most. */
95
+ export function formatBytes(n: number): string {
96
+ if (!Number.isFinite(n) || n < 0) return '0 B';
97
+ const units = ['B', 'KB', 'MB', 'GB', 'TB'];
98
+ let v = n;
99
+ let i = 0;
100
+ while (v >= 1024 && i < units.length - 1) {
101
+ v /= 1024;
102
+ i++;
103
+ }
104
+ const s = i === 0 ? String(Math.round(v)) : String(Math.round(v * 10) / 10);
105
+ return `${s} ${units[i]}`;
106
+ }
@@ -0,0 +1,20 @@
1
+ export { default as Admin } from './Admin.svelte';
2
+ export { default as FieldShell } from './fields/FieldShell.svelte';
3
+ export { fieldId } from './fields/types';
4
+ export type { FieldProps } from './fields/types';
5
+ export { getFormContext } from './form/context';
6
+ export type { FormContext } from './form/context';
7
+ export { default as FileUpload } from './upload/FileUpload.svelte';
8
+ export { default as MediaPicker } from './media/MediaPicker.svelte';
9
+ export { defineAdmin } from './preview/types';
10
+ export type {
11
+ AdminClientConfig,
12
+ AdminPreviews,
13
+ BlockPreviewProps,
14
+ DocPreviewProps,
15
+ LazyComponent,
16
+ PreviewDoc,
17
+ } from './preview/types';
18
+ export { useRelation } from './preview/useRelation.svelte';
19
+ export type { RelationState } from './preview/useRelation.svelte';
20
+ export type { PickerDoc } from './fields/relation/api';
@@ -0,0 +1,32 @@
1
+ // Admin URL helpers. The generated route file always lives at this route id; resolve() applies `paths.base`.
2
+ import { resolve } from '$app/paths';
3
+
4
+ const ADMIN = '/(kitcms)/admin/[...path]';
5
+
6
+ /** `path` is relative to the admin root: '', `collections/posts`, `collections/posts/create`. */
7
+ export function adminHref(path = '', query?: Record<string, string | number | undefined>): string {
8
+ const base = resolve(ADMIN, { path });
9
+ if (!query) return base;
10
+ const params = new URLSearchParams();
11
+ for (const [k, v] of Object.entries(query)) {
12
+ if (v !== undefined && v !== '') params.set(k, String(v));
13
+ }
14
+ const qs = params.toString();
15
+ return qs ? `${base}?${qs}` : base;
16
+ }
17
+
18
+ export const collectionHref = (slug: string, query?: Record<string, string | number | undefined>) =>
19
+ adminHref(`collections/${slug}`, query);
20
+ export const docHref = (slug: string, id: string) => adminHref(`collections/${slug}/${id}`);
21
+ export const createHref = (slug: string) => adminHref(`collections/${slug}/create`);
22
+ export const globalHref = (slug: string) => adminHref(`globals/${slug}`);
23
+ export const versionsHref = (slug: string, id: string) => adminHref(`collections/${slug}/${id}/versions`);
24
+ export const globalVersionsHref = (slug: string) => adminHref(`globals/${slug}/versions`);
25
+
26
+ const GLOBAL_PREFIX = '_global_';
27
+ /** Where a document of `collection` is edited. `_global_<slug>` (refs from a global) links to the global. */
28
+ export const refHref = (collection: string, id: string) =>
29
+ collection.startsWith(GLOBAL_PREFIX) ? globalHref(collection.slice(GLOBAL_PREFIX.length)) : docHref(collection, id);
30
+
31
+ /** A plugin's read-only admin panel (Decision 33). */
32
+ export const panelHref = (plugin: string, panel: string) => adminHref(`plugins/${plugin}/${panel}`);