@anja.codes/vitakit 0.1.0 → 0.3.0

package/dist/nuxt.mjs

@@ -1,26 +1,58 @@
 import { defineNuxtModule, createResolver, addTemplate, addTypeTemplate, addImportsDir, addComponentsDir, addPrerenderRoutes, updateTemplates } from '@nuxt/kit';
 import { createRequire } from 'node:module';
-import { l as loadContent } from './shared/vitakit.CypCF-4Q.mjs';
-import 'node:fs/promises';
-import 'node:path';
+import { l as loadContent } from './shared/vitakit.DteA9vLy.mjs';
+import { f as fail } from './shared/vitakit.DCK90zq4.mjs';
+import { b as findWebPlacements, p as publicationPlacementProblems } from './shared/vitakit.DvvUYUTS.mjs';
+import { readdir } from 'node:fs/promises';
+import { isAbsolute, resolve, relative } from 'node:path';
 import 'gray-matter';
 import 'yaml';
+import './chunks/bibliography.mjs';
+import 'node:fs';
+import './shared/vitakit.DQ6PmGoL.mjs';
+import 'node:url';
+import '@behackl/citation-js-extras';
 import 'unified';
+import 'rehype-parse';
+import 'rehype-sanitize';
+import 'rehype-stringify';
 import 'remark-parse';
 import 'remark-gfm';
 import 'remark-math';
 import 'remark-rehype';
 import 'rehype-katex';
 import 'rehype-raw';
-import 'rehype-stringify';
 import 'unist-util-visit';
-import './shared/vitakit.BxcnlFGP.mjs';
-import 'node:fs';
-import 'node:url';
 import 'zod';
-import '@behackl/citation-js-extras';
-import 'rehype-parse';
-import 'rehype-sanitize';
+import './chunks/publication-lists.mjs';
+import './shared/vitakit.D10HyDhF.mjs';
+import './chunks/sections.mjs';
+import './chunks/schemas.mjs';
+import './shared/vitakit.DvABWuUc.mjs';
+import './shared/vitakit.TSMTC5Jl.mjs';
+
+function isWithin(directory, path) {
+  const child = relative(directory, path);
+  return child === "" || !isAbsolute(child) && child.split(/[/\\]/)[0] !== "..";
+}
+async function watchComponentOverrides(nuxt, packagedDir) {
+  const names = new Set((await readdir(packagedDir)).filter((file) => file.endsWith(".vue")).map((file) => file.slice(0, -4)));
+  let previous;
+  let restarting = false;
+  nuxt.hook("components:extend", async (components) => {
+    const overrides = new Set(components.filter((component) => names.has(component.pascalName) && isAbsolute(component.filePath) && !isWithin(packagedDir, component.filePath) && !component.filePath.replace(/\\/g, "/").split("/").includes("node_modules") && (isWithin(nuxt.options.srcDir, component.filePath) || isWithin(nuxt.options.rootDir, component.filePath))).map((component) => resolve(component.filePath)));
+    const before = previous;
+    previous = overrides;
+    if (!before || restarting || before.size === overrides.size && [...before].every((path) => overrides.has(path))) return;
+    restarting = true;
+    try {
+      await nuxt.callHook("restart");
+    } catch (error) {
+      restarting = false;
+      throw error;
+    }
+  });
+}
 
 function katexStylesheet() {
   const renderer = createRequire(createRequire(import.meta.url).resolve("rehype-katex"));
@@ -54,6 +86,11 @@ const module$1 = defineNuxtModule({
     });
     let content = await load(!nuxt.options.dev);
     report(content);
+    if (!nuxt.options.dev && !nuxt.options._prepare) {
+      const { publications } = await findWebPlacements(rootDir);
+      const [problem] = publicationPlacementProblems(publications, [], Object.keys(content.publications));
+      if (problem) fail(problem.where, problem.message);
+    }
     nuxt.options.alias["#vitakit/content"] = `${nuxt.options.buildDir}/${TEMPLATE}`;
     addTemplate({
       filename: TEMPLATE,
@@ -78,6 +115,7 @@ const module$1 = defineNuxtModule({
     await addComponentsDir({ path: resolver.resolve("./runtime/components"), prefix: "Vita", pathPrefix: false });
     addPrerenderRoutes(content.pages.map((page) => page.route));
     if (!nuxt.options.dev) return;
+    await watchComponentOverrides(nuxt, resolver.resolve("./runtime/components"));
     nuxt.options.watch.push("../content", "../schemas");
     nuxt.hook("builder:watch", async (_event, path) => {
       if (!/[/\\](content|schemas)[/\\]/.test(path)) return;

package/dist/runtime/components/VitaPublications.vue

@@ -1,36 +1,35 @@
 <script setup lang="ts">
 /**
- * Publication groups formatted from `content/publications.bib` at build time.
+ * A publication list from `content/publication-lists.yml`, formatted from
+ * `content/publications.bib` at build time.
  *
- * This component lays out the groups; each entry is a `VitaPublication`, which
- * can be ejected on its own to change how a reference looks. Grouping, style
- * and badge fields are configured in `nuxt.config.ts` and
- * `content/publications.csl`.
+ * Which publications, in what order and in which groups is the list's
+ * business; this component decides where it appears and under which heading.
+ * Each entry is a `VitaPublication`, which can be ejected on its own to change
+ * how a reference looks. Nothing is shown for an empty list, heading included.
  */
 import { computed } from 'vue'
-import { usePublications } from '#imports'
+import { usePublicationList } from '#imports'
 
-// `withDefaults` is required for the boolean: Vue casts an absent Boolean prop
-// to `false`, so `headings` would silently default to off.
-const props = withDefaults(defineProps<{
-  /** Restrict to these group ids, in this order. */
-  groups?: string[]
-  /** Show the group label above each list. */
-  headings?: boolean
-}>(), { groups: undefined, headings: true })
+const props = defineProps<{
+  /** The list's name in `content/publication-lists.yml`. */
+  list: string
+  /** A heading above the list. */
+  title?: string
+}>()
 
-const all = usePublications()
-const shown = computed(() => props.groups
-  ? props.groups.map(id => all.find(group => group.id === id)).filter(group => group !== undefined)
-  : all)
+const publications = computed(() => usePublicationList(props.list))
 </script>
 
 <template>
-  <div class="vita-publications">
-    <section v-for="group in shown" :key="group.id" class="vita-publications__group">
-      <h2 v-if="headings" class="vita-publications__heading">
+  <div v-if="publications.count" class="vita-publications">
+    <h2 v-if="title !== undefined" class="vita-publications__title">
+      {{ title }}
+    </h2>
+    <section v-for="group in publications.groups" :key="group.id" class="vita-publications__group">
+      <component :is="title !== undefined ? 'h3' : 'h2'" v-if="group.label !== undefined" class="vita-publications__heading">
         {{ group.label }}
-      </h2>
+      </component>
       <ol class="vita-bib csl-bib-body">
         <VitaPublication v-for="entry in group.entries" :key="entry.key" :entry="entry" />
       </ol>

package/dist/runtime/components/VitaSection.vue

@@ -1,15 +1,26 @@
 <script setup lang="ts">
 /**
- * Renders any section without a dedicated component.
+ * A generic section with conventional field selection and optional overrides.
  *
- * It shows the fields a vitakit schema is built from -- a date, something
- * title-like, an institution, a note, a link -- and ignores what it does not
- * understand. That is enough to make a newly added `content/<name>.yml` visible
- * immediately; write your own component (or eject one) when you want control.
+ * title/meta/note slots replace those regions; the default slot replaces the
+ * whole entry body. The list, row and date column remain owned by vitakit.
+ *
+ * With `title`, the list comes with its heading, in a <section> carrying the
+ * section id as anchor, and neither appears when there are no entries -- the
+ * website's `\vitasection[Title]{id}`.
  */
-import { computed } from 'vue'
+import { computed, type VNodeChild } from 'vue'
 import { useSection } from '#imports'
-import { entrySecondaryParts, entryTitleField, richHtml, type Entry } from '@anja.codes/vitakit/shared'
+import {
+  entrySecondaryParts,
+  entryTitleField,
+  filterWhere,
+  richHtml,
+  type DateRange,
+  type Entry,
+  type VitaSectionSlotProps,
+  type Where,
+} from '@anja.codes/vitakit/shared'
 
 const props = defineProps<{
   /** Section id; ignored when `entries` is given. */
@@ -17,44 +28,89 @@ const props = defineProps<{
   entries?: Entry[]
   /** Fields to try, in order, for the main line. */
   titleFields?: string[]
+  /** Only entries whose fields have these values, as `where` in a PDF document. */
+  where?: Where
   limit?: number
+  /** A heading; the list is then wrapped in a <section> with the id as anchor. */
+  title?: string
 }>()
 
-const items = computed(() => {
-  const source = props.entries ?? (props.id ? useSection(props.id) : [])
-  return props.limit ? source.slice(0, props.limit) : source
-})
-
-// Which fields are the headline and the context line is decided in
-// `@anja.codes/vitakit/shared`, the same code the LaTeX emitter uses; only the
-// separator and the markup are decided here.
-const titleFieldOf = (entry: Entry): string | undefined =>
-  entryTitleField(entry, props.titleFields)
-
-const titleOf = (entry: Entry): string => {
-  const field = titleFieldOf(entry)
-  return (field && richHtml(entry[field])) || ''
-}
-
-const secondaryOf = (entry: Entry): string =>
-  entrySecondaryParts(entry, titleFieldOf(entry))
-    .map(part => (part.kind === 'institution' ? part.institution.name : part.text))
-    .join(' · ')
+const slots = defineSlots<{
+  title?(props: VitaSectionSlotProps): VNodeChild
+  meta?(props: VitaSectionSlotProps): VNodeChild
+  note?(props: VitaSectionSlotProps): VNodeChild
+  default?(props: VitaSectionSlotProps): VNodeChild
+}>()
 
-const linkOf = (entry: Entry): string | undefined =>
-  typeof entry.url === 'string' ? entry.url : undefined
+const rows = computed(() => {
+  const source = filterWhere(props.entries ?? (props.id ? useSection(props.id) : []), props.where)
+  const items = props.limit ? source.slice(0, props.limit) : source
+  return items.map((entry, index): VitaSectionSlotProps => {
+    // Field selection remains shared with the emitter; only the web-specific
+    // presentation (such as a term replacing the date) is decided here.
+    const titleField = entryTitleField(entry, props.titleFields)
+    const term = typeof entry.term === 'string' && entry.term.length > 0 ? entry.term : undefined
+    return {
+      entry,
+      index,
+      display: {
+        titleHtml: (titleField && richHtml(entry[titleField])) || '',
+        titleUrl: typeof entry.url === 'string' ? entry.url : undefined,
+        date: entry.date as DateRange | undefined,
+        term,
+        meta: entrySecondaryParts(term ? { ...entry, term: undefined } : entry, titleField),
+        note: typeof entry.note === 'string' ? entry.note : undefined,
+        links: typeof entry.slides === 'string' && entry.slides ? [{ label: 'Slides', url: entry.slides }] : [],
+        ongoing: entry.ongoing === true,
+      },
+    }
+  })
+})
 </script>
 
 <template>
-  <ul v-if="items.length" class="vita-section">
-    <VitaEntry v-for="item in items" :key="item.id" :date="item.date as never">
-      <p class="vita-entry__title">
-        <!-- eslint-disable vue/no-v-html -- build-time rendered Markdown -->
-        <a v-if="linkOf(item)" :href="linkOf(item)" v-html="titleOf(item)" />
-        <span v-else v-html="titleOf(item)" />
-      </p>
-      <p v-if="secondaryOf(item)" class="vita-entry__meta">{{ secondaryOf(item) }}</p>
-      <p v-if="typeof item.note === 'string'" class="vita-entry__note">{{ item.note }}</p>
+  <!-- With a title: the same component without one, inside its section. -->
+  <section v-if="title !== undefined && rows.length" :id="id" class="vita-section-group">
+    <h2 class="vita-section-group__title">
+      {{ title }}
+    </h2>
+    <VitaSection :entries="rows.map(row => row.entry)" :title-fields="titleFields">
+      <template v-for="(_, name) in slots" #[name]="scope">
+        <slot :name="name" v-bind="scope" />
+      </template>
+    </VitaSection>
+  </section>
+  <ul v-else-if="title === undefined && rows.length" class="vita-section">
+    <VitaEntry v-for="row in rows" :key="row.entry.id" :date="row.display.date">
+      <template v-if="row.display.term" #date>{{ row.display.term }}</template>
+      <!-- Check presence explicitly: an intentionally empty slot must not
+           bring back Vue's slot fallback (or an empty default wrapper). -->
+      <slot v-if="slots.default" v-bind="row" />
+      <template v-else>
+        <slot v-if="slots.title" name="title" v-bind="row" />
+        <p v-else class="vita-entry__title">
+          <!-- eslint-disable vue/no-v-html -- build-time rendered Markdown -->
+          <a v-if="row.display.titleUrl" :href="row.display.titleUrl" v-html="row.display.titleHtml" />
+          <span v-else v-html="row.display.titleHtml" />
+          <span v-if="row.display.ongoing" class="vita-entry__status"> (in progress)</span>
+        </p>
+        <slot v-if="slots.meta" name="meta" v-bind="row" />
+        <p v-else-if="row.display.meta.length" class="vita-entry__meta">
+          <template v-for="(part, index) in row.display.meta" :key="index">
+            <template v-if="index"> · </template>
+            <template v-if="part.kind === 'linked'">
+              <a v-if="part.linked.url" :href="part.linked.url">{{ part.linked.label }}</a>
+              <template v-else>{{ part.linked.label }}</template>
+            </template>
+            <template v-else>{{ part.text }}</template>
+          </template>
+        </p>
+        <slot v-if="slots.note" name="note" v-bind="row" />
+        <p v-else-if="row.display.note !== undefined" class="vita-entry__note">{{ row.display.note }}</p>
+        <p v-if="row.display.links.length" class="vita-entry__links">
+          <a v-for="link in row.display.links" :key="link.url" :href="link.url">{{ link.label }}</a>
+        </p>
+      </template>
     </VitaEntry>
   </ul>
 </template>

package/dist/runtime/composables/useVitakit.ts

@@ -6,7 +6,7 @@
  * chunk.
  */
 import content from '#vitakit/content'
-import type { Entry, Page, Profile, PublicationGroup, VitakitContent } from '@anja.codes/vitakit/shared'
+import type { Entry, Page, Profile, PublicationList, VitakitContent } from '@anja.codes/vitakit/shared'
 
 export function useVitakit(): VitakitContent {
   return content
@@ -32,8 +32,19 @@ export function useSectionIds(): string[] {
   return Object.keys(content.sections)
 }
 
-export function usePublications(): PublicationGroup[] {
-  return content.publications
+/**
+ * A list declared in `content/publication-lists.yml`, formatted at build time.
+ *
+ * Unlike a section, an unknown name is an error: a list is declared on
+ * purpose, so a name that matches none is a typo. Builds report it before
+ * this runs.
+ */
+export function usePublicationList(name: string): PublicationList {
+  if (Object.hasOwn(content.publications, name)) return content.publications[name]!
+  const names = Object.keys(content.publications)
+  throw new Error(name
+    ? `no publication list "${name}" in content/publication-lists.yml; the lists are ${names.join(', ') || '(none)'}`
+    : 'VitaPublications needs a list, e.g. <VitaPublications list="all" />; the lists are in content/publication-lists.yml')
 }
 
 /** The page for a route, or `undefined`. Routes always end with a slash. */

package/dist/schemas/education.ts

@@ -1,20 +1,20 @@
 /**
  * Shape of `content/education.yml`.
  *
- * Also the file `vitakit eject education` copies into a project, with the import
+ * Also the file `vitakit customize education --schema --copy` writes into a project, with the import
  * rewritten to `@anja.codes/vitakit`; it is therefore the single definition of
  * this section, not a copy of one.
  */
-import { dateRange, institution, link, richText, section, text, url, z } from '../primitives'
+import { dateRange, linked, richText, section, text, url, z } from '../primitives'
 
 export default section({
   date: dateRange,
   degree: text,
-  institution,
+  institution: linked,
   thesis: z.strictObject({
     title: richText,
     type: text.optional(),
-    supervisor: z.union([text, link]).optional(),
+    supervisor: linked.optional(),
     url: url.optional(),
   }).optional(),
   note: text.optional(),

package/dist/schemas/employment.ts

@@ -1,16 +1,16 @@
 /**
  * Shape of `content/employment.yml`.
  *
- * Also the file `vitakit eject employment` copies into a project, with the import
+ * Also the file `vitakit customize employment --schema --copy` writes into a project, with the import
  * rewritten to `@anja.codes/vitakit`; it is therefore the single definition of
  * this section, not a copy of one.
  */
-import { dateRange, institution, richText, section, text, url, z } from '../primitives'
+import { dateRange, linked, richText, section, text, url, z } from '../primitives'
 
 export default section({
   date: dateRange,
   position: text,
-  institution,
+  institution: linked,
   project: z.strictObject({
     title: richText,
     funder: text.optional(),

package/dist/schemas/publications.ts

@@ -1,8 +1,9 @@
 /**
- * How `content/publications.bib` is grouped and linked -- on the website, in
- * `vitakit-check` and in the PDF alike.
+ * The statuses of `content/publications.bib`, and how references are linked
+ * -- on the website, in `vitakit verify` and in the PDF alike. Which
+ * publications a list shows is decided in `content/publication-lists.yml`.
  *
- * Also the file `vitakit eject publications` copies into a project, with the
+ * Also the file `vitakit customize publications` writes into a project, with the
  * import rewritten to `@anja.codes/vitakit`; it is therefore the single definition
  * of the defaults, not a copy of them. Every setting is optional: leave out
  * what you do not change.
@@ -11,10 +12,11 @@ import { badgePresets, publications } from '../publications'
 
 export default publications({
   /**
-   * The values of the `status` field, in the order the groups appear. A
-   * status that is not listed here is an error, in any capitalisation.
+   * The values of the `status` field, with the heading of their group, in
+   * the order the groups appear in a list grouped by status. A status that
+   * is not listed here is an error, in any capitalisation.
    */
-  groups: [
+  statuses: [
     { id: 'published', label: 'Published' },
     { id: 'accepted', label: 'Accepted' },
     { id: 'preprint', label: 'Preprints' },
@@ -22,8 +24,8 @@ export default publications({
     { id: 'other', label: 'Other' },
   ],
 
-  /** The group of an entry without `status`; the first group if left out. */
-  defaultGroup: 'published',
+  /** The status of an entry without one; the first status if left out. */
+  defaultStatus: 'published',
 
   /**
    * BibTeX fields that become links after a reference on the website. The

package/dist/schemas/supervision.ts

@@ -1,11 +1,11 @@
 /**
  * Shape of `content/supervision.yml`.
  *
- * Also the file `vitakit eject supervision` copies into a project, with the import
+ * Also the file `vitakit customize supervision --schema --copy` writes into a project, with the import
  * rewritten to `@anja.codes/vitakit`; it is therefore the single definition of
  * this section, not a copy of one.
  */
-import { dateRange, institution, richText, section, text, z } from '../primitives'
+import { dateRange, linked, richText, section, text, z } from '../primitives'
 
 export default section({
   date: dateRange,
@@ -15,6 +15,6 @@ export default section({
   /** Markdown, math allowed. */
   title: richText,
   degree: text.optional(),
-  institution: institution.optional(),
+  institution: linked.optional(),
   coSupervisor: text.optional(),
 })

package/dist/schemas/talks.ts

@@ -1,7 +1,7 @@
 /**
  * Shape of `content/talks.yml`.
  *
- * Also the file `vitakit eject talks` copies into a project, with the import
+ * Also the file `vitakit customize talks --schema --copy` writes into a project, with the import
  * rewritten to `@anja.codes/vitakit`; it is therefore the single definition of
  * this section, not a copy of one.
  */

package/dist/schemas/teaching.ts

@@ -1,17 +1,17 @@
 /**
  * Shape of `content/teaching.yml`.
  *
- * Also the file `vitakit eject teaching` copies into a project, with the import
+ * Also the file `vitakit customize teaching --schema --copy` writes into a project, with the import
  * rewritten to `@anja.codes/vitakit`; it is therefore the single definition of
  * this section, not a copy of one.
  */
-import { dateRange, institution, richText, section, text, url } from '../primitives'
+import { dateRange, linked, richText, section, text, url } from '../primitives'
 
 export default section({
   date: dateRange,
   title: richText,
   role: text.optional(),
-  institution: institution.optional(),
+  institution: linked.optional(),
   /** e.g. `2024S`, `Winter 2023/24` -- free text, shown as written. */
   term: text.optional(),
   url: url.optional(),

package/dist/shared/index.d.mts

@@ -1,5 +1,5 @@
-import { D as DateRange, I as Institution, E as Entry } from './vitakit.D8WRg_Xx.mjs';
-export { C as ContentIssue, b as DatePoint, c as EntryBase, L as Link, P as Page, d as Profile, e as Publication, f as PublicationBadge, g as PublicationGroup, h as RichText, R as RichTextMarker, V as Visibility, a as VitakitContent } from './vitakit.D8WRg_Xx.mjs';
+import { D as DateRange, d as Linked, L as Link, E as Entry } from './vitakit.BfR_mUHm.mjs';
+export { C as ContentIssue, b as DatePoint, c as EntryBase, P as Page, e as Profile, f as Publication, g as PublicationBadge, h as PublicationGroup, i as PublicationList, j as RichText, R as RichTextMarker, V as Visibility, a as VitakitContent } from './vitakit.BfR_mUHm.mjs';
 
 /**
  * Presentation helpers shared by the website and the LaTeX side.
@@ -37,32 +37,83 @@ declare function dateSortKey(range: DateRange | undefined): string;
 declare const TITLE_FIELDS: readonly string[];
 /** Plain-text fields tried, in order, for the context line. */
 declare const SECONDARY_FIELDS: readonly string[];
-/** Fields that may hold an institution, in order of preference. */
-declare const INSTITUTION_FIELDS: readonly string[];
+/** `linked` fields tried, in order, for the place on the context line. */
+declare const LINKED_FIELDS: readonly string[];
 /**
  * The field holding the entry's headline, or `undefined` when nothing fits.
  * Returns the field *name* so callers can render its value themselves: the
  * website needs the rendered HTML, the emitter the LaTeX source.
  */
 declare function entryTitleField(entry: Entry, fields?: readonly string[]): string | undefined;
-/** A piece of the context line: plain text, or an institution that may link. */
+/** A piece of the context line: plain text, or a `linked` value that may link. */
 type SecondaryPart = {
     kind: 'text';
     text: string;
 } | {
-    kind: 'institution';
-    institution: Institution;
+    kind: 'linked';
+    linked: Linked;
 };
+/** Values used by VitaSection's default web rendering, also available to slots. */
+interface VitaSectionDisplay {
+    /** Build-time rendered HTML, respecting the component's titleFields. */
+    titleHtml: string;
+    titleUrl?: string;
+    date?: DateRange;
+    /** A teaching term replaces the normal date label. */
+    term?: string;
+    /** Structured context, preserving links. */
+    meta: SecondaryPart[];
+    note?: string;
+    /** Additional links; does not include the title's link. */
+    links: Link[];
+    ongoing: boolean;
+}
+/** Shared context for VitaSection's title, meta, note and default (body) slots. */
+interface VitaSectionSlotProps {
+    entry: Entry;
+    /** Zero-based position in the displayed list, after limiting. */
+    index: number;
+    display: VitaSectionDisplay;
+}
 /**
  * The context line, as structured parts. The field used for the title is
  * skipped, so nothing appears twice.
  */
 declare function entrySecondaryParts(entry: Entry, titleField?: string): SecondaryPart[];
+/**
+ * The `linked` values of a field, as a list: none, one, or several. For
+ * templates that show a field which may hold one link or a list of them.
+ */
+declare function asLinkedList(value: unknown): Linked[];
 
 /** The plain-text form: Markdown source, for LaTeX, comparisons and `title=`. */
 declare function richSource(value: unknown): string;
 /** The rendered form, or `undefined` when there is nothing to render. */
 declare function richHtml(value: unknown): string | undefined;
 
-export { DateRange, Entry, INSTITUTION_FIELDS, Institution, SECONDARY_FIELDS, TITLE_FIELDS, dateSortKey, entrySecondaryParts, entryTitleField, formatDateRange, richHtml, richSource };
-export type { DateFormatOptions, SecondaryPart };
+/**
+ * Selecting entries by field: the `where` of a PDF document's `.yml` and of
+ * `<VitaSection where>`. One implementation, so that the website and the PDF
+ * cannot disagree about which entries match.
+ *
+ * Deliberately small: equality with one value, or with any of several. Values
+ * are compared as text, so `where: { year: 2024 }` and `{ year: '2024' }` mean
+ * the same.
+ */
+
+/** A value to compare with, or several of which any may match. */
+type WhereValue = string | number | boolean | readonly (string | number | boolean)[];
+/** Field name -> wanted value(s). Every field must match. */
+type Where = Readonly<Record<string, WhereValue>>;
+/**
+ * The comparable value of a field: `year` from the date, the source text of a
+ * formatted-text field, the label of a link.
+ */
+declare function fieldValue(entry: Entry, field: string): unknown;
+/** Whether an entry matches every field of `where`. */
+declare function matchesWhere(entry: Entry, where: Where): boolean;
+/** The entries matching `where`; all of them when it is empty or absent. */
+declare function filterWhere<T extends Entry>(entries: readonly T[], where: Where | undefined): T[];
+
+export { DateRange, Entry, LINKED_FIELDS, Link, Linked, SECONDARY_FIELDS, TITLE_FIELDS, asLinkedList, dateSortKey, entrySecondaryParts, entryTitleField, fieldValue, filterWhere, formatDateRange, matchesWhere, richHtml, richSource };
+export type { DateFormatOptions, SecondaryPart, VitaSectionDisplay, VitaSectionSlotProps, Where, WhereValue };

package/dist/shared/index.mjs

@@ -1,57 +1,3 @@
-export { a as richHtml, r as richSource } from './vitakit.BlU-p01e.mjs';
-
-function formatPoint(point, { locale = "en", precision = "auto" }) {
-  if (precision === "year" || point.month === void 0) return String(point.year);
-  const date = new Date(Date.UTC(point.year, point.month - 1, point.day ?? 1));
-  return new Intl.DateTimeFormat(locale, {
-    year: "numeric",
-    month: "short",
-    ...point.day === void 0 ? {} : { day: "numeric" },
-    timeZone: "UTC"
-  }).format(date);
-}
-function formatDateRange(range, options = {}) {
-  if (!range) return "";
-  const { presentLabel = "present" } = options;
-  const from = formatPoint(range.from, options);
-  if (range.point) return from;
-  if (range.ongoing) return `${from}\u2013${presentLabel}`;
-  if (!range.to) return from;
-  const to = formatPoint(range.to, options);
-  return from === to ? from : `${from}\u2013${to}`;
-}
-function dateSortKey(range) {
-  return range?.from.sortKey ?? "";
-}
-
-const TITLE_FIELDS = ["title", "position", "degree", "role", "student"];
-const SECONDARY_FIELDS = ["student", "role", "event", "term", "degree"];
-const INSTITUTION_FIELDS = ["institution", "issuer", "organisation"];
-function entryTitleField(entry, fields = TITLE_FIELDS) {
-  return fields.find((field) => {
-    const value = entry[field];
-    if (typeof value === "string") return value.length > 0;
-    return typeof value === "object" && value !== null && "html" in value;
-  });
-}
-function entrySecondaryParts(entry, titleField) {
-  const parts = [];
-  for (const field of SECONDARY_FIELDS) {
-    if (field === titleField) continue;
-    const value = entry[field];
-    if (typeof value === "string" && value.length > 0) parts.push({ kind: "text", text: value });
-  }
-  for (const field of INSTITUTION_FIELDS) {
-    const value = entry[field];
-    if (value?.name) {
-      parts.push({ kind: "institution", institution: value });
-      break;
-    }
-  }
-  if (typeof entry.location === "string" && entry.location.length > 0) {
-    parts.push({ kind: "text", text: entry.location });
-  }
-  return parts;
-}
-
-export { INSTITUTION_FIELDS, SECONDARY_FIELDS, TITLE_FIELDS, dateSortKey, entrySecondaryParts, entryTitleField, formatDateRange };
+export { L as LINKED_FIELDS, S as SECONDARY_FIELDS, T as TITLE_FIELDS, a as asLinkedList, d as dateSortKey, e as entrySecondaryParts, b as entryTitleField, f as formatDateRange } from './vitakit.CfB3hMHl.mjs';
+export { r as richHtml, a as richSource } from './vitakit.CtChKO0I.mjs';
+export { f as fieldValue, a as filterWhere, m as matchesWhere } from './vitakit.D-DdJaDZ.mjs';