@samva/markup 0.7.0 → 0.8.0

package/dist/selection-CCArx9lU.d.ts

@@ -0,0 +1,91 @@
+import { i as JsxSourceLocation } from "./source-locations-DrCM82Ym.js";
+//#region src/email/selection.d.ts
+/**
+ * The attribute a preview stamps so a click in a rendered document resolves to
+ * exactly one rendered element. A delivered message never carries it.
+ */
+declare const INSTANCE_PATH_ATTRIBUTE = "data-samva-instance";
+/** Where one element sits in the emitted document, with the authoring that produced it. */
+interface EmittedPosition {
+  readonly start: number;
+  readonly end: number;
+  readonly origins: ReadonlyArray<JsxSourceLocation>;
+  /**
+   * Dot-separated element indices from the document root, assigned as the
+   * document is written. It is the identity of one rendered instance.
+   */
+  readonly instancePath: string;
+  readonly tag: string;
+  /** False when a compiler primitive generated this element. */
+  readonly authored: boolean;
+}
+/** One rendered element, and the authoring it came from. */
+interface EmailElementSelection {
+  /**
+   * Dot-separated element indices from the document root. It is the identity
+   * of one rendered instance, which is what tells two iterations of the same
+   * authored element apart: their origins are identical.
+   */
+  readonly instancePath: string;
+  readonly tag: string;
+  /**
+   * The authored JSX element first, then each enclosing component call site,
+   * innermost first. Empty when the compiler generated this element with no
+   * authoring on the stack — the hidden preheader block, for instance.
+   */
+  readonly origins: ReadonlyArray<JsxSourceLocation>;
+  /**
+   * False when a compiler primitive generated this element. `origins[0]` is
+   * then the authoring element that asked for it rather than this element
+   * itself, so the wrapper selects the primitive the author wrote.
+   */
+  readonly authored: boolean;
+  /** 1-based position among the rendered elements sharing this origin chain and tag. */
+  readonly occurrence: number;
+  /**
+   * How many rendered elements share that chain and tag. Above one, one piece
+   * of authoring produced several rendered elements — a loop over a component,
+   * or a primitive that generates a repeated cell — so an edit there changes
+   * all of them.
+   */
+  readonly occurrences: number;
+  /** Absent for the document root. */
+  readonly parentPath?: string;
+  /** Offset range in the rendered HTML this selection was taken from. */
+  readonly start: number;
+  readonly end: number;
+}
+/**
+ * Turn one render's emitted positions into selections, in document order.
+ *
+ * The serializer records an element once its content is written, so positions
+ * arrive innermost-first; document order is what an outline and an ancestry
+ * walk both need.
+ */
+declare const emailSelections: (positions: readonly EmittedPosition[]) => readonly EmailElementSelection[];
+/** Look selections up by the instance path a rendered document carries. */
+declare const emailSelectionIndex: (selections: readonly EmailElementSelection[]) => ReadonlyMap<string, EmailElementSelection>;
+/**
+ * The authoring element a selection edits. For an authored element that is the
+ * element itself; for a generated wrapper it is the primitive that asked for
+ * it. Undefined only where the compiler generated markup with no authoring on
+ * the stack, which nothing can edit in place.
+ */
+declare const emailAuthoringTarget: (selection: EmailElementSelection) => JsxSourceLocation | undefined;
+/** Root-first ancestry of a selection, itself last. */
+declare const emailSelectionAncestry: (index: ReadonlyMap<string, EmailElementSelection>, instancePath: string) => readonly EmailElementSelection[];
+/**
+ * Every rendered instance produced through the same call site, in document
+ * order. One entry means the call ran once; several mean it repeated.
+ */
+declare const emailSelectionSiblings: (selections: readonly EmailElementSelection[], selection: EmailElementSelection) => readonly EmailElementSelection[];
+/**
+ * Every rendered instance of the same authored element, across every call site
+ * that reaches it. A shared component edited at its definition changes all of
+ * these; edited at one call site it changes only `emailSelectionSiblings`. A
+ * control has to say which of the two it is doing before it applies.
+ */
+declare const emailDefinitionInstances: (selections: readonly EmailElementSelection[], selection: EmailElementSelection) => readonly EmailElementSelection[];
+//#endregion
+export { emailDefinitionInstances as a, emailSelectionSiblings as c, emailAuthoringTarget as i, emailSelections as l, EmittedPosition as n, emailSelectionAncestry as o, INSTANCE_PATH_ATTRIBUTE as r, emailSelectionIndex as s, EmailElementSelection as t };
+//# sourceMappingURL=selection-CCArx9lU.d.ts.map

package/dist/{showcase-DGZAWn4Z.d.ts → showcase-egkusQBf.d.ts}

@@ -1,11 +1,13 @@
-import { r as PresetCategory } from "./catalog-60eaYC7b.js";
-//#region presets/showcase.d.ts
+import { r as StarterCategory } from "./catalog-CKuOooB8.js";
+//#region starters/showcase.d.ts
 /**
- * The showcase projects: presets authored as complete editable projects under
- * `examples/email-showcase` rather than as the single module `packages/markup/presets/<id>.tsx`.
+ * The showcase projects: starters authored as complete editable projects under
+ * `examples/email-showcase/starters` rather than as the single module
+ * `packages/markup/starters/<id>.tsx`.
  *
- * This registry is the one place a showcase project is declared. Codegen reads it to bundle the
- * project's files, the corpus reads it for provenance and canonical source paths, and
+ * This registry is the one place a showcase project is declared. Each project is the directory
+ * `examples/email-showcase/starters/<id>`, whose files `starter-manifest.json` lists. Codegen reads
+ * both to bundle the project, the corpus reads the registry for provenance and canonical source paths, and
  * `showcase.test.ts` fails when an entry here is missing from the catalog, the public gallery or
  * the previews — so a project cannot be half-registered.
  */
@@ -21,26 +23,23 @@ type ShowcaseProvenance = {
   readonly reviewedNote: string;
 };
 interface ShowcaseProject {
-  /** The preset id, matching its catalog row and its entry file's stem. */
+  /** The starter id, matching its catalog row and its entry file's stem. */
   readonly id: string;
-  /** The project's TSX entry, relative to the showcase root. */
+  /** The project's TSX entry, relative to the starter's own directory. */
   readonly entryPath: `emails/${string}.tsx`;
-  /** Every other file that travels with the entry: stylesheet, assets, retained notices. */
-  readonly files: ReadonlyArray<string>;
   readonly provenance: ShowcaseProvenance;
   /** Must equal the catalog row's category. */
-  readonly category: PresetCategory;
+  readonly category: StarterCategory;
   /** Must equal the public gallery entry's slug. */
   readonly gallerySlug: string;
   /** Stable ISO-8601 timestamp recorded on the corpus entry. */
   readonly recordedAt: string;
 }
-/** Repository-relative root of the showcase project, used to build canonical source paths. */
-declare const SHOWCASE_ROOT = "examples/email-showcase";
+/** Repository-relative directory holding one directory per showcase project. */
+declare const SHOWCASE_ROOT = "examples/email-showcase/starters";
 declare const showcaseProjects: readonly [{
   readonly id: "data-sharing-review";
   readonly entryPath: "emails/data-sharing-review.tsx";
-  readonly files: readonly ["emails/data-sharing-review.css", "emails/assets/data-sharing-review-connection.png", "emails/assets/data-sharing-review-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -50,7 +49,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "editorial-newsletter";
   readonly entryPath: "emails/editorial-newsletter.tsx";
-  readonly files: readonly ["emails/editorial-newsletter.css", "emails/assets/editorial-newsletter-author.png", "emails/assets/editorial-newsletter-hero.png", "emails/assets/editorial-newsletter-sponsor.png", "emails/assets/editorial-newsletter-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -60,7 +58,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "email-verification";
   readonly entryPath: "emails/email-verification.tsx";
-  readonly files: readonly ["emails/email-verification.css", "emails/assets/email-verification-badge.png", "emails/assets/email-verification-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -70,7 +67,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "events-roundup";
   readonly entryPath: "emails/events-roundup.tsx";
-  readonly files: readonly ["emails/events-roundup.css", "emails/assets/events-roundup-spotlight.png", "emails/assets/events-roundup-tile-five.png", "emails/assets/events-roundup-tile-four.png", "emails/assets/events-roundup-tile-one.png", "emails/assets/events-roundup-tile-six.png", "emails/assets/events-roundup-tile-three.png", "emails/assets/events-roundup-tile-two.png", "emails/assets/events-roundup-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -80,7 +76,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "feature-release-roundup";
   readonly entryPath: "emails/feature-release-roundup.tsx";
-  readonly files: readonly ["emails/feature-release-roundup.css", "emails/assets/feature-release-roundup-release-activity.png", "emails/assets/feature-release-roundup-release-branching.png", "emails/assets/feature-release-roundup-release-keys.png", "emails/assets/feature-release-roundup-release-nodes.png", "emails/assets/feature-release-roundup-release-regions.png", "emails/assets/feature-release-roundup-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -90,7 +85,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "feedback-request";
   readonly entryPath: "emails/feedback-request.tsx";
-  readonly files: readonly ["emails/feedback-request.css", "emails/assets/feedback-request-avatar.png", "emails/assets/feedback-request-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -100,7 +94,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "flash-getaway-offer";
   readonly entryPath: "emails/flash-getaway-offer.tsx";
-  readonly files: readonly ["emails/flash-getaway-offer.css", "emails/assets/flash-getaway-offer-banner.png", "emails/assets/flash-getaway-offer-city-harbour.png", "emails/assets/flash-getaway-offer-desert-canyon.png", "emails/assets/flash-getaway-offer-reef-bay.png", "emails/assets/flash-getaway-offer-snow-ridge.png", "emails/assets/flash-getaway-offer-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -110,7 +103,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "industry-news-digest";
   readonly entryPath: "emails/industry-news-digest.tsx";
-  readonly files: readonly ["emails/industry-news-digest.css", "emails/assets/industry-news-digest-lead.png", "emails/assets/industry-news-digest-sponsor.png", "emails/assets/industry-news-digest-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -120,7 +112,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "rewards-milestone";
   readonly entryPath: "emails/rewards-milestone.tsx";
-  readonly files: readonly ["emails/assets/rewards-milestone-banner.png", "emails/assets/rewards-milestone-tier-amber.png", "emails/assets/rewards-milestone-tier-brass.png", "emails/assets/rewards-milestone-tier-copper.png", "emails/assets/rewards-milestone-tier-slate.png", "emails/assets/rewards-milestone-wordmark.png", "emails/rewards-milestone.css"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -130,7 +121,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "member-referral-offer";
   readonly entryPath: "emails/member-referral-offer.tsx";
-  readonly files: readonly ["emails/assets/member-referral-offer-hero.png", "emails/assets/member-referral-offer-step-earn.png", "emails/assets/member-referral-offer-step-join.png", "emails/assets/member-referral-offer-step-share.png", "emails/assets/member-referral-offer-wordmark.png", "emails/member-referral-offer.css"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -140,7 +130,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "catalog-sale-newsletter";
   readonly entryPath: "emails/catalog-sale-newsletter.tsx";
-  readonly files: readonly ["emails/assets/catalog-sale-newsletter-banner.png", "emails/assets/catalog-sale-newsletter-item-blanket.png", "emails/assets/catalog-sale-newsletter-item-crate.png", "emails/assets/catalog-sale-newsletter-item-kettle.png", "emails/assets/catalog-sale-newsletter-item-lantern.png", "emails/assets/catalog-sale-newsletter-wordmark.png", "emails/catalog-sale-newsletter.css"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -150,7 +139,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "event-invite";
   readonly entryPath: "emails/event-invite.tsx";
-  readonly files: readonly ["emails/assets/event-invite-hero.png", "emails/assets/event-invite-wordmark.png", "emails/event-invite.css"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -160,7 +148,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "limited-time-savings";
   readonly entryPath: "emails/limited-time-savings.tsx";
-  readonly files: readonly ["emails/assets/limited-time-savings-banner.png", "emails/assets/limited-time-savings-wordmark.png", "emails/limited-time-savings.css"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -170,7 +157,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "membership-promo";
   readonly entryPath: "emails/membership-promo.tsx";
-  readonly files: readonly ["emails/assets/membership-promo-hero.png", "emails/assets/membership-promo-tier-cellar.png", "emails/assets/membership-promo-tier-market.png", "emails/assets/membership-promo-tier-pantry.png", "emails/assets/membership-promo-wordmark.png", "emails/membership-promo.css"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -180,7 +166,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "announcement";
   readonly entryPath: "emails/announcement.tsx";
-  readonly files: readonly ["emails/announcement.css", "emails/assets/announcement-hero.png", "emails/assets/announcement-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -190,7 +175,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "linear-login-code";
   readonly entryPath: "emails/linear-login-code.tsx";
-  readonly files: readonly ["emails/linear-login-code.css", "README.md", "emails/assets/linear-logo.png"];
   readonly provenance: {
     readonly kind: "brand-recreation";
     readonly brand: "Linear";
@@ -203,7 +187,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "membership-benefits-promo";
   readonly entryPath: "emails/membership-benefits-promo.tsx";
-  readonly files: readonly ["emails/membership-benefits-promo.css", "emails/assets/membership-benefits-promo-icon-concierge.png", "emails/assets/membership-benefits-promo-icon-lounge.png", "emails/assets/membership-benefits-promo-icon-shield.png", "emails/assets/membership-benefits-promo-icon-suitcase.png", "emails/assets/membership-benefits-promo-icon-table.png", "emails/assets/membership-benefits-promo-icon-ticket.png", "emails/assets/membership-benefits-promo-panel.png", "emails/assets/membership-benefits-promo-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -213,7 +196,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "notification";
   readonly entryPath: "emails/notification.tsx";
-  readonly files: readonly ["emails/notification.css", "emails/assets/notification-avatar-one.png", "emails/assets/notification-avatar-three.png", "emails/assets/notification-avatar-two.png", "emails/assets/notification-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -223,7 +205,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "onboarding-step";
   readonly entryPath: "emails/onboarding-step.tsx";
-  readonly files: readonly ["emails/onboarding-step.css", "emails/assets/onboarding-step-illustration.png", "emails/assets/onboarding-step-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -233,7 +214,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "order-receipt";
   readonly entryPath: "emails/order-receipt.tsx";
-  readonly files: readonly ["emails/order-receipt.css", "emails/assets/order-receipt-candles.png", "emails/assets/order-receipt-mug.png", "emails/assets/order-receipt-napkins.png", "emails/assets/order-receipt-throw.png", "emails/assets/order-receipt-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -243,7 +223,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "otp";
   readonly entryPath: "emails/otp.tsx";
-  readonly files: readonly ["emails/otp.css", "emails/assets/otp-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -253,7 +232,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "password-reset";
   readonly entryPath: "emails/password-reset.tsx";
-  readonly files: readonly ["emails/password-reset.css", "emails/assets/password-reset-lock.png", "emails/assets/password-reset-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -263,7 +241,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "payment-failed";
   readonly entryPath: "emails/payment-failed.tsx";
-  readonly files: readonly ["emails/payment-failed.css", "emails/assets/payment-failed-bowls.png", "emails/assets/payment-failed-kettle.png", "emails/assets/payment-failed-tray.png", "emails/assets/payment-failed-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -273,7 +250,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "product-digest";
   readonly entryPath: "emails/product-digest.tsx";
-  readonly files: readonly ["emails/product-digest.css", "emails/assets/product-digest-podcast.png", "emails/assets/product-digest-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -283,7 +259,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "product-launch-promo";
   readonly entryPath: "emails/product-launch-promo.tsx";
-  readonly files: readonly ["emails/product-launch-promo.css", "emails/assets/oakline-hero.png", "emails/assets/oakline-wordmark.png", "emails/assets/product-chair.png", "emails/assets/product-lamp.png", "emails/assets/product-mirror.png", "emails/assets/product-stool.png", "emails/assets/product-throw.png", "emails/assets/product-vase.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -293,7 +268,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "product-newsletter";
   readonly entryPath: "emails/product-newsletter.tsx";
-  readonly files: readonly ["emails/product-newsletter.css", "emails/assets/newsletter-lead.png", "emails/assets/newsletter-story-five.png", "emails/assets/newsletter-story-four.png", "emails/assets/newsletter-story-one.png", "emails/assets/newsletter-story-three.png", "emails/assets/newsletter-story-two.png", "emails/assets/newsletter-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -303,7 +277,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "product-onboarding-tour";
   readonly entryPath: "emails/product-onboarding-tour.tsx";
-  readonly files: readonly ["emails/product-onboarding-tour.css", "emails/assets/product-onboarding-tour-feature-alerts.png", "emails/assets/product-onboarding-tour-feature-digest.png", "emails/assets/product-onboarding-tour-feature-questions.png", "emails/assets/product-onboarding-tour-read-alerts.png", "emails/assets/product-onboarding-tour-read-metrics.png", "emails/assets/product-onboarding-tour-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -313,7 +286,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "product-updates-roundup";
   readonly entryPath: "emails/product-updates-roundup.tsx";
-  readonly files: readonly ["emails/product-updates-roundup.css", "emails/assets/product-updates-roundup-access-matrix.png", "emails/assets/product-updates-roundup-import-pipeline.png", "emails/assets/product-updates-roundup-query-timeline.png", "emails/assets/product-updates-roundup-status-board.png", "emails/assets/product-updates-roundup-usage-chart.png", "emails/assets/product-updates-roundup-webhook-retry.png", "emails/assets/product-updates-roundup-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -323,7 +295,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "season-clearance-promo";
   readonly entryPath: "emails/season-clearance-promo.tsx";
-  readonly files: readonly ["emails/season-clearance-promo.css", "emails/assets/season-clearance-promo-banner.png", "emails/assets/season-clearance-promo-cushions.png", "emails/assets/season-clearance-promo-planter.png", "emails/assets/season-clearance-promo-secondary.png", "emails/assets/season-clearance-promo-side-table.png", "emails/assets/season-clearance-promo-wall-clock.png", "emails/assets/season-clearance-promo-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -333,7 +304,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "seasonal-sale-flyer";
   readonly entryPath: "emails/seasonal-sale-flyer.tsx";
-  readonly files: readonly ["emails/seasonal-sale-flyer.css", "emails/assets/seasonal-sale-flyer-bedding.png", "emails/assets/seasonal-sale-flyer-cookware.png", "emails/assets/seasonal-sale-flyer-hero.png", "emails/assets/seasonal-sale-flyer-lighting.png", "emails/assets/seasonal-sale-flyer-outdoor.png", "emails/assets/seasonal-sale-flyer-storage.png", "emails/assets/seasonal-sale-flyer-tableware.png", "emails/assets/seasonal-sale-flyer-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -343,7 +313,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "setup-checklist";
   readonly entryPath: "emails/setup-checklist.tsx";
-  readonly files: readonly ["emails/setup-checklist.css", "emails/assets/setup-checklist-step-invite.png", "emails/assets/setup-checklist-step-publish.png", "emails/assets/setup-checklist-step-source.png", "emails/assets/setup-checklist-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -353,7 +322,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "shipping-update";
   readonly entryPath: "emails/shipping-update.tsx";
-  readonly files: readonly ["emails/shipping-update.css", "emails/assets/shipping-update-runner.png", "emails/assets/shipping-update-teapot.png", "emails/assets/shipping-update-tumblers.png", "emails/assets/shipping-update-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -363,7 +331,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "team-invite";
   readonly entryPath: "emails/team-invite.tsx";
-  readonly files: readonly ["emails/team-invite.css", "emails/assets/team-invite-inviter.png", "emails/assets/team-invite-teammate-one.png", "emails/assets/team-invite-teammate-three.png", "emails/assets/team-invite-teammate-two.png", "emails/assets/team-invite-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -373,7 +340,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "travel-rewards-promo";
   readonly entryPath: "emails/travel-rewards-promo.tsx";
-  readonly files: readonly ["emails/travel-rewards-promo.css", "emails/assets/travel-rewards-promo-hero.png", "emails/assets/travel-rewards-promo-partner-dining.png", "emails/assets/travel-rewards-promo-partner-drives.png", "emails/assets/travel-rewards-promo-partner-lounges.png", "emails/assets/travel-rewards-promo-partner-stays.png", "emails/assets/travel-rewards-promo-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -383,7 +349,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "trial-ending";
   readonly entryPath: "emails/trial-ending.tsx";
-  readonly files: readonly ["emails/trial-ending.css", "emails/assets/trial-ending-countdown.png", "emails/assets/trial-ending-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -393,7 +358,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "vercel-invitation";
   readonly entryPath: "emails/vercel-invitation.tsx";
-  readonly files: readonly ["emails/vercel-invitation.css", "README.md", "emails/assets/vercel-arrow.png", "emails/assets/vercel-logo.png", "emails/assets/vercel-team.png", "emails/assets/vercel-user.png"];
   readonly provenance: {
     readonly kind: "brand-recreation";
     readonly brand: "Vercel";
@@ -406,7 +370,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "weekly-deals-circular";
   readonly entryPath: "emails/weekly-deals-circular.tsx";
-  readonly files: readonly ["emails/weekly-deals-circular.css", "emails/assets/weekly-deals-circular-banner.png", "emails/assets/weekly-deals-circular-basket.png", "emails/assets/weekly-deals-circular-board.png", "emails/assets/weekly-deals-circular-bowls.png", "emails/assets/weekly-deals-circular-duvet.png", "emails/assets/weekly-deals-circular-kettle.png", "emails/assets/weekly-deals-circular-rug.png", "emails/assets/weekly-deals-circular-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -416,7 +379,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "welcome";
   readonly entryPath: "emails/welcome.tsx";
-  readonly files: readonly ["emails/welcome.css", "emails/assets/welcome-hero.png", "emails/assets/welcome-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -426,7 +388,6 @@ declare const showcaseProjects: readonly [{
 }, {
   readonly id: "win-back";
   readonly entryPath: "emails/win-back.tsx";
-  readonly files: readonly ["emails/win-back.css", "emails/assets/win-back-update-alerts.png", "emails/assets/win-back-update-exports.png", "emails/assets/win-back-update-mobile.png", "emails/assets/win-back-update-speed.png", "emails/assets/win-back-update-workspaces.png", "emails/assets/win-back-wordmark.png"];
   readonly provenance: {
     readonly kind: "owned";
   };
@@ -449,8 +410,6 @@ declare const isShowcaseProjectId: (id: string) => id is ShowcaseProjectId;
 declare const showcaseProject: (id: string) => ShowcaseProject | undefined;
 /** Repository-relative path of a showcase project's TSX entry. */
 declare const showcaseSourcePath: (project: ShowcaseProject) => string;
-/** Every file the project bundles, entry first in sorted order — the shape codegen writes. */
-declare const showcaseProjectPaths: (project: ShowcaseProject) => ReadonlyArray<string>;
 //#endregion
-export { ShowcaseProjectId as a, showcaseProject as c, showcaseSourcePath as d, ShowcaseProject as i, showcaseProjectPaths as l, OwnedShowcaseId as n, ShowcaseProvenance as o, SHOWCASE_ROOT as r, isShowcaseProjectId as s, BrandRecreationShowcaseId as t, showcaseProjects as u };
-//# sourceMappingURL=showcase-DGZAWn4Z.d.ts.map
+export { ShowcaseProjectId as a, showcaseProject as c, ShowcaseProject as i, showcaseProjects as l, OwnedShowcaseId as n, ShowcaseProvenance as o, SHOWCASE_ROOT as r, isShowcaseProjectId as s, BrandRecreationShowcaseId as t, showcaseSourcePath as u };
+//# sourceMappingURL=showcase-egkusQBf.d.ts.map

package/dist/{presets → starters}/category-mapping.d.ts

@@ -1,13 +1,13 @@
-import { r as PresetCategory } from "../catalog-60eaYC7b.js";
+import { r as StarterCategory } from "../catalog-CKuOooB8.js";
 import { TemplateCollectionId } from "./public-gallery.js";
-//#region presets/category-mapping.d.ts
+//#region starters/category-mapping.d.ts
 declare const LAB_DIMENSIONS: readonly ["newsletter", "receipt", "security", "product-update", "onboarding", "promotion", "shipping", "social-notification"];
 type LabDimension = (typeof LAB_DIMENSIONS)[number];
 declare const LAB_KINDS: readonly ["newsletter", "receipt", "security", "product-update", "onboarding", "promotion", "shipping", "social-notification", "digest", "invoice", "account", "event", "statement", "developer-notification", "unknown"];
 type LabKind = (typeof LAB_KINDS)[number];
-declare const labKindToPresetCategory: Record<LabKind, PresetCategory>;
-declare const presetCategoryToCollection: Record<PresetCategory, TemplateCollectionId>;
+declare const labKindToStarterCategory: Record<LabKind, StarterCategory>;
+declare const starterCategoryToCollection: Record<StarterCategory, TemplateCollectionId>;
 declare const labKindToCollection: (kind: LabKind) => TemplateCollectionId;
 //#endregion
-export { LAB_DIMENSIONS, LAB_KINDS, LabDimension, LabKind, labKindToCollection, labKindToPresetCategory, presetCategoryToCollection };
+export { LAB_DIMENSIONS, LAB_KINDS, LabDimension, LabKind, labKindToCollection, labKindToStarterCategory, starterCategoryToCollection };
 //# sourceMappingURL=category-mapping.d.ts.map

package/dist/{presets → starters}/category-mapping.js

@@ -1,4 +1,4 @@
-//#region presets/category-mapping.ts
+//#region starters/category-mapping.ts
 const LAB_DIMENSIONS = [
 	"newsletter",
 	"receipt",
@@ -19,7 +19,7 @@ const LAB_KINDS = [
 	"developer-notification",
 	"unknown"
 ];
-const labKindToPresetCategory = {
+const labKindToStarterCategory = {
 	newsletter: "digest",
 	receipt: "transactional",
 	security: "transactional",
@@ -36,14 +36,14 @@ const labKindToPresetCategory = {
 	"developer-notification": "transactional",
 	unknown: "transactional"
 };
-const presetCategoryToCollection = {
+const starterCategoryToCollection = {
 	transactional: "category:transactional",
 	digest: "category:digest-editorial",
 	marketing: "category:marketing",
 	lifecycle: "category:lifecycle"
 };
-const labKindToCollection = (kind) => presetCategoryToCollection[labKindToPresetCategory[kind]];
+const labKindToCollection = (kind) => starterCategoryToCollection[labKindToStarterCategory[kind]];
 //#endregion
-export { LAB_DIMENSIONS, LAB_KINDS, labKindToCollection, labKindToPresetCategory, presetCategoryToCollection };
+export { LAB_DIMENSIONS, LAB_KINDS, labKindToCollection, labKindToStarterCategory, starterCategoryToCollection };
 
 //# sourceMappingURL=category-mapping.js.map

package/dist/starters/corpus.d.ts

@@ -0,0 +1,2 @@
+import { a as PublicCorpusRegistrationIssue, c as TemplateFacetQuery, d as matchesTemplateFacets, f as ownedShowcaseStarterSources, h as templateFacetOptions, i as PublicCorpusRegistration, l as TemplateFacetSet, m as registerPublicCorpusEntry, n as InspirationReference, o as TemplateCorpusKind, p as ownedStarterSourcePath, r as OwnedEditableStarter, s as TemplateCorpusRecord, t as BrandRecreationStarter, u as brandRecreationProvenance } from "../corpus-CPPfgAHN.js";
+export { BrandRecreationStarter, InspirationReference, OwnedEditableStarter, PublicCorpusRegistration, PublicCorpusRegistrationIssue, TemplateCorpusKind, TemplateCorpusRecord, TemplateFacetQuery, TemplateFacetSet, brandRecreationProvenance, matchesTemplateFacets, ownedShowcaseStarterSources, ownedStarterSourcePath, registerPublicCorpusEntry, templateFacetOptions };

package/dist/{presets → starters}/corpus.js

@@ -1,8 +1,8 @@
 import { n as isObject } from "../guards-eV1qLbf2.js";
-import { presetCatalog } from "../presets.js";
+import { starterCatalog } from "../starters.js";
 import { showcaseProject, showcaseProjects, showcaseSourcePath } from "./showcase.js";
 import { Result } from "better-result";
-//#region presets/corpus.ts
+//#region starters/corpus.ts
 const templateFacetOptions = {
 	jobType: [
 		"account-access",
@@ -53,13 +53,13 @@ const brandRecreationProvenance = Object.fromEntries(showcaseProjects.flatMap((p
 	reviewedNote: project.provenance.reviewedNote
 }]] : []));
 /**
-* Owned presets authored as complete showcase projects with their own stylesheet and assets.
-* Every other owned preset is the single module `packages/markup/presets/<id>.tsx`.
+* Owned starters authored as complete showcase projects with their own stylesheet and assets.
+* Every other owned starter is the single module `packages/markup/starters/<id>.tsx`.
 */
-const ownedShowcasePresetSources = Object.fromEntries(showcaseProjects.flatMap((project) => project.provenance.kind === "owned" ? [[project.id, showcaseSourcePath(project)]] : []));
-const ownedPresetSourcePath = (id) => {
+const ownedShowcaseStarterSources = Object.fromEntries(showcaseProjects.flatMap((project) => project.provenance.kind === "owned" ? [[project.id, showcaseSourcePath(project)]] : []));
+const ownedStarterSourcePath = (id) => {
 	const project = showcaseProject(id);
-	return project === void 0 || project.provenance.kind !== "owned" ? `packages/markup/presets/${id}.tsx` : showcaseSourcePath(project);
+	return project === void 0 || project.provenance.kind !== "owned" ? `packages/markup/starters/${id}.tsx` : showcaseSourcePath(project);
 };
 const ISO_TIMESTAMP = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$/;
 const nonEmpty = (value) => value.trim().length > 0;
@@ -111,12 +111,12 @@ const CORPUS_KEYS = [
 const isCorpusRecord = (value) => {
 	if (!exactKeys(value, CORPUS_KEYS) || !hasGovernance(value)) return false;
 	const provenance = value.provenance;
-	if (value.type === "OwnedEditablePreset") return value.corpusKind === "owned-editable-sml" && exactKeys(provenance, [
+	if (value.type === "OwnedEditableStarter") return value.corpusKind === "owned-editable-sml" && exactKeys(provenance, [
 		"owner",
 		"sourcePath",
 		"recordedAt"
 	]) && provenance.owner === "Samva" && typeof provenance.sourcePath === "string" && typeof provenance.recordedAt === "string";
-	if (value.type === "BrandRecreationPreset") return value.corpusKind === "brand-recreation-sml" && exactKeys(provenance, [
+	if (value.type === "BrandRecreationStarter") return value.corpusKind === "brand-recreation-sml" && exactKeys(provenance, [
 		"owner",
 		"sourcePath",
 		"recordedAt",
@@ -137,7 +137,7 @@ const isCorpusEntry = (value) => exactKeys(value, [
 	"corpus",
 	"facets"
 ]) && typeof value.id === "string" && isCorpusRecord(value.corpus) && isFacetSet(value.facets);
-const canonicalOwnedPresetSources = new Map(presetCatalog.filter((preset) => preset.channel === "email" && !Object.hasOwn(brandRecreationProvenance, preset.id)).map((preset) => [preset.id, ownedPresetSourcePath(preset.id)]));
+const canonicalOwnedStarterSources = new Map(starterCatalog.filter((starter) => starter.channel === "email" && !Object.hasOwn(brandRecreationProvenance, starter.id)).map((starter) => [starter.id, ownedStarterSourcePath(starter.id)]));
 /** Decode and gate a record before it can enter any public projection. */
 const registerPublicCorpusEntry = (input) => {
 	if (!isCorpusEntry(input)) return Result.err({
@@ -154,12 +154,12 @@ const registerPublicCorpusEntry = (input) => {
 		id,
 		message: "public corpus records require approved review, display, retention, and takedown metadata"
 	});
-	if (corpus.type === "OwnedEditablePreset" && (canonicalOwnedPresetSources.get(id) !== corpus.provenance.sourcePath || corpus.retention.policy !== "retain-until-withdrawn" || facets.brandProvenance.some((value) => value !== "samva-original"))) return Result.err({
+	if (corpus.type === "OwnedEditableStarter" && (canonicalOwnedStarterSources.get(id) !== corpus.provenance.sourcePath || corpus.retention.policy !== "retain-until-withdrawn" || facets.brandProvenance.some((value) => value !== "samva-original"))) return Result.err({
 		id,
-		message: "owned presets require a canonical editable TSX source"
+		message: "owned starters require a canonical editable TSX source"
 	});
-	if (corpus.type === "BrandRecreationPreset") {
-		const canonical = Object.entries(brandRecreationProvenance).find(([presetId]) => presetId === id)?.[1];
+	if (corpus.type === "BrandRecreationStarter") {
+		const canonical = Object.entries(brandRecreationProvenance).find(([starterId]) => starterId === id)?.[1];
 		if (canonical === void 0 || Object.entries(canonical).some(([key, value]) => corpus.provenance[key] !== value) || !nonEmpty(corpus.provenance.brand) || !nonEmpty(corpus.provenance.subject) || corpus.retention.policy !== "retain-until-withdrawn" || facets.brandProvenance.some((value) => value !== "third-party-reference")) return Result.err({
 			id,
 			message: "brand recreations require a canonical source, a referenced brand and subject, and third-party provenance"
@@ -189,6 +189,6 @@ const matchesTemplateFacets = (facets, query) => requiredFacetDimensions.every((
 	return selected === void 0 || selected.every((value) => available.has(value));
 });
 //#endregion
-export { brandRecreationProvenance, matchesTemplateFacets, ownedPresetSourcePath, ownedShowcasePresetSources, registerPublicCorpusEntry, templateFacetOptions };
+export { brandRecreationProvenance, matchesTemplateFacets, ownedShowcaseStarterSources, ownedStarterSourcePath, registerPublicCorpusEntry, templateFacetOptions };
 
 //# sourceMappingURL=corpus.js.map

package/dist/starters/library.d.ts

@@ -0,0 +1,18 @@
+//#region starters/library.gen.d.ts
+/** One public gallery template whose project the Agents Worker serves at `/library/<digest>.json`. */
+interface LibraryTemplate {
+  readonly slug: string;
+  readonly starterId: string;
+  readonly name: string;
+  /** SHA-256 of the served project bytes, lowercase hex. */
+  readonly digest: string;
+  /** Project-relative paths, so a listing needs no fetch. */
+  readonly paths: ReadonlyArray<string>;
+  readonly byteSize: number;
+}
+declare const libraryTemplates: ReadonlyArray<LibraryTemplate>;
+/** Identifies this exact library; a workspace records it to notice a changed gallery. */
+declare const libraryManifestDigest = "60bd511a973a6d1fe17bc6a03990118dd2a0e8a1f14556f09aaf54713420fd53";
+//#endregion
+export { LibraryTemplate, libraryManifestDigest, libraryTemplates };
+//# sourceMappingURL=library.d.ts.map