@contentrain/astro-kit 0.34.3 → 0.35.0

package/catalog.json

@@ -4566,6 +4566,10 @@
           "type": "string",
           "description": "Locale the date is written in (site.language)."
         },
+        "timeZone": {
+          "type": "string",
+          "description": "Time zone the date is read in (the site's: an IANA name or a ±hh:mm offset); absent, UTC."
+        },
         "image": {
           "type": "object",
           "fields": {
@@ -4804,6 +4808,11 @@
           "content": false,
           "description": "BCP 47 locale the dates are written in (site.language)."
         },
+        "timeZone": {
+          "type": "string",
+          "content": false,
+          "description": "Time zone the dates are read in (the site's: an IANA name or a ±hh:mm offset); absent, UTC."
+        },
         "surface": {
           "type": "string",
           "content": false,

package/components/post-card/PostCard.astro

@@ -44,6 +44,8 @@ interface Props {
   date?: Date | string | undefined
   /** BCP 47 locale the date is written in (site.language). */
   locale?: string | undefined
+  /** The time zone the date is read in (the site's, an IANA name or a `±hh:mm` offset); absent, UTC. */
+  timeZone?: string | undefined
   image?: ImageInput | undefined
   category?: LinkInput | undefined
   author?: string | undefined
@@ -63,11 +65,11 @@ interface Props {
   imageAspect?: string | undefined
 }
 
-const { title, href, excerpt, date: rawDate, locale = 'en', image, category, author, headingLevel = 2, layout, surface, byline, linkTitle, excerptLines, sizes, imageHeight, imageAspect } = Astro.props
+const { title, href, excerpt, date: rawDate, locale = 'en', timeZone = 'UTC', image, category, author, headingLevel = 2, layout, surface, byline, linkTitle, excerptLines, sizes, imageHeight, imageAspect } = Astro.props
 const date = rawDate === undefined ? undefined : new Date(rawDate)
 const slots = card({ layout, surface, byline })
 const below = byline === 'below'
-const shown = date?.toLocaleDateString(locale, { dateStyle: 'long', timeZone: 'UTC' })
+const shown = date?.toLocaleDateString(locale, { dateStyle: 'long', timeZone })
 const imageStyle = imageHeight ? `height:${imageHeight}` : imageAspect ? `aspect-ratio:${imageAspect}` : undefined
 const Heading = `h${headingLevel}` as 'h2' | 'h3'
 ---

package/components/post-card/meta.json

@@ -16,6 +16,7 @@
     "excerpt": { "type": "text", "description": "Summary (posts.excerpt)." },
     "date": { "type": "datetime", "description": "Publication date (posts.published_at)." },
     "locale": { "type": "string", "description": "Locale the date is written in (site.language)." },
+    "timeZone": { "type": "string", "description": "Time zone the date is read in (the site's: an IANA name or a ±hh:mm offset); absent, UTC." },
     "image": { "type": "object", "fields": { "src": { "type": "image", "required": true }, "alt": { "type": "string", "required": true }, "width": { "type": "integer" }, "height": { "type": "integer" } }, "description": "Cover (posts.cover → media)." },
     "category": { "type": "object", "fields": { "label": { "type": "string", "required": true }, "href": { "type": "url", "required": true } }, "description": "Primary category and its archive." },
     "author": { "type": "string", "description": "Author name (posts.author → authors.name)." },

package/components/post-list/PostList.astro

@@ -61,6 +61,8 @@ interface Props {
   excerptLines?: 2 | 3 | 4 | undefined
   /** BCP 47 locale the dates are written in. */
   locale?: string | undefined
+  /** The time zone the dates are read in (the site's: an IANA name or a `±hh:mm` offset); absent, UTC. */
+  timeZone?: string | undefined
   /** Card surface: none, or each post its own card. */
   surface?: 'plain' | 'card' | undefined
   /** Where the full archive lives; with `moreLabel` a link follows the list. */
@@ -72,7 +74,7 @@ interface Props {
   id?: string | undefined
 }
 
-const { heading, intro, posts, layout = 'grid', columns, showImage = true, showExcerpt = true, showAuthor = true, showCategory = true, excerptLines, locale, surface, moreHref, moreLabel, tone, measured, id = 'posts' } = Astro.props
+const { heading, intro, posts, layout = 'grid', columns, showImage = true, showExcerpt = true, showAuthor = true, showCategory = true, excerptLines, locale, timeZone, surface, moreHref, moreLabel, tone, measured, id = 'posts' } = Astro.props
 const s = list({ layout, columns })
 const headingId = heading ? `${id}-title` : undefined
 // Cards sit one heading level under the section's; with no section heading they are the page's h2s.
@@ -98,6 +100,7 @@ const cardLayout = (i: number) => layout === 'compact' ? 'minimal' : layout ===
             excerpt={showExcerpt && layout !== 'compact' ? post.excerpt : undefined}
             date={post.date}
             locale={locale}
+            timeZone={timeZone}
             image={showImage && layout !== 'compact' ? post.image : undefined}
             category={showCategory && layout !== 'compact' ? post.category : undefined}
             author={showAuthor && layout !== 'compact' ? post.author : undefined}

package/components/post-list/meta.json

@@ -141,6 +141,11 @@
       "content": false,
       "description": "BCP 47 locale the dates are written in (site.language)."
     },
+    "timeZone": {
+      "type": "string",
+      "content": false,
+      "description": "Time zone the dates are read in (the site's: an IANA name or a ±hh:mm offset); absent, UTC."
+    },
     "surface": {
       "type": "string",
       "content": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentrain/astro-kit",
-  "version": "0.34.3",
+  "version": "0.35.0",
   "license": "MIT",
   "description": "Copy-in Astro components for Contentrain sites (shadcn model): typed props, tailwind-variants, zero JavaScript by default — with a machine-readable catalog",
   "type": "module",