@charcuterie/ui 2.18.0 → 3.1.0

package/dist/DatePicker/plainDate.d.ts

@@ -0,0 +1,167 @@
+/**
+ * A calendar date, and deliberately not an instant.
+ *
+ * ### The bug this file exists to make impossible
+ *
+ * A due date is not a moment. "This is due on the 19th" is true in
+ * Denver and true in Tokyo, and it does not become the 18th because
+ * a laptop crossed a meridian. The classic date-picker defect is
+ * that the value is a `Date` — which is an instant, a count of
+ * milliseconds — and every read of it goes through the *browser's*
+ * timezone. Pick the 19th at 23:30 in Denver, store
+ * `new Date("2026-08-19").toISOString()`, and the server, the next
+ * device, and the same device after a flight all disagree about
+ * which day you meant. It is a one-day error, it only appears near
+ * midnight or after travel, and it is invisible in every test
+ * written at noon.
+ *
+ * So the value here is a **plain date**: a year, a month, and a day,
+ * with no time, no offset, and no zone. It is stored as an ISO
+ * `YYYY-MM-DD` string — which is exactly `<input type="date">`'s own
+ * `value` format, so a consumer can move between this component and
+ * the native control without a migration.
+ *
+ * ### There is no `Date` arithmetic in here at all
+ *
+ * Not "carefully-written `Date` arithmetic" — none. Every operation
+ * below is integer maths on a **day number**: the count of days
+ * since 1970-01-01, computed with Howard Hinnant's `days_from_civil`
+ * / `civil_from_days` (public domain, the algorithm C++20's
+ * `<chrono>` and Rust's `chrono` both use). Adding a day is `+ 1`.
+ * That is a proleptic Gregorian calendar with no DST, no leap
+ * seconds, and no zone, which is what a calendar date actually is.
+ *
+ * A `Date` appears in exactly two places, both of them named and
+ * both of them fenced:
+ *
+ *  - `getLocalPlainDate`, which is the **one** conversion from an
+ *    instant to a calendar date, and which requires you to say
+ *    which zone's calendar you mean.
+ *  - `formatPlainDate` and its callers, which hand `Intl` a date
+ *    built at UTC midnight and format it with `timeZone: "UTC"`, so
+ *    the formatter cannot shift the day either.
+ *
+ * `plainDate.test.ts` re-runs the whole suite under four `TZ`
+ * values, including UTC+14 and UTC-11, and asserts every answer is
+ * byte-identical.
+ *
+ * ### Why not `Temporal`
+ *
+ * `Temporal.PlainDate` is this type, done properly, and it is
+ * available in the Node this repo builds on. It is not available in
+ * every browser a published package has to run in, and the polyfill
+ * is ~50 KB gz — an order of magnitude more than this entire
+ * component. The functions below are the ~80 lines of it a date
+ * picker needs. When `Temporal` is baseline, this file becomes a
+ * thin adapter and the public API — ISO strings — does not change,
+ * which is the reason the API is ISO strings.
+ */
+/** Year, month (1-12), day (1-31). No time, no zone. */
+export type PlainDate = {
+    day: number;
+    month: number;
+    year: number;
+};
+/**
+ * A start and an end, either of which may be absent — because a
+ * half-picked range is a real state a user spends time in, not an
+ * error. `start` with a null `end` is "I have clicked once".
+ */
+export type DateRange = {
+    end: null | string;
+    start: null | string;
+};
+export declare const getIsLeapYear: (year: number) => boolean;
+export declare const getDaysInMonth: (year: number, month: number) => number;
+export declare const getIsValidPlainDate: ({ day, month, year, }: PlainDate) => boolean;
+/**
+ * Days since 1970-01-01, by Hinnant's `days_from_civil`.
+ *
+ * Every other operation in this file is expressed through this and
+ * its inverse, which is why "add a month, then add 40 days, then
+ * ask what weekday it is" cannot drift: there is one representation
+ * and it is an integer.
+ */
+export declare const getDayNumber: ({ day, month, year, }: PlainDate) => number;
+/** The inverse — Hinnant's `civil_from_days`. */
+export declare const getPlainDateFromDayNumber: (dayNumber: number) => PlainDate;
+export declare const addDays: (date: PlainDate, days: number) => PlainDate;
+/**
+ * Month arithmetic clamps the day rather than overflowing, which is
+ * the answer every calendar app gives and the one `Date` does not:
+ * `new Date(2026, 0, 31)` plus a month is **3 March**, because 31
+ * February rolls forward. One month after 31 January is 28
+ * February.
+ */
+export declare const addMonths: (date: PlainDate, months: number) => PlainDate;
+export declare const comparePlainDates: (first: PlainDate, second: PlainDate) => number;
+export declare const getIsSameDay: (first: PlainDate, second: PlainDate) => boolean;
+/**
+ * Whole days from `from` to `to`. Docket's staleness threshold is
+ * counted in days, and this is the subtraction that counts it —
+ * with no hour-of-day and no DST to make "14 days" occasionally mean
+ * 13.958.
+ */
+export declare const getDaysBetween: (from: PlainDate, to: PlainDate) => number;
+export declare const clampPlainDate: (date: PlainDate, minimum?: PlainDate, maximum?: PlainDate) => PlainDate;
+export declare const getIsWithinRange: (date: PlainDate, minimum?: PlainDate, maximum?: PlainDate) => boolean;
+/**
+ * 0 is Sunday, 6 is Saturday — the numbering `Intl`'s `weekday`
+ * option and `Date.prototype.getDay` both use, so the two never
+ * need reconciling at a call site.
+ *
+ * Day number 0 (1970-01-01) was a Thursday, which is the `+ 4`.
+ */
+export declare const getWeekday: (date: PlainDate) => number;
+export declare const toIsoDate: (date: PlainDate) => string;
+/**
+ * `null` rather than a throw, and `null` rather than a "best
+ * effort" date. A string that is not a calendar date has no nearest
+ * calendar date, and inventing one is the silent-guess failure this
+ * component is built to avoid.
+ */
+export declare const parseIsoDate: (isoDate: null | string | undefined) => null | PlainDate;
+export type PlainDateFormatOptions = Intl.DateTimeFormatOptions & {
+    locale?: string;
+};
+/**
+ * `timeZone: "UTC"` is forced, and it is not configurable.
+ *
+ * The instant above is UTC midnight, so formatting it in any other
+ * zone renders the previous or the next day — which is the same
+ * one-day error as storing an instant, arriving through the display
+ * layer instead. There is no legitimate reason to format a calendar
+ * date in a zone: the date *is* the answer.
+ */
+export declare const formatPlainDate: (date: PlainDate, { locale, ...options }?: PlainDateFormatOptions) => string;
+/**
+ * The one instant-to-calendar-date conversion in the library, and it
+ * makes you name the zone.
+ *
+ * Defaulting `timeZone` to the device's own resolved zone is right
+ * for "what is today on this screen"; passing one explicitly is
+ * right for "what is today for this household". Either way the
+ * question is asked out loud, which is the difference between this
+ * and `new Date().toISOString().slice(0, 10)` — a line that appears
+ * in three of the fleet's repos and is wrong for everybody west of
+ * Greenwich after 17:00.
+ */
+export declare const getLocalPlainDate: (now: Date, timeZone?: string) => PlainDate;
+export declare const getFirstDayOfWeek: (locale?: string) => number;
+/**
+ * The seven weekday names, rotated so index 0 is the locale's own
+ * first day. A fixed sample week is formatted rather than a
+ * hand-written table, so every locale the browser knows is covered
+ * and nothing here needs translating.
+ */
+export declare const getWeekdayNames: ({ firstDayOfWeek, locale, weekday, }: {
+    firstDayOfWeek: number;
+    locale?: string;
+    weekday: "long" | "narrow" | "short";
+}) => string[];
+/** January-first month names, for the parser and the header. */
+export declare const getMonthNames: ({ locale, month, }: {
+    locale?: string;
+    month: "long" | "short";
+}) => string[];
+//# sourceMappingURL=plainDate.d.ts.map

package/dist/DatePicker/plainDate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plainDate.d.ts","sourceRoot":"","sources":["../../src/DatePicker/plainDate.ts"],"names":[],"mappings":"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"}

package/dist/DatePicker/plainDate.js

@@ -0,0 +1,272 @@
+/**
+ * A calendar date, and deliberately not an instant.
+ *
+ * ### The bug this file exists to make impossible
+ *
+ * A due date is not a moment. "This is due on the 19th" is true in
+ * Denver and true in Tokyo, and it does not become the 18th because
+ * a laptop crossed a meridian. The classic date-picker defect is
+ * that the value is a `Date` — which is an instant, a count of
+ * milliseconds — and every read of it goes through the *browser's*
+ * timezone. Pick the 19th at 23:30 in Denver, store
+ * `new Date("2026-08-19").toISOString()`, and the server, the next
+ * device, and the same device after a flight all disagree about
+ * which day you meant. It is a one-day error, it only appears near
+ * midnight or after travel, and it is invisible in every test
+ * written at noon.
+ *
+ * So the value here is a **plain date**: a year, a month, and a day,
+ * with no time, no offset, and no zone. It is stored as an ISO
+ * `YYYY-MM-DD` string — which is exactly `<input type="date">`'s own
+ * `value` format, so a consumer can move between this component and
+ * the native control without a migration.
+ *
+ * ### There is no `Date` arithmetic in here at all
+ *
+ * Not "carefully-written `Date` arithmetic" — none. Every operation
+ * below is integer maths on a **day number**: the count of days
+ * since 1970-01-01, computed with Howard Hinnant's `days_from_civil`
+ * / `civil_from_days` (public domain, the algorithm C++20's
+ * `<chrono>` and Rust's `chrono` both use). Adding a day is `+ 1`.
+ * That is a proleptic Gregorian calendar with no DST, no leap
+ * seconds, and no zone, which is what a calendar date actually is.
+ *
+ * A `Date` appears in exactly two places, both of them named and
+ * both of them fenced:
+ *
+ *  - `getLocalPlainDate`, which is the **one** conversion from an
+ *    instant to a calendar date, and which requires you to say
+ *    which zone's calendar you mean.
+ *  - `formatPlainDate` and its callers, which hand `Intl` a date
+ *    built at UTC midnight and format it with `timeZone: "UTC"`, so
+ *    the formatter cannot shift the day either.
+ *
+ * `plainDate.test.ts` re-runs the whole suite under four `TZ`
+ * values, including UTC+14 and UTC-11, and asserts every answer is
+ * byte-identical.
+ *
+ * ### Why not `Temporal`
+ *
+ * `Temporal.PlainDate` is this type, done properly, and it is
+ * available in the Node this repo builds on. It is not available in
+ * every browser a published package has to run in, and the polyfill
+ * is ~50 KB gz — an order of magnitude more than this entire
+ * component. The functions below are the ~80 lines of it a date
+ * picker needs. When `Temporal` is baseline, this file becomes a
+ * thin adapter and the public API — ISO strings — does not change,
+ * which is the reason the API is ISO strings.
+ */
+const MONTH_LENGTHS = [
+    31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31,
+];
+const ISO_DATE_PATTERN = /^(\d{4})-(\d{2})-(\d{2})$/;
+export const getIsLeapYear = (year) => (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
+export const getDaysInMonth = (year, month) => month === 2 && getIsLeapYear(year)
+    ? 29
+    : (MONTH_LENGTHS[month - 1] ?? 30);
+export const getIsValidPlainDate = ({ day, month, year, }) => Number.isInteger(year) &&
+    Number.isInteger(month) &&
+    Number.isInteger(day) &&
+    year >= 1 &&
+    year <= 9999 &&
+    month >= 1 &&
+    month <= 12 &&
+    day >= 1 &&
+    day <= getDaysInMonth(year, month);
+/**
+ * Days since 1970-01-01, by Hinnant's `days_from_civil`.
+ *
+ * Every other operation in this file is expressed through this and
+ * its inverse, which is why "add a month, then add 40 days, then
+ * ask what weekday it is" cannot drift: there is one representation
+ * and it is an integer.
+ */
+export const getDayNumber = ({ day, month, year, }) => {
+    const shiftedYear = year - (month <= 2 ? 1 : 0);
+    const era = Math.floor(shiftedYear / 400);
+    const yearOfEra = shiftedYear - era * 400;
+    const dayOfYear = Math.floor((153 * (month + (month > 2 ? -3 : 9)) + 2) / 5) +
+        day -
+        1;
+    const dayOfEra = yearOfEra * 365 +
+        Math.floor(yearOfEra / 4) -
+        Math.floor(yearOfEra / 100) +
+        dayOfYear;
+    return era * 146097 + dayOfEra - 719468;
+};
+/** The inverse — Hinnant's `civil_from_days`. */
+export const getPlainDateFromDayNumber = (dayNumber) => {
+    const shifted = dayNumber + 719468;
+    const era = Math.floor(shifted / 146097);
+    const dayOfEra = shifted - era * 146097;
+    const yearOfEra = Math.floor((dayOfEra -
+        Math.floor(dayOfEra / 1460) +
+        Math.floor(dayOfEra / 36524) -
+        Math.floor(dayOfEra / 146096)) /
+        365);
+    const dayOfYear = dayOfEra -
+        (365 * yearOfEra +
+            Math.floor(yearOfEra / 4) -
+            Math.floor(yearOfEra / 100));
+    const monthPrime = Math.floor((5 * dayOfYear + 2) / 153);
+    const day = dayOfYear - Math.floor((153 * monthPrime + 2) / 5) + 1;
+    const month = monthPrime + (monthPrime < 10 ? 3 : -9);
+    return {
+        day,
+        month,
+        year: yearOfEra + era * 400 + (month <= 2 ? 1 : 0),
+    };
+};
+export const addDays = (date, days) => getPlainDateFromDayNumber(getDayNumber(date) + days);
+/**
+ * Month arithmetic clamps the day rather than overflowing, which is
+ * the answer every calendar app gives and the one `Date` does not:
+ * `new Date(2026, 0, 31)` plus a month is **3 March**, because 31
+ * February rolls forward. One month after 31 January is 28
+ * February.
+ */
+export const addMonths = (date, months) => {
+    const monthIndex = date.year * 12 + (date.month - 1) + months;
+    const year = Math.floor(monthIndex / 12);
+    const month = monthIndex - year * 12 + 1;
+    return {
+        day: Math.min(date.day, getDaysInMonth(year, month)),
+        month,
+        year,
+    };
+};
+export const comparePlainDates = (first, second) => getDayNumber(first) - getDayNumber(second);
+export const getIsSameDay = (first, second) => comparePlainDates(first, second) === 0;
+/**
+ * Whole days from `from` to `to`. Docket's staleness threshold is
+ * counted in days, and this is the subtraction that counts it —
+ * with no hour-of-day and no DST to make "14 days" occasionally mean
+ * 13.958.
+ */
+export const getDaysBetween = (from, to) => getDayNumber(to) - getDayNumber(from);
+export const clampPlainDate = (date, minimum, maximum) => {
+    if (minimum && comparePlainDates(date, minimum) < 0) {
+        return minimum;
+    }
+    if (maximum && comparePlainDates(date, maximum) > 0) {
+        return maximum;
+    }
+    return date;
+};
+export const getIsWithinRange = (date, minimum, maximum) => (!minimum || comparePlainDates(date, minimum) >= 0) &&
+    (!maximum || comparePlainDates(date, maximum) <= 0);
+/**
+ * 0 is Sunday, 6 is Saturday — the numbering `Intl`'s `weekday`
+ * option and `Date.prototype.getDay` both use, so the two never
+ * need reconciling at a call site.
+ *
+ * Day number 0 (1970-01-01) was a Thursday, which is the `+ 4`.
+ */
+export const getWeekday = (date) => {
+    const dayNumber = getDayNumber(date);
+    return ((((dayNumber % 7) + 7) % 7) + 4) % 7;
+};
+const pad = (value, length) => String(value).padStart(length, "0");
+export const toIsoDate = (date) => `${pad(date.year, 4)}-${pad(date.month, 2)}-${pad(date.day, 2)}`;
+/**
+ * `null` rather than a throw, and `null` rather than a "best
+ * effort" date. A string that is not a calendar date has no nearest
+ * calendar date, and inventing one is the silent-guess failure this
+ * component is built to avoid.
+ */
+export const parseIsoDate = (isoDate) => {
+    if (!isoDate) {
+        return null;
+    }
+    const match = ISO_DATE_PATTERN.exec(isoDate);
+    if (!match) {
+        return null;
+    }
+    const date = {
+        day: Number(match[3]),
+        month: Number(match[2]),
+        year: Number(match[1]),
+    };
+    return getIsValidPlainDate(date) ? date : null;
+};
+/**
+ * A `Date` pinned at UTC midnight, for `Intl` and for nothing else.
+ *
+ * `Date.UTC` is not used, because it maps years 0-99 onto 1900-1999
+ * — a two-digit year silently becomes the twentieth century inside
+ * the formatter, which is a bug the *parser* takes an explicit
+ * position on and the formatter has no business re-deciding.
+ */
+const toUtcInstant = (date) => {
+    const instant = new Date(0);
+    instant.setUTCFullYear(date.year, date.month - 1, date.day);
+    instant.setUTCHours(0, 0, 0, 0);
+    return instant;
+};
+/**
+ * `timeZone: "UTC"` is forced, and it is not configurable.
+ *
+ * The instant above is UTC midnight, so formatting it in any other
+ * zone renders the previous or the next day — which is the same
+ * one-day error as storing an instant, arriving through the display
+ * layer instead. There is no legitimate reason to format a calendar
+ * date in a zone: the date *is* the answer.
+ */
+export const formatPlainDate = (date, { locale, ...options } = {}) => new Intl.DateTimeFormat(locale, {
+    ...options,
+    timeZone: "UTC",
+}).format(toUtcInstant(date));
+/**
+ * The one instant-to-calendar-date conversion in the library, and it
+ * makes you name the zone.
+ *
+ * Defaulting `timeZone` to the device's own resolved zone is right
+ * for "what is today on this screen"; passing one explicitly is
+ * right for "what is today for this household". Either way the
+ * question is asked out loud, which is the difference between this
+ * and `new Date().toISOString().slice(0, 10)` — a line that appears
+ * in three of the fleet's repos and is wrong for everybody west of
+ * Greenwich after 17:00.
+ */
+export const getLocalPlainDate = (now, timeZone) => {
+    const parts = new Intl.DateTimeFormat("en-US", {
+        day: "2-digit",
+        month: "2-digit",
+        timeZone,
+        year: "numeric",
+    }).formatToParts(now);
+    const read = (type) => Number(parts.find((part) => part.type === type)?.value ??
+        "0");
+    return {
+        day: read("day"),
+        month: read("month"),
+        year: read("year"),
+    };
+};
+export const getFirstDayOfWeek = (locale) => {
+    const resolved = new Intl.Locale(locale ??
+        new Intl.DateTimeFormat().resolvedOptions().locale);
+    const firstDay = resolved.getWeekInfo?.().firstDay ??
+        resolved.weekInfo?.firstDay;
+    // `getWeekInfo` numbers Monday 1 through Sunday 7; this file
+    // numbers Sunday 0 through Saturday 6.
+    return firstDay === undefined ? 0 : firstDay % 7;
+};
+/**
+ * The seven weekday names, rotated so index 0 is the locale's own
+ * first day. A fixed sample week is formatted rather than a
+ * hand-written table, so every locale the browser knows is covered
+ * and nothing here needs translating.
+ */
+export const getWeekdayNames = ({ firstDayOfWeek, locale, weekday, }) => {
+    // 2026-08-16 is a Sunday, so `+ index` walks Sunday to Saturday.
+    const sundayDayNumber = getDayNumber({
+        day: 16,
+        month: 8,
+        year: 2026,
+    });
+    return Array.from({ length: 7 }, (_unused, index) => formatPlainDate(getPlainDateFromDayNumber(sundayDayNumber + ((firstDayOfWeek + index) % 7)), { locale, weekday }));
+};
+/** January-first month names, for the parser and the header. */
+export const getMonthNames = ({ locale, month, }) => Array.from({ length: 12 }, (_unused, index) => formatPlainDate({ day: 1, month: index + 1, year: 2026 }, { locale, month }));
+//# sourceMappingURL=plainDate.js.map

package/dist/DatePicker/plainDate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plainDate.js","sourceRoot":"","sources":["../../src/DatePicker/plainDate.ts"],"names":[],"mappings":"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"}

package/dist/MarkdownEditor/MarkdownEditor.d.ts

@@ -0,0 +1,147 @@
+import type { ReactNode } from "react";
+import type { SlotProps } from "../slotProps.ts";
+export type MarkdownImageUpload = {
+    /** Alt text. Defaults to the file's name when omitted. */
+    alt?: string;
+    /** Where the image now lives. Inserted verbatim. */
+    url: string;
+};
+/**
+ * The toolbar's glyphs, by action.
+ *
+ * **No default, and none shipped** — this package ships no icons,
+ * and a `⋯`/`▨` default renders as nothing where the font lacks it
+ * ([decision](../../../../docs/decisions/2026-07-29-ship-no-icons-and-no-symbol-glyphs.md)).
+ * With no icons the toolbar is nine word buttons, which works
+ * everywhere and collapses into the overflow menu early; an app
+ * that brings lucide gets a compact bar and keeps the words as the
+ * accessible names.
+ */
+export type MarkdownEditorIcons = Partial<Record<"bold" | "bulletedList" | "code" | "heading" | "italic" | "link" | "numberedList" | "quote" | "taskList", ReactNode>>;
+export type MarkdownEditorProps = SlotProps & {
+    className?: string;
+    /**
+     * **Initial** only. This control is uncontrolled, and the long
+     * reason is in the doc comment below — it is the whole design.
+     */
+    defaultValue?: string;
+    /** See `MarkdownEditorIcons`. */
+    icons?: MarkdownEditorIcons;
+    isDisabled?: boolean;
+    isReadOnly?: boolean;
+    /**
+     * The accessible name, as `aria-label`. Omit it inside a `Field`,
+     * which supplies a real `<label htmlFor>` — same contract as
+     * `Select`.
+     */
+    label?: string;
+    onChange?: (value: string) => void;
+    /**
+     * A failed upload, after the placeholder has been taken back out
+     * of the text. Pair it with a `Toast`; this component does not
+     * own one.
+     */
+    onUploadError?: (file: File, error: unknown) => void;
+    /**
+     * Paste or drop an image and this runs. **The component does not
+     * own storage** — it hands you a `File`, you put it somewhere,
+     * and the URL you return is inserted at the caret as
+     * `![alt](url)`. Docket keeps its own blob storage precisely so
+     * the URL stays stable and theirs.
+     *
+     * Omit it and image paste is simply not offered: a `<textarea>`
+     * ignores a pasted image on its own, which is the correct
+     * fallback rather than a broken one.
+     */
+    onUploadImage?: (file: File) => Promise<MarkdownImageUpload>;
+    placeholder?: string;
+    /** The editing surface's accessible name in the toolbar's label. */
+    toolbarLabel?: string;
+};
+/**
+ * A live hybrid markdown editor whose stored value is markdown and
+ * only ever markdown.
+ *
+ * Docket asked for this one and the requirement is unusually sharp,
+ * because the tracker it replaces destroyed data by storing HTML in
+ * a field it later tried to read back as text. So the constraint
+ * here is not "prefer markdown" — it is that **an HTML tag must not
+ * be able to reach the stored string**, and the design is chosen to
+ * make that mechanical rather than policed:
+ *
+ *  - the editing surface is a `<textarea>`, which takes
+ *    `text/plain` off the clipboard and nothing else. Copy a
+ *    styled paragraph out of a browser and the `text/html` flavour
+ *    is simply not read;
+ *  - every command in `markdownCommands.ts` returns markdown, and
+ *    there is no serialiser anywhere in the component;
+ *  - the painted layer emits `{ kind, text }` spans that React
+ *    renders as **text nodes**. No `innerHTML`, no sanitiser, and
+ *    nothing to get wrong — a `<script>` in the source is four
+ *    coloured characters on screen.
+ *
+ * `MarkdownEditor.test.tsx` round-trips a value full of the
+ * characters that tempt escaping and asserts no tag ever appears.
+ *
+ * ## Why a `<textarea>` and not an editor core
+ *
+ * Charcuterie is published, so a dependency here is a permanent
+ * cost to every consumer of the package — measured, for a markdown
+ * setup: CodeMirror 6 at 176 KB gzipped, Lexical at 148 KB, TipTap
+ * at 238 KB. This component adds **nothing**. The full argument,
+ * with the numbers and with what the choice gives up, is
+ * `docs/decisions/2026-08-19-the-markdown-editor-is-a-textarea-with-a-painted-layer.md`.
+ *
+ * The accessibility half of that argument is worth repeating here,
+ * because it is the half that is hard to buy back later. A
+ * `<textarea>` arrives with caret movement, word-wise selection,
+ * `Home`/`End`, IME composition, spellcheck, autocorrect, the
+ * platform's own undo stack, `role="textbox"` and
+ * `aria-multiline="true"` — all of it, in every browser, tested by
+ * the vendors. A `contenteditable` starts with none of those and
+ * re-earns each one, and the ones it never fully re-earns are IME
+ * and undo. This library's central claim is that an agent and a
+ * keyboard can drive every component; starting from the platform's
+ * own text control is the cheapest way to keep it.
+ *
+ * ## It is uncontrolled, and that is not a shortcut
+ *
+ * `defaultValue` in, `onChange` out — the same contract as `Select`
+ * ([decision](../../../../docs/decisions/2026-07-31-select-is-uncontrolled-because-the-platform-owns-the-value.md)),
+ * and here it protects something specific. A controlled React
+ * `<textarea>` round-trips every keystroke through render, and any
+ * programmatic `value` assignment **wipes the browser's undo
+ * stack**: Ctrl+Z after a toolbar click then skips the paragraph
+ * you typed before it, or does nothing at all.
+ *
+ * So the textarea is never handed a `value`. Its text is mirrored
+ * into state for *painting* only, and every programmatic edit — a
+ * toolbar action, a shortcut, an image insertion — is applied as a
+ * range replacement through `document.execCommand("insertText")`,
+ * which is deprecated, is the only API that appends to the native
+ * undo stack, and is exactly why `getMinimalEdit` exists.
+ *
+ * A consumer that must swap the whole document — Docket opening a
+ * different task — remounts with a `key`. That is one line, and it
+ * is honest about the fact that the old undo history belonged to
+ * the old document.
+ *
+ * ## Composition, and the one component that did not fit
+ *
+ * The toolbar is this package's `Toolbar`, so the row collapses
+ * into a menu **by measurement** rather than at a breakpoint —
+ * which is what the Narrow View actually needs, since a lane in a
+ * three-up board is narrow on a 4K display. `Field` wraps it
+ * through `SlotProps`, so a label, a description and an error wire
+ * themselves to the textarea.
+ *
+ * `FileDropZone` does **not** wrap it, and that is the interesting
+ * one. That component is a `<label>` around a file input covering
+ * its whole area — correct for "drop a disc image here", and wrong
+ * for a text surface, where the drop has to land *at a character
+ * offset* and the area has to keep taking clicks as caret
+ * placement. So the editor handles its own drop, and `FileDropZone`
+ * stays the right answer for the attachment list beside it.
+ */
+export declare const MarkdownEditor: ({ className, defaultValue, icons, isDisabled, isReadOnly, label, onChange, onUploadError, onUploadImage, placeholder, toolbarLabel, ...receivedSlotProps }: MarkdownEditorProps) => ReactNode;
+//# sourceMappingURL=MarkdownEditor.d.ts.map

package/dist/MarkdownEditor/MarkdownEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownEditor.d.ts","sourceRoot":"","sources":["../../src/MarkdownEditor/MarkdownEditor.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAIV,SAAS,EACV,MAAM,OAAO,CAAA;AAGd,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAwBhD,MAAM,MAAM,mBAAmB,GAAG;IAChC,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,CACvC,MAAM,CACF,MAAM,GACN,cAAc,GACd,MAAM,GACN,SAAS,GACT,QAAQ,GACR,MAAM,GACN,cAAc,GACd,OAAO,GACP,UAAU,EACZ,SAAS,CACV,CACF,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iCAAiC;IACjC,KAAK,CAAC,EAAE,mBAAmB,CAAA;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IACpD;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,CACd,IAAI,EAAE,IAAI,KACP,OAAO,CAAC,mBAAmB,CAAC,CAAA;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AA+DD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AACH,eAAO,MAAM,cAAc,GAAI,4JAa5B,mBAAmB,KAAG,SAilBxB,CAAA"}