@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.
- package/LICENSE +21 -0
- package/README.md +69 -2
- package/package.json +47 -3
- package/src/index.ts +1 -0
- package/src/lib/Admin.svelte +345 -0
- package/src/lib/fields/ArrayField.svelte +134 -0
- package/src/lib/fields/BlocksField.svelte +201 -0
- package/src/lib/fields/CheckboxField.svelte +48 -0
- package/src/lib/fields/DateField.svelte +70 -0
- package/src/lib/fields/EmailField.svelte +39 -0
- package/src/lib/fields/FieldShell.svelte +70 -0
- package/src/lib/fields/GroupField.svelte +40 -0
- package/src/lib/fields/JsonField.svelte +74 -0
- package/src/lib/fields/NumberField.svelte +51 -0
- package/src/lib/fields/RelationshipField.svelte +11 -0
- package/src/lib/fields/RenderFields.svelte +32 -0
- package/src/lib/fields/RenderNodes.svelte +147 -0
- package/src/lib/fields/RichTextField.svelte +310 -0
- package/src/lib/fields/RowCard.svelte +229 -0
- package/src/lib/fields/SelectField.svelte +43 -0
- package/src/lib/fields/SlugField.svelte +85 -0
- package/src/lib/fields/TextField.svelte +41 -0
- package/src/lib/fields/TextareaField.svelte +40 -0
- package/src/lib/fields/UploadField.svelte +26 -0
- package/src/lib/fields/registry.ts +41 -0
- package/src/lib/fields/relation/RelationField.svelte +256 -0
- package/src/lib/fields/relation/RelationPicker.svelte +246 -0
- package/src/lib/fields/relation/api.ts +66 -0
- package/src/lib/fields/rowDrag.svelte.ts +41 -0
- package/src/lib/fields/rows.ts +70 -0
- package/src/lib/fields/types.ts +35 -0
- package/src/lib/form/context.ts +26 -0
- package/src/lib/format.ts +106 -0
- package/src/lib/index.ts +20 -0
- package/src/lib/links.ts +32 -0
- package/src/lib/media/MediaPicker.svelte +327 -0
- package/src/lib/media/util.ts +36 -0
- package/src/lib/preview/BlocksPreview.svelte +37 -0
- package/src/lib/preview/LazyPreview.svelte +75 -0
- package/src/lib/preview/PreviewPane.svelte +98 -0
- package/src/lib/preview/blocks.ts +39 -0
- package/src/lib/preview/load.ts +21 -0
- package/src/lib/preview/relations.ts +70 -0
- package/src/lib/preview/types.ts +75 -0
- package/src/lib/preview/useRelation.svelte.ts +58 -0
- package/src/lib/theme.css +193 -0
- package/src/lib/upload/FileUpload.svelte +216 -0
- package/src/lib/views/Dashboard.svelte +64 -0
- package/src/lib/views/Edit.svelte +557 -0
- package/src/lib/views/FirstUser.svelte +63 -0
- package/src/lib/views/List.svelte +557 -0
- package/src/lib/views/Login.svelte +58 -0
- package/src/lib/views/Panel.svelte +175 -0
- package/src/lib/views/Versions.svelte +144 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 kitcms contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,70 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @kitcms/ui
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
The kitcms admin: the shell, dashboard, list and edit views, the field components, the block editor, the upload field and the media library. It is Svelte 5 and is rendered by a route file that `kitcms` generates into your app, so there is nothing to build by hand. The admin logic (`load` and form `actions`) lives in `@kitcms/core/sveltekit/admin`.
|
|
4
|
+
|
|
5
|
+
```sh
|
|
6
|
+
pnpm add @kitcms/ui
|
|
7
|
+
```
|
|
8
|
+
|
|
9
|
+
`@kitcms/ui` peer-depends on `@kitcms/core`, `@sveltejs/kit` (v3) and `svelte` (v5).
|
|
10
|
+
|
|
11
|
+
## Usage
|
|
12
|
+
|
|
13
|
+
The admin route in an app is generated, and should not be edited. `templates/blank/src/routes/(kitcms)/admin/[...path]/+page.svelte`:
|
|
14
|
+
|
|
15
|
+
```svelte
|
|
16
|
+
<!-- GENERATED by kitcms. Do not edit: the admin lives in @kitcms/ui. -->
|
|
17
|
+
<script lang="ts">
|
|
18
|
+
import { Admin } from '@kitcms/ui';
|
|
19
|
+
|
|
20
|
+
let { data, form } = $props();
|
|
21
|
+
</script>
|
|
22
|
+
|
|
23
|
+
<Admin {data} {form} admin={adminConfig} />
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
(with `import adminConfig from '../../../../kitcms.admin';` in the script block). The matching `+page.server.ts` re-exports the server side:
|
|
27
|
+
|
|
28
|
+
```ts
|
|
29
|
+
// GENERATED by kitcms. Do not edit: the admin lives in @kitcms/core and @kitcms/ui.
|
|
30
|
+
export { load, actions } from '@kitcms/core/sveltekit/admin';
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## Live preview
|
|
34
|
+
|
|
35
|
+
Previews are browser code, so they are registered in a client-safe `src/kitcms.admin.ts` (not in `kitcms.config.ts`) and loaded lazily:
|
|
36
|
+
|
|
37
|
+
```ts
|
|
38
|
+
// src/kitcms.admin.ts
|
|
39
|
+
import { defineAdmin } from '@kitcms/ui';
|
|
40
|
+
|
|
41
|
+
export default defineAdmin({
|
|
42
|
+
previews: {
|
|
43
|
+
collections: { pages: () => import('#lib/previews/Page.svelte') }, // props: { doc }
|
|
44
|
+
globals: { site: () => import('#lib/previews/Site.svelte') }, // props: { doc }
|
|
45
|
+
blocks: { hero: () => import('#lib/blocks/Hero.svelte') }, // props: { block, doc }
|
|
46
|
+
},
|
|
47
|
+
});
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
- The edit view shows a pane beside the form (stacked on narrow screens) with Hide/Show and Desktop/Mobile (390px) toggles. A collection/global preview takes over the pane; otherwise, if any `blocks` value has a registered block preview, the blocks render in document order (blocks without a preview show a labelled placeholder).
|
|
51
|
+
- `doc` and `block` are the **live form state** (a `$state` object, updated on every keystroke). They are **read-only by contract**: never write to them.
|
|
52
|
+
- Upload/relationship values are ids. Resolve them with `useRelation('media', () => block.image)`, which returns `{ current, loading }` (a `PickerDoc` with `title`, and for uploads `url`, `width`, `height`). Lookups are batched and cached.
|
|
53
|
+
- Previews render inside `.kitcms-preview`, which resets the admin typography and colours (`all: initial`, on a light canvas) so only your component styles apply. Import site CSS from the preview components, scoped (Svelte component styles are).
|
|
54
|
+
- Nothing runs on the server: the pane renders a "Loading preview…" placeholder and loads components in the browser. A load or render error shows inline and never breaks the form.
|
|
55
|
+
|
|
56
|
+
## Exports
|
|
57
|
+
|
|
58
|
+
From `packages/ui/src/lib/index.ts`:
|
|
59
|
+
|
|
60
|
+
- `Admin`: the admin app component. The generated route renders it.
|
|
61
|
+
- `FieldShell`: the wrapper that field components render inside.
|
|
62
|
+
- `fieldId`: builds the DOM id for a field.
|
|
63
|
+
- `FieldProps` (type): the props every field component receives.
|
|
64
|
+
- `getFormContext`: reads the form context inside a field component.
|
|
65
|
+
- `FormContext` (type): the shape of that form context.
|
|
66
|
+
- `FileUpload`: the upload control.
|
|
67
|
+
- `MediaPicker`: the media library picker used by the upload and relationship fields.
|
|
68
|
+
- `defineAdmin`, `useRelation` and the preview types (`AdminClientConfig`, `DocPreviewProps`, `BlockPreviewProps`, `LazyComponent`, `PickerDoc`): live preview (above).
|
|
69
|
+
|
|
70
|
+
Status: pre-release (0.x), Cloudflare Workers + D1 + R2 only.
|
package/package.json
CHANGED
|
@@ -1,6 +1,50 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@kitcms/ui",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
3
|
+
"version": "0.1.1",
|
|
4
|
+
"license": "MIT",
|
|
5
|
+
"repository": {
|
|
6
|
+
"type": "git",
|
|
7
|
+
"url": "git+https://github.com/Norden-Tenzin/kitcms.git",
|
|
8
|
+
"directory": "packages/ui"
|
|
9
|
+
},
|
|
10
|
+
"homepage": "https://kitcms.dev",
|
|
11
|
+
"bugs": {
|
|
12
|
+
"url": "https://github.com/Norden-Tenzin/kitcms/issues"
|
|
13
|
+
},
|
|
14
|
+
"type": "module",
|
|
15
|
+
"sideEffects": false,
|
|
16
|
+
"exports": {
|
|
17
|
+
".": {
|
|
18
|
+
"svelte": "./src/lib/index.ts",
|
|
19
|
+
"types": "./src/lib/index.ts",
|
|
20
|
+
"default": "./src/lib/index.ts"
|
|
21
|
+
}
|
|
22
|
+
},
|
|
23
|
+
"files": [
|
|
24
|
+
"src",
|
|
25
|
+
"!src/**/*.test.ts"
|
|
26
|
+
],
|
|
27
|
+
"peerDependencies": {
|
|
28
|
+
"@kitcms/core": "^0.1.1",
|
|
29
|
+
"@sveltejs/kit": "^3",
|
|
30
|
+
"svelte": "^5"
|
|
31
|
+
},
|
|
32
|
+
"devDependencies": {
|
|
33
|
+
"@kitcms/core": "0.1.1",
|
|
34
|
+
"@sveltejs/kit": "^3.2.0",
|
|
35
|
+
"@sveltejs/package": "^3.0.2",
|
|
36
|
+
"@sveltejs/vite-plugin-svelte": "^7.3.1",
|
|
37
|
+
"svelte": "^5.57.3",
|
|
38
|
+
"svelte-check": "^4.7.8"
|
|
39
|
+
},
|
|
40
|
+
"dependencies": {
|
|
41
|
+
"@tiptap/core": "^3.34.0",
|
|
42
|
+
"@tiptap/extension-link": "^3.34.0",
|
|
43
|
+
"@tiptap/pm": "^3.34.0",
|
|
44
|
+
"@tiptap/starter-kit": "^3.34.0"
|
|
45
|
+
},
|
|
46
|
+
"scripts": {
|
|
47
|
+
"typecheck": "svelte-check --tsconfig ./tsconfig.json",
|
|
48
|
+
"test": "vitest run"
|
|
49
|
+
}
|
|
6
50
|
}
|
package/src/index.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export const VERSION = '0.0.0';
|
|
@@ -0,0 +1,345 @@
|
|
|
1
|
+
<script lang="ts">
|
|
2
|
+
// The admin root. Defines the theme scope (`.kitcms-admin`) and switches on the route view.
|
|
3
|
+
import './theme.css';
|
|
4
|
+
import { enhance } from '$app/forms';
|
|
5
|
+
import type { AdminActionData, AdminData, AdminDataOf } from '@kitcms/core/client';
|
|
6
|
+
import { adminHref, collectionHref, globalHref, panelHref } from './links';
|
|
7
|
+
import Login from './views/Login.svelte';
|
|
8
|
+
import FirstUser from './views/FirstUser.svelte';
|
|
9
|
+
import Dashboard from './views/Dashboard.svelte';
|
|
10
|
+
import List from './views/List.svelte';
|
|
11
|
+
import type { AdminClientConfig } from './preview/types';
|
|
12
|
+
import Edit from './views/Edit.svelte';
|
|
13
|
+
import Versions from './views/Versions.svelte';
|
|
14
|
+
import Panel from './views/Panel.svelte';
|
|
15
|
+
|
|
16
|
+
let {
|
|
17
|
+
data,
|
|
18
|
+
form,
|
|
19
|
+
admin,
|
|
20
|
+
}: { data: AdminData; form?: AdminActionData | null; admin?: AdminClientConfig } = $props();
|
|
21
|
+
|
|
22
|
+
type Signed = Exclude<AdminData, { route: { view: 'login' | 'create-first-user' } }>;
|
|
23
|
+
// TypeScript doesn't narrow `data` from `data.route.view`, so views get a typed accessor.
|
|
24
|
+
const as = <V extends AdminData['route']['view']>(v: V) =>
|
|
25
|
+
data.route.view === v ? (data as AdminDataOf<V>) : null;
|
|
26
|
+
const dashboard = $derived(as('dashboard'));
|
|
27
|
+
const list = $derived(as('list'));
|
|
28
|
+
const editing = $derived(as('create') ?? as('edit') ?? as('global'));
|
|
29
|
+
const versions = $derived(as('versions'));
|
|
30
|
+
const panel = $derived(as('panel'));
|
|
31
|
+
const signed = $derived(
|
|
32
|
+
data.route.view === 'login' || data.route.view === 'create-first-user'
|
|
33
|
+
? null
|
|
34
|
+
: (data as Signed),
|
|
35
|
+
);
|
|
36
|
+
|
|
37
|
+
let navOpen = $state(false);
|
|
38
|
+
let menuBtn = $state<HTMLButtonElement>();
|
|
39
|
+
let navEl = $state<HTMLElement>();
|
|
40
|
+
|
|
41
|
+
// Mobile drawer: focus moves into it when it opens, Escape (or leaving it) closes it and
|
|
42
|
+
// returns focus to the menu button.
|
|
43
|
+
function closeNav(restoreFocus = false) {
|
|
44
|
+
if (!navOpen) return;
|
|
45
|
+
navOpen = false;
|
|
46
|
+
if (restoreFocus) menuBtn?.focus();
|
|
47
|
+
}
|
|
48
|
+
function toggleNav() {
|
|
49
|
+
navOpen = !navOpen;
|
|
50
|
+
if (navOpen) {
|
|
51
|
+
// After the nav is displayed.
|
|
52
|
+
queueMicrotask(() => {
|
|
53
|
+
const first = navEl?.querySelector<HTMLElement>('a[aria-current="page"], a');
|
|
54
|
+
if (navEl && navEl.offsetParent !== null) first?.focus();
|
|
55
|
+
});
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
function onNavFocusOut(e: FocusEvent) {
|
|
59
|
+
const to = e.relatedTarget as Node | null;
|
|
60
|
+
if (to && !navEl?.contains(to) && to !== menuBtn) navOpen = false;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
// Nav grouped by `group`; ungrouped collections first.
|
|
64
|
+
const groups = $derived.by(() => {
|
|
65
|
+
if (!signed) return [];
|
|
66
|
+
const by: Record<string, Signed['nav']> = {};
|
|
67
|
+
for (const item of signed.nav) (by[item.group ?? ''] ??= []).push(item);
|
|
68
|
+
return Object.entries(by).sort(([a], [b]) => (a === '' ? -1 : b === '' ? 1 : a.localeCompare(b)));
|
|
69
|
+
});
|
|
70
|
+
// Plugin panels: grouped by `group` (own section), ungrouped ones under "Plugins".
|
|
71
|
+
const panelGroups = $derived.by(() => {
|
|
72
|
+
if (!signed) return [];
|
|
73
|
+
const by: Record<string, Signed['panels']> = {};
|
|
74
|
+
for (const p of signed.panels ?? []) (by[p.group || 'Plugins'] ??= []).push(p);
|
|
75
|
+
return Object.entries(by);
|
|
76
|
+
});
|
|
77
|
+
const activePanel = $derived(
|
|
78
|
+
data.route.view === 'panel' ? `${data.route.plugin}/${data.route.panel}` : undefined,
|
|
79
|
+
);
|
|
80
|
+
const activeSlug = $derived('collection' in data.route ? data.route.collection : undefined);
|
|
81
|
+
const activeGlobal = $derived('global' in data.route ? data.route.global : undefined);
|
|
82
|
+
// Edit views are also re-keyed on `updatedAt`, so the form re-seeds from the saved document
|
|
83
|
+
// (server-derived values such as generated slugs show up after a save).
|
|
84
|
+
const viewKey = $derived(
|
|
85
|
+
data.route.view +
|
|
86
|
+
('id' in data.route ? data.route.id : '') +
|
|
87
|
+
('global' in data.route ? data.route.global : '') +
|
|
88
|
+
((data.route.view === 'edit' || data.route.view === 'global') && 'doc' in data
|
|
89
|
+
? String(data.doc.updatedAt ?? '')
|
|
90
|
+
: ''),
|
|
91
|
+
);
|
|
92
|
+
</script>
|
|
93
|
+
|
|
94
|
+
<!-- eslint-disable svelte/no-navigation-without-resolve -- every href comes from ../links, which calls resolve() -->
|
|
95
|
+
|
|
96
|
+
<svelte:head><title>{data.title}</title></svelte:head>
|
|
97
|
+
|
|
98
|
+
<svelte:window
|
|
99
|
+
onkeydown={(e) => {
|
|
100
|
+
if (e.key === 'Escape' && navOpen) {
|
|
101
|
+
e.preventDefault();
|
|
102
|
+
closeNav(true);
|
|
103
|
+
}
|
|
104
|
+
}}
|
|
105
|
+
/>
|
|
106
|
+
|
|
107
|
+
<div
|
|
108
|
+
class="kitcms-admin"
|
|
109
|
+
style:--kc-accent={data.branding.colors.accent}
|
|
110
|
+
style:--kc-accent-text={data.branding.colors.accentText}
|
|
111
|
+
>
|
|
112
|
+
{#if data.route.view === 'login'}
|
|
113
|
+
<Login title={data.title} logo={data.branding.logo} message={form?.message} />
|
|
114
|
+
{:else if data.route.view === 'create-first-user'}
|
|
115
|
+
<FirstUser title={data.title} logo={data.branding.logo} message={form?.message} />
|
|
116
|
+
{:else if signed}
|
|
117
|
+
<div class="shell">
|
|
118
|
+
<header class="top">
|
|
119
|
+
<button
|
|
120
|
+
class="kc-btn kc-btn--ghost menu"
|
|
121
|
+
aria-expanded={navOpen}
|
|
122
|
+
aria-controls="kc-nav"
|
|
123
|
+
bind:this={menuBtn}
|
|
124
|
+
onclick={toggleNav}>Menu</button
|
|
125
|
+
>
|
|
126
|
+
<a class="brand" href={adminHref('')}>
|
|
127
|
+
{#if data.branding.logo}<img class="logo" src={data.branding.logo} alt={data.title} />{/if}
|
|
128
|
+
{data.title}
|
|
129
|
+
</a>
|
|
130
|
+
<span class="spacer"></span>
|
|
131
|
+
<span class="who" data-testid="whoami">{signed.user.email}</span>
|
|
132
|
+
<form method="POST" action="?/logout" use:enhance>
|
|
133
|
+
<button class="kc-btn kc-btn--ghost">Log out</button>
|
|
134
|
+
</form>
|
|
135
|
+
</header>
|
|
136
|
+
{#if navOpen}
|
|
137
|
+
<!-- Mobile only (hidden by CSS on desktop): tapping outside the drawer closes it. -->
|
|
138
|
+
<button type="button" class="backdrop" tabindex="-1" aria-label="Dismiss navigation" onclick={() => closeNav(true)}></button>
|
|
139
|
+
{/if}
|
|
140
|
+
<nav
|
|
141
|
+
id="kc-nav"
|
|
142
|
+
class="nav"
|
|
143
|
+
data-open={navOpen}
|
|
144
|
+
aria-label="Main"
|
|
145
|
+
bind:this={navEl}
|
|
146
|
+
onfocusout={onNavFocusOut}
|
|
147
|
+
>
|
|
148
|
+
<a
|
|
149
|
+
href={adminHref('')}
|
|
150
|
+
aria-current={data.route.view === 'dashboard' ? 'page' : undefined}
|
|
151
|
+
onclick={() => closeNav()}>Dashboard</a
|
|
152
|
+
>
|
|
153
|
+
{#each groups as [group, items] (group)}
|
|
154
|
+
{#if group}<span class="group">{group}</span>{/if}
|
|
155
|
+
{#each items as item (item.slug)}
|
|
156
|
+
<a
|
|
157
|
+
href={collectionHref(item.slug)}
|
|
158
|
+
aria-current={item.slug === activeSlug ? 'page' : undefined}
|
|
159
|
+
onclick={() => closeNav()}>{item.label}</a
|
|
160
|
+
>
|
|
161
|
+
{/each}
|
|
162
|
+
{/each}
|
|
163
|
+
{#if signed.globals.length > 0}
|
|
164
|
+
<span class="group">Globals</span>
|
|
165
|
+
{#each signed.globals as item (item.slug)}
|
|
166
|
+
<a
|
|
167
|
+
href={globalHref(item.slug)}
|
|
168
|
+
aria-current={item.slug === activeGlobal ? 'page' : undefined}
|
|
169
|
+
onclick={() => closeNav()}>{item.label}</a
|
|
170
|
+
>
|
|
171
|
+
{/each}
|
|
172
|
+
{/if}
|
|
173
|
+
{#each panelGroups as [group, items] (group)}
|
|
174
|
+
<span class="group">{group}</span>
|
|
175
|
+
{#each items as item (item.plugin + '/' + item.id)}
|
|
176
|
+
<a
|
|
177
|
+
href={panelHref(item.plugin, item.id)}
|
|
178
|
+
aria-current={`${item.plugin}/${item.id}` === activePanel ? 'page' : undefined}
|
|
179
|
+
onclick={() => closeNav()}>{item.label}</a
|
|
180
|
+
>
|
|
181
|
+
{/each}
|
|
182
|
+
{/each}
|
|
183
|
+
</nav>
|
|
184
|
+
<main class="content">
|
|
185
|
+
{#if dashboard}
|
|
186
|
+
<Dashboard data={dashboard} />
|
|
187
|
+
{:else if list}
|
|
188
|
+
{#key viewKey}<List data={list} />{/key}
|
|
189
|
+
{:else if editing}
|
|
190
|
+
{#key viewKey}<Edit data={editing} {form} {admin} />{/key}
|
|
191
|
+
{:else if versions}
|
|
192
|
+
<Versions data={versions} {form} />
|
|
193
|
+
{:else if panel}
|
|
194
|
+
<Panel data={panel} />
|
|
195
|
+
{/if}
|
|
196
|
+
</main>
|
|
197
|
+
</div>
|
|
198
|
+
{/if}
|
|
199
|
+
</div>
|
|
200
|
+
|
|
201
|
+
<style>
|
|
202
|
+
.shell {
|
|
203
|
+
display: grid;
|
|
204
|
+
grid-template-columns: 14rem minmax(0, 1fr);
|
|
205
|
+
grid-template-rows: auto 1fr;
|
|
206
|
+
grid-template-areas:
|
|
207
|
+
'top top'
|
|
208
|
+
'nav content';
|
|
209
|
+
min-height: 100vh;
|
|
210
|
+
}
|
|
211
|
+
.top {
|
|
212
|
+
grid-area: top;
|
|
213
|
+
display: flex;
|
|
214
|
+
align-items: center;
|
|
215
|
+
gap: 0.75rem;
|
|
216
|
+
padding: 0.5rem 1rem;
|
|
217
|
+
background: var(--kc-surface);
|
|
218
|
+
border-bottom: 1px solid var(--kc-border);
|
|
219
|
+
}
|
|
220
|
+
.brand {
|
|
221
|
+
display: inline-flex;
|
|
222
|
+
align-items: center;
|
|
223
|
+
gap: 0.5rem;
|
|
224
|
+
font-weight: 700;
|
|
225
|
+
color: var(--kc-text);
|
|
226
|
+
text-decoration: none;
|
|
227
|
+
}
|
|
228
|
+
.logo {
|
|
229
|
+
height: 24px;
|
|
230
|
+
width: auto;
|
|
231
|
+
}
|
|
232
|
+
.spacer {
|
|
233
|
+
flex: 1;
|
|
234
|
+
}
|
|
235
|
+
.who {
|
|
236
|
+
color: var(--kc-muted);
|
|
237
|
+
}
|
|
238
|
+
.menu {
|
|
239
|
+
display: none;
|
|
240
|
+
}
|
|
241
|
+
.nav {
|
|
242
|
+
grid-area: nav;
|
|
243
|
+
display: flex;
|
|
244
|
+
flex-direction: column;
|
|
245
|
+
gap: 0.15rem;
|
|
246
|
+
padding: 1rem 0.75rem;
|
|
247
|
+
background: var(--kc-surface);
|
|
248
|
+
border-right: 1px solid var(--kc-border);
|
|
249
|
+
}
|
|
250
|
+
.nav a {
|
|
251
|
+
padding: 0.4rem 0.6rem;
|
|
252
|
+
border-radius: var(--kc-radius);
|
|
253
|
+
color: var(--kc-text);
|
|
254
|
+
text-decoration: none;
|
|
255
|
+
}
|
|
256
|
+
.nav a:hover {
|
|
257
|
+
background: color-mix(in srgb, var(--kc-muted) 15%, transparent);
|
|
258
|
+
}
|
|
259
|
+
.nav a[aria-current='page'] {
|
|
260
|
+
background: var(--kc-accent);
|
|
261
|
+
color: var(--kc-accent-text);
|
|
262
|
+
}
|
|
263
|
+
.group {
|
|
264
|
+
margin-top: 0.75rem;
|
|
265
|
+
padding: 0 0.6rem;
|
|
266
|
+
font-size: 0.75rem;
|
|
267
|
+
text-transform: uppercase;
|
|
268
|
+
letter-spacing: 0.04em;
|
|
269
|
+
color: var(--kc-muted);
|
|
270
|
+
}
|
|
271
|
+
.content {
|
|
272
|
+
grid-area: content;
|
|
273
|
+
padding: 1.25rem;
|
|
274
|
+
min-width: 0;
|
|
275
|
+
}
|
|
276
|
+
.backdrop {
|
|
277
|
+
display: none;
|
|
278
|
+
}
|
|
279
|
+
@media (max-width: 800px) {
|
|
280
|
+
.backdrop {
|
|
281
|
+
display: block;
|
|
282
|
+
}
|
|
283
|
+
.shell {
|
|
284
|
+
grid-template-columns: minmax(0, 1fr);
|
|
285
|
+
grid-template-areas:
|
|
286
|
+
'top'
|
|
287
|
+
'content';
|
|
288
|
+
grid-template-rows: auto 1fr;
|
|
289
|
+
}
|
|
290
|
+
.top {
|
|
291
|
+
position: sticky;
|
|
292
|
+
top: 0;
|
|
293
|
+
z-index: 50;
|
|
294
|
+
min-height: 3.5rem;
|
|
295
|
+
padding-inline: 0.5rem;
|
|
296
|
+
}
|
|
297
|
+
.menu {
|
|
298
|
+
display: inline-flex;
|
|
299
|
+
min-width: 2.75rem;
|
|
300
|
+
min-height: 2.75rem;
|
|
301
|
+
}
|
|
302
|
+
.brand {
|
|
303
|
+
min-width: 0;
|
|
304
|
+
overflow: hidden;
|
|
305
|
+
text-overflow: ellipsis;
|
|
306
|
+
white-space: nowrap;
|
|
307
|
+
}
|
|
308
|
+
.who {
|
|
309
|
+
display: none;
|
|
310
|
+
}
|
|
311
|
+
/* The nav becomes a drawer under the header. */
|
|
312
|
+
.nav {
|
|
313
|
+
position: fixed;
|
|
314
|
+
z-index: 45;
|
|
315
|
+
top: 3.5rem;
|
|
316
|
+
bottom: 0;
|
|
317
|
+
left: 0;
|
|
318
|
+
width: min(18rem, 85vw);
|
|
319
|
+
overflow-y: auto;
|
|
320
|
+
overscroll-behavior: contain;
|
|
321
|
+
border-right: 1px solid var(--kc-border);
|
|
322
|
+
box-shadow: 0 8px 24px rgb(0 0 0 / 0.2);
|
|
323
|
+
}
|
|
324
|
+
.nav a {
|
|
325
|
+
display: flex;
|
|
326
|
+
align-items: center;
|
|
327
|
+
min-height: 2.75rem;
|
|
328
|
+
}
|
|
329
|
+
.nav[data-open='false'] {
|
|
330
|
+
display: none;
|
|
331
|
+
}
|
|
332
|
+
.backdrop {
|
|
333
|
+
position: fixed;
|
|
334
|
+
z-index: 44;
|
|
335
|
+
inset: 3.5rem 0 0 0;
|
|
336
|
+
border: 0;
|
|
337
|
+
padding: 0;
|
|
338
|
+
background: rgb(0 0 0 / 0.4);
|
|
339
|
+
cursor: default;
|
|
340
|
+
}
|
|
341
|
+
.content {
|
|
342
|
+
padding: 1rem 0.75rem;
|
|
343
|
+
}
|
|
344
|
+
}
|
|
345
|
+
</style>
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
<script lang="ts">
|
|
2
|
+
// Array: repeatable rows of sub-fields. The server reads rows in DOM order, so rows render in
|
|
3
|
+
// array order and use their CURRENT index in every name; reordering the state re-renders names.
|
|
4
|
+
import { tick } from 'svelte';
|
|
5
|
+
import type { FieldOf } from '@kitcms/core/client';
|
|
6
|
+
import { FORM } from '@kitcms/core/client';
|
|
7
|
+
import { getFormContext } from '../form/context';
|
|
8
|
+
import FieldShell from './FieldShell.svelte';
|
|
9
|
+
import RenderFields from './RenderFields.svelte';
|
|
10
|
+
import RowCard from './RowCard.svelte';
|
|
11
|
+
import { RowDrag } from './rowDrag.svelte';
|
|
12
|
+
import { cloneRow, emptyRow, moveItem, rowSummary, type Row } from './rows';
|
|
13
|
+
import type { FieldProps } from './types';
|
|
14
|
+
|
|
15
|
+
let { field, path, value = $bindable() }: FieldProps<FieldOf<'array', 'client'>> = $props();
|
|
16
|
+
|
|
17
|
+
const ctx = getFormContext();
|
|
18
|
+
const readOnly = $derived(Boolean(field.admin.readOnly) || ctx.readOnly);
|
|
19
|
+
|
|
20
|
+
if (!Array.isArray(value)) value = [];
|
|
21
|
+
const rows = $derived(value as Row[]);
|
|
22
|
+
|
|
23
|
+
const label = $derived(field.labels.singular);
|
|
24
|
+
const full = $derived(field.maxRows !== undefined && rows.length >= field.maxRows);
|
|
25
|
+
const atMin = $derived(field.minRows !== undefined && rows.length <= field.minRows);
|
|
26
|
+
|
|
27
|
+
let collapsed = $state<Record<string, boolean>>({});
|
|
28
|
+
let root: HTMLElement | undefined = $state();
|
|
29
|
+
let addButton: HTMLButtonElement | undefined = $state();
|
|
30
|
+
|
|
31
|
+
const rowKey = (row: Row, i: number) => (typeof row.id === 'string' && row.id ? row.id : `#${i}`);
|
|
32
|
+
const hasError = (i: number) => Object.keys(ctx.errors).some((k) => k.startsWith(`${path}.${i}.`));
|
|
33
|
+
|
|
34
|
+
async function focusRow(id: string) {
|
|
35
|
+
await tick();
|
|
36
|
+
root?.querySelector<HTMLElement>(`[data-row-id="${CSS.escape(id)}"] [data-row-focus]`)?.focus();
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
function add() {
|
|
40
|
+
if (full || readOnly) return;
|
|
41
|
+
const row = emptyRow(field.fields);
|
|
42
|
+
value = [...rows, row];
|
|
43
|
+
void focusRow(row.id as string);
|
|
44
|
+
}
|
|
45
|
+
function move(from: number, to: number) {
|
|
46
|
+
value = moveItem(rows, from, to);
|
|
47
|
+
}
|
|
48
|
+
function duplicate(i: number) {
|
|
49
|
+
if (full) return;
|
|
50
|
+
const copy = cloneRow($state.snapshot(rows[i]!) as Row);
|
|
51
|
+
value = [...rows.slice(0, i + 1), copy, ...rows.slice(i + 1)];
|
|
52
|
+
void focusRow(copy.id as string);
|
|
53
|
+
}
|
|
54
|
+
async function remove(i: number) {
|
|
55
|
+
if (atMin) return;
|
|
56
|
+
value = rows.filter((_, j) => j !== i);
|
|
57
|
+
await tick();
|
|
58
|
+
addButton?.focus();
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
const drag = new RowDrag(move);
|
|
62
|
+
</script>
|
|
63
|
+
|
|
64
|
+
<FieldShell {field} {path} as="fieldset">
|
|
65
|
+
<div class="kc-rows" bind:this={root}>
|
|
66
|
+
<input type="hidden" name={FORM.marker(path)} value="1" disabled={readOnly} />
|
|
67
|
+
{#if field.minRows !== undefined || field.maxRows !== undefined}
|
|
68
|
+
<p class="kc-muted kc-rows__hint">
|
|
69
|
+
{rows.length}
|
|
70
|
+
{rows.length === 1 ? 'row' : 'rows'}{#if field.minRows !== undefined}, min {field.minRows}{/if}{#if field.maxRows !== undefined},
|
|
71
|
+
max {field.maxRows}{/if}
|
|
72
|
+
</p>
|
|
73
|
+
{/if}
|
|
74
|
+
{#each rows as row, i (rowKey(row, i))}
|
|
75
|
+
{@const rowPath = `${path}.${i}`}
|
|
76
|
+
{@const summary = rowSummary(field.fields, row)}
|
|
77
|
+
<RowCard
|
|
78
|
+
index={i}
|
|
79
|
+
rowId={rowKey(row, i)}
|
|
80
|
+
title="{label} {i + 1}"
|
|
81
|
+
subtitle={summary}
|
|
82
|
+
collapsed={collapsed[rowKey(row, i)] === true}
|
|
83
|
+
hasError={hasError(i)}
|
|
84
|
+
{readOnly}
|
|
85
|
+
count={rows.length}
|
|
86
|
+
canDuplicate={!full}
|
|
87
|
+
dragging={drag.from === i}
|
|
88
|
+
dropTarget={drag.over === i && drag.from !== i}
|
|
89
|
+
ontoggle={() => (collapsed[rowKey(row, i)] = !collapsed[rowKey(row, i)])}
|
|
90
|
+
onmove={(d) => move(i, i + d)}
|
|
91
|
+
onduplicate={() => duplicate(i)}
|
|
92
|
+
onremove={() => remove(i)}
|
|
93
|
+
ondragstart={(e) => drag.start(i, e)}
|
|
94
|
+
ondragend={drag.end}
|
|
95
|
+
ondragover={(e) => drag.dragover(i, e)}
|
|
96
|
+
ondrop={(e) => drag.drop(i, e)}
|
|
97
|
+
>
|
|
98
|
+
<input type="hidden" name="{rowPath}.id" value={typeof row.id === 'string' ? row.id : ''} />
|
|
99
|
+
<RenderFields
|
|
100
|
+
fields={field.fields}
|
|
101
|
+
layout={field.layout}
|
|
102
|
+
bind:values={() => rows[i]!, (v) => (rows[i] = v)}
|
|
103
|
+
prefix={rowPath}
|
|
104
|
+
/>
|
|
105
|
+
</RowCard>
|
|
106
|
+
{/each}
|
|
107
|
+
{#if !readOnly}
|
|
108
|
+
<div>
|
|
109
|
+
<button
|
|
110
|
+
type="button"
|
|
111
|
+
class="kc-btn"
|
|
112
|
+
bind:this={addButton}
|
|
113
|
+
disabled={full}
|
|
114
|
+
onclick={add}>Add {label}</button
|
|
115
|
+
>
|
|
116
|
+
</div>
|
|
117
|
+
{/if}
|
|
118
|
+
</div>
|
|
119
|
+
</FieldShell>
|
|
120
|
+
|
|
121
|
+
<style>
|
|
122
|
+
.kc-rows {
|
|
123
|
+
display: grid;
|
|
124
|
+
gap: 0.75rem;
|
|
125
|
+
border: 0;
|
|
126
|
+
padding: 0;
|
|
127
|
+
margin: 0;
|
|
128
|
+
min-width: 0;
|
|
129
|
+
}
|
|
130
|
+
.kc-rows__hint {
|
|
131
|
+
margin: 0;
|
|
132
|
+
font-size: 0.8125rem;
|
|
133
|
+
}
|
|
134
|
+
</style>
|