@vit-foundation/ui 0.21.0 → 0.23.0

package/dist/admin.d.ts

@@ -5,7 +5,6 @@
  * components receive already-filtered data through props, the Nav/Footer
  * genericization pattern.
  */
-export { default as AdminShell } from './components/admin/AdminShell.svelte';
 export { default as DecorMosaic } from './components/admin/DecorMosaic.svelte';
 export { default as PageHeading } from './components/admin/PageHeading.svelte';
 export { default as Sidebar, type SidebarItem } from './components/admin/Sidebar.svelte';

package/dist/admin.js

@@ -5,7 +5,15 @@
  * components receive already-filtered data through props, the Nav/Footer
  * genericization pattern.
  */
-export { default as AdminShell } from './components/admin/AdminShell.svelte';
+/*
+ * `AdminShell` was exported here — a public name behind two doors with zero
+ * readers in either host, no test, and one story. Seven props, five of them
+ * forwarded verbatim to `Sidebar`, and the only implementation it added beyond
+ * the forwarding was `main { margin-left: 4.5rem }`. The one admin host went
+ * the other way: vit-brain imports `Sidebar` directly and composes its own
+ * shell with a different offset, so the rail's width had two answers and the
+ * untested one was nobody's. Deleting it left nothing to reappear.
+ */
 export { default as DecorMosaic } from './components/admin/DecorMosaic.svelte';
 export { default as PageHeading } from './components/admin/PageHeading.svelte';
 export { default as Sidebar } from './components/admin/Sidebar.svelte';

package/dist/components/timeline/TimelineMilestone.svelte

@@ -25,7 +25,7 @@
 <script lang="ts">
 	import { getUiConfig } from '../../config/context.js';
 	import ActionLabel from '../../edit/ActionLabel.svelte';
-	import type { MilestoneCategory, MilestoneData } from '../../content/types.js';
+	import { MILESTONE_CATEGORIES, type MilestoneData } from '../../content/types.js';
 	import EditFrame from '../../edit/chrome/EditFrame.svelte';
 	import EditPanel from '../../edit/chrome/EditPanel.svelte';
 	import Editable from '../../edit/Editable.svelte';
@@ -46,7 +46,7 @@
 
 	const config = getUiConfig();
 
-	const CATEGORIES = Object.keys(MILESTONE_CATEGORY_COLOR) as MilestoneCategory[];
+	// The set's own order, not a colour map's key order and not a cast.
 
 	/**
 	 * The panel rows, zipped from the map's descriptors and this milestone's
@@ -58,7 +58,7 @@
 			edit?.occurredOn && { descriptor: edit.occurredOn, value: milestone.occurredOn },
 			edit?.category && {
 				descriptor: {
-					options: CATEGORIES.map((category) => ({
+					options: MILESTONE_CATEGORIES.map((category) => ({
 						value: category,
 						label: milestoneCategoryLabel(category, config.messages)
 					})),

package/dist/components/timeline/TimelineMilestone.svelte.d.ts

@@ -20,7 +20,7 @@ export interface MilestoneEditMap {
         kind: 'remove';
     }>;
 }
-import type { MilestoneData } from '../../content/types.js';
+import { type MilestoneData } from '../../content/types.js';
 interface Props {
     milestone: MilestoneData;
     /** Marks fields editable where an edit adapter is active. */

package/dist/content/index.d.ts

@@ -1,4 +1,4 @@
 export { renderBody } from './richtext.js';
 export type { RichTextBlock } from './richtext.js';
-export { CONTACT_CATEGORIES, REACTIONS } from './types.js';
-export type { CollaboratorData, CommentData, CommentThreadData, ContactCategory, FieldConstraint, FormFailReason, JobOpeningData, MilestoneCategory, MilestoneData, ProjectCardData, ProjectKind, Reaction, ReactionSummary, ReactionTarget, SortDirection, TeamMemberData, WeeklyCardData } from './types.js';
+export { COMMENT_STATUSES, CONTACT_CATEGORIES, MILESTONE_CATEGORIES, PROJECT_KINDS, REACTIONS } from './types.js';
+export type { CollaboratorData, CommentData, CommentThreadData, CommentStatus, ContactCategory, FieldConstraint, FormFailReason, JobOpeningData, MilestoneCategory, MilestoneData, ProjectCardData, ProjectKind, Reaction, ReactionSummary, ReactionTarget, SortDirection, TeamMemberData, WeeklyCardData } from './types.js';

package/dist/content/index.js

@@ -1,2 +1,2 @@
 export { renderBody } from './richtext.js';
-export { CONTACT_CATEGORIES, REACTIONS } from './types.js';
+export { COMMENT_STATUSES, CONTACT_CATEGORIES, MILESTONE_CATEGORIES, PROJECT_KINDS, REACTIONS } from './types.js';

package/dist/content/types.d.ts

@@ -28,7 +28,9 @@ export interface WeeklyCardData {
     excerpt: string;
     imageUrl: string;
 }
-export type ProjectKind = 'collaboration' | 'passion';
+/** The kinds a project can have, in display order — a host's enum derives from this. */
+export declare const PROJECT_KINDS: readonly ["collaboration", "passion"];
+export type ProjectKind = (typeof PROJECT_KINDS)[number];
 /** A project as its card shows it. */
 export interface ProjectCardData {
     id: number;
@@ -43,7 +45,23 @@ export interface ProjectCardData {
     externalUrl: string | null;
     hasStory: boolean;
 }
-export type MilestoneCategory = 'education' | 'lab' | 'foundation' | 'collaboration' | 'press';
+/**
+ * The timeline's categories, in DISPLAY ORDER — every select that offers them
+ * and every host enum derives from this.
+ *
+ * The order was an emergent property of two unrelated literals before: the
+ * panel select read `Object.keys(MILESTONE_CATEGORY_COLOR)` while vit-brain's
+ * record form spelled its own array, so one CMS offered the same field in two
+ * orders and seeded a new row with the third member of one of them. The order
+ * kept here is the colour map's, which is the one with a reason attached (its
+ * slots are fixed and never reordered).
+ *
+ * A tuple rather than a union for the reason `CONTACT_CATEGORIES` is one: a
+ * `satisfies readonly MilestoneCategory[]` binds the element type and never
+ * the list, so a host could drop a member and still compile.
+ */
+export declare const MILESTONE_CATEGORIES: readonly ["foundation", "lab", "education", "collaboration", "press"];
+export type MilestoneCategory = (typeof MILESTONE_CATEGORIES)[number];
 /** One timeline milestone. */
 export interface MilestoneData {
     id: number;
@@ -108,6 +126,22 @@ export interface CommentData {
     createdAt: string;
     reactions: ReactionSummary[];
 }
+/**
+ * A comment's moderation state, as the database constrains it.
+ *
+ * The set is `comments.status`'s CHECK in fndvit-website and the vocabulary
+ * vit-brain's Comentaris tab moderates through — two repositories that cannot
+ * import each other — and it had no owner in TypeScript at all: the site read
+ * `status = 'published'` as a bare SQL literal in four queries, typed the
+ * field `z.string()`, and never named the other two states anywhere. A test
+ * fixture using `'visible'`, a value the CHECK refuses, passed green.
+ *
+ * `published` is what a reader sees; `hidden` is moderated away; `pending`
+ * awaits review. Which of them a given surface SHOWS is that surface's rule,
+ * not this list's.
+ */
+export declare const COMMENT_STATUSES: readonly ["published", "pending", "hidden"];
+export type CommentStatus = (typeof COMMENT_STATUSES)[number];
 /** A top-level comment with its flat reply list. */
 export interface CommentThreadData extends CommentData {
     replies: CommentData[];

package/dist/content/types.js

@@ -3,7 +3,46 @@
  * applied. The website's zod-inferred types satisfy these structurally; the
  * package states them itself so consumers owe it no schema library.
  */
+/** The kinds a project can have, in display order — a host's enum derives from this. */
+export const PROJECT_KINDS = ['collaboration', 'passion'];
+/**
+ * The timeline's categories, in DISPLAY ORDER — every select that offers them
+ * and every host enum derives from this.
+ *
+ * The order was an emergent property of two unrelated literals before: the
+ * panel select read `Object.keys(MILESTONE_CATEGORY_COLOR)` while vit-brain's
+ * record form spelled its own array, so one CMS offered the same field in two
+ * orders and seeded a new row with the third member of one of them. The order
+ * kept here is the colour map's, which is the one with a reason attached (its
+ * slots are fixed and never reordered).
+ *
+ * A tuple rather than a union for the reason `CONTACT_CATEGORIES` is one: a
+ * `satisfies readonly MilestoneCategory[]` binds the element type and never
+ * the list, so a host could drop a member and still compile.
+ */
+export const MILESTONE_CATEGORIES = [
+    'foundation',
+    'lab',
+    'education',
+    'collaboration',
+    'press'
+];
 /** The reactions a weekly or comment can carry, in display order. */
 export const REACTIONS = ['like', 'love', 'clap'];
+/**
+ * A comment's moderation state, as the database constrains it.
+ *
+ * The set is `comments.status`'s CHECK in fndvit-website and the vocabulary
+ * vit-brain's Comentaris tab moderates through — two repositories that cannot
+ * import each other — and it had no owner in TypeScript at all: the site read
+ * `status = 'published'` as a bare SQL literal in four queries, typed the
+ * field `z.string()`, and never named the other two states anywhere. A test
+ * fixture using `'visible'`, a value the CHECK refuses, passed green.
+ *
+ * `published` is what a reader sees; `hidden` is moderated away; `pending`
+ * awaits review. Which of them a given surface SHOWS is that surface's rule,
+ * not this list's.
+ */
+export const COMMENT_STATUSES = ['published', 'pending', 'hidden'];
 /** The contact form's reasons, in display order — the host schema derives its enum from this. */
 export const CONTACT_CATEGORIES = ['collaborate', 'event', 'press', 'brand', 'other'];

package/dist/content-components.d.ts

@@ -23,7 +23,7 @@ export { createUrlFilters } from './utils/url-filters.svelte.js';
 export type { UrlFilters, UrlFiltersConfig } from './utils/url-filters.svelte.js';
 export { createWeeklyList } from './utils/weekly-list.svelte.js';
 export type { WeeklyList, WeeklyListConfig } from './utils/weekly-list.svelte.js';
-export { WEEKLY_LIST_DEFAULTS } from './utils/weekly-list-contract.js';
+export { WEEKLY_LIST_DEFAULTS, WEEKLY_LIST_PARAMS, parseWeeklyListUrl } from './utils/weekly-list-contract.js';
 export type { WeeklyListFilters, WeeklyListPage, WeeklyListServerData } from './utils/weekly-list-contract.js';
 export { contactCategoryLabel } from './utils/contact.js';
 export { formatDate, yearOf } from './utils/dates.js';

package/dist/content-components.js

@@ -18,6 +18,6 @@ export { createUrlFilters } from './utils/url-filters.svelte.js';
 export { createWeeklyList } from './utils/weekly-list.svelte.js';
 // The list's contract is component-free on purpose, so ./contract carries it
 // too — a host's +page.server.ts reads these without loading the grid.
-export { WEEKLY_LIST_DEFAULTS } from './utils/weekly-list-contract.js';
+export { WEEKLY_LIST_DEFAULTS, WEEKLY_LIST_PARAMS, parseWeeklyListUrl } from './utils/weekly-list-contract.js';
 export { contactCategoryLabel } from './utils/contact.js';
 export { formatDate, yearOf } from './utils/dates.js';

package/dist/contract.d.ts

@@ -43,11 +43,26 @@ export { localize } from './edit/types.js';
 export type { CollectionRef, ContentRef, EditableEntity, EditDescriptor, EntityOp, LocalizedText, PropertyDescriptor, PropertyOption, PropertyType, PropertyValue } from './edit/types.js';
 export { REACTIONS } from './content/types.js';
 export type { Reaction, ReactionSummary, SortDirection } from './content/types.js';
-export { WEEKLY_LIST_DEFAULTS } from './utils/weekly-list-contract.js';
+export { MILESTONE_CATEGORIES, PROJECT_KINDS } from './content/types.js';
+export type { MilestoneCategory, ProjectKind } from './content/types.js';
+export { WEEKLY_LIST_DEFAULTS, WEEKLY_LIST_PARAMS, parseWeeklyListUrl } from './utils/weekly-list-contract.js';
 export type { WeeklyListFilters, WeeklyListPage, WeeklyListServerData } from './utils/weekly-list-contract.js';
 export { CONTACT_CATEGORIES } from './content/types.js';
-export type { ContactCategory, FieldConstraint, FormFailReason } from './content/types.js';
+export { COMMENT_STATUSES } from './content/types.js';
+export type { CommentStatus, ContactCategory, FieldConstraint, FormFailReason } from './content/types.js';
 export { COMMENT_BODY, CONTACT_MESSAGE, CONTACT_NAME, DISPLAY_NAME, EMAIL, LOGIN_PASSWORD, PASSWORD } from './forms/constraints.js';
 export { hasNewsletterIntent, HONEYPOT_FIELD, isNewsletterIntent, NEWSLETTER_INTENT_PARAM, NEWSLETTER_INTENT_VALUE, withNewsletterIntent } from './forms/transport.js';
 export type { FormFail, FormFieldIssue, FormResultLike, FormResultOf, KeyedRemoteForms, RemoteField, RemoteFormAttributes, RemoteFormInstance } from './forms/types.js';
-export { buildQueryString, isExternalUrl, isInternalPath, isPathUnder } from './utils/paths.js';
+export { buildQueryString, isExternalUrl, isInternalPath } from './utils/paths.js';
+/**
+ * The descriptor factories. `edit/helpers.ts` imports nothing but types from
+ * two modules this subpath already anchors, so it needed a door rather than a
+ * split.
+ *
+ * They were reachable only beside the components, which cost vit-brain an
+ * eslint exception that switched `no-restricted-imports` off WHOLESALE for the
+ * two files calling one factory each — and one of those, `mirror.ts`, is
+ * already reached from a server repository by `import type`. A per-specifier
+ * door replaces a per-file hole.
+ */
+export { chromeEdit, chromeProperty, collectionOf, entityEdit, entityProperty, pageCopyEdit } from './edit/helpers.js';

package/dist/contract.js

@@ -40,8 +40,32 @@
 export { LOCALES, BASE_LOCALE } from './config/types.js';
 export { localize } from './edit/types.js';
 export { REACTIONS } from './content/types.js';
-export { WEEKLY_LIST_DEFAULTS } from './utils/weekly-list-contract.js';
+// The two content vocabularies a host's zod enum derives from, the way its
+// contact form already derives from CONTACT_CATEGORIES below. Values, because
+// a type cannot be the source of an enum.
+export { MILESTONE_CATEGORIES, PROJECT_KINDS } from './content/types.js';
+// The weeklies URL contract, both halves: the values a param stands for when
+// absent, the names it travels as, and the parse that reads one back. The read
+// half had three spellings across two repositories and this package's own test,
+// and the round-trip case guarding them crossed against the test's copy.
+export { WEEKLY_LIST_DEFAULTS, WEEKLY_LIST_PARAMS, parseWeeklyListUrl } from './utils/weekly-list-contract.js';
 export { CONTACT_CATEGORIES } from './content/types.js';
+export { COMMENT_STATUSES } from './content/types.js';
 export { COMMENT_BODY, CONTACT_MESSAGE, CONTACT_NAME, DISPLAY_NAME, EMAIL, LOGIN_PASSWORD, PASSWORD } from './forms/constraints.js';
 export { hasNewsletterIntent, HONEYPOT_FIELD, isNewsletterIntent, NEWSLETTER_INTENT_PARAM, NEWSLETTER_INTENT_VALUE, withNewsletterIntent } from './forms/transport.js';
-export { buildQueryString, isExternalUrl, isInternalPath, isPathUnder } from './utils/paths.js';
+// `isPathUnder` is deliberately absent: `Nav` and `Sidebar` reach it by relative
+// import and no host has ever imported it, so exporting it pinned a prefix rule
+// into semver for nobody. See utils/paths.ts.
+export { buildQueryString, isExternalUrl, isInternalPath } from './utils/paths.js';
+/**
+ * The descriptor factories. `edit/helpers.ts` imports nothing but types from
+ * two modules this subpath already anchors, so it needed a door rather than a
+ * split.
+ *
+ * They were reachable only beside the components, which cost vit-brain an
+ * eslint exception that switched `no-restricted-imports` off WHOLESALE for the
+ * two files calling one factory each — and one of those, `mirror.ts`, is
+ * already reached from a server repository by `import type`. A per-specifier
+ * door replaces a per-file hole.
+ */
+export { chromeEdit, chromeProperty, collectionOf, entityEdit, entityProperty, pageCopyEdit } from './edit/helpers.js';

package/dist/index.js

@@ -12,13 +12,7 @@ export * from './forms/index.js';
 // App wiring: configuration context and the edit-mode contract.
 export * from './config/index.js';
 export * from './edit/index.js';
-// The one path utility a host actually reads: fndvit-website re-exports
-// `buildQueryString` from its own `utils/nav.ts`, so the URL a list mirrors
-// and the hrefs it renders are spelled by this function in both codebases.
-// The other three are NOT exported. `isInternalPath` and `isExternalUrl` are
-// the destination classifiers `Link` and `TimelineMilestone` branch on, and
-// `isPathUnder` is the prefix match `Nav` and `Sidebar` highlight the current
-// section with — all four in-package readers reach them by deep import, and
-// no host imports any of the three. Exporting them would pin their behaviour
-// into semver for no reader; `paths.test.ts` is what holds them instead.
+// The one path utility this BARREL carries. The destination classifiers are
+// server-side rules, so they go through ./contract instead — see the note in
+// utils/paths.ts, which is where the export surface for all of them is decided.
 export { buildQueryString } from './utils/paths.js';

package/dist/utils/milestones.d.ts

@@ -5,6 +5,11 @@ import type { MilestoneCategory } from '../content/types.js';
  * teal, slots are never reordered). Labels always accompany the color dot,
  * so color is never the only encoding. The --series-* tokens ship in
  * tokens.css.
+ *
+ * Keyed, not positional, so a member added to `MILESTONE_CATEGORIES` fails to
+ * compile here rather than silently taking slot 6 — and so the display order
+ * is `MILESTONE_CATEGORIES`' to decide, not a side effect of this literal's
+ * key order, which is what the panel select used to read.
  */
 export declare const MILESTONE_CATEGORY_COLOR: Record<MilestoneCategory, string>;
 /**

package/dist/utils/milestones.js

@@ -3,6 +3,11 @@
  * teal, slots are never reordered). Labels always accompany the color dot,
  * so color is never the only encoding. The --series-* tokens ship in
  * tokens.css.
+ *
+ * Keyed, not positional, so a member added to `MILESTONE_CATEGORIES` fails to
+ * compile here rather than silently taking slot 6 — and so the display order
+ * is `MILESTONE_CATEGORIES`' to decide, not a side effect of this literal's
+ * key order, which is what the panel select used to read.
  */
 export const MILESTONE_CATEGORY_COLOR = {
     foundation: 'var(--series-1)',

package/dist/utils/paths.d.ts

@@ -1,3 +1,30 @@
+/**
+ * The four path rules, and which doors they go out of.
+ *
+ * This note used to live in `index.ts` and argue that only `buildQueryString`
+ * was exported, that the other three were private, and that exporting them
+ * "would pin their behaviour into semver for no reader". All three claims had
+ * stopped being true:
+ *
+ * - `contract.ts` exports all four, and has since the subpath reached both
+ *   hosts.
+ * - Two of them DO have a host reader. fndvit-website's repository integration
+ *   suite asserts the `site_links.href` check constraint against
+ *   `isInternalPath` byte for byte, and the https columns against
+ *   `isExternalUrl` — that binding is the whole reason those cases exist, and
+ *   it is why these two belong on `./contract`: a CHECK constraint is a
+ *   server-side rule, and the classifier that has to agree with it must be
+ *   importable without loading a component.
+ * - fndvit-website does not re-export `buildQueryString` from its `nav.ts`
+ *   any more; that pass-through is deleted and its one reader imports the
+ *   package directly.
+ *
+ * What the old note got right is the principle, and `isPathUnder` is the name
+ * it applies to: it is the prefix match `Nav` and `Sidebar` highlight the
+ * current section with, both of them reach it by relative import, and no host
+ * has ever imported it. So it is the one of the four that stays in, held by
+ * `paths.test.ts` rather than by semver.
+ */
 /** Prefix match over a URL pathname: '/what-we-do' covers '/what-we-do/<slug>'. */
 export declare function isPathUnder(pathname: string, prefix: string): boolean;
 /**

package/dist/utils/paths.js

@@ -1,3 +1,30 @@
+/**
+ * The four path rules, and which doors they go out of.
+ *
+ * This note used to live in `index.ts` and argue that only `buildQueryString`
+ * was exported, that the other three were private, and that exporting them
+ * "would pin their behaviour into semver for no reader". All three claims had
+ * stopped being true:
+ *
+ * - `contract.ts` exports all four, and has since the subpath reached both
+ *   hosts.
+ * - Two of them DO have a host reader. fndvit-website's repository integration
+ *   suite asserts the `site_links.href` check constraint against
+ *   `isInternalPath` byte for byte, and the https columns against
+ *   `isExternalUrl` — that binding is the whole reason those cases exist, and
+ *   it is why these two belong on `./contract`: a CHECK constraint is a
+ *   server-side rule, and the classifier that has to agree with it must be
+ *   importable without loading a component.
+ * - fndvit-website does not re-export `buildQueryString` from its `nav.ts`
+ *   any more; that pass-through is deleted and its one reader imports the
+ *   package directly.
+ *
+ * What the old note got right is the principle, and `isPathUnder` is the name
+ * it applies to: it is the prefix match `Nav` and `Sidebar` highlight the
+ * current section with, both of them reach it by relative import, and no host
+ * has ever imported it. So it is the one of the four that stays in, held by
+ * `paths.test.ts` rather than by semver.
+ */
 /** Prefix match over a URL pathname: '/what-we-do' covers '/what-we-do/<slug>'. */
 export function isPathUnder(pathname, prefix) {
     return pathname === prefix || pathname.startsWith(`${prefix}/`);

package/dist/utils/weekly-list-contract.d.ts

@@ -64,3 +64,38 @@ export interface WeeklyListServerData {
     pageSize: number;
     query: WeeklyListFilters;
 }
+/**
+ * The four params this list travels as, in the order a URL reads.
+ *
+ * Exported so a host's query schema can be bound to them rather than agreeing
+ * by coincidence: fndvit-website's `weeklyListQuerySchema` names all four as
+ * zod fields, and nothing said they were these four.
+ */
+export declare const WEEKLY_LIST_PARAMS: readonly ["q", "theme", "sort", "page"];
+/**
+ * The READ half of the weeklies URL contract — what a URL this package wrote
+ * means when it comes back.
+ *
+ * `WEEKLY_LIST_DEFAULTS` gave the VALUES one owner and both hosts derive from
+ * it correctly. The param NAMES and the parse had none: they were spelled four
+ * times across three repositories — `toQuery`/`hrefFor` here, a `parseListUrl`
+ * declared inside this package's own test, `weeklyListQuerySchema` in
+ * fndvit-website and `weeklyQuery` in vit-brain — and the two repositories
+ * cannot import each other, so nothing could disagree out loud. vit-brain's
+ * docblock states the failure exactly: rename a param here and the read side
+ * drops the filter silently while the write side keeps producing it.
+ *
+ * Worse, the round-trip case that exists to catch precisely that
+ * ("builds URLs that parse back to the filters they were built from") crossed
+ * the write half against the stand-in in the test file, not against either
+ * real reader. It could not fail for the reason it was written.
+ *
+ * TOLERANT, because these URLs are shared and hand-edited: an unknown sort or
+ * a junk page falls back to its default rather than refusing the page. A host
+ * may still layer its own tolerance on top — fndvit-website trims and caps
+ * lengths in zod, vit-brain clamps nothing further — but the names, and what
+ * an absent or bad value means, are answered once, here.
+ */
+export declare function parseWeeklyListUrl(url: URL | string): WeeklyListFilters & {
+    page: number;
+};

package/dist/utils/weekly-list-contract.js

@@ -40,3 +40,49 @@
  * is the value it should answer unless it means to differ.
  */
 export const WEEKLY_LIST_DEFAULTS = { sort: 'desc', page: 1, pageSize: 12 };
+/**
+ * The four params this list travels as, in the order a URL reads.
+ *
+ * Exported so a host's query schema can be bound to them rather than agreeing
+ * by coincidence: fndvit-website's `weeklyListQuerySchema` names all four as
+ * zod fields, and nothing said they were these four.
+ */
+export const WEEKLY_LIST_PARAMS = ['q', 'theme', 'sort', 'page'];
+/**
+ * The READ half of the weeklies URL contract — what a URL this package wrote
+ * means when it comes back.
+ *
+ * `WEEKLY_LIST_DEFAULTS` gave the VALUES one owner and both hosts derive from
+ * it correctly. The param NAMES and the parse had none: they were spelled four
+ * times across three repositories — `toQuery`/`hrefFor` here, a `parseListUrl`
+ * declared inside this package's own test, `weeklyListQuerySchema` in
+ * fndvit-website and `weeklyQuery` in vit-brain — and the two repositories
+ * cannot import each other, so nothing could disagree out loud. vit-brain's
+ * docblock states the failure exactly: rename a param here and the read side
+ * drops the filter silently while the write side keeps producing it.
+ *
+ * Worse, the round-trip case that exists to catch precisely that
+ * ("builds URLs that parse back to the filters they were built from") crossed
+ * the write half against the stand-in in the test file, not against either
+ * real reader. It could not fail for the reason it was written.
+ *
+ * TOLERANT, because these URLs are shared and hand-edited: an unknown sort or
+ * a junk page falls back to its default rather than refusing the page. A host
+ * may still layer its own tolerance on top — fndvit-website trims and caps
+ * lengths in zod, vit-brain clamps nothing further — but the names, and what
+ * an absent or bad value means, are answered once, here.
+ */
+export function parseWeeklyListUrl(url) {
+    // A relative href (`hrefFor` writes one) needs a base to parse against; it
+    // is never read, only discarded with the rest of the origin.
+    const params = (typeof url === 'string' ? new URL(url, 'https://weekly-list.invalid') : url)
+        .searchParams;
+    const sort = params.get('sort');
+    const page = Math.trunc(Number(params.get('page')));
+    return {
+        q: params.get('q') ?? '',
+        theme: params.get('theme'),
+        sort: sort === 'asc' || sort === 'desc' ? sort : WEEKLY_LIST_DEFAULTS.sort,
+        page: page >= WEEKLY_LIST_DEFAULTS.page ? page : WEEKLY_LIST_DEFAULTS.page
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vit-foundation/ui",
-	"version": "0.21.0",
+	"version": "0.23.0",
 	"scripts": {
 		"dev": "vite dev",
 		"build": "vite build && npm run prepack",

package/dist/components/admin/AdminShell.svelte

@@ -1,42 +0,0 @@
-<script lang="ts">
-	import type { Snippet } from 'svelte';
-	import Sidebar, { type SidebarItem } from './Sidebar.svelte';
-
-	interface Props {
-		/** Rail entries, already permission-filtered by the host. */
-		items: SidebarItem[];
-		/** Accessible name of the sidebar nav landmark. */
-		navLabel?: string;
-		logo?: Snippet;
-		/** Bottom of the rail — the host's logout form. */
-		footer?: Snippet;
-		/** The page content. */
-		children: Snippet;
-		/** Highlighting override for tests and stories. */
-		url?: URL;
-	}
-
-	let { items, navLabel = 'Principal', logo, footer, children, url = undefined }: Props = $props();
-</script>
-
-<div class="shell">
-	<Sidebar {items} label={navLabel} {logo} {footer} {url} />
-	<main class="content">
-		{@render children()}
-	</main>
-</div>
-
-<style>
-	/* The sidebar is fixed at 4.5rem; the content pays for it once, here,
-	   instead of every page knowing the rail's width. */
-	.content {
-		margin-left: 4.5rem;
-		min-height: 100vh;
-	}
-
-	@media print {
-		.content {
-			margin-left: 0;
-		}
-	}
-</style>

package/dist/components/admin/AdminShell.svelte.d.ts

@@ -1,18 +0,0 @@
-import type { Snippet } from 'svelte';
-import { type SidebarItem } from './Sidebar.svelte';
-interface Props {
-    /** Rail entries, already permission-filtered by the host. */
-    items: SidebarItem[];
-    /** Accessible name of the sidebar nav landmark. */
-    navLabel?: string;
-    logo?: Snippet;
-    /** Bottom of the rail — the host's logout form. */
-    footer?: Snippet;
-    /** The page content. */
-    children: Snippet;
-    /** Highlighting override for tests and stories. */
-    url?: URL;
-}
-declare const AdminShell: import("svelte").Component<Props, {}, "">;
-type AdminShell = ReturnType<typeof AdminShell>;
-export default AdminShell;

package/dist/components/jobs/index.d.ts

@@ -1,2 +0,0 @@
-export { default as JobList } from './JobList.svelte';
-export type { JobEditMap } from './JobList.svelte';

package/dist/components/jobs/index.js

@@ -1 +0,0 @@
-export { default as JobList } from './JobList.svelte';

package/dist/components/layout/index.d.ts

@@ -1,3 +0,0 @@
-export { default as Footer } from './Footer.svelte';
-export { default as Nav } from './Nav.svelte';
-export { default as PageShell } from './PageShell.svelte';

package/dist/components/layout/index.js

@@ -1,3 +0,0 @@
-export { default as Footer } from './Footer.svelte';
-export { default as Nav } from './Nav.svelte';
-export { default as PageShell } from './PageShell.svelte';

package/dist/components/projects/index.d.ts

@@ -1,2 +0,0 @@
-export { default as ProjectCard } from './ProjectCard.svelte';
-export type { ProjectEditMap } from './ProjectCard.svelte';

package/dist/components/projects/index.js

@@ -1 +0,0 @@
-export { default as ProjectCard } from './ProjectCard.svelte';

package/dist/components/team/index.d.ts

@@ -1,3 +0,0 @@
-export { default as CollaboratorList } from './CollaboratorList.svelte';
-export { default as TeamMemberCard } from './TeamMemberCard.svelte';
-export type { TeamMemberEditMap } from './TeamMemberCard.svelte';

package/dist/components/team/index.js

@@ -1,2 +0,0 @@
-export { default as CollaboratorList } from './CollaboratorList.svelte';
-export { default as TeamMemberCard } from './TeamMemberCard.svelte';

package/dist/components/timeline/index.d.ts

@@ -1,3 +0,0 @@
-export { default as Timeline } from './Timeline.svelte';
-export { default as TimelineMilestone } from './TimelineMilestone.svelte';
-export type { MilestoneEditMap } from './TimelineMilestone.svelte';

package/dist/components/timeline/index.js

@@ -1,2 +0,0 @@
-export { default as Timeline } from './Timeline.svelte';
-export { default as TimelineMilestone } from './TimelineMilestone.svelte';

package/dist/components/ui/index.d.ts

@@ -1,20 +0,0 @@
-export { default as Button } from './Button.svelte';
-export { default as CardMedia } from './CardMedia.svelte';
-export { default as CardTitle } from './CardTitle.svelte';
-export { default as CopyIntro } from './CopyIntro.svelte';
-export { default as DateText } from './DateText.svelte';
-export { default as DecorShapes } from './DecorShapes.svelte';
-export { default as Field } from './Field.svelte';
-export { default as FilterChips } from './FilterChips.svelte';
-export { default as FormErrorFeedback } from './FormErrorFeedback.svelte';
-export { default as FormFeedback } from './FormFeedback.svelte';
-export { default as FormResultSlot } from './FormResultSlot.svelte';
-export { default as GhostButton } from './GhostButton.svelte';
-export { default as Honeypot } from './Honeypot.svelte';
-export { default as Link } from './Link.svelte';
-export { default as LocaleField } from './LocaleField.svelte';
-export { default as NewsletterIntentField } from './NewsletterIntentField.svelte';
-export { default as Pagination } from './Pagination.svelte';
-export { default as RichText } from './RichText.svelte';
-export { default as SearchInput } from './SearchInput.svelte';
-export { default as ShareRow } from './ShareRow.svelte';

package/dist/components/ui/index.js

@@ -1,20 +0,0 @@
-export { default as Button } from './Button.svelte';
-export { default as CardMedia } from './CardMedia.svelte';
-export { default as CardTitle } from './CardTitle.svelte';
-export { default as CopyIntro } from './CopyIntro.svelte';
-export { default as DateText } from './DateText.svelte';
-export { default as DecorShapes } from './DecorShapes.svelte';
-export { default as Field } from './Field.svelte';
-export { default as FilterChips } from './FilterChips.svelte';
-export { default as FormErrorFeedback } from './FormErrorFeedback.svelte';
-export { default as FormFeedback } from './FormFeedback.svelte';
-export { default as FormResultSlot } from './FormResultSlot.svelte';
-export { default as GhostButton } from './GhostButton.svelte';
-export { default as Honeypot } from './Honeypot.svelte';
-export { default as Link } from './Link.svelte';
-export { default as LocaleField } from './LocaleField.svelte';
-export { default as NewsletterIntentField } from './NewsletterIntentField.svelte';
-export { default as Pagination } from './Pagination.svelte';
-export { default as RichText } from './RichText.svelte';
-export { default as SearchInput } from './SearchInput.svelte';
-export { default as ShareRow } from './ShareRow.svelte';

package/dist/components/weeklies/index.d.ts

@@ -1,7 +0,0 @@
-export { default as CommentSection } from './CommentSection.svelte';
-export type { CommentFormInstance } from './CommentSection.svelte';
-export { default as ReactionBar } from './ReactionBar.svelte';
-export type { CommentReactionChip, ReactionBarForms, WeeklyReactionChip } from './ReactionBar.svelte';
-export { default as SortSelect } from './SortSelect.svelte';
-export { default as WeeklieCard } from './WeeklieCard.svelte';
-export type { WeeklyEditMap } from './WeeklieCard.svelte';

package/dist/components/weeklies/index.js

@@ -1,4 +0,0 @@
-export { default as CommentSection } from './CommentSection.svelte';
-export { default as ReactionBar } from './ReactionBar.svelte';
-export { default as SortSelect } from './SortSelect.svelte';
-export { default as WeeklieCard } from './WeeklieCard.svelte';