@odla-ai/chapter 0.20.2 → 0.22.0

package/dist/index.d.cts

@@ -53,8 +53,50 @@ interface Rule {
 }
 /** Namespace → rule set. */
 type DbRules = Record<string, Rule>;
-/** Brand tokens that theme the site: palette, fonts, wordmark, nav, logos. */
+/** Typed semantic roles shared by the public site and application surfaces. */
+interface ChapterBrandTokens {
+    background?: string;
+    surface?: string;
+    surface2?: string;
+    text?: string;
+    textMuted?: string;
+    textFaint?: string;
+    border?: string;
+    borderStrong?: string;
+    accent?: string;
+    accentStrong?: string;
+    accentSoft?: string;
+    onAccent?: string;
+    good?: string;
+    warn?: string;
+    danger?: string;
+    chart1?: string;
+    chart2?: string;
+    chart3?: string;
+    chart4?: string;
+    chart5?: string;
+    chart6?: string;
+    chartPositive?: string;
+    chartNegative?: string;
+    /** Admin/application content width, e.g. `"960px"`. */
+    contentWidth?: string;
+    panelRadius?: string;
+    panelShadow?: string;
+    masterDetailColumns?: string;
+    masterDetailMinHeight?: string;
+    /** Chapter-admin page padding shorthand. */
+    pagePadding?: string;
+    /** Chapter-admin workspace-tab padding shorthand. */
+    workspacePadding?: string;
+}
+/** Brand tokens that theme the site: theme, semantic roles, fonts, and logos. */
 interface ChapterBrand {
+    /** Preloaded @odla-ai/ui theme name used by ThemeScope. */
+    theme?: string;
+    /** Admin/application color mode. Explicit light is the safe default. */
+    colorScheme?: "light" | "dark" | "system";
+    tokens?: ChapterBrandTokens;
+    tokensDark?: ChapterBrandTokens;
     /** Palette overrides written into styles.css :root (e.g. `{ moss: "#2F3E34" }`
      * or `--ui-*` token names). Applies in BOTH light and dark unless overridden
      * by {@link paletteDark}. */
@@ -88,7 +130,7 @@ interface ChapterNetworkTarget {
     id: string;
     /** Human-facing site name. Defaults to `id`. */
     name?: string;
-    /** Absolute follower origin, e.g. `https://silver.example.com`. */
+    /** Absolute follower origin, e.g. `https://chapter.example.com`. */
     url: string;
     /** Leader-vault key holding this follower's share secret. Defaults to
      * `network_share_<id-with-underscores>`. */
@@ -159,10 +201,10 @@ interface ChapterScheduling {
 }
 /** How a signed-in user's role is determined.
  *
- * - `"claim"` reads a role ladder from a JWT claim (Silver & Salt's model:
+ * - `"claim"` reads a role ladder from a JWT claim (the member-site model:
  *   `provisional → member → admin`). Admin is the last (highest) rung; the
  *   read-only `superAdmins` tier sits above it.
- * - `"table"` gates on the deny-all `admins` allowlist (Built Not Found's model):
+ * - `"table"` gates on the deny-all `admins` allowlist (the hub model):
  *   a binary "email is an admin or isn't", set only in odla Studio.
  *
  * Defaults: `"claim"` in `chapter` mode, `"table"` in `hub` mode. */
@@ -189,7 +231,7 @@ interface ResolvedAuth {
 }
 /** The application status pipeline. Which statuses exist, and the subsets a site
  *  allows a call to be booked from / an application approved from. Defaults to
- *  Silver & Salt's pipeline. Status never moves backwards (package-enforced). */
+ *  the reference pipeline. Status never moves backwards (package-enforced). */
 interface ChapterPipeline {
     stages?: readonly string[];
     bookableFrom?: readonly string[];
@@ -206,8 +248,8 @@ interface ResolvedPipeline {
 }
 /** The application (join form) validation surface — which string fields are
  *  required vs accepted, their max lengths, and the request body cap. Drives
- *  submit validation + the CRM slot projection; defaults to Silver & Salt's form.
- *  The `applications` schema attrs stay fixed (byte-equal to S&S); this is
+ *  submit validation + the CRM slot projection; defaults to the reference form.
+ *  The `applications` schema attrs stay fixed; this is
  *  validation config, not schema generation. */
 interface ChapterApplication {
     required?: readonly string[];
@@ -279,7 +321,7 @@ interface ChapterConfig {
     /** `notificationEmail` required in `chapter` mode. */
     emails?: ChapterEmails;
     scheduling?: ChapterScheduling;
-    /** Application status pipeline (stages + bookable/approvable subsets). Defaults to S&S's. */
+    /** Application status pipeline (stages + bookable/approvable subsets). */
     pipeline?: ChapterPipeline;
     /** Join-form validation (required/optional fields, max lengths, body cap). */
     application?: ChapterApplication;
@@ -439,7 +481,7 @@ declare function createChapterIntegration(chapter: Chapter, options?: ChapterInt
  * `chapter` mode only. The auth tables follow {@link ResolvedAuth}: `source:
  * "table"` adds the `admins` allowlist (hub/BNF); `superAdmins` adds the
  * read-only super-admin tier (default on for the `"claim"` ladder). A `"claim"`
- * chapter therefore emits exactly Silver & Salt's namespace set — `applications`,
+ * chapter therefore emits the reference namespace set — `applications`,
  * `groups`, `meetings`, `emailLog`, `superAdmins` — with no `admins` table. */
 declare function chapterDb(mode: ChapterMode, auth: ResolvedAuth): {
     schema: DbSchema;
@@ -457,8 +499,8 @@ declare function buildGroupSeed(config: ChapterConfig): Record<string, unknown>;
 /**
  * Apply defaults + validate the auth config into a {@link ResolvedAuth}. Defaults
  * by mode: `chapter` → the `provisional/member/admin` claim ladder with the
- * `superAdmins` tier (Silver & Salt); `hub` → the `admins` allowlist table, no
- * super tier (Built Not Found). Throws at import on a bad policy.
+ * `superAdmins` tier; `hub` → the `admins` allowlist table with no super tier.
+ * Throws at import on a bad policy.
  */
 declare function resolveAuth(mode: ChapterMode, auth: ChapterAuth | undefined): ResolvedAuth;
 /** The role from a verified JWT payload, per the resolved policy. An unknown or
@@ -633,8 +675,8 @@ declare function sendTemplated(deps: NotifyDeps, input: NotifyInput): Promise<No
 declare function emailGroupFrom(row: Record<string, unknown>): EmailGroup;
 
 /**
- * Apply defaults + validate the pipeline config. With no config, the full Silver
- * & Salt pipeline. With `stages` given but the subsets omitted, the subsets
+ * Apply defaults + validate the pipeline config. With no config, the complete
+ * reference pipeline. With `stages` given but the subsets omitted, the subsets
  * default to empty (a site opts in to bookable/approvable states explicitly).
  * Throws at import on a bad pipeline (empty/duplicate stages, an initial or a
  * subset entry not on the ladder).
@@ -678,8 +720,7 @@ declare function paymentsReady(group: PaymentsGroup, hasSecretKey: boolean): boo
  *  of nested objects into bracket syntax (`metadata[applicationId]=...`). */
 declare function stripeForm(params: Record<string, unknown>): string;
 /** The Stripe idempotency key for creating an application's subscription — one
- *  per application, so a client retry can't orphan a second subscription (S&S
- *  lacked this; the package enforces it). */
+ *  per application, so a client retry can't orphan a second subscription. */
 declare function subscriptionIdempotencyKey(applicationId: string): string;
 /** The db mutationId for a webhook-driven write — exactly-once per Stripe event,
  *  so replays are deduped at the db layer. */
@@ -941,6 +982,22 @@ declare function bucketSeries(points: Array<{
     weekStart: number;
     value: number;
 }>;
+/** Labels and current/previous values for one dashboard comparison window. */
+interface DashboardMetricSeries {
+    labels: string[];
+    current: number[];
+    previous: number[];
+}
+/** Week-over-week and month-over-month series consumed by MetricWidget. */
+interface DashboardMetricData {
+    wow: DashboardMetricSeries;
+    mom: DashboardMetricSeries;
+}
+/** MetricWidget-ready daily and weekly comparison windows. */
+declare function dashboardMetricData(points: Array<{
+    t: number;
+    v: number;
+}>, now: number): DashboardMetricData;
 /** Annualized cents for a Stripe subscription: sum each item's
  *  `unit_amount * quantity`, ×12 for monthly intervals. A yearly interval is
  *  taken as-is. Returns 0 for a shape with no priced items. */
@@ -1183,7 +1240,9 @@ declare function memberSession(user: SessionUser, opts: {
  * theme. These are brand OVERRIDES on top of a base theme — they do not replace
  * the theme layer the components need (see {@link brandTokens} usage in the docs).
  */
-declare function brandTokens(brand: ChapterBrand | undefined): string;
+declare function brandTokens(brand: ChapterBrand | undefined, options?: {
+    selector?: string;
+}): string;
 
 /** A `meetings` row, as far as reconciliation cares. */
 interface MeetingForReconcile {
@@ -1235,13 +1294,13 @@ interface ResolvedScheduling {
     windowDays: number;
     summaryTemplate: string;
 }
-/** The S&S-proven defaults: 45-minute weekday slots, 9–5 Pacific, 24h notice,
+/** Proven defaults: 45-minute weekday slots, 9–5 Pacific, 24h notice,
  *  a 14-day window. The summary is generic (a chapter's group seed supplies a
  *  name-branded one). */
 declare const SCHEDULING_DEFAULTS: ResolvedScheduling;
 /**
  * Resolve a group's scheduling config against the defaults, validating every
- * bound the way S&S does at config-write time (throws on a bad config, so a
+ * bound at config-write time (throws on a bad config, so a
  * misconfiguration surfaces immediately rather than yielding empty slots).
  * `windowDays` is capped at 62 because Google FreeBusy is.
  */
@@ -1345,4 +1404,4 @@ type ApplicationBookingPatch = {
  *  already there (never backward). */
 declare function applicationBookingUpdate(currentStatus: string, startAt: number, htmlLink?: string | null): ApplicationBookingPatch;
 
-export { type AccountModel, type AdminNotificationTrigger, type Applicant, type ApplicationBookingPatch, type ApplicationRecord, type ApplicationSummary, type Attr, type AttrType, type Chapter, type ChapterApplication, type ChapterAuth, type ChapterBrand, type ChapterConfig, type ChapterDb, type ChapterEmails, type ChapterIntegrationDescriptor, type ChapterIntegrationOptions, type ChapterMode, type ChapterNetwork, type ChapterNetworkTarget, type ChapterOperations, type ChapterPipeline, type ChapterPolicy, type ChapterPrices, type ChapterScheduling, type ChapterSends, type ClerkInviteInput, type ClerkResult, type ClerkUserInput, type ClerkUserRecord, DEFAULT_SHARE_FIELDS, type DbOp, type DbRules, type DbSchema, type DeliveryDecision, type EmailGroup, type EmailTemplate, type EmailTemplateRow, type Entity, type ExistingMeeting, type GuardResult, type IntegrationDescriptor, type IntegrationProvision, type IntegrationSecret, type IntegrationSetting, type IntegrationSync, type JoinConfigGroup, type LiveEvent, type MailSender, type MeetingForReconcile, type MeetingRecord, type MeetingReschedulePatch, type MemberApplication, type MemberSession, type NewMeetingRow, type NotifyDeps, type NotifyInput, type NotifyResult, type PaymentsGroup, type ProjectionDeps, type ReconcileDecision, type ResolvedApplication, type ResolvedAuth, type ResolvedNetwork, type ResolvedNetworkTarget, type ResolvedOperations, type ResolvedPipeline, type ResolvedScheduling, type ResolvedSends, type RoleChangeContext, type Rule, SCHEDULING_DEFAULTS, type SchedulingErrors, type SecretMode, type SecretStore, type SessionUser, type SharedBusiness, type SharedPerson, type SharedRecord, type StripeEvent, type StripeResult, type SubmitResult, type WebhookEvent, applicantProfile, applicationBookingUpdate, applicationSummary, backfillCrm, bookingDecision, brandTokens, bucketSeries, buildGroupSeed, canApprove, canBook, canChangeRole, canTransition, canceledPatch, chapterDb, clampArray, clerkGetUser, clerkGetUserByEmail, clerkIntegration, clerkInviteRequest, clerkListUsers, clerkSetRole, clerkUserRequest, createChapterIntegration, createClerkInvitation, createClerkUser, defaultCrm, defineChapter, emailGroupFrom, endForSlot, findApplicationRef, firstPaymentPatch, getVaultSecret, hasDisclaimerAck, introIdempotencyKey, isAdminRole, isAlreadySent, isReconcilable, isSlotAvailable, isValidEmail, joinConfig, meetingCreateRow, meetingRescheduleUpdate, memberApplication, memberSession, networkSourceTag, normalizeSharedRecord, normalizeWebhookEvent, paymentsReady, personInputFromApp, planDelivery, projectApplicant, projectSharedRecord, reconcileMeetings, refundedPatch, render, renderSummary, renderTemplateBody, renewalPatch, resolveApplication, resolveAuth, resolvePipeline, resolveScheduling, roleFromClaim, sendTemplated, sharedPersonInput, sharedRecordFromCrm, slotWindow, stageIndex, stripeCall, stripeForm, subAnnualCents, submitApplication, subscriptionIdempotencyKey, syncApplicationToCrm, validateScheduling, verifyStripeSignature, webhookMutationId };
+export { type AccountModel, type AdminNotificationTrigger, type Applicant, type ApplicationBookingPatch, type ApplicationRecord, type ApplicationSummary, type Attr, type AttrType, type Chapter, type ChapterApplication, type ChapterAuth, type ChapterBrand, type ChapterConfig, type ChapterDb, type ChapterEmails, type ChapterIntegrationDescriptor, type ChapterIntegrationOptions, type ChapterMode, type ChapterNetwork, type ChapterNetworkTarget, type ChapterOperations, type ChapterPipeline, type ChapterPolicy, type ChapterPrices, type ChapterScheduling, type ChapterSends, type ClerkInviteInput, type ClerkResult, type ClerkUserInput, type ClerkUserRecord, DEFAULT_SHARE_FIELDS, type DashboardMetricData, type DashboardMetricSeries, type DbOp, type DbRules, type DbSchema, type DeliveryDecision, type EmailGroup, type EmailTemplate, type EmailTemplateRow, type Entity, type ExistingMeeting, type GuardResult, type IntegrationDescriptor, type IntegrationProvision, type IntegrationSecret, type IntegrationSetting, type IntegrationSync, type JoinConfigGroup, type LiveEvent, type MailSender, type MeetingForReconcile, type MeetingRecord, type MeetingReschedulePatch, type MemberApplication, type MemberSession, type NewMeetingRow, type NotifyDeps, type NotifyInput, type NotifyResult, type PaymentsGroup, type ProjectionDeps, type ReconcileDecision, type ResolvedApplication, type ResolvedAuth, type ResolvedNetwork, type ResolvedNetworkTarget, type ResolvedOperations, type ResolvedPipeline, type ResolvedScheduling, type ResolvedSends, type RoleChangeContext, type Rule, SCHEDULING_DEFAULTS, type SchedulingErrors, type SecretMode, type SecretStore, type SessionUser, type SharedBusiness, type SharedPerson, type SharedRecord, type StripeEvent, type StripeResult, type SubmitResult, type WebhookEvent, applicantProfile, applicationBookingUpdate, applicationSummary, backfillCrm, bookingDecision, brandTokens, bucketSeries, buildGroupSeed, canApprove, canBook, canChangeRole, canTransition, canceledPatch, chapterDb, clampArray, clerkGetUser, clerkGetUserByEmail, clerkIntegration, clerkInviteRequest, clerkListUsers, clerkSetRole, clerkUserRequest, createChapterIntegration, createClerkInvitation, createClerkUser, dashboardMetricData, defaultCrm, defineChapter, emailGroupFrom, endForSlot, findApplicationRef, firstPaymentPatch, getVaultSecret, hasDisclaimerAck, introIdempotencyKey, isAdminRole, isAlreadySent, isReconcilable, isSlotAvailable, isValidEmail, joinConfig, meetingCreateRow, meetingRescheduleUpdate, memberApplication, memberSession, networkSourceTag, normalizeSharedRecord, normalizeWebhookEvent, paymentsReady, personInputFromApp, planDelivery, projectApplicant, projectSharedRecord, reconcileMeetings, refundedPatch, render, renderSummary, renderTemplateBody, renewalPatch, resolveApplication, resolveAuth, resolvePipeline, resolveScheduling, roleFromClaim, sendTemplated, sharedPersonInput, sharedRecordFromCrm, slotWindow, stageIndex, stripeCall, stripeForm, subAnnualCents, submitApplication, subscriptionIdempotencyKey, syncApplicationToCrm, validateScheduling, verifyStripeSignature, webhookMutationId };

package/dist/index.d.ts

@@ -53,8 +53,50 @@ interface Rule {
 }
 /** Namespace → rule set. */
 type DbRules = Record<string, Rule>;
-/** Brand tokens that theme the site: palette, fonts, wordmark, nav, logos. */
+/** Typed semantic roles shared by the public site and application surfaces. */
+interface ChapterBrandTokens {
+    background?: string;
+    surface?: string;
+    surface2?: string;
+    text?: string;
+    textMuted?: string;
+    textFaint?: string;
+    border?: string;
+    borderStrong?: string;
+    accent?: string;
+    accentStrong?: string;
+    accentSoft?: string;
+    onAccent?: string;
+    good?: string;
+    warn?: string;
+    danger?: string;
+    chart1?: string;
+    chart2?: string;
+    chart3?: string;
+    chart4?: string;
+    chart5?: string;
+    chart6?: string;
+    chartPositive?: string;
+    chartNegative?: string;
+    /** Admin/application content width, e.g. `"960px"`. */
+    contentWidth?: string;
+    panelRadius?: string;
+    panelShadow?: string;
+    masterDetailColumns?: string;
+    masterDetailMinHeight?: string;
+    /** Chapter-admin page padding shorthand. */
+    pagePadding?: string;
+    /** Chapter-admin workspace-tab padding shorthand. */
+    workspacePadding?: string;
+}
+/** Brand tokens that theme the site: theme, semantic roles, fonts, and logos. */
 interface ChapterBrand {
+    /** Preloaded @odla-ai/ui theme name used by ThemeScope. */
+    theme?: string;
+    /** Admin/application color mode. Explicit light is the safe default. */
+    colorScheme?: "light" | "dark" | "system";
+    tokens?: ChapterBrandTokens;
+    tokensDark?: ChapterBrandTokens;
     /** Palette overrides written into styles.css :root (e.g. `{ moss: "#2F3E34" }`
      * or `--ui-*` token names). Applies in BOTH light and dark unless overridden
      * by {@link paletteDark}. */
@@ -88,7 +130,7 @@ interface ChapterNetworkTarget {
     id: string;
     /** Human-facing site name. Defaults to `id`. */
     name?: string;
-    /** Absolute follower origin, e.g. `https://silver.example.com`. */
+    /** Absolute follower origin, e.g. `https://chapter.example.com`. */
     url: string;
     /** Leader-vault key holding this follower's share secret. Defaults to
      * `network_share_<id-with-underscores>`. */
@@ -159,10 +201,10 @@ interface ChapterScheduling {
 }
 /** How a signed-in user's role is determined.
  *
- * - `"claim"` reads a role ladder from a JWT claim (Silver & Salt's model:
+ * - `"claim"` reads a role ladder from a JWT claim (the member-site model:
  *   `provisional → member → admin`). Admin is the last (highest) rung; the
  *   read-only `superAdmins` tier sits above it.
- * - `"table"` gates on the deny-all `admins` allowlist (Built Not Found's model):
+ * - `"table"` gates on the deny-all `admins` allowlist (the hub model):
  *   a binary "email is an admin or isn't", set only in odla Studio.
  *
  * Defaults: `"claim"` in `chapter` mode, `"table"` in `hub` mode. */
@@ -189,7 +231,7 @@ interface ResolvedAuth {
 }
 /** The application status pipeline. Which statuses exist, and the subsets a site
  *  allows a call to be booked from / an application approved from. Defaults to
- *  Silver & Salt's pipeline. Status never moves backwards (package-enforced). */
+ *  the reference pipeline. Status never moves backwards (package-enforced). */
 interface ChapterPipeline {
     stages?: readonly string[];
     bookableFrom?: readonly string[];
@@ -206,8 +248,8 @@ interface ResolvedPipeline {
 }
 /** The application (join form) validation surface — which string fields are
  *  required vs accepted, their max lengths, and the request body cap. Drives
- *  submit validation + the CRM slot projection; defaults to Silver & Salt's form.
- *  The `applications` schema attrs stay fixed (byte-equal to S&S); this is
+ *  submit validation + the CRM slot projection; defaults to the reference form.
+ *  The `applications` schema attrs stay fixed; this is
  *  validation config, not schema generation. */
 interface ChapterApplication {
     required?: readonly string[];
@@ -279,7 +321,7 @@ interface ChapterConfig {
     /** `notificationEmail` required in `chapter` mode. */
     emails?: ChapterEmails;
     scheduling?: ChapterScheduling;
-    /** Application status pipeline (stages + bookable/approvable subsets). Defaults to S&S's. */
+    /** Application status pipeline (stages + bookable/approvable subsets). */
     pipeline?: ChapterPipeline;
     /** Join-form validation (required/optional fields, max lengths, body cap). */
     application?: ChapterApplication;
@@ -439,7 +481,7 @@ declare function createChapterIntegration(chapter: Chapter, options?: ChapterInt
  * `chapter` mode only. The auth tables follow {@link ResolvedAuth}: `source:
  * "table"` adds the `admins` allowlist (hub/BNF); `superAdmins` adds the
  * read-only super-admin tier (default on for the `"claim"` ladder). A `"claim"`
- * chapter therefore emits exactly Silver & Salt's namespace set — `applications`,
+ * chapter therefore emits the reference namespace set — `applications`,
  * `groups`, `meetings`, `emailLog`, `superAdmins` — with no `admins` table. */
 declare function chapterDb(mode: ChapterMode, auth: ResolvedAuth): {
     schema: DbSchema;
@@ -457,8 +499,8 @@ declare function buildGroupSeed(config: ChapterConfig): Record<string, unknown>;
 /**
  * Apply defaults + validate the auth config into a {@link ResolvedAuth}. Defaults
  * by mode: `chapter` → the `provisional/member/admin` claim ladder with the
- * `superAdmins` tier (Silver & Salt); `hub` → the `admins` allowlist table, no
- * super tier (Built Not Found). Throws at import on a bad policy.
+ * `superAdmins` tier; `hub` → the `admins` allowlist table with no super tier.
+ * Throws at import on a bad policy.
  */
 declare function resolveAuth(mode: ChapterMode, auth: ChapterAuth | undefined): ResolvedAuth;
 /** The role from a verified JWT payload, per the resolved policy. An unknown or
@@ -633,8 +675,8 @@ declare function sendTemplated(deps: NotifyDeps, input: NotifyInput): Promise<No
 declare function emailGroupFrom(row: Record<string, unknown>): EmailGroup;
 
 /**
- * Apply defaults + validate the pipeline config. With no config, the full Silver
- * & Salt pipeline. With `stages` given but the subsets omitted, the subsets
+ * Apply defaults + validate the pipeline config. With no config, the complete
+ * reference pipeline. With `stages` given but the subsets omitted, the subsets
  * default to empty (a site opts in to bookable/approvable states explicitly).
  * Throws at import on a bad pipeline (empty/duplicate stages, an initial or a
  * subset entry not on the ladder).
@@ -678,8 +720,7 @@ declare function paymentsReady(group: PaymentsGroup, hasSecretKey: boolean): boo
  *  of nested objects into bracket syntax (`metadata[applicationId]=...`). */
 declare function stripeForm(params: Record<string, unknown>): string;
 /** The Stripe idempotency key for creating an application's subscription — one
- *  per application, so a client retry can't orphan a second subscription (S&S
- *  lacked this; the package enforces it). */
+ *  per application, so a client retry can't orphan a second subscription. */
 declare function subscriptionIdempotencyKey(applicationId: string): string;
 /** The db mutationId for a webhook-driven write — exactly-once per Stripe event,
  *  so replays are deduped at the db layer. */
@@ -941,6 +982,22 @@ declare function bucketSeries(points: Array<{
     weekStart: number;
     value: number;
 }>;
+/** Labels and current/previous values for one dashboard comparison window. */
+interface DashboardMetricSeries {
+    labels: string[];
+    current: number[];
+    previous: number[];
+}
+/** Week-over-week and month-over-month series consumed by MetricWidget. */
+interface DashboardMetricData {
+    wow: DashboardMetricSeries;
+    mom: DashboardMetricSeries;
+}
+/** MetricWidget-ready daily and weekly comparison windows. */
+declare function dashboardMetricData(points: Array<{
+    t: number;
+    v: number;
+}>, now: number): DashboardMetricData;
 /** Annualized cents for a Stripe subscription: sum each item's
  *  `unit_amount * quantity`, ×12 for monthly intervals. A yearly interval is
  *  taken as-is. Returns 0 for a shape with no priced items. */
@@ -1183,7 +1240,9 @@ declare function memberSession(user: SessionUser, opts: {
  * theme. These are brand OVERRIDES on top of a base theme — they do not replace
  * the theme layer the components need (see {@link brandTokens} usage in the docs).
  */
-declare function brandTokens(brand: ChapterBrand | undefined): string;
+declare function brandTokens(brand: ChapterBrand | undefined, options?: {
+    selector?: string;
+}): string;
 
 /** A `meetings` row, as far as reconciliation cares. */
 interface MeetingForReconcile {
@@ -1235,13 +1294,13 @@ interface ResolvedScheduling {
     windowDays: number;
     summaryTemplate: string;
 }
-/** The S&S-proven defaults: 45-minute weekday slots, 9–5 Pacific, 24h notice,
+/** Proven defaults: 45-minute weekday slots, 9–5 Pacific, 24h notice,
  *  a 14-day window. The summary is generic (a chapter's group seed supplies a
  *  name-branded one). */
 declare const SCHEDULING_DEFAULTS: ResolvedScheduling;
 /**
  * Resolve a group's scheduling config against the defaults, validating every
- * bound the way S&S does at config-write time (throws on a bad config, so a
+ * bound at config-write time (throws on a bad config, so a
  * misconfiguration surfaces immediately rather than yielding empty slots).
  * `windowDays` is capped at 62 because Google FreeBusy is.
  */
@@ -1345,4 +1404,4 @@ type ApplicationBookingPatch = {
  *  already there (never backward). */
 declare function applicationBookingUpdate(currentStatus: string, startAt: number, htmlLink?: string | null): ApplicationBookingPatch;
 
-export { type AccountModel, type AdminNotificationTrigger, type Applicant, type ApplicationBookingPatch, type ApplicationRecord, type ApplicationSummary, type Attr, type AttrType, type Chapter, type ChapterApplication, type ChapterAuth, type ChapterBrand, type ChapterConfig, type ChapterDb, type ChapterEmails, type ChapterIntegrationDescriptor, type ChapterIntegrationOptions, type ChapterMode, type ChapterNetwork, type ChapterNetworkTarget, type ChapterOperations, type ChapterPipeline, type ChapterPolicy, type ChapterPrices, type ChapterScheduling, type ChapterSends, type ClerkInviteInput, type ClerkResult, type ClerkUserInput, type ClerkUserRecord, DEFAULT_SHARE_FIELDS, type DbOp, type DbRules, type DbSchema, type DeliveryDecision, type EmailGroup, type EmailTemplate, type EmailTemplateRow, type Entity, type ExistingMeeting, type GuardResult, type IntegrationDescriptor, type IntegrationProvision, type IntegrationSecret, type IntegrationSetting, type IntegrationSync, type JoinConfigGroup, type LiveEvent, type MailSender, type MeetingForReconcile, type MeetingRecord, type MeetingReschedulePatch, type MemberApplication, type MemberSession, type NewMeetingRow, type NotifyDeps, type NotifyInput, type NotifyResult, type PaymentsGroup, type ProjectionDeps, type ReconcileDecision, type ResolvedApplication, type ResolvedAuth, type ResolvedNetwork, type ResolvedNetworkTarget, type ResolvedOperations, type ResolvedPipeline, type ResolvedScheduling, type ResolvedSends, type RoleChangeContext, type Rule, SCHEDULING_DEFAULTS, type SchedulingErrors, type SecretMode, type SecretStore, type SessionUser, type SharedBusiness, type SharedPerson, type SharedRecord, type StripeEvent, type StripeResult, type SubmitResult, type WebhookEvent, applicantProfile, applicationBookingUpdate, applicationSummary, backfillCrm, bookingDecision, brandTokens, bucketSeries, buildGroupSeed, canApprove, canBook, canChangeRole, canTransition, canceledPatch, chapterDb, clampArray, clerkGetUser, clerkGetUserByEmail, clerkIntegration, clerkInviteRequest, clerkListUsers, clerkSetRole, clerkUserRequest, createChapterIntegration, createClerkInvitation, createClerkUser, defaultCrm, defineChapter, emailGroupFrom, endForSlot, findApplicationRef, firstPaymentPatch, getVaultSecret, hasDisclaimerAck, introIdempotencyKey, isAdminRole, isAlreadySent, isReconcilable, isSlotAvailable, isValidEmail, joinConfig, meetingCreateRow, meetingRescheduleUpdate, memberApplication, memberSession, networkSourceTag, normalizeSharedRecord, normalizeWebhookEvent, paymentsReady, personInputFromApp, planDelivery, projectApplicant, projectSharedRecord, reconcileMeetings, refundedPatch, render, renderSummary, renderTemplateBody, renewalPatch, resolveApplication, resolveAuth, resolvePipeline, resolveScheduling, roleFromClaim, sendTemplated, sharedPersonInput, sharedRecordFromCrm, slotWindow, stageIndex, stripeCall, stripeForm, subAnnualCents, submitApplication, subscriptionIdempotencyKey, syncApplicationToCrm, validateScheduling, verifyStripeSignature, webhookMutationId };
+export { type AccountModel, type AdminNotificationTrigger, type Applicant, type ApplicationBookingPatch, type ApplicationRecord, type ApplicationSummary, type Attr, type AttrType, type Chapter, type ChapterApplication, type ChapterAuth, type ChapterBrand, type ChapterConfig, type ChapterDb, type ChapterEmails, type ChapterIntegrationDescriptor, type ChapterIntegrationOptions, type ChapterMode, type ChapterNetwork, type ChapterNetworkTarget, type ChapterOperations, type ChapterPipeline, type ChapterPolicy, type ChapterPrices, type ChapterScheduling, type ChapterSends, type ClerkInviteInput, type ClerkResult, type ClerkUserInput, type ClerkUserRecord, DEFAULT_SHARE_FIELDS, type DashboardMetricData, type DashboardMetricSeries, type DbOp, type DbRules, type DbSchema, type DeliveryDecision, type EmailGroup, type EmailTemplate, type EmailTemplateRow, type Entity, type ExistingMeeting, type GuardResult, type IntegrationDescriptor, type IntegrationProvision, type IntegrationSecret, type IntegrationSetting, type IntegrationSync, type JoinConfigGroup, type LiveEvent, type MailSender, type MeetingForReconcile, type MeetingRecord, type MeetingReschedulePatch, type MemberApplication, type MemberSession, type NewMeetingRow, type NotifyDeps, type NotifyInput, type NotifyResult, type PaymentsGroup, type ProjectionDeps, type ReconcileDecision, type ResolvedApplication, type ResolvedAuth, type ResolvedNetwork, type ResolvedNetworkTarget, type ResolvedOperations, type ResolvedPipeline, type ResolvedScheduling, type ResolvedSends, type RoleChangeContext, type Rule, SCHEDULING_DEFAULTS, type SchedulingErrors, type SecretMode, type SecretStore, type SessionUser, type SharedBusiness, type SharedPerson, type SharedRecord, type StripeEvent, type StripeResult, type SubmitResult, type WebhookEvent, applicantProfile, applicationBookingUpdate, applicationSummary, backfillCrm, bookingDecision, brandTokens, bucketSeries, buildGroupSeed, canApprove, canBook, canChangeRole, canTransition, canceledPatch, chapterDb, clampArray, clerkGetUser, clerkGetUserByEmail, clerkIntegration, clerkInviteRequest, clerkListUsers, clerkSetRole, clerkUserRequest, createChapterIntegration, createClerkInvitation, createClerkUser, dashboardMetricData, defaultCrm, defineChapter, emailGroupFrom, endForSlot, findApplicationRef, firstPaymentPatch, getVaultSecret, hasDisclaimerAck, introIdempotencyKey, isAdminRole, isAlreadySent, isReconcilable, isSlotAvailable, isValidEmail, joinConfig, meetingCreateRow, meetingRescheduleUpdate, memberApplication, memberSession, networkSourceTag, normalizeSharedRecord, normalizeWebhookEvent, paymentsReady, personInputFromApp, planDelivery, projectApplicant, projectSharedRecord, reconcileMeetings, refundedPatch, render, renderSummary, renderTemplateBody, renewalPatch, resolveApplication, resolveAuth, resolvePipeline, resolveScheduling, roleFromClaim, sendTemplated, sharedPersonInput, sharedRecordFromCrm, slotWindow, stageIndex, stripeCall, stripeForm, subAnnualCents, submitApplication, subscriptionIdempotencyKey, syncApplicationToCrm, validateScheduling, verifyStripeSignature, webhookMutationId };

package/dist/index.js

@@ -1111,6 +1111,31 @@ function bucketSeries(points, now, weeks = 12) {
   }
   return buckets;
 }
+function periodSeries(points, now, count, periodMs) {
+  const start = now - count * periodMs;
+  const previousStart = start - count * periodMs;
+  const current = Array.from({ length: count }, () => 0);
+  const previous = Array.from({ length: count }, () => 0);
+  for (const point of points) {
+    if (!Number.isFinite(point.t) || !Number.isFinite(point.v)) continue;
+    if (point.t >= start && point.t <= now) {
+      const index = Math.min(count - 1, Math.floor((point.t - start) / periodMs));
+      current[index] = (current[index] ?? 0) + point.v;
+    } else if (point.t >= previousStart && point.t < start) {
+      const index = Math.min(count - 1, Math.floor((point.t - previousStart) / periodMs));
+      previous[index] = (previous[index] ?? 0) + point.v;
+    }
+  }
+  const labels = current.map((_, index) => new Date(start + index * periodMs).toISOString().slice(5, 10));
+  return { labels, current, previous };
+}
+function dashboardMetricData(points, now) {
+  const DAY = 864e5;
+  return {
+    wow: periodSeries(points, now, 7, DAY),
+    mom: periodSeries(points, now, 4, 7 * DAY)
+  };
+}
 function subAnnualCents(sub) {
   const items = sub.items?.data ?? [];
   let cents = 0;
@@ -1367,15 +1392,55 @@ function paletteDecls(palette) {
   }
   return decls;
 }
-function brandTokens(brand) {
+var TOKEN_VARS = {
+  background: "--ui-bg",
+  surface: "--ui-surface",
+  surface2: "--ui-surface-2",
+  text: "--ui-text",
+  textMuted: "--ui-text-muted",
+  textFaint: "--ui-text-faint",
+  border: "--ui-border",
+  borderStrong: "--ui-border-strong",
+  accent: "--ui-accent",
+  accentStrong: "--ui-accent-strong",
+  accentSoft: "--ui-accent-soft",
+  onAccent: "--ui-on-accent",
+  good: "--ui-good",
+  warn: "--ui-warn",
+  danger: "--ui-danger",
+  chart1: "--ui-chart-1",
+  chart2: "--ui-chart-2",
+  chart3: "--ui-chart-3",
+  chart4: "--ui-chart-4",
+  chart5: "--ui-chart-5",
+  chart6: "--ui-chart-6",
+  chartPositive: "--ui-chart-pos",
+  chartNegative: "--ui-chart-neg",
+  contentWidth: "--ui-content-width",
+  panelRadius: "--ui-radius-lg",
+  panelShadow: "--ui-shadow",
+  masterDetailColumns: "--ui-master-detail-columns",
+  masterDetailMinHeight: "--ui-master-detail-min-height",
+  pagePadding: "--chapter-admin-page-padding",
+  workspacePadding: "--chapter-admin-workspace-padding"
+};
+function semanticDecls(tokens) {
+  return Object.entries(tokens ?? {}).flatMap(
+    ([key, value]) => typeof value === "string" && value.trim() ? [`${TOKEN_VARS[key]}: ${cleanValue(value)};`] : []
+  );
+}
+function brandTokens(brand, options = {}) {
   if (!brand) return "";
-  const light = paletteDecls(brand.palette);
+  const light = [...paletteDecls(brand.palette), ...semanticDecls(brand.tokens)];
   const fonts = brand.fonts;
   if (fonts?.display) light.push(`--ui-font-display: ${cleanValue(fonts.display)};`);
   if (fonts?.body) light.push(`--ui-font-sans: ${cleanValue(fonts.body)};`);
   if (fonts?.numeral) light.push(`--ui-font-numeral: ${cleanValue(fonts.numeral)};`);
-  const dark = paletteDecls(brand.paletteDark);
-  let css = light.length ? `:root {
+  const dark = [...paletteDecls(brand.paletteDark), ...semanticDecls(brand.tokensDark)];
+  const selector = options.selector ?? ":root";
+  const darkSelector = selector === ":root" ? ':root[data-theme="dark"]' : `${selector}[data-theme="dark"]`;
+  const systemSelector = selector === ":root" ? ':root:not([data-theme="light"])' : `${selector}:not([data-theme="light"])`;
+  let css = light.length ? `${selector} {
   ${light.join("\n  ")}
 }
 ` : "";
@@ -1383,9 +1448,9 @@ function brandTokens(brand) {
     const block = `{
   ${dark.join("\n  ")}
 }`;
-    css += `:root[data-theme="dark"] ${block}
+    css += `${darkSelector} ${block}
 @media (prefers-color-scheme: dark) {
-  :root:not([data-theme="light"]) ${block}
+  ${systemSelector} ${block}
 }
 `;
   }
@@ -1558,6 +1623,7 @@ export {
   createChapterIntegration,
   createClerkInvitation,
   createClerkUser,
+  dashboardMetricData,
   defaultCrm,
   defineChapter,
   emailGroupFrom,