@instructure/platform-modules 0.3.0 → 1.0.0

package/dist/components/ModulesList.stories.d.ts

@@ -1,166 +1,49 @@
 import { Meta, StoryObj } from '@storybook/react';
 import { ReactElement } from 'react';
 import { InMemoryFixture, ItemsMode } from '../index';
-import { ModulesFilterId } from './labels';
-/**
- * The Modules Foundation design over the real data layer.
- *
- * Harness: `createInMemoryAdapter` over a fixture, a
- * `QueryClient` whose identity survives a re-render, and the adapter's
- * `onRequest` feeding a live counter. Nothing is mocked — the adapter is a real
- * implementation of the contract, including declining to inline a module above
- * `INLINE_ITEM_LIMIT` as Canvas REST does — so the request count in the dev
- * banner is the genuine cost of what is on screen.
- *
- * The counter is the most useful thing here. Switch `itemsMode` to `onDemand`,
- * hit "Expand all" on the large course, and watch what the design costs.
- */
 declare const FIXTURES: Record<string, () => InMemoryFixture>;
-/**
- * The four scales, as either audience.
- *
- * The teacher shape comes from `buildFixture`'s own `view` option rather than
- * being derived here by stripping fields. That matters for what the story shows:
- * a teacher sees unpublished modules and items — which is the whole reason the
- * teacher view exists — and no progress, because Canvas resolves `progression`
- * to null for a viewer with no progression record. Deriving it by deletion used
- * to produce the one combination Canvas cannot: an unpublished module with a
- * progress bar beside it.
- */
+type ThemeName = 'light' | 'canvas-high-contrast';
 type ProgressMode = 'student' | 'teacher';
 interface ModulesListStoryProps {
     fixture: keyof typeof FIXTURES;
     itemsMode: ItemsMode;
     progressMode: ProgressMode;
-    initialFilter: ModulesFilterId;
-    /** Modules per `listModules` request. Canvas caps this at 100. */
+    initialFilter: string;
     pageSize: number;
-    /** Items per `listModuleItems` request. Canvas caps this at 100. */
     itemPageSize: number;
     itemConcurrency: number;
-    /** Expand these module ids on mount, so a story shows item rows without a click. */
     initialExpandedModuleIds: string[];
-    /**
-     * Which i18n bridge to render through.
-     *
-     * `none` is a host that supplies no catalog: every string comes from
-     * `locales/en.json`. `pseudo` is the standard pre-translation audit — every
-     * string is bracketed and padded, so an untranslated literal is visible on
-     * sight and a layout that cannot survive a longer language shows up before a
-     * translator is ever involved. `rebranded` and `partial` are host catalogs,
-     * and both are deliberately incomplete.
-     */
     i18n: 'none' | 'pseudo' | 'rebranded' | 'partial';
-    /** Clear it to render the catalog's `pageTitle` instead of a host-supplied name. */
+    timezone: 'none' | 'America/Denver' | 'America/Los_Angeles' | 'Australia/Sydney';
     courseName: string;
     navigation: 'none' | 'rewritten' | 'intercepted';
+    config: HostConfigName;
+    theme: ThemeName;
 }
-/**
- * Its own `QueryClient`, deliberately — the global preview decorator builds one
- * in its render body, and these stories are about cache behavior.
- */
+type HostConfigName = 'none' | 'itemTypes' | 'itemMeta' | 'filters';
 declare function ModulesListHarness(props: ModulesListStoryProps): ReactElement;
 declare const meta: Meta<typeof ModulesListHarness>;
 export default meta;
 type Story = StoryObj<typeof meta>;
-/**
- * The design, near enough: 5 modules × 8 items with module 1 open.
- *
- * `auto` resolves to `inline`, so opening any other module costs zero extra
- * requests — the counter in the dev banner stays put as you click around.
- */
 export declare const Default: Story;
-/**
- * 120 modules × 25 items. `auto` resolves to `onDemand` and first paint is a
- * single request no matter how big the course is.
- *
- * The point of this story is the button at the bottom: `hasNextPage` is true,
- * it says so, and the remaining 20 modules are one click away rather than gone.
- * Canvas Career shows 100 and says nothing.
- */
+export declare const HighContrast: Story;
 export declare const LargeCourse: Story;
-/**
- * 3 modules, the middle one 250 items, pinned to `inline` — the Canvas fallback
- * in miniature. Modules 1 and 3 come back with items attached; module 2 is over
- * `INLINE_ITEM_LIMIT` so the server omits its items and that *one module* falls
- * back to a per-module fetch, then pages 100 at a time. "Load more items" stays
- * on the card until all 250 are loaded.
- */
 export declare const FatModuleInlineFallback: Story;
-/** Every shape an item title can take: linked, new tab, sub-header, no url, long, locked. */
 export declare const ItemTitleLinks: Story;
-/** The same module with `getItemHref` rewriting each href the adapter supplied. */
+export declare const ItemRowVariants: Story;
 export declare const ItemTitleLinksRewritten: Story;
-/** `onItemClick` with `preventDefault()`, as a client-side router would. */
 export declare const ItemTitleLinksIntercepted: Story;
-/** No modules. The empty state. */
 export declare const EmptyCourse: Story;
-/**
- * Teacher / anonymous: `progress` is undefined on every module and `status` on
- * every item.
- *
- * The card renders no progress bar and no status pill, and nowhere does it say
- * "0%" — "we did not fetch progress" and "the student has done none of it" are
- * different facts. Every filter chip except "All" correctly matches nothing,
- * because a module-level filter has nothing to read.
- */
 export declare const TeacherViewNoProgress: Story;
-/** `progress.status === 'in_progress'`. */
 export declare const FilterInProgress: Story;
-/** `progress.status` is `all_submitted` or `all_graded`. */
 export declare const FilterComplete: Story;
-/**
- * `progress.latestDueAt` within 7 days of the injected "today" (2025-01-08).
- *
- * On the small fixture rather than the large one, deliberately: `latestDueAt` is
- * the *latest* due date in a module, and a 25-item module's latest date is
- * always months out, so the large course legitimately has nothing in a 7-day
- * window. A story that only ever showed the empty state would prove nothing
- * about the chip.
- */
 export declare const FilterDueThisWeek: Story;
-/** `progress.missingCount > 0`. */
 export declare const FilterMissing: Story;
-/**
- * Every module status and every item status on one screen.
- *
- * `courseSmall` is sized to `MODULE_STATUS_CYCLE.length` precisely so it can
- * show all six `ModuleStatus` values; expanding every module then shows every
- * `ModuleItemStatus` too, so a reviewer can check the whole pill mapping in one
- * screenshot. Note the mock's single green "All items complete" pill is split
- * here into "All items complete" (`all_submitted`) and "All items graded"
- * (`all_graded`), because the domain distinguishes them and the view should not
- * quietly collapse the two.
- */
 export declare const StatusCoverage: Story;
-/**
- * Every user-visible string, bracketed and padded.
- *
- * This is the story that makes the i18n seam reviewable rather than asserted: a
- * string rendering *without* `⟦ ⟧` never went through `t`. Padding to ~135%
- * approximates German, so it also shows whether the card header, the chip row
- * and the "Load more" button survive a longer language.
- *
- * The one deliberate exception is the dev diagnostics banner, which is developer
- * text and is documented as untranslated in `ModuleCard`.
- */
 export declare const PseudoLocalized: Story;
-/**
- * A host rebranding the page in its own language.
- *
- * Career calls the page a Learning Path and its modules units. That is a
- * catalog entry, not a config key — six entries here, and every string they do
- * not name still reads English from `locales/en.json`. Switch the `fixture`
- * control to `empty` to see the rebranded empty state.
- */
 export declare const HostRebrand: Story;
-/**
- * A deliberately incomplete translation.
- *
- * Four German keys against an English catalog: the filter row is translated
- * and everything else falls back rather than throwing or rendering blank. This
- * is the property that lets a host adopt the package before translating it, and
- * `locale` travels with the catalog so `Intl` dates match the words.
- */
 export declare const PartialCatalog: Story;
+export declare const ItemTypesCustomized: Story;
+export declare const FiltersCustomized: Story;
+export declare const ItemMetaCustomized: Story;
 //# sourceMappingURL=ModulesList.stories.d.ts.map

package/dist/components/ModulesList.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ModulesList.stories.d.ts","sourceRoot":"","sources":["../../src/components/ModulesList.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAEtD,OAAO,EAAE,KAAK,YAAY,EAAqB,MAAM,OAAO,CAAA;AAE5D,OAAO,EASL,KAAK,eAAe,EACpB,KAAK,SAAS,EAKf,MAAM,UAAU,CAAA;AACjB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAG/C;;;;;;;;;;;;GAYG;AAEH,QAAA,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,eAAe,CAMnD,CAAA;AAoBD;;;;;;;;;;GAUG;AAIH,KAAK,YAAY,GAAG,SAAS,GAAG,SAAS,CAAA;AAEzC,UAAU,qBAAqB;IAC7B,OAAO,EAAE,MAAM,OAAO,QAAQ,CAAA;IAC9B,SAAS,EAAE,SAAS,CAAA;IACpB,YAAY,EAAE,YAAY,CAAA;IAC1B,aAAa,EAAE,eAAe,CAAA;IAC9B,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAA;IAChB,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;IACvB,oFAAoF;IACpF,wBAAwB,EAAE,MAAM,EAAE,CAAA;IAClC;;;;;;;;;OASG;IACH,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAA;IACjD,oFAAoF;IACpF,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,aAAa,CAAA;CACjD;AAkJD;;;GAGG;AACH,iBAAS,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,GAAG,YAAY,CAetE;AAkBD,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,kBAAkB,CAiCzC,CAAA;AAED,eAAe,IAAI,CAAA;AACnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAA;AAElC;;;;;GAKG;AACH,eAAO,MAAM,OAAO,EAAE,KAErB,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,KAEzB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,EAAE,KAErC,CAAA;AAED,6FAA6F;AAC7F,eAAO,MAAM,cAAc,EAAE,KAE5B,CAAA;AAED,mFAAmF;AACnF,eAAO,MAAM,uBAAuB,EAAE,KAErC,CAAA;AAED,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB,EAAE,KAEvC,CAAA;AAED,mCAAmC;AACnC,eAAO,MAAM,WAAW,EAAE,KAEzB,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,EAAE,KAEnC,CAAA;AASD,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB,EAAE,KAE9B,CAAA;AAED,4DAA4D;AAC5D,eAAO,MAAM,cAAc,EAAE,KAE5B,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAE/B,CAAA;AAED,mCAAmC;AACnC,eAAO,MAAM,aAAa,EAAE,KAE3B,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,EAAE,KAM5B,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,EAAE,KAO7B,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,KAQzB,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,KAO5B,CAAA"}
+{"version":3,"file":"ModulesList.stories.d.ts","sourceRoot":"","sources":["../../src/components/ModulesList.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAKtD,OAAO,EAAE,KAAK,YAAY,EAAqB,MAAM,OAAO,CAAA;AAE5D,OAAO,EAaL,KAAK,eAAe,EACpB,KAAK,SAAS,EAUf,MAAM,UAAU,CAAA;AAGjB,QAAA,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,eAAe,CAQnD,CAAA;AAED,KAAK,SAAS,GAAG,OAAO,GAAG,sBAAsB,CAAA;AAmBjD,KAAK,YAAY,GAAG,SAAS,GAAG,SAAS,CAAA;AAEzC,UAAU,qBAAqB;IAC7B,OAAO,EAAE,MAAM,OAAO,QAAQ,CAAA;IAC9B,SAAS,EAAE,SAAS,CAAA;IACpB,YAAY,EAAE,YAAY,CAAA;IAC1B,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;IACvB,wBAAwB,EAAE,MAAM,EAAE,CAAA;IAClC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAA;IACjD,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,qBAAqB,GAAG,kBAAkB,CAAA;IAChF,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,aAAa,CAAA;IAChD,MAAM,EAAE,cAAc,CAAA;IACtB,KAAK,EAAE,SAAS,CAAA;CACjB;AAiDD,KAAK,cAAc,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAA;AAsKnE,iBAAS,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,GAAG,YAAY,CAetE;AAkBD,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,kBAAkB,CAiDzC,CAAA;AAED,eAAe,IAAI,CAAA;AACnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAA;AAElC,eAAO,MAAM,OAAO,EAAE,KAErB,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,KAE1B,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,KAEzB,CAAA;AAED,eAAO,MAAM,uBAAuB,EAAE,KAErC,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,KAE5B,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,KAE7B,CAAA;AAED,eAAO,MAAM,uBAAuB,EAAE,KAErC,CAAA;AAED,eAAO,MAAM,yBAAyB,EAAE,KAEvC,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,KAEzB,CAAA;AAED,eAAO,MAAM,qBAAqB,EAAE,KAEnC,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KAE9B,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,KAE5B,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,KAE/B,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,KAE3B,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,KAM5B,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,KAO7B,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,KAQzB,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,KAO5B,CAAA;AAED,eAAO,MAAM,mBAAmB,EAAE,KAEjC,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,KAE/B,CAAA;AAED,eAAO,MAAM,kBAAkB,EAAE,KAOhC,CAAA"}

package/dist/components/StatusPill.d.ts

@@ -1,18 +1,16 @@
 import { ReactElement } from 'react';
 import { TranslateFunction } from '../i18n';
 import { ModuleItemStatus, ModuleStatus } from '../types';
-/** Exhaustive: a new `ModuleStatus` is a compile error until it has a label. */
-export declare function moduleStatusLabel(t: TranslateFunction, status: ModuleStatus): string;
-/** @see moduleStatusLabel */
+export declare function moduleStatusLabel(t: TranslateFunction, status: ModuleStatus, missingCount: number, incompleteCount: number): string;
 export declare function moduleItemStatusLabel(t: TranslateFunction, status: ModuleItemStatus): string;
 export interface ModuleStatusPillProps {
     status: ModuleStatus;
+    missingCount: number;
+    incompleteCount: number;
 }
-/** @see ModuleStatusPillProps */
-export declare function ModuleStatusPill({ status }: ModuleStatusPillProps): ReactElement;
+export declare function ModuleStatusPill({ status, missingCount, incompleteCount, }: ModuleStatusPillProps): ReactElement;
 export interface ModuleItemStatusPillProps {
     status: ModuleItemStatus;
 }
-/** @see ModuleItemStatusPillProps */
 export declare function ModuleItemStatusPill({ status }: ModuleItemStatusPillProps): ReactElement;
 //# sourceMappingURL=StatusPill.d.ts.map

package/dist/components/StatusPill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StatusPill.d.ts","sourceRoot":"","sources":["../../src/components/StatusPill.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AACzC,OAAO,EAAE,KAAK,iBAAiB,EAAkB,MAAM,SAAS,CAAA;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AA4C9D,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAepF;AAED,6BAA6B;AAC7B,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAe5F;AAUD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,YAAY,CAAA;CACrB;AAED,iCAAiC;AACjC,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,EAAE,qBAAqB,GAAG,YAAY,CAOhF;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,gBAAgB,CAAA;CACzB;AAED,qCAAqC;AACrC,wBAAgB,oBAAoB,CAAC,EAAE,MAAM,EAAE,EAAE,yBAAyB,GAAG,YAAY,CAOxF"}
+{"version":3,"file":"StatusPill.d.ts","sourceRoot":"","sources":["../../src/components/StatusPill.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,OAAO,CAAA;AACzD,OAAO,EAAE,KAAK,iBAAiB,EAAkB,MAAM,SAAS,CAAA;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAuC9D,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,iBAAiB,EACpB,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,GACtB,MAAM,CAoBR;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAmB5F;AAeD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,YAAY,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,YAAY,EACZ,eAAe,GAChB,EAAE,qBAAqB,GAAG,YAAY,CAOtC;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,gBAAgB,CAAA;CACzB;AAED,wBAAgB,oBAAoB,CAAC,EAAE,MAAM,EAAE,EAAE,yBAAyB,GAAG,YAAY,CAOxF"}

package/dist/components/index.d.ts

@@ -1,5 +1,5 @@
 export { FilterChips, type FilterChipsProps } from './FilterChips';
-export { calendarDayDiff, DUE_THIS_WEEK_DAYS, filterLabel, formatDateTime, formatDueByline, formatModuleNumber, formatPoints, formatUnlockByline, itemTypeLabel, moduleMatchesFilter, moduleMatchesSearch, MODULES_FILTER_IDS, type ModulesFilterId, progressSummary, requirementLabel, } from './labels';
+export { calendarDayDiff, type DateFormatOptions, formatDateTime, formatModuleNumber, formatPoints, moduleMatchesSearch, progressScreenReaderValue, progressSummary, requirementLabel, } from './labels';
 export { ModuleCard, type ModuleCardProps } from './ModuleCard';
 export { ModuleItemRow, type ModuleItemRowProps } from './ModuleItemRow';
 export { ModuleNumberBadge, type ModuleNumberBadgeProps } from './ModuleNumberBadge';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAClE,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,KAAK,eAAe,EACpB,eAAe,EACf,gBAAgB,GACjB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAC/D,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACxE,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AACpF,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAC7F,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,yBAAyB,EAC9B,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAClE,OAAO,EACL,eAAe,EACf,KAAK,iBAAiB,EACtB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,yBAAyB,EACzB,eAAe,EACf,gBAAgB,GACjB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAC/D,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACxE,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AACpF,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAC7F,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,yBAAyB,EAC9B,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,cAAc,CAAA"}

package/dist/components/labels.d.ts

@@ -1,85 +1,15 @@
 import { TranslateFunction } from '../i18n';
-import { CompletionRequirement, Module, ModuleItemType } from '../types';
-/** Whole calendar days between two dates, ignoring the time of day. */
-export declare function calendarDayDiff(a: Date, b: Date): number;
-/**
- * "today, 11:59 PM" / "yesterday, 11:59 PM" / "January 12, 11:59 PM".
- *
- * The relative words are separate keys rather than one string with a placeholder,
- * because a language that puts the time first, or inflects "yesterday" by what
- * follows it, needs to move the pieces independently.
- *
- * No timezone suffix. The domain model carries none and this package may not read
- * one off the host, so printing one would be a guess — see `src/i18n.tsx`.
- */
-export declare function formatDateTime(t: TranslateFunction, iso: string, today: Date, locale?: string): string;
-/** The module header byline when the module is open: "Due yesterday, 11:59 PM". */
-export declare function formatDueByline(t: TranslateFunction, iso: string, today: Date, locale?: string): string;
-/** The module header byline when the module is locked. */
-export declare function formatUnlockByline(t: TranslateFunction, iso: string, today: Date, locale?: string): string;
-/**
- * "01", "02", … "120". `Intl` rather than `padStart` so a locale's own digits show.
- * Anything but a positive integer is an unknown position and returns `null`.
- */
+import { CompletionRequirement, Module } from '../types';
+export interface DateFormatOptions {
+    locale?: string;
+    timezone?: string;
+}
+export declare function calendarDayDiff(a: Date, b: Date, timezone?: string): number;
+export declare function formatDateTime(t: TranslateFunction, iso: string, today: Date, { locale, timezone }?: DateFormatOptions): string;
 export declare function formatModuleNumber(position: number, locale?: string): string | null;
-export declare function itemTypeLabel(t: TranslateFunction, type: ModuleItemType): string;
-/** "10 pts". Null/undefined points render nothing at all, not "0 pts". */
 export declare function formatPoints(t: TranslateFunction, pointsPossible: number | null | undefined): string | null;
-/**
- * The requirement column, e.g. "Submit the assignment".
- *
- * Exhaustive over `CompletionRequirementType` — no `default`, so adding a member
- * to the enum is a compile error here rather than a silently unlabeled row. The
- * `unknown` member is what absorbs a seventh Canvas type, and it still renders
- * something: an unlabeled requirement would look like *no* requirement, which
- * is the wrong failure.
- */
 export declare function requirementLabel(t: TranslateFunction, requirement: CompletionRequirement): string;
-/**
- * "75% | 3 of 4 requirements met", straight off the design.
- *
- * The `|` is baked into the translatable string, which is not ideal — a translator
- * cannot tell it is a divider rather than punctuation, and a screen reader may
- * either skip it or announce "vertical bar". Left as one key because splitting it
- * changes the design's copy; flagged rather than quietly restructured.
- */
 export declare function progressSummary(t: TranslateFunction, percentComplete: number, met: number, total: number): string;
-export type ModulesFilterId = 'all' | 'in_progress' | 'complete' | 'due_this_week' | 'missing';
-/**
- * The chip order the design draws, as ids only.
- *
- * Ids rather than `{ id, label }` pairs because a label is now a function of the
- * host's `t`, and a module-level constant cannot call one. `filterLabel` supplies
- * the text.
- */
-export declare const MODULES_FILTER_IDS: readonly ModulesFilterId[];
-export declare function filterLabel(t: TranslateFunction, id: ModulesFilterId): string;
-/** How far ahead "Due this week" looks. */
-export declare const DUE_THIS_WEEK_DAYS = 7;
-/**
- * Filter chips are **module-level only**, by design.
- *
- * Every predicate reads `module.progress`, which the adapter returns with the
- * module list. None of them touch items. That is deliberate: in `onDemand` mode
- * the items of a collapsed module have not been fetched, so an item-level
- * filter would either lie or cost one request per module. The designer's
- * annotation says the filters describe the *module's* overall status, which is
- * exactly the cheap version.
- *
- * A module with no `progress` (teacher/anonymous view) matches only "All" —
- * "we did not fetch progress" is not the same as "not in progress".
- */
-export declare function moduleMatchesFilter(module: Module, filter: ModulesFilterId, today: Date): boolean;
-/**
- * Search matches **module names only**, never item titles.
- *
- * Same reason as the filters: with `onDemand` pagination the items of collapsed
- * modules are not in memory, so an item-level search would silently under-report
- * — the one thing this package exists to prevent. The input is labeled
- * "Search module names" so the limit is on screen rather than in a comment.
- *
- * `toLocaleLowerCase` rather than `toLowerCase`: the Turkish dotless i is the
- * standard counterexample, and a course in Turkish should find its own modules.
- */
+export declare function progressScreenReaderValue(t: TranslateFunction, percentComplete: number, met: number, total: number): string;
 export declare function moduleMatchesSearch(module: Module, query: string, locale?: string): boolean;
 //# sourceMappingURL=labels.d.ts.map

package/dist/components/labels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/components/labels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEhD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AA8D7E,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAIxD;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,CAAC,EAAE,iBAAiB,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,IAAI,EACX,MAAM,GAAE,MAAuB,GAC9B,MAAM,CAiBR;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAC7B,CAAC,EAAE,iBAAiB,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,IAAI,EACX,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAER;AAED,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,iBAAiB,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,IAAI,EACX,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAER;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAuB,GAC9B,MAAM,GAAG,IAAI,CAGf;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CAmBhF;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAC1B,CAAC,EAAE,iBAAiB,EACpB,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACxC,MAAM,GAAG,IAAI,CAGf;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,iBAAiB,EAAE,WAAW,EAAE,qBAAqB,GAAG,MAAM,CAqBjG;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,CAAC,EAAE,iBAAiB,EACpB,eAAe,EAAE,MAAM,EACvB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,MAAM,CAER;AAID,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,aAAa,GAAG,UAAU,GAAG,eAAe,GAAG,SAAS,CAAA;AAE9F;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,eAAe,EAMxD,CAAA;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,iBAAiB,EAAE,EAAE,EAAE,eAAe,GAAG,MAAM,CAa7E;AAED,2CAA2C;AAC3C,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAEnC;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAqCjG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAI3F"}
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/components/labels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEhD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAM7D,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAmFD,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3E;AAMD,wBAAgB,cAAc,CAC5B,CAAC,EAAE,iBAAiB,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,IAAI,EACX,EAAE,MAAuB,EAAE,QAAQ,EAAE,GAAE,iBAAsB,GAC5D,MAAM,CAiBR;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAuB,GAC9B,MAAM,GAAG,IAAI,CAGf;AAED,wBAAgB,YAAY,CAC1B,CAAC,EAAE,iBAAiB,EACpB,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACxC,MAAM,GAAG,IAAI,CAGf;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,iBAAiB,EAAE,WAAW,EAAE,qBAAqB,GAAG,MAAM,CAqBjG;AAED,wBAAgB,eAAe,CAC7B,CAAC,EAAE,iBAAiB,EACpB,eAAe,EAAE,MAAM,EACvB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,MAAM,CAER;AAED,wBAAgB,yBAAyB,CACvC,CAAC,EAAE,iBAAiB,EACpB,eAAe,EAAE,MAAM,EACvB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,MAAM,CAER;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAI3F"}

package/dist/components/lightThemeDecorator.d.ts

@@ -0,0 +1,3 @@
+import { Decorator } from '@storybook/react';
+export declare const withLightTheme: Decorator;
+//# sourceMappingURL=lightThemeDecorator.d.ts.map

package/dist/components/lightThemeDecorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lightThemeDecorator.d.ts","sourceRoot":"","sources":["../../src/components/lightThemeDecorator.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjD,eAAO,MAAM,cAAc,EAAE,SAI5B,CAAA"}

package/dist/config/base.d.ts

@@ -1,8 +1,3 @@
 import { ModulesConfig } from './types';
-/**
- * The starting point every host resolves against. Empty until each mechanism
- * lands; `docs/adr/0001-customization.md` decides what each key then carries.
- * Frozen: it is what `useModulesConfig` returns with no provider mounted.
- */
 export declare const baseModulesConfig: ModulesConfig;
 //# sourceMappingURL=base.d.ts.map

package/dist/config/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/config/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,aAS/B,CAAA"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/config/base.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C,eAAO,MAAM,iBAAiB,EAAE,aAS/B,CAAA"}

package/dist/config/capabilities.d.ts

@@ -0,0 +1,8 @@
+import { FilterCapabilities } from '../types';
+import { Registry } from './registry';
+import { FilterEntry } from './schemas';
+export declare function unservableFilters(filters: Registry<FilterEntry>, capabilities: FilterCapabilities | undefined): string[];
+export declare function unservableFilterMessage(keys: readonly string[]): string;
+/** Do not fall back to the predicate. That trades complete results for partial ones. */
+export declare function hideUnservableFilters(filters: Registry<FilterEntry>, capabilities: FilterCapabilities | undefined): Registry<FilterEntry>;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/config/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/config/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAgB,MAAM,UAAU,CAAA;AAEhE,OAAO,EAAE,KAAK,QAAQ,EAAkB,MAAM,YAAY,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAE5C,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,EAC9B,YAAY,EAAE,kBAAkB,GAAG,SAAS,GAC3C,MAAM,EAAE,CAOV;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAKvE;AAED,wFAAwF;AACxF,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,EAC9B,YAAY,EAAE,kBAAkB,GAAG,SAAS,GAC3C,QAAQ,CAAC,WAAW,CAAC,CAWvB"}

package/dist/config/context.d.ts

@@ -4,8 +4,7 @@ export interface ModulesConfigProviderProps {
     value: ModulesConfig;
     children: ReactNode;
 }
-/** Optional. Without it the package renders against `baseModulesConfig`. */
 export declare function ModulesConfigProvider({ value, children }: ModulesConfigProviderProps): ReactNode;
-/** The resolved config, falling back to `baseModulesConfig`. */
 export declare function useModulesConfig(): ModulesConfig;
+export declare function useFieldVisible(key: string): boolean;
 //# sourceMappingURL=context.d.ts.map

package/dist/config/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/config/context.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAc,MAAM,OAAO,CAAA;AAEjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAI5C,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,aAAa,CAAA;IACpB,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,0BAA0B,GAAG,SAAS,CAEhG;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/config/context.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAc,MAAM,OAAO,CAAA;AAGjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAI5C,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,aAAa,CAAA;IACpB,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED,wBAAgB,qBAAqB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,0BAA0B,GAAG,SAAS,CAEhG;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEpD"}

package/dist/config/filters.d.ts

@@ -0,0 +1,15 @@
+import { FilterClause } from '../types';
+import { Registry } from './registry';
+import { FilterEntry } from './schemas';
+export declare const ALL_FILTER = "all";
+/** How far ahead "Due this week" looks. */
+export declare const DUE_THIS_WEEK_DAYS = 7;
+/**
+ * In design order. See `docs/adr/0008-filtering-and-the-data-layer.md`.
+ * Read `module.progress` only. A collapsed module has no items in `onDemand` mode.
+ */
+export declare const baseFilters: Registry<FilterEntry>;
+/** `clientOnly` is the only way to un-write an inherited clause. */
+export declare function filterClauseOf(entry: FilterEntry | undefined): FilterClause | undefined;
+export declare function isPredicateServed(entry: FilterEntry | undefined): boolean;
+//# sourceMappingURL=filters.d.ts.map

package/dist/config/filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../src/config/filters.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAE5C,eAAO,MAAM,UAAU,QAAQ,CAAA;AAE/B,2CAA2C;AAC3C,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAEnC;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,WAAW,CAyC4B,CAAA;AAE1E,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAGvF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAEzE"}

package/dist/config/formatters.d.ts

@@ -0,0 +1,15 @@
+import { TranslateFunction } from '../i18n';
+import { Module } from '../types';
+export interface FormatterContext {
+    t: TranslateFunction;
+    locale: string;
+    timezone?: string;
+}
+export interface ModulesFormatters {
+    moduleLabel: (position: number, module: Module, ctx: FormatterContext) => string | null;
+    dateTime: (iso: string, today: Date, ctx: FormatterContext) => string;
+    points: (pointsPossible: number | null | undefined, ctx: FormatterContext) => string | null;
+    progress: (percentComplete: number, met: number, total: number, ctx: FormatterContext) => string;
+}
+export declare const defaultFormatters: ModulesFormatters;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/config/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/config/formatters.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEtC,MAAM,WAAW,gBAAgB;IAC/B,CAAC,EAAE,iBAAiB,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,KAAK,MAAM,GAAG,IAAI,CAAA;IACvF,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,gBAAgB,KAAK,MAAM,CAAA;IACrE,MAAM,EAAE,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,EAAE,gBAAgB,KAAK,MAAM,GAAG,IAAI,CAAA;IAC3F,QAAQ,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,KAAK,MAAM,CAAA;CACjG;AAED,eAAO,MAAM,iBAAiB,EAAE,iBAS/B,CAAA"}

package/dist/config/index.d.ts

@@ -1,8 +1,13 @@
 export { baseModulesConfig } from './base';
-export { ModulesConfigProvider, type ModulesConfigProviderProps, useModulesConfig, } from './context';
+export { ALL_FILTER, baseFilters, DUE_THIS_WEEK_DAYS, filterClauseOf, isPredicateServed, } from './filters';
+export { hideUnservableFilters, unservableFilters } from './capabilities';
+export { TYPE_FIELD } from './itemMeta';
+export { ModulesConfigProvider, type ModulesConfigProviderProps, useFieldVisible, useModulesConfig, } from './context';
+export { defaultFormatters, type FormatterContext, type ModulesFormatters, } from './formatters';
 export { partialModulesConfig } from './partialModulesConfig';
-export { mergeRegistry, visibleEntries, type Registry, type RegistryOverride, type VisibleEntry, } from './registry';
+export { mergeRegistry, visibleEntries, visibleEntry, type Registry, type RegistryOverride, type VisibleEntry, } from './registry';
 export { resolveModulesConfig } from './resolve';
-export { ModulesConfigSchema, registrySchema, RegistryEntrySchema, type RegistryEntry, } from './schemas';
-export type { ModulesConfig, ModulesConfigOverride, ModulesFormatters, ModulesNavigation, } from './types';
+export { type FilterContext, type FilterEntry, FilterEntrySchema, type ItemTypeContext, type ItemTypeEntry, ItemTypeEntrySchema, type MetaFieldContext, type MetaFieldEntry, MetaFieldEntrySchema, ModulesConfigSchema, registrySchema, RegistryEntrySchema, type RegistryEntry, } from './schemas';
+export type { ModulesConfig, ModulesConfigOverride, ModulesNavigation } from './types';
+export { type BoundFormatters, useFormatters } from './useFormatters';
 //# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAA;AAC1C,OAAO,EACL,qBAAqB,EACrB,KAAK,0BAA0B,EAC/B,gBAAgB,GACjB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EACL,aAAa,EACb,cAAc,EACd,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,KAAK,aAAa,GACnB,MAAM,WAAW,CAAA;AAClB,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAA;AAC1C,OAAO,EACL,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,iBAAiB,GAClB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EACL,qBAAqB,EACrB,KAAK,0BAA0B,EAC/B,eAAe,EACf,gBAAgB,GACjB,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EACL,aAAa,EACb,cAAc,EACd,YAAY,EACZ,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,KAAK,aAAa,GACnB,MAAM,WAAW,CAAA;AAClB,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AACtF,OAAO,EAAE,KAAK,eAAe,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/config/itemMeta.d.ts

@@ -0,0 +1,5 @@
+import { Registry } from './registry';
+import { MetaFieldEntry } from './schemas';
+export declare const TYPE_FIELD = "type";
+export declare const baseItemMeta: Registry<MetaFieldEntry>;
+//# sourceMappingURL=itemMeta.d.ts.map

package/dist/config/itemMeta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"itemMeta.d.ts","sourceRoot":"","sources":["../../src/config/itemMeta.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,QAAQ,EAAgB,MAAM,YAAY,CAAA;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE/C,eAAO,MAAM,UAAU,SAAS,CAAA;AAEhC,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,cAAc,CA4C2B,CAAA"}

package/dist/config/itemTypes.d.ts

@@ -0,0 +1,4 @@
+import { ModuleItemType } from '../types';
+import { ItemTypeEntry } from './schemas';
+export declare const baseItemTypes: Record<ModuleItemType, ItemTypeEntry>;
+//# sourceMappingURL=itemTypes.d.ts.map

package/dist/config/itemTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"itemTypes.d.ts","sourceRoot":"","sources":["../../src/config/itemTypes.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAI9C,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,cAAc,EAAE,aAAa,CAyBoB,CAAA"}

package/dist/config/partialModulesConfig.d.ts

@@ -1,4 +1,3 @@
 import { ModulesConfig, ModulesConfigOverride } from './types';
-/** Use for tests where you don't need a full config. */
 export declare function partialModulesConfig(override?: ModulesConfigOverride): ModulesConfig;
 //# sourceMappingURL=partialModulesConfig.d.ts.map

package/dist/config/partialModulesConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"partialModulesConfig.d.ts","sourceRoot":"","sources":["../../src/config/partialModulesConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAEnE,wDAAwD;AACxD,wBAAgB,oBAAoB,CAAC,QAAQ,GAAE,qBAA0B,GAAG,aAAa,CAExF"}
+{"version":3,"file":"partialModulesConfig.d.ts","sourceRoot":"","sources":["../../src/config/partialModulesConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAEnE,wBAAgB,oBAAoB,CAAC,QAAQ,GAAE,qBAA0B,GAAG,aAAa,CAExF"}

package/dist/config/registry.d.ts

@@ -1,41 +1,13 @@
 import { RegistryEntry } from './schemas';
-/**
- * The registry primitive: merge one over another, then read the visible entries
- * in a deterministic order. No React, no validation — the schemas in
- * `./schemas` validate once, at config resolution.
- */
 export type Registry<E extends RegistryEntry = RegistryEntry> = Record<string, E>;
-/** `Partial<E>` because an overlay states only what it changes. An addition still needs a whole entry, which only the schema can enforce. */
 export type RegistryOverride<E extends RegistryEntry = RegistryEntry> = Record<string, Partial<E>>;
 export type VisibleEntry<E extends RegistryEntry = RegistryEntry> = E & {
     key: string;
 };
+/** Own properties only: a host override parsed from JSON must not reach `Object.prototype`. */
 export declare const hasOwn: (target: object, key: string) => boolean;
-/** Spread one object over another, skipping explicit `undefined` so a stated key cannot blank an inherited value. */
 export declare function overlay<T extends object>(base: Partial<T>, over: Partial<T> | undefined): T;
-/**
- * Fold an override over a base registry, one entry at a time:
- * `{ ...base[key], ...override[key] }`. A key the base has is an overlay; a key
- * it doesn't is an addition.
- *
- * Key order of the result is what `visibleEntries` breaks ties on: base keys in
- * base order, then additions sorted by key so a host cannot change the rendered
- * order by reordering its own literal.
- *
- * Copies every entry, so neither argument is mutated or shared. Built by spread
- * rather than assignment, and keyed by own properties only, so an override
- * parsed from host JSON cannot reach `Object.prototype` through a `__proto__`
- * or `constructor` key.
- */
 export declare function mergeRegistry<E extends RegistryEntry>(base: Registry<E>, override?: RegistryOverride<E>): Registry<E>;
-/**
- * The entries a host has left switched on, sorted by `order` ascending.
- *
- * Ties fall through to key order, per `mergeRegistry` above — `Array#sort` is
- * stable by specification from ES2019.
- *
- * Filtering `hidden` here rather than at the merge is what lets a host inspect
- * what it turned off.
- */
+export declare function visibleEntry<E extends RegistryEntry>(registry: Registry<E>, key: string): E | undefined;
 export declare function visibleEntries<E extends RegistryEntry>(registry: Registry<E>): ReadonlyArray<VisibleEntry<E>>;
 //# sourceMappingURL=registry.d.ts.map

package/dist/config/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/config/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAE9C;;;;GAIG;AAEH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;AAEjF,6IAA6I;AAC7I,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;AAElG,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,IAAI,CAAC,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvF,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,EAAE,KAAK,MAAM,KAAG,OACF,CAAA;AAEnD,qHAAqH;AACrH,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,CAAC,CAI3F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,aAAa,EACnD,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EACjB,QAAQ,GAAE,gBAAgB,CAAC,CAAC,CAAM,GACjC,QAAQ,CAAC,CAAC,CAAC,CAYb;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,aAAa,EACpD,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GACpB,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAKhC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/config/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAE9C,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;AAEjF,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;AAElG,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,IAAI,CAAC,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvF,+FAA+F;AAC/F,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,EAAE,KAAK,MAAM,KAAG,OACF,CAAA;AAEnD,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,CAAC,CAI3F;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS,aAAa,EACnD,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EACjB,QAAQ,GAAE,gBAAgB,CAAC,CAAC,CAAM,GACjC,QAAQ,CAAC,CAAC,CAAC,CAYb;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,aAAa,EAClD,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EACrB,GAAG,EAAE,MAAM,GACV,CAAC,GAAG,SAAS,CAGf;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,aAAa,EACpD,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GACpB,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAKhC"}

package/dist/config/resolve.d.ts

@@ -1,7 +1,3 @@
 import { ModulesConfig, ModulesConfigOverride } from './types';
-/**
- * Fold an override over a base config, one key at a time, and validate the
- * result.
- */
 export declare function resolveModulesConfig(base: ModulesConfig, override?: ModulesConfigOverride): ModulesConfig;
 //# sourceMappingURL=resolve.d.ts.map

package/dist/config/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/config/resolve.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAEnE;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,aAAa,EACnB,QAAQ,GAAE,qBAA0B,GACnC,aAAa,CAwBf"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/config/resolve.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAEnE,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,aAAa,EACnB,QAAQ,GAAE,qBAA0B,GACnC,aAAa,CAuBf"}