@anja.codes/vitakit 0.1.0 → 0.2.0

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/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,8 @@
 /**
  * How `content/publications.bib` is grouped and linked -- on the website, in
- * `vitakit-check` and in the PDF alike.
+ * `vitakit verify` and in the PDF alike.
  *
- * 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.

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.BfpxDtz1.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 RichText, R as RichTextMarker, V as Visibility, a as VitakitContent } from './vitakit.BfpxDtz1.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';

package/dist/shared/vitakit.BZZIsWlY.mjs

@@ -0,0 +1,179 @@
+import { parse } from '@babel/parser';
+
+const PACKAGE = "@anja.codes/vitakit";
+function parseModule(source) {
+  return parse(source, { sourceType: "module", plugins: ["typescript"] }).program;
+}
+function unwrap(expression) {
+  let current = expression;
+  while (current.type === "TSAsExpression" || current.type === "TSSatisfiesExpression" || current.type === "ParenthesizedExpression" || current.type === "TSNonNullExpression") {
+    current = current.expression;
+  }
+  return current;
+}
+function packageImports(body) {
+  const names = /* @__PURE__ */ new Map();
+  for (const statement of body) {
+    if (statement.type !== "ImportDeclaration" || statement.source.value !== PACKAGE) continue;
+    for (const specifier of statement.specifiers) {
+      if (specifier.type !== "ImportSpecifier") continue;
+      const imported = specifier.imported.type === "Identifier" ? specifier.imported.name : specifier.imported.value;
+      names.set(specifier.local.name, imported);
+    }
+  }
+  return names;
+}
+function defaultExport(body) {
+  const exported = body.find((statement) => statement.type === "ExportDefaultDeclaration");
+  if (!exported || exported.type !== "ExportDefaultDeclaration") return void 0;
+  const declaration = exported.declaration;
+  if (declaration.type === "Identifier") {
+    for (const statement of body) {
+      if (statement.type !== "VariableDeclaration" || statement.kind !== "const") continue;
+      for (const declarator of statement.declarations) {
+        if (declarator.id.type === "Identifier" && declarator.id.name === declaration.name && declarator.init) {
+          return unwrap(declarator.init);
+        }
+      }
+    }
+    return void 0;
+  }
+  if (declaration.type.endsWith("Declaration")) return void 0;
+  return unwrap(declaration);
+}
+function keyName(property) {
+  if (property.type !== "ObjectProperty" || property.computed) return void 0;
+  if (property.key.type === "Identifier") return property.key.name;
+  if (property.key.type === "StringLiteral") return property.key.value;
+  return void 0;
+}
+function recognizeSchema(source) {
+  let body;
+  try {
+    body = parseModule(source).body;
+  } catch (error) {
+    return { ok: false, reason: `cannot be parsed: ${error instanceof Error ? error.message : String(error)}` };
+  }
+  const expression = defaultExport(body);
+  if (!expression || expression.type !== "CallExpression" || expression.callee.type !== "Identifier") {
+    return { ok: false, reason: "its default export is not a section(...) or extendSection(...) call" };
+  }
+  const call = expression;
+  const kind = packageImports(body).get(call.callee.name);
+  const object = kind === "section" ? call.arguments[0] : kind === "extendSection" ? call.arguments[1] : void 0;
+  const expected = kind === "section" ? 1 : 2;
+  if (kind !== "section" && kind !== "extendSection" || call.arguments.length !== expected || !object || object.type !== "ObjectExpression") {
+    return { ok: false, reason: `its default export is not section({ ... }) or extendSection(base, { ... }) from ${PACKAGE}` };
+  }
+  const fields = [];
+  for (const property of object.properties) {
+    const name = keyName(property);
+    if (name === void 0) return { ok: false, reason: "its fields contain a spread or a computed key" };
+    fields.push(name);
+  }
+  return {
+    ok: true,
+    value: {
+      kind,
+      fields,
+      start: object.start,
+      end: object.end,
+      properties: object.properties.map((property) => ({ start: property.start, end: property.end }))
+    }
+  };
+}
+const IDENTIFIER = /^[A-Za-z_$][\w$]*$/;
+function propertyKey(name) {
+  return IDENTIFIER.test(name) ? name : `'${name.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
+}
+function lineStart(source, offset) {
+  return source.lastIndexOf("\n", offset - 1) + 1;
+}
+function indentationAt(source, offset) {
+  return /^[ \t]*/.exec(source.slice(lineStart(source, offset)))[0];
+}
+function endOfLineContent(source, offset) {
+  let position = offset;
+  for (; ; ) {
+    while (source[position] === " " || source[position] === "	") position++;
+    if (source.startsWith("//", position)) {
+      const end = source.indexOf("\n", position);
+      return end === -1 ? source.length : end;
+    }
+    if (source.startsWith("/*", position)) {
+      const end = source.indexOf("*/", position + 2);
+      if (end === -1 || source.slice(position, end).includes("\n")) return position;
+      position = end + 2;
+      continue;
+    }
+    return position;
+  }
+}
+function addSchemaField(source, name, code) {
+  const recognized = recognizeSchema(source);
+  if (!recognized.ok) return recognized;
+  const { fields, properties, start: open, end } = recognized.value;
+  if (fields.includes(name)) return { ok: false, reason: `it already has a field "${name}"` };
+  const entry = `${propertyKey(name)}: ${code}`;
+  const close = end - 1;
+  if (!properties.length) {
+    const inner = source.slice(open + 1, close);
+    if (!inner.includes("\n")) {
+      const indent3 = indentationAt(source, open);
+      return { ok: true, value: `${source.slice(0, open)}{
+${indent3}  ${entry},
+${indent3}}${source.slice(close + 1)}` };
+    }
+    const closeLine = lineStart(source, close);
+    const indent2 = `${indentationAt(source, close)}  `;
+    if (source.slice(closeLine, close).trim() !== "") {
+      return { ok: true, value: `${source.slice(0, close)}
+${indent2}${entry},
+${source.slice(close)}` };
+    }
+    return { ok: true, value: `${source.slice(0, closeLine)}${indent2}${entry},
+${source.slice(closeLine)}` };
+  }
+  const first = properties[0];
+  const last = properties[properties.length - 1];
+  const multiline = source.slice(open, close).includes("\n") && source.slice(lineStart(source, first.start), first.start).trim() === "";
+  let afterLast = last.end;
+  while (source[afterLast] === " " || source[afterLast] === "	") afterLast++;
+  const comma = source[afterLast] === ",";
+  if (!multiline) {
+    return { ok: true, value: `${source.slice(0, last.end)}, ${entry}${source.slice(last.end)}` };
+  }
+  const indent = indentationAt(source, first.start);
+  const insertAt = endOfLineContent(source, comma ? afterLast + 1 : last.end);
+  const head = comma ? source.slice(0, insertAt) : `${source.slice(0, last.end)},${source.slice(last.end, insertAt)}`;
+  return { ok: true, value: `${head}
+${indent}${entry}${comma ? "," : ""}${source.slice(insertAt)}` };
+}
+function ensurePackageImports(source, names) {
+  let body;
+  try {
+    body = parseModule(source).body;
+  } catch (error) {
+    return { ok: false, reason: `cannot be parsed: ${error instanceof Error ? error.message : String(error)}` };
+  }
+  const imported = packageImports(body);
+  const local = new Set(imported.keys());
+  const missing = names.filter((name) => !local.has(name));
+  if (!missing.length) return { ok: true, value: source };
+  const declaration = body.find((statement) => statement.type === "ImportDeclaration" && statement.source.value === PACKAGE && statement.importKind !== "type" && statement.specifiers.some((specifier) => specifier.type === "ImportSpecifier"));
+  if (declaration) {
+    const specifiers = declaration.specifiers.filter((specifier) => specifier.type === "ImportSpecifier");
+    const at2 = specifiers[specifiers.length - 1].end;
+    return { ok: true, value: `${source.slice(0, at2)}, ${missing.join(", ")}${source.slice(at2)}` };
+  }
+  const imports = body.filter((statement) => statement.type === "ImportDeclaration");
+  const line = `import { ${missing.join(", ")} } from '${PACKAGE}'
+`;
+  if (!imports.length) return { ok: true, value: line + source };
+  const at = imports[imports.length - 1].end;
+  const end = source.indexOf("\n", at);
+  const position = end === -1 ? source.length : end + 1;
+  return { ok: true, value: `${source.slice(0, position)}${end === -1 ? "\n" : ""}${line}${source.slice(position)}` };
+}
+
+export { addSchemaField as a, ensurePackageImports as e, propertyKey as p };