@vskstudio/takt-astro 0.2.1 → 0.3.1

package/Badge.astro

@@ -0,0 +1,14 @@
+---
+import { badgeUrl, type BadgeVariant, type BadgeGlyph, type WidgetLang } from '@vskstudio/takt-core'
+
+type Props = {
+  domain: string
+  variant?: BadgeVariant
+  glyph?: BadgeGlyph
+  lang?: WidgetLang
+  host?: string
+}
+
+const { domain, variant, glyph, lang, host, ...rest } = Astro.props
+---
+<img alt="takt" {...rest} loading="lazy" decoding="async" src={badgeUrl(domain, { variant, glyph, lang, host })} />

package/Embed.astro

@@ -0,0 +1,16 @@
+---
+import { embedUrl, type EmbedTheme, type WidgetLang } from '@vskstudio/takt-core'
+
+type Props = {
+  domain: string
+  theme?: EmbedTheme
+  lang?: WidgetLang
+  host?: string
+  width?: number | string
+  height?: number | string
+  title?: string
+}
+
+const { domain, theme, lang, host, width = 404, height = 264, title = 'takt', ...rest } = Astro.props
+---
+<iframe title={title} referrerpolicy="strict-origin-when-cross-origin" {...rest} width={width} height={height} loading="lazy" style="border:0" src={embedUrl(domain, { theme, lang, host })}></iframe>

package/README.md

@@ -65,6 +65,32 @@ import { track } from '@vskstudio/takt-astro'
 track('Signup', { revenue: { amount: '9.00', currency: 'USD' } })
 ```
 
+## Widgets
+
+Thin wrappers around Takt's server-rendered badge SVG and embed iframe.
+
+```astro
+---
+import Badge from '@vskstudio/takt-astro/Badge.astro'
+import Embed from '@vskstudio/takt-astro/Embed.astro'
+---
+<Badge domain="example.com" variant="d" />
+<Embed domain="example.com" theme="dark" />
+```
+
+`Badge` renders an `<img>` (props: `domain`, `variant`, `glyph`, `lang`, `host`); `Embed` renders an `<iframe>` (props: `domain`, `theme`, `lang`, `host`, `width`, `height`, `title`). Extra attributes pass through to the underlying element, but the built `src` is locked and cannot be overridden. The optional `host` must be an absolute `http(s)` URL — core validates it and throws on anything else (e.g. a `javascript:` URL).
+
+## Public stats
+
+`createStats` (re-exported from core) reads public analytics:
+
+```js
+import { createStats } from '@vskstudio/takt-astro'
+
+const stats = createStats({ domain: 'example.com' })
+const summary = await stats.summary({ period: '7d' })
+```
+
 ## License
 
 MIT

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { AstroIntegration } from 'astro';
 import { InitOptions } from '@vskstudio/takt-core';
-export { InitOptions, TrackOptions, optIn, optOut, pageview, track } from '@vskstudio/takt-core';
+export { BadgeGlyph, BadgeOptions, BadgeVariant, EmbedOptions, EmbedTheme, InitOptions, PublicApiError, StatsBreakdown, StatsBreakdownRow, StatsClient, StatsClientOptions, StatsDimension, StatsMetrics, StatsParams, StatsPeriod, StatsPoint, StatsRealtime, StatsSummary, StatsTimeseries, TrackOptions, WidgetLang, badgeUrl, createStats, embedUrl, optIn, optOut, pageview, track } from '@vskstudio/takt-core';
 
 /**
  * Options for the Takt integration and `<Takt />` component. Mirrors core's

package/dist/index.js

@@ -50,9 +50,14 @@ function takt(options = {}) {
 
 // src/index.ts
 import { track, pageview, optOut, optIn } from "@vskstudio/takt-core";
+import { createStats, PublicApiError, badgeUrl, embedUrl } from "@vskstudio/takt-core";
 export {
+  PublicApiError,
+  badgeUrl,
   buildRuntime,
+  createStats,
   takt as default,
+  embedUrl,
   optIn,
   optOut,
   pageview,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vskstudio/takt-astro",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "Astro integration for Takt privacy-friendly analytics",
   "license": "MIT",
   "author": "VSK Studio",
@@ -32,24 +32,28 @@
       "default": "./dist/index.js"
     },
     "./Takt.astro": "./Takt.astro",
+    "./Badge.astro": "./Badge.astro",
+    "./Embed.astro": "./Embed.astro",
     "./package.json": "./package.json"
   },
   "files": [
     "dist",
-    "Takt.astro"
+    "Takt.astro",
+    "Badge.astro",
+    "Embed.astro"
   ],
   "engines": {
     "node": ">=18"
   },
   "peerDependencies": {
-    "@vskstudio/takt-core": ">=0.2.0",
+    "@vskstudio/takt-core": ">=0.3.0",
     "astro": ">=4"
   },
   "devDependencies": {
     "@changesets/cli": "^2.31.0",
     "@playwright/test": "^1.50.0",
     "@size-limit/preset-small-lib": "^11.1.6",
-    "@vskstudio/takt-core": "^0.2.0",
+    "@vskstudio/takt-core": "^0.3.0",
     "astro": "^5.0.0",
     "eslint": "^9.0.0",
     "size-limit": "^11.1.6",