@riducms/admin 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Haniel Ubogu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,31 @@
+# `@riducms/admin`
+
+The framework-owned Svelte 5 authoring application embedded by Ridu servers. Generated projects
+provide a thin entry that mounts this package with their exact generated SDK client and statically
+registered plugin/language imports; applications do not fork or regenerate the admin source.
+
+```ts
+import { mountAdmin } from "@riducms/admin";
+import { createClient, type RiduConfig } from "../generated/ridu.generated";
+import { adminPlugins } from "./plugins";
+
+const target = document.getElementById("app");
+if (!target) throw new Error("Ridu admin requires #app.");
+
+mountAdmin<RiduConfig>({
+	target,
+	clientFactory: () => createClient({ baseURL: window.location.origin }),
+	plugins: adminPlugins,
+});
+```
+
+Use the generated project entry unless you are building a custom Ridu admin host. Keep
+`@riducms/admin`, `@riducms/sdk`, `@riducms/plugin`, `@riducms/ui`, and paired plugin packages on the
+same Ridu release. Production uses the built static assets embedded in the Go binary; this package
+does not introduce a JavaScript server runtime.
+
+Start with [The Ridu admin](../website/src/content/docs/admin.md), then use the focused author task
+guides for [browsing](../website/src/content/docs/browsing-content.md),
+[editing](../website/src/content/docs/editing-documents.md),
+[bulk/trash actions](../website/src/content/docs/bulk-and-trash.md), and
+[document locks](../website/src/content/docs/document-locks.md).

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,217 @@
+# Third-party notices
+
+The Ridu admin embeds the following third-party software and generated assets in its production
+build. Exact package versions are listed so dependency updates cannot silently reuse stale notices.
+
+## dnd-kit
+
+- Package: `@dnd-kit/abstract 0.2.4`
+- Package: `@dnd-kit/collision 0.2.4`
+- Package: `@dnd-kit/dom 0.2.4`
+- Package: `@dnd-kit/geometry 0.2.4`
+- Package: `@dnd-kit/state 0.2.4`
+- Copyright: Copyright (c) 2021, Claudéric Demers
+- License: MIT
+
+MIT License
+
+Copyright (c) 2021, Claudéric Demers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+## dnd-kit-svelte
+
+- Package: `@dnd-kit-svelte/svelte 0.1.6`
+- Copyright: Copyright (c) 2025 Haniel Ubogu
+- License: MIT
+- Upstream notice: this package contains modified portions of dnd-kit and retains the dnd-kit
+  attribution above.
+
+MIT License
+
+Copyright (c) 2025 Haniel Ubogu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+## Lucide icons
+
+- Package: `Lucide icons 2.2.509`
+- Source snapshot: `@iconify/json 2.2.509`
+- Copyright: Copyright (c) 2026 Lucide Icons and Contributors
+- License: ISC, with Feather-derived icons under MIT
+
+ISC License
+
+Copyright (c) 2026 Lucide Icons and Contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+Some Lucide icons are derived from the Feather project and remain under the MIT License:
+
+Copyright (c) 2013-present Cole Bemis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+## Geist
+
+- Package: `@fontsource-variable/geist 5.3.0`
+- Copyright: 2024 The Geist Project Authors (<https://github.com/vercel/geist-font>)
+- Upstream attribution: Geist-Italic[wght].ttf, Copyright 2024 The Geist Project Authors
+- License: SIL Open Font License 1.1
+
+## Spline Sans Mono
+
+- Package: `@fontsource-variable/spline-sans-mono 5.3.0`
+- Copyright: 2022 The Spline Sans Mono Project Authors (<https://github.com/SorkinType/SplineSansMono>)
+- Upstream attribution: SplineSansMono-Italic[wght].ttf, Copyright 2022 The Spline Sans Mono Project Authors
+- License: SIL Open Font License 1.1
+
+## SIL Open Font License 1.1
+
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+
+PREAMBLE
+
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/package.json

@@ -0,0 +1,62 @@
+{
+	"bugs": {
+		"url": "https://github.com/riducms/ridu/issues"
+	},
+	"dependencies": {
+		"@dnd-kit-svelte/svelte": "^0.1.6",
+		"@fontsource-variable/geist": "^5.3.0",
+		"@fontsource-variable/spline-sans-mono": "^5.3.0",
+		"@hvniel/svelte-router": "^0.0.6",
+		"@iconify/json": "^2.2.509",
+		"@internationalized/date": "^3.12.3",
+		"@riducms/plugin": "0.1.0",
+		"@riducms/protocol": "0.1.0",
+		"@riducms/sdk": "0.1.0",
+		"@riducms/translations": "0.1.0",
+		"@riducms/ui": "0.1.0",
+		"@types/prismjs": "^1.26.5",
+		"bits-ui": "^2.18.1",
+		"prismjs": "^1.30.0",
+		"svelte-sonner": "^1.1.1"
+	},
+	"description": "Framework-owned Svelte 5 authoring application embedded by Ridu servers.",
+	"devDependencies": {
+		"@hvniel/lexical-svelte": "^0.1.1",
+		"@riducms/build": "0.1.0",
+		"svelte": "^5.56.8"
+	},
+	"exports": {
+		".": "./src/index.ts"
+	},
+	"files": [
+		"src",
+		"!src/tsconfig.json",
+		"LICENSE",
+		"THIRD_PARTY_NOTICES.md"
+	],
+	"homepage": "https://riducms.com",
+	"license": "MIT",
+	"name": "@riducms/admin",
+	"peerDependencies": {
+		"svelte": "^5.56.8"
+	},
+	"publishConfig": {
+		"access": "public",
+		"provenance": true
+	},
+	"repository": {
+		"directory": "admin",
+		"type": "git",
+		"url": "git+https://github.com/riducms/ridu.git"
+	},
+	"scripts": {
+		"build": "vite build",
+		"check": "svelte-check --tsconfig ./tsconfig.app.json && tsc -p tsconfig.test.json",
+		"dev": "vite",
+		"lint": "tsc -p tsconfig.node.json && bun ../scripts/check-admin-ui-policy.ts",
+		"preview": "vite preview",
+		"test": "bun test"
+	},
+	"type": "module",
+	"version": "0.1.0"
+}

package/src/app/admin-core-view-route.svelte

@@ -0,0 +1,89 @@
+<script lang="ts">
+	import { useLocation, useParams } from "@hvniel/svelte-router";
+	import type { AdminCoreView, AdminCoreViewHost, AdminCoreViewSurface } from "@riducms/plugin";
+	import { untrack, type Component } from "svelte";
+
+	import { getNotificationCenter } from "@admin/core/notifications/notification-center.svelte";
+	import { documentIDFromAdminPath } from "@admin/core/routing/admin-paths";
+	import { getAdminRuntime } from "@admin/core/runtime/admin-runtime.svelte";
+
+	interface Props {
+		surface: AdminCoreViewSurface;
+		DefaultView: Component;
+	}
+
+	let { surface, DefaultView }: Props = $props();
+	const runtime = getAdminRuntime();
+	const notifications = getNotificationCenter();
+	const params = $derived(useParams<"collection" | "document" | "global" | "view">());
+	const location = $derived(useLocation());
+	let documentID = $state(
+		untrack(() =>
+			params.document === undefined ? undefined : documentIDFromAdminPath(location.pathname)
+		)
+	);
+	$effect(() => {
+		if (params.document === undefined) {
+			documentID = undefined;
+			return;
+		}
+		const decoded = documentIDFromAdminPath(location.pathname);
+		if (decoded !== undefined) documentID = decoded;
+	});
+	const collection = $derived(
+		runtime.manifest?.collections.find((candidate) => candidate.slug === params.collection)
+	);
+	const global = $derived(
+		runtime.manifest?.globals?.find((candidate) => candidate.slug === params.global)
+	);
+	const replacement = $derived(
+		resolveCoreView(runtime.coreViews, surface, params.collection, params.global)
+	);
+	const host: AdminCoreViewHost = {
+		refreshManifest: () => runtime.refreshManifest(),
+		documentsChanged: () => runtime.documentsChanged(),
+		notify: (tone, title, message) => notifications[tone]({ title, message }),
+	};
+
+	function resolveCoreView(
+		views: readonly AdminCoreView[],
+		viewSurface: AdminCoreViewSurface,
+		collectionSlug: string | undefined,
+		globalSlug: string | undefined
+	) {
+		const candidates = views.filter((view) => view.surface === viewSurface);
+		if (viewSurface === "global") {
+			return (
+				candidates.find((view) => "global" in view && view.global === globalSlug) ??
+				candidates.find((view) => "global" in view && view.global === undefined)
+			);
+		}
+		if (viewSurface !== "notFound") {
+			return (
+				candidates.find((view) => "collection" in view && view.collection === collectionSlug) ??
+				candidates.find((view) => "collection" in view && view.collection === undefined)
+			);
+		}
+		return candidates[0];
+	}
+</script>
+
+{#snippet defaultView()}
+	<DefaultView />
+{/snippet}
+
+{#if runtime.manifest !== undefined && replacement !== undefined}
+	<replacement.component
+		manifest={runtime.manifest}
+		user={runtime.session?.user}
+		{surface}
+		{collection}
+		{global}
+		{documentID}
+		{defaultView}
+		{host}
+		i18n={runtime.i18n}
+	/>
+{:else}
+	{@render defaultView()}
+{/if}