@openrails/contentkit-ui 0.94.0 → 0.95.1

package/README.md

@@ -290,18 +290,75 @@ cover at 3:1.
 
 ### Card lists: decorations and locked cards
 
-Every card list (`ContentGrid`, `ContentListing`, `ContentRail`,
+Every card list (`ContentGrid`, `ContentListing`, `ContentRail`, `DailyReleases`,
 `SearchResults`, `ContentHistory`) and `ContentCard` take `decorate(card)`:
 the host's badges, drawn over the cover (place them yourself; clicks reach
 the card, and click signals stay intact). Cards carry what badges need:
 `access.level` and `access.tiers` (the effective rule, the same for every
 reader), `version.has_audio`, `viewer.favorited` and `entities`.
 
+Hosts can tailor the details without replacing the card. For example,
+`metadata={{ languages: false, traits: ["colored"], duration: false }}` keeps
+the page count and the Colored trait, and `showCounts={false}` hides reaction
+totals. `groupKinds={["series"]}` selects series chips;
+`filterEntity={(entity, kind) => ...}` filters them before the chip limit.
+Defaults continue to show all normal metadata, entity chips and totals.
+
+For a poster-style card, set `aspectRatio="182 / 260"`,
+`titlePosition="cover"` and `entityStyle="text"`. The title is a single
+accessible link over the cover's bottom gradient; entities remain clickable
+without chip borders. The ratio overrides `shape` and also applies to loading
+placeholders. These options work through every card grid, rail and daily feed;
+omitting them retains the default ratio, title below the image and chips.
+Plain-text entities sit directly below the cover, followed by other metadata.
+
+```tsx
+<ContentGrid query={{ kind: "gallery" }}
+  aspectRatio="182 / 260" titlePosition="cover" entityStyle="text"
+  groupKinds={["series"]} showCounts={false}
+  metadata={{ languages: false, traits: ["colored"], duration: false }} />
+```
+
+Set `grid={{ minCardWidth: 320, mobileColumns: 2 }}` for large covers in a fluid
+grid: two columns on small screens, then as many columns as the available
+width supports. This is supported by card grids, daily releases, Popular and
+`ContentRail` previews; an unconfigured rail remains horizontal. There is no
+desktop column ceiling, and other apps keep their existing layout by default.
+
 `ContentGrid` and `ContentListing` take `locked`: `show` (default) marks the
 cards the reader doesn't open, `hide` leaves them out, and `collapse` lists
 the open ones and puts the rest behind a counted toggle that loads them on
 opening (`useLockedCount` counts them).
 
+### Daily releases
+
+```tsx
+<DailyReleases query={{ kind: "gallery", days: 10 }} initialVisible={30} />
+```
+
+`DailyReleases` fetches all card metadata for the calendar window in one
+`GET /releases` request. It uses the browser's IANA time zone unless
+`query.time_zone` is supplied. Days appear newest first as keyboard-accessible
+disclosures, with reduced-motion support. The initial card budget is shared
+across days, newest first. Opening older days or choosing **Show more** reveals
+already-fetched cards; it does not make another listing request.
+
+Only revealed cards occupy the grid, and images/previews mount when those cards
+enter the viewport. Collapsing a day removes its media. The standard card
+properties (`href`, `decorate`, `groupKinds`, `tiers`, and so on) remain available.
+For a custom layout, `useDailyReleases(query)` exposes the same shared read and
+`client.discovery.releases(query)` exposes the typed request directly.
+
+`published_within` filters a listing by publication age independently of its
+ranking window. For example, `{ sort: "popular:7d", published_within: "7d" }`
+ranks only content published during the past seven days.
+
+`<PopularContentGrid query={{ kind: "gallery" }} />` supplies the 7-day,
+90-day, 365-day and all-time selector, keeps score and age windows matched,
+and loads further pages as the reader scrolls. `period` and `onPeriodChange`
+optionally keep its state in the host's URL. For a homepage preview, pass
+`popularQuery("7d", { kind: "gallery", limit: 6 })` to a `ContentRail`'s `list`.
+
 ### MediaFolderEditor
 
 ```tsx

package/dist/client/discovery.d.ts

@@ -1,4 +1,4 @@
-import { ContentFilters, ContentFiltersUpdate, ContentPage, ExposureInput, RecentSearches, ReleaseDates, SignalInput, Typeahead } from './generated/wire.js';
+import { ContentFilters, ContentFiltersUpdate, ContentPage, DailyReleases, ExposureInput, RecentSearches, ReleaseDates, SignalInput, Typeahead } from './generated/wire.js';
 import { Http } from './http.js';
 import { BrowserSearchHistory } from './browser-search-history.js';
 /** A popularity period. */
@@ -28,6 +28,8 @@ export interface ContentFilterQuery {
     attribute?: readonly string[];
     /** Published on this day (YYYY-MM-DD) or month (YYYY-MM). */
     released_on?: string;
+    /** Only contents published within this age window; independent of the popularity score window. */
+    published_within?: Period;
     /** IANA time zone of released_on and release dates; UTC by default. */
     tz?: string;
     /** The signed-in reader's unseen, in-progress or completed contents. */
@@ -52,6 +54,10 @@ export interface PageQuery {
 export type ContentQuery = ContentFilterQuery & ReaderQuery & CardQuery & PageQuery & {
     sort?: ListSort;
 };
+export type PopularPeriod = "7d" | "90d" | "365d" | "all";
+export type PopularQuery = Omit<ContentQuery, "sort" | "published_within">;
+/** Match the popularity score window and publication age window. */
+export declare function popularQuery(period?: PopularPeriod, filters?: PopularQuery): ContentQuery;
 export type SearchQuery = ContentFilterQuery & ReaderQuery & CardQuery & PageQuery & {
     q: string;
     sort?: "relevance" | ListSort;
@@ -71,6 +77,11 @@ export type RailQuery = ContentFilterQuery & ReaderQuery & CardQuery & {
 export type ReleaseDatesQuery = ContentFilterQuery & ReaderQuery & PageQuery & {
     by?: "month" | "day";
 };
+/** Complete daily metadata for one calendar window, without pagination. */
+export type DailyReleasesQuery = Omit<ContentFilterQuery, "released_on" | "tz"> & ReaderQuery & CardQuery & {
+    days?: number;
+    time_zone?: string;
+};
 export type HistoryQuery = ReaderQuery & CardQuery & PageQuery & {
     kind?: string;
     status?: "seen" | "in_progress" | "completed";
@@ -114,6 +125,8 @@ export declare class DiscoveryClient {
     recommendations(q?: RailQuery, signal?: AbortSignal): Promise<ContentPage>;
     /** Per month or day, newest first: how many contents the reader's listing shows released then, and how many are free. */
     releaseDates(q?: ReleaseDatesQuery, signal?: AbortSignal): Promise<ReleaseDates>;
+    /** Every visible card in each day; opening or expanding a day needs no further request. */
+    releases(q?: DailyReleasesQuery, signal?: AbortSignal): Promise<DailyReleases>;
     contentFilters(language?: string, signal?: AbortSignal): Promise<ContentFilters>;
     /** Replaces the reader's filter settings; every read applies them. */
     setContentFilters(update: ContentFiltersUpdate, language?: string): Promise<ContentFilters>;

package/dist/client/discovery.js

@@ -1,7 +1,14 @@
 import { call as e, routeURL as t } from "./route.js";
 import { browserSearchHistory as n } from "./browser-search-history.js";
 //#region src/client/discovery.ts
-var r = /* @__PURE__ */ new Set([
+function r(e = "7d", t = {}) {
+	return {
+		...t,
+		sort: `popular:${e}`,
+		published_within: e
+	};
+}
+var i = /* @__PURE__ */ new Set([
 	"groups",
 	"exclude_groups",
 	"creators",
@@ -11,12 +18,12 @@ var r = /* @__PURE__ */ new Set([
 	"card_entities",
 	"entity_kinds"
 ]);
-function i(e) {
+function a(e) {
 	let t = {};
-	for (let [n, i] of Object.entries(e)) t[n] = r.has(n) && Array.isArray(i) ? i.length ? i.join(",") : void 0 : i;
+	for (let [n, r] of Object.entries(e)) t[n] = i.has(n) && Array.isArray(r) ? r.length ? r.join(",") : void 0 : r;
 	return t;
 }
-var a = class {
+var o = class {
 	http;
 	browserSearches;
 	constructor(e) {
@@ -24,16 +31,16 @@ var a = class {
 	}
 	list(t = {}, n) {
 		return e(this.http, "GET", "/contents", {
-			query: i(t),
+			query: a(t),
 			signal: n
 		});
 	}
 	async search(t, n) {
-		let r = t.cursor ? null : this.http.captureChanges(), a = await e(this.http, "GET", "/search", {
-			query: i(t),
+		let r = t.cursor ? null : this.http.captureChanges(), i = await e(this.http, "GET", "/search", {
+			query: a(t),
 			signal: n
 		});
-		return r?.({ type: "searches.changed" }), a;
+		return r?.({ type: "searches.changed" }), i;
 	}
 	recentSearches(t = {}, n) {
 		return e(this.http, "GET", "/me/searches", {
@@ -47,26 +54,32 @@ var a = class {
 	}
 	typeahead(t, n) {
 		return e(this.http, "GET", "/typeahead", {
-			query: i(t),
+			query: a(t),
 			signal: n
 		});
 	}
 	similar(t, n = {}, r) {
 		return e(this.http, "GET", "/contents/{id}/similar", {
 			params: { id: t },
-			query: i(n),
+			query: a(n),
 			signal: r
 		});
 	}
 	recommendations(t = {}, n) {
 		return e(this.http, "GET", "/recommendations", {
-			query: i(t),
+			query: a(t),
 			signal: n
 		});
 	}
 	releaseDates(t = {}, n) {
 		return e(this.http, "GET", "/release-dates", {
-			query: i(t),
+			query: a(t),
+			signal: n
+		});
+	}
+	releases(t = {}, n) {
+		return e(this.http, "GET", "/releases", {
+			query: a(t),
 			signal: n
 		});
 	}
@@ -86,7 +99,7 @@ var a = class {
 	}
 	history(t = {}, n) {
 		return e(this.http, "GET", "/me/history", {
-			query: i(t),
+			query: a(t),
 			signal: n
 		});
 	}
@@ -116,6 +129,6 @@ var a = class {
 	}
 };
 //#endregion
-export { a as DiscoveryClient, i as query };
+export { o as DiscoveryClient, r as popularQuery, a as query };
 
 //# sourceMappingURL=discovery.js.map

package/dist/client/discovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.js","names":[],"sources":["../../src/client/discovery.ts"],"sourcesContent":["import type {\n  ContentFilters,\n  ContentFiltersUpdate,\n  ContentPage,\n  ExposureInput,\n  Exposures,\n  RecentSearches,\n  ReleaseDates,\n  SignalInput,\n  Signals,\n  Typeahead,\n} from \"./generated/wire.js\";\nimport type { Http } from \"./http.js\";\nimport { call, routeURL } from \"./route.js\";\nimport { browserSearchHistory, type BrowserSearchHistory } from \"./browser-search-history.js\";\n\n/** A popularity period. */\nexport type Period = \"7d\" | \"30d\" | \"90d\" | \"365d\" | \"all\";\n/** A list's order; position orders by the first of `groups` (an ordered group). */\nexport type ListSort = \"newest\" | \"oldest\" | \"title\" | \"popular\" | `popular:${Period}` | \"top_rated\" | `top_rated:${Period}` | \"most_favorited\" | \"most_viewed\" | \"position\" | \"random\";\n/** How locked contents list: marked (lock, the default) or left out (hide). */\nexport type AccessMode = \"lock\" | \"hide\";\n\n/** Which contents a list holds. */\nexport interface ContentFilterQuery {\n  kind?: string;\n  /** Group ids every listed version is in. */\n  groups?: readonly string[];\n  /** Group ids no listed version is in. */\n  exclude_groups?: readonly string[];\n  /** Only contents this group owns: a channel's feed. */\n  owner_group?: string;\n  /** User ids: only contents one of them is credited on. */\n  creators?: readonly string[];\n  /** public (anyone opens it now) or the level it stays locked at. */\n  access?: readonly (\"public\" | \"tier\" | \"group\" | \"ppv\" | \"group_ppv\")[];\n  /** Only contents locked behind one of these tiers. */\n  tiers?: readonly string[];\n  /** Version traits every listed version has. */\n  traits?: readonly string[];\n  /** \"name:value\" of the kind's filterable attributes. */\n  attribute?: readonly string[];\n  /** Published on this day (YYYY-MM-DD) or month (YYYY-MM). */\n  released_on?: string;\n  /** IANA time zone of released_on and release dates; UTC by default. */\n  tz?: string;\n  /** The signed-in reader's unseen, in-progress or completed contents. */\n  view_status?: \"unseen\" | \"in_progress\" | \"completed\";\n}\n\n/** How a list reads to its reader. */\nexport interface ReaderQuery {\n  /** Only content with a live version in this language. */\n  language?: string;\n  /** Titles, names and paths in this language, and each card's preferred version's; language by default. */\n  display_language?: string;\n  mode?: AccessMode;\n}\n\n/** The group kinds cards name; every kind with a page by default. */\nexport interface CardQuery {\n  card_entities?: readonly string[];\n}\n\nexport interface PageQuery {\n  cursor?: string;\n  limit?: number;\n}\n\nexport type ContentQuery = ContentFilterQuery & ReaderQuery & CardQuery & PageQuery & { sort?: ListSort };\nexport type SearchQuery = ContentFilterQuery &\n  ReaderQuery &\n  CardQuery &\n  PageQuery & {\n    q: string;\n    sort?: \"relevance\" | ListSort;\n    personalize?: boolean;\n    /** Explicit legacy server-side anonymous history. Omit for public search without server history. */\n    session?: string;\n  };\nexport interface RecentSearchesQuery {\n  /** Explicit legacy server-side anonymous history; no anonymous session is created by default. */\n  session?: string;\n  /** 10 by default, at most 100. */\n  limit?: number;\n}\nexport type RailQuery = ContentFilterQuery & ReaderQuery & CardQuery & { limit?: number };\nexport type ReleaseDatesQuery = ContentFilterQuery & ReaderQuery & PageQuery & { by?: \"month\" | \"day\" };\nexport type HistoryQuery = ReaderQuery & CardQuery & PageQuery & { kind?: string; status?: \"seen\" | \"in_progress\" | \"completed\" };\nexport interface TypeaheadQuery extends ReaderQuery {\n  q: string;\n  /** Only contents of this kind. */\n  kind?: string;\n  /** The group kinds suggested; every kind with a page by default. */\n  entity_kinds?: readonly string[];\n  /** Per section: 8 by default, at most 20. */\n  limit?: number;\n}\n\n// Comma-joined list parameters; `attribute` repeats instead.\nconst LISTS = new Set([\"groups\", \"exclude_groups\", \"creators\", \"access\", \"tiers\", \"traits\", \"card_entities\", \"entity_kinds\"]);\n\n/** A query with its list parameters comma-joined, as discovery routes read them. */\nexport function query(q: object): Record<string, string | number | boolean | readonly string[] | undefined> {\n  const out: Record<string, string | number | boolean | readonly string[] | undefined> = {};\n  for (const [k, v] of Object.entries(q)) out[k] = LISTS.has(k) && Array.isArray(v) ? (v.length ? v.join(\",\") : undefined) : v;\n  return out;\n}\n\n/**\n * Discovery: lists, search, typeahead, similar and recommended contents,\n * release dates, the reader's content filters and history, signals and exposures.\n */\nexport class DiscoveryClient {\n  /** Local anonymous history, isolated from authenticated server history. */\n  readonly browserSearches: BrowserSearchHistory;\n\n  constructor(private readonly http: Http) {\n    this.browserSearches = browserSearchHistory(http.mount(\"discovery\"));\n  }\n\n  /** Contents as cards, one per content item with the version that fits the reader. */\n  list(q: ContentQuery = {}, signal?: AbortSignal): Promise<ContentPage> {\n    return call(this.http, \"GET\", \"/contents\", { query: query(q) as never, signal });\n  }\n  /** A first page is kept among the reader's recent searches. */\n  async search(q: SearchQuery, signal?: AbortSignal): Promise<ContentPage> {\n    const emit = q.cursor ? null : this.http.captureChanges();\n    const out: ContentPage = await call(this.http, \"GET\", \"/search\", { query: query(q) as never, signal });\n    emit?.({ type: \"searches.changed\" });\n    return out;\n  }\n  /** The reader's recent searches, newest first, since they last cleared them. */\n  recentSearches(q: RecentSearchesQuery = {}, signal?: AbortSignal): Promise<RecentSearches> {\n    return call(this.http, \"GET\", \"/me/searches\", { query: q, signal });\n  }\n  /** Clears one recent search, or all of them. */\n  async clearSearches(o: { query?: string; session?: string } = {}): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"DELETE\", \"/me/searches\", { query: o });\n    emit({ type: \"searches.changed\" });\n  }\n  /** Contents and groups while the reader types. */\n  typeahead(q: TypeaheadQuery, signal?: AbortSignal): Promise<Typeahead> {\n    return call(this.http, \"GET\", \"/typeahead\", { query: query(q) as never, signal });\n  }\n  /** Contents like one, of its kind unless q.kind names another. */\n  similar(id: string, q: RailQuery = {}, signal?: AbortSignal): Promise<ContentPage> {\n    return call(this.http, \"GET\", \"/contents/{id}/similar\", { params: { id }, query: query(q) as never, signal });\n  }\n  /** For the signed-in reader. */\n  recommendations(q: RailQuery = {}, signal?: AbortSignal): Promise<ContentPage> {\n    return call(this.http, \"GET\", \"/recommendations\", { query: query(q) as never, signal });\n  }\n  /** Per month or day, newest first: how many contents the reader's listing shows released then, and how many are free. */\n  releaseDates(q: ReleaseDatesQuery = {}, signal?: AbortSignal): Promise<ReleaseDates> {\n    return call(this.http, \"GET\", \"/release-dates\", { query: query(q) as never, signal });\n  }\n  async contentFilters(language?: string, signal?: AbortSignal): Promise<ContentFilters> {\n    const result = await this.http.request<ContentFilters>(routeURL(this.http, \"GET\", \"/content-filters\", { query: { language } }), { signal, guestPreferences: false });\n    this.http.acceptGuestFilters(result.filters);\n    return result;\n  }\n  /** Replaces the reader's filter settings; every read applies them. */\n  async setContentFilters(update: ContentFiltersUpdate, language?: string): Promise<ContentFilters> {\n    const emit = this.http.captureChanges();\n    const out: ContentFilters = await call(this.http, \"PUT\", \"/me/content-filters\", { query: { language }, body: update });\n    emit({ type: \"contentFilters.changed\" });\n    return out;\n  }\n  /** What the reader engaged with, most recent first. */\n  history(q: HistoryQuery = {}, signal?: AbortSignal): Promise<ContentPage> {\n    return call(this.http, \"GET\", \"/me/history\", { query: query(q) as never, signal });\n  }\n  /** Erases the reader's history: of one content item, one kind or everything. */\n  async forgetHistory(o: { kind?: string; content_id?: string } = {}): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"DELETE\", \"/me/history\", { query: o });\n    emit({ type: \"history.changed\" });\n  }\n  /** Views and clicks; signed out, of the session named. */\n  signals(signals: SignalInput[], session?: string, o: { keepalive?: boolean } = {}): Promise<void> {\n    const body: Signals = { session, signals };\n    return call(this.http, \"POST\", \"/signals\", { body, keepalive: o.keepalive });\n  }\n  /** Result lists served, rendered or shown, for click attribution. */\n  exposures(exposures: ExposureInput[], session?: string, o: { keepalive?: boolean } = {}): Promise<void> {\n    const body: Exposures = { session, exposures };\n    return call(this.http, \"POST\", \"/exposures\", { body, keepalive: o.keepalive });\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"discovery.js","names":[],"sources":["../../src/client/discovery.ts"],"sourcesContent":["import type {\n  ContentFilters,\n  ContentFiltersUpdate,\n  ContentPage,\n  DailyReleases,\n  ExposureInput,\n  Exposures,\n  RecentSearches,\n  ReleaseDates,\n  SignalInput,\n  Signals,\n  Typeahead,\n} from \"./generated/wire.js\";\nimport type { Http } from \"./http.js\";\nimport { call, routeURL } from \"./route.js\";\nimport { browserSearchHistory, type BrowserSearchHistory } from \"./browser-search-history.js\";\n\n/** A popularity period. */\nexport type Period = \"7d\" | \"30d\" | \"90d\" | \"365d\" | \"all\";\n/** A list's order; position orders by the first of `groups` (an ordered group). */\nexport type ListSort = \"newest\" | \"oldest\" | \"title\" | \"popular\" | `popular:${Period}` | \"top_rated\" | `top_rated:${Period}` | \"most_favorited\" | \"most_viewed\" | \"position\" | \"random\";\n/** How locked contents list: marked (lock, the default) or left out (hide). */\nexport type AccessMode = \"lock\" | \"hide\";\n\n/** Which contents a list holds. */\nexport interface ContentFilterQuery {\n  kind?: string;\n  /** Group ids every listed version is in. */\n  groups?: readonly string[];\n  /** Group ids no listed version is in. */\n  exclude_groups?: readonly string[];\n  /** Only contents this group owns: a channel's feed. */\n  owner_group?: string;\n  /** User ids: only contents one of them is credited on. */\n  creators?: readonly string[];\n  /** public (anyone opens it now) or the level it stays locked at. */\n  access?: readonly (\"public\" | \"tier\" | \"group\" | \"ppv\" | \"group_ppv\")[];\n  /** Only contents locked behind one of these tiers. */\n  tiers?: readonly string[];\n  /** Version traits every listed version has. */\n  traits?: readonly string[];\n  /** \"name:value\" of the kind's filterable attributes. */\n  attribute?: readonly string[];\n  /** Published on this day (YYYY-MM-DD) or month (YYYY-MM). */\n  released_on?: string;\n  /** Only contents published within this age window; independent of the popularity score window. */\n  published_within?: Period;\n  /** IANA time zone of released_on and release dates; UTC by default. */\n  tz?: string;\n  /** The signed-in reader's unseen, in-progress or completed contents. */\n  view_status?: \"unseen\" | \"in_progress\" | \"completed\";\n}\n\n/** How a list reads to its reader. */\nexport interface ReaderQuery {\n  /** Only content with a live version in this language. */\n  language?: string;\n  /** Titles, names and paths in this language, and each card's preferred version's; language by default. */\n  display_language?: string;\n  mode?: AccessMode;\n}\n\n/** The group kinds cards name; every kind with a page by default. */\nexport interface CardQuery {\n  card_entities?: readonly string[];\n}\n\nexport interface PageQuery {\n  cursor?: string;\n  limit?: number;\n}\n\nexport type ContentQuery = ContentFilterQuery & ReaderQuery & CardQuery & PageQuery & { sort?: ListSort };\nexport type PopularPeriod = \"7d\" | \"90d\" | \"365d\" | \"all\";\nexport type PopularQuery = Omit<ContentQuery, \"sort\" | \"published_within\">;\n\n/** Match the popularity score window and publication age window. */\nexport function popularQuery(period: PopularPeriod = \"7d\", filters: PopularQuery = {}): ContentQuery {\n  return { ...filters, sort: `popular:${period}`, published_within: period };\n}\n\nexport type SearchQuery = ContentFilterQuery &\n  ReaderQuery &\n  CardQuery &\n  PageQuery & {\n    q: string;\n    sort?: \"relevance\" | ListSort;\n    personalize?: boolean;\n    /** Explicit legacy server-side anonymous history. Omit for public search without server history. */\n    session?: string;\n  };\nexport interface RecentSearchesQuery {\n  /** Explicit legacy server-side anonymous history; no anonymous session is created by default. */\n  session?: string;\n  /** 10 by default, at most 100. */\n  limit?: number;\n}\nexport type RailQuery = ContentFilterQuery & ReaderQuery & CardQuery & { limit?: number };\nexport type ReleaseDatesQuery = ContentFilterQuery & ReaderQuery & PageQuery & { by?: \"month\" | \"day\" };\n/** Complete daily metadata for one calendar window, without pagination. */\nexport type DailyReleasesQuery = Omit<ContentFilterQuery, \"released_on\" | \"tz\"> & ReaderQuery & CardQuery & { days?: number; time_zone?: string };\nexport type HistoryQuery = ReaderQuery & CardQuery & PageQuery & { kind?: string; status?: \"seen\" | \"in_progress\" | \"completed\" };\nexport interface TypeaheadQuery extends ReaderQuery {\n  q: string;\n  /** Only contents of this kind. */\n  kind?: string;\n  /** The group kinds suggested; every kind with a page by default. */\n  entity_kinds?: readonly string[];\n  /** Per section: 8 by default, at most 20. */\n  limit?: number;\n}\n\n// Comma-joined list parameters; `attribute` repeats instead.\nconst LISTS = new Set([\"groups\", \"exclude_groups\", \"creators\", \"access\", \"tiers\", \"traits\", \"card_entities\", \"entity_kinds\"]);\n\n/** A query with its list parameters comma-joined, as discovery routes read them. */\nexport function query(q: object): Record<string, string | number | boolean | readonly string[] | undefined> {\n  const out: Record<string, string | number | boolean | readonly string[] | undefined> = {};\n  for (const [k, v] of Object.entries(q)) out[k] = LISTS.has(k) && Array.isArray(v) ? (v.length ? v.join(\",\") : undefined) : v;\n  return out;\n}\n\n/**\n * Discovery: lists, search, typeahead, similar and recommended contents,\n * release dates, the reader's content filters and history, signals and exposures.\n */\nexport class DiscoveryClient {\n  /** Local anonymous history, isolated from authenticated server history. */\n  readonly browserSearches: BrowserSearchHistory;\n\n  constructor(private readonly http: Http) {\n    this.browserSearches = browserSearchHistory(http.mount(\"discovery\"));\n  }\n\n  /** Contents as cards, one per content item with the version that fits the reader. */\n  list(q: ContentQuery = {}, signal?: AbortSignal): Promise<ContentPage> {\n    return call(this.http, \"GET\", \"/contents\", { query: query(q) as never, signal });\n  }\n  /** A first page is kept among the reader's recent searches. */\n  async search(q: SearchQuery, signal?: AbortSignal): Promise<ContentPage> {\n    const emit = q.cursor ? null : this.http.captureChanges();\n    const out: ContentPage = await call(this.http, \"GET\", \"/search\", { query: query(q) as never, signal });\n    emit?.({ type: \"searches.changed\" });\n    return out;\n  }\n  /** The reader's recent searches, newest first, since they last cleared them. */\n  recentSearches(q: RecentSearchesQuery = {}, signal?: AbortSignal): Promise<RecentSearches> {\n    return call(this.http, \"GET\", \"/me/searches\", { query: q, signal });\n  }\n  /** Clears one recent search, or all of them. */\n  async clearSearches(o: { query?: string; session?: string } = {}): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"DELETE\", \"/me/searches\", { query: o });\n    emit({ type: \"searches.changed\" });\n  }\n  /** Contents and groups while the reader types. */\n  typeahead(q: TypeaheadQuery, signal?: AbortSignal): Promise<Typeahead> {\n    return call(this.http, \"GET\", \"/typeahead\", { query: query(q) as never, signal });\n  }\n  /** Contents like one, of its kind unless q.kind names another. */\n  similar(id: string, q: RailQuery = {}, signal?: AbortSignal): Promise<ContentPage> {\n    return call(this.http, \"GET\", \"/contents/{id}/similar\", { params: { id }, query: query(q) as never, signal });\n  }\n  /** For the signed-in reader. */\n  recommendations(q: RailQuery = {}, signal?: AbortSignal): Promise<ContentPage> {\n    return call(this.http, \"GET\", \"/recommendations\", { query: query(q) as never, signal });\n  }\n  /** Per month or day, newest first: how many contents the reader's listing shows released then, and how many are free. */\n  releaseDates(q: ReleaseDatesQuery = {}, signal?: AbortSignal): Promise<ReleaseDates> {\n    return call(this.http, \"GET\", \"/release-dates\", { query: query(q) as never, signal });\n  }\n  /** Every visible card in each day; opening or expanding a day needs no further request. */\n  releases(q: DailyReleasesQuery = {}, signal?: AbortSignal): Promise<DailyReleases> {\n    return call(this.http, \"GET\", \"/releases\", { query: query(q) as never, signal });\n  }\n  async contentFilters(language?: string, signal?: AbortSignal): Promise<ContentFilters> {\n    const result = await this.http.request<ContentFilters>(routeURL(this.http, \"GET\", \"/content-filters\", { query: { language } }), { signal, guestPreferences: false });\n    this.http.acceptGuestFilters(result.filters);\n    return result;\n  }\n  /** Replaces the reader's filter settings; every read applies them. */\n  async setContentFilters(update: ContentFiltersUpdate, language?: string): Promise<ContentFilters> {\n    const emit = this.http.captureChanges();\n    const out: ContentFilters = await call(this.http, \"PUT\", \"/me/content-filters\", { query: { language }, body: update });\n    emit({ type: \"contentFilters.changed\" });\n    return out;\n  }\n  /** What the reader engaged with, most recent first. */\n  history(q: HistoryQuery = {}, signal?: AbortSignal): Promise<ContentPage> {\n    return call(this.http, \"GET\", \"/me/history\", { query: query(q) as never, signal });\n  }\n  /** Erases the reader's history: of one content item, one kind or everything. */\n  async forgetHistory(o: { kind?: string; content_id?: string } = {}): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"DELETE\", \"/me/history\", { query: o });\n    emit({ type: \"history.changed\" });\n  }\n  /** Views and clicks; signed out, of the session named. */\n  signals(signals: SignalInput[], session?: string, o: { keepalive?: boolean } = {}): Promise<void> {\n    const body: Signals = { session, signals };\n    return call(this.http, \"POST\", \"/signals\", { body, keepalive: o.keepalive });\n  }\n  /** Result lists served, rendered or shown, for click attribution. */\n  exposures(exposures: ExposureInput[], session?: string, o: { keepalive?: boolean } = {}): Promise<void> {\n    const body: Exposures = { session, exposures };\n    return call(this.http, \"POST\", \"/exposures\", { body, keepalive: o.keepalive });\n  }\n}\n"],"mappings":"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"}

package/dist/client/generated/routes.d.ts

@@ -1826,13 +1826,26 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     };
     readonly errors: readonly [];
     readonly errorSets: readonly ["module:offers", "auth", "request"];
+}, {
+    readonly method: "GET";
+    readonly module: "discovery";
+    readonly path: "/releases";
+    readonly auth: "public";
+    readonly permission: null;
+    readonly query: readonly ["kind", "groups", "exclude_groups", "owner_group", "creators", "access", "tiers", "traits", "attribute", "published_within", "view_status", "language", "display_language", "mode", "card_entities", "days", "time_zone"];
+    readonly request: null;
+    readonly responses: {
+        readonly 200: "DailyReleases";
+    };
+    readonly errors: readonly [];
+    readonly errorSets: readonly ["module:discovery", "auth", "request"];
 }, {
     readonly method: "GET";
     readonly module: "discovery";
     readonly path: "/contents";
     readonly auth: "public";
     readonly permission: null;
-    readonly query: readonly ["kind", "groups", "exclude_groups", "owner_group", "creators", "access", "tiers", "traits", "attribute", "released_on", "tz", "view_status", "language", "display_language", "mode", "sort", "card_entities", "cursor", "limit"];
+    readonly query: readonly ["kind", "groups", "exclude_groups", "owner_group", "creators", "access", "tiers", "traits", "attribute", "released_on", "published_within", "tz", "view_status", "language", "display_language", "mode", "sort", "card_entities", "cursor", "limit"];
     readonly request: null;
     readonly responses: {
         readonly 200: "ContentPage";
@@ -1845,7 +1858,7 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     readonly path: "/search";
     readonly auth: "public";
     readonly permission: null;
-    readonly query: readonly ["q", "kind", "groups", "exclude_groups", "owner_group", "creators", "access", "tiers", "traits", "attribute", "released_on", "tz", "view_status", "language", "display_language", "mode", "sort", "card_entities", "personalize", "session", "cursor", "limit"];
+    readonly query: readonly ["q", "kind", "groups", "exclude_groups", "owner_group", "creators", "access", "tiers", "traits", "attribute", "released_on", "published_within", "tz", "view_status", "language", "display_language", "mode", "sort", "card_entities", "personalize", "session", "cursor", "limit"];
     readonly request: null;
     readonly responses: {
         readonly 200: "ContentPage";
@@ -1871,7 +1884,7 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     readonly path: "/contents/{id}/similar";
     readonly auth: "public";
     readonly permission: null;
-    readonly query: readonly ["kind", "groups", "exclude_groups", "owner_group", "creators", "access", "tiers", "traits", "attribute", "released_on", "tz", "view_status", "language", "display_language", "mode", "card_entities", "limit"];
+    readonly query: readonly ["kind", "groups", "exclude_groups", "owner_group", "creators", "access", "tiers", "traits", "attribute", "released_on", "published_within", "tz", "view_status", "language", "display_language", "mode", "card_entities", "limit"];
     readonly request: null;
     readonly responses: {
         readonly 200: "ContentPage";
@@ -1884,7 +1897,7 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     readonly path: "/recommendations";
     readonly auth: "user";
     readonly permission: null;
-    readonly query: readonly ["kind", "groups", "exclude_groups", "owner_group", "creators", "access", "tiers", "traits", "attribute", "released_on", "tz", "view_status", "language", "display_language", "mode", "card_entities", "limit"];
+    readonly query: readonly ["kind", "groups", "exclude_groups", "owner_group", "creators", "access", "tiers", "traits", "attribute", "released_on", "published_within", "tz", "view_status", "language", "display_language", "mode", "card_entities", "limit"];
     readonly request: null;
     readonly responses: {
         readonly 200: "ContentPage";
@@ -1897,7 +1910,7 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     readonly path: "/release-dates";
     readonly auth: "public";
     readonly permission: null;
-    readonly query: readonly ["by", "kind", "groups", "exclude_groups", "owner_group", "creators", "access", "tiers", "traits", "attribute", "released_on", "tz", "view_status", "language", "display_language", "mode", "cursor", "limit"];
+    readonly query: readonly ["by", "kind", "groups", "exclude_groups", "owner_group", "creators", "access", "tiers", "traits", "attribute", "released_on", "published_within", "tz", "view_status", "language", "display_language", "mode", "cursor", "limit"];
     readonly request: null;
     readonly responses: {
         readonly 200: "ReleaseDates";

package/dist/client/generated/routes.js

@@ -2529,6 +2529,40 @@ var e = {
 			"request"
 		]
 	},
+	{
+		method: "GET",
+		module: "discovery",
+		path: "/releases",
+		auth: "public",
+		permission: null,
+		query: [
+			"kind",
+			"groups",
+			"exclude_groups",
+			"owner_group",
+			"creators",
+			"access",
+			"tiers",
+			"traits",
+			"attribute",
+			"published_within",
+			"view_status",
+			"language",
+			"display_language",
+			"mode",
+			"card_entities",
+			"days",
+			"time_zone"
+		],
+		request: null,
+		responses: { 200: "DailyReleases" },
+		errors: [],
+		errorSets: [
+			"module:discovery",
+			"auth",
+			"request"
+		]
+	},
 	{
 		method: "GET",
 		module: "discovery",
@@ -2546,6 +2580,7 @@ var e = {
 			"traits",
 			"attribute",
 			"released_on",
+			"published_within",
 			"tz",
 			"view_status",
 			"language",
@@ -2583,6 +2618,7 @@ var e = {
 			"traits",
 			"attribute",
 			"released_on",
+			"published_within",
 			"tz",
 			"view_status",
 			"language",
@@ -2645,6 +2681,7 @@ var e = {
 			"traits",
 			"attribute",
 			"released_on",
+			"published_within",
 			"tz",
 			"view_status",
 			"language",
@@ -2679,6 +2716,7 @@ var e = {
 			"traits",
 			"attribute",
 			"released_on",
+			"published_within",
 			"tz",
 			"view_status",
 			"language",
@@ -2714,6 +2752,7 @@ var e = {
 			"traits",
 			"attribute",
 			"released_on",
+			"published_within",
 			"tz",
 			"view_status",
 			"language",