@curvenote/renderers 1.0.1 → 2.0.0

package/dist/transforms/articles.js

@@ -7,7 +7,7 @@ import pLimit from 'p-limit';
  * @param node
  * @returns
  */
-export async function transformArticles(node, { apiUrl, venue }) {
+export async function transformArticles(node, { apiUrl, venue, fetchHeaders, }) {
     const articlesDirectives = selectAll('curvenoteArticles', node);
     const applyLimit = pLimit(5);
     return Promise.all(articlesDirectives.map(async (n) => applyLimit(async () => {
@@ -30,7 +30,7 @@ export async function transformArticles(node, { apiUrl, venue }) {
         if (n.limit)
             url.searchParams.set('limit', n.limit.toString());
         try {
-            const res = await fetch(url.toString());
+            const res = await fetch(url.toString(), { headers: fetchHeaders });
             if (!res.ok)
                 throw new Error(`${res.status} ${res.statusText}`);
             const data = (await res.json());

package/dist/transforms/index.d.ts

@@ -1,6 +1,9 @@
 import type { PageLoader } from '@myst-theme/common';
-export declare function applyCustomPageTransformsInPlace(page: PageLoader, opts?: {
+export type CustomPageTransformOptions = {
     apiUrl?: string;
     venue?: string;
-}): Promise<void>;
+    /** Headers for SCMS API requests (e.g. from getScmsFetchHeaders). */
+    fetchHeaders?: Record<string, string>;
+};
+export declare function applyCustomPageTransformsInPlace(page: PageLoader, opts?: CustomPageTransformOptions): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/transforms/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transforms/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAKrD,wBAAsB,gCAAgC,CACpD,IAAI,EAAE,UAAU,EAChB,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,iBAS3C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transforms/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAKrD,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC,CAAC;AAEF,wBAAsB,gCAAgC,CACpD,IAAI,EAAE,UAAU,EAChB,IAAI,CAAC,EAAE,0BAA0B,iBAUlC"}

package/dist/transforms/index.js

@@ -6,6 +6,7 @@ export async function applyCustomPageTransformsInPlace(page, opts) {
         await transformArticles(page.mdast, {
             apiUrl: opts.apiUrl,
             venue: opts.venue,
+            fetchHeaders: opts.fetchHeaders,
         });
     }
     transformDecorateNotebookOutputsWithSlugs(page);

package/dist/utils/anywidget-analytics.d.ts

@@ -0,0 +1,13 @@
+import type { AnalyticsCaptureFn } from '@curvenote/theme-ui';
+export type AnywidgetKind = 'myst_anywidget' | 'any_widget' | 'any_bundle';
+export type AnywidgetIdentity = {
+    moduleUrl?: string;
+    nodeKey?: string;
+    widgetKind: AnywidgetKind;
+};
+export declare function captureAnywidgetClicked(capture: AnalyticsCaptureFn, identity: AnywidgetIdentity): void;
+export declare function getMystAnywidgetIdentity(node: {
+    esm?: string;
+    key?: string;
+}): AnywidgetIdentity;
+//# sourceMappingURL=anywidget-analytics.d.ts.map

package/dist/utils/anywidget-analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anywidget-analytics.d.ts","sourceRoot":"","sources":["../../src/utils/anywidget-analytics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,YAAY,GAAG,YAAY,CAAC;AAE3E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,aAAa,CAAC;CAC3B,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,iBAAiB,QAO/F;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CAMhG"}

package/dist/utils/anywidget-analytics.js

@@ -0,0 +1,15 @@
+export function captureAnywidgetClicked(capture, identity) {
+    capture('content_anywidget_clicked', {
+        surface: 'content',
+        moduleUrl: identity.moduleUrl,
+        nodeKey: identity.nodeKey,
+        widgetKind: identity.widgetKind,
+    });
+}
+export function getMystAnywidgetIdentity(node) {
+    return {
+        moduleUrl: node.esm,
+        nodeKey: node.key,
+        widgetKind: 'myst_anywidget',
+    };
+}

package/dist/utils/content-analytics.d.ts

@@ -0,0 +1,44 @@
+import type { AnalyticsCaptureFn } from '@curvenote/theme-ui';
+export type ContentEngagementSurface = 'trigger' | 'hover_card' | 'inline_block';
+export type ContentLinkClickedPayload = {
+    linkKind: string;
+    destinationUrl?: string;
+    engagementSurface: ContentEngagementSurface;
+    cardKind?: string;
+    properties?: Record<string, unknown>;
+};
+export type ContentEnrichmentOutcome = 'loading' | 'success' | 'error' | 'empty' | 'fallback';
+export declare function captureContentLinkClicked(capture: AnalyticsCaptureFn, payload: ContentLinkClickedPayload): void;
+export declare function captureContentCiteClicked(capture: AnalyticsCaptureFn, payload: {
+    citeLabel: string;
+    doi?: string;
+    hasUrl: boolean;
+    engagementSurface: ContentEngagementSurface;
+}): void;
+export declare function captureContentEnrichmentDisplayed(capture: AnalyticsCaptureFn, payload: {
+    enrichmentSource: string;
+    outcome: ContentEnrichmentOutcome;
+    cardKind?: string;
+    engagementSurface?: ContentEngagementSurface;
+    properties?: Record<string, unknown>;
+}): void;
+/**
+ * Emits `content_enrichment_displayed` when async enrichment for a hover card or inline
+ * block moves to a new outcome (`loading`, `success`, `error`, `empty`, or `fallback`).
+ *
+ * Enrichment cards derive outcome from SWR or similar hooks, so the value changes after
+ * mount. A plain render-time capture would fire on every re-render; this hook records
+ * each outcome at most once per mount. `enabled` gates mutually exclusive paths (for
+ * example OpenAlex vs HTML cite fallback). `properties` is read from a ref so late
+ * metadata does not widen the effect deps or duplicate events when only fields change.
+ */
+export declare function useContentEnrichmentDisplay({ capture, enrichmentSource, outcome, cardKind, engagementSurface, properties, enabled, }: {
+    capture: AnalyticsCaptureFn;
+    enrichmentSource: string;
+    outcome: ContentEnrichmentOutcome;
+    cardKind?: string;
+    engagementSurface?: ContentEngagementSurface;
+    properties?: Record<string, unknown>;
+    enabled?: boolean;
+}): void;
+//# sourceMappingURL=content-analytics.d.ts.map

package/dist/utils/content-analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-analytics.d.ts","sourceRoot":"","sources":["../../src/utils/content-analytics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,YAAY,GAAG,cAAc,CAAC;AAEjF,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;AAE9F,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,yBAAyB,QAUnC;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE;IACP,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,iBAAiB,EAAE,wBAAwB,CAAC;CAC7C,QASF;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE;IACP,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,wBAAwB,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,QAUF;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,EAC1C,OAAO,EACP,gBAAgB,EAChB,OAAO,EACP,QAAQ,EACR,iBAAiB,EACjB,UAAU,EACV,OAAc,GACf,EAAE;IACD,OAAO,EAAE,kBAAkB,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,wBAAwB,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,QAiBA"}

package/dist/utils/content-analytics.js

@@ -0,0 +1,59 @@
+import { useEffect, useRef } from 'react';
+export function captureContentLinkClicked(capture, payload) {
+    capture('content_link_clicked', {
+        surface: 'content',
+        linkKind: payload.linkKind,
+        destinationUrl: payload.destinationUrl,
+        engagementSurface: payload.engagementSurface,
+        cardKind: payload.cardKind,
+        ...payload.properties,
+    });
+}
+export function captureContentCiteClicked(capture, payload) {
+    capture('content_cite_clicked', {
+        surface: 'content',
+        citeLabel: payload.citeLabel,
+        doi: payload.doi,
+        hasUrl: payload.hasUrl,
+        engagementSurface: payload.engagementSurface,
+    });
+}
+export function captureContentEnrichmentDisplayed(capture, payload) {
+    capture('content_enrichment_displayed', {
+        surface: 'content',
+        enrichmentSource: payload.enrichmentSource,
+        outcome: payload.outcome,
+        cardKind: payload.cardKind,
+        engagementSurface: payload.engagementSurface,
+        ...payload.properties,
+    });
+}
+/**
+ * Emits `content_enrichment_displayed` when async enrichment for a hover card or inline
+ * block moves to a new outcome (`loading`, `success`, `error`, `empty`, or `fallback`).
+ *
+ * Enrichment cards derive outcome from SWR or similar hooks, so the value changes after
+ * mount. A plain render-time capture would fire on every re-render; this hook records
+ * each outcome at most once per mount. `enabled` gates mutually exclusive paths (for
+ * example OpenAlex vs HTML cite fallback). `properties` is read from a ref so late
+ * metadata does not widen the effect deps or duplicate events when only fields change.
+ */
+export function useContentEnrichmentDisplay({ capture, enrichmentSource, outcome, cardKind, engagementSurface, properties, enabled = true, }) {
+    const lastOutcomeRef = useRef(null);
+    const propertiesRef = useRef(properties);
+    propertiesRef.current = properties;
+    useEffect(() => {
+        if (!enabled)
+            return;
+        if (lastOutcomeRef.current === outcome)
+            return;
+        lastOutcomeRef.current = outcome;
+        captureContentEnrichmentDisplayed(capture, {
+            enrichmentSource,
+            outcome,
+            cardKind,
+            engagementSurface,
+            properties: propertiesRef.current,
+        });
+    }, [capture, cardKind, enabled, engagementSurface, enrichmentSource, outcome]);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curvenote/renderers",
-  "version": "1.0.1",
+  "version": "2.0.0",
   "license": "MIT",
   "sideEffects": false,
   "type": "module",
@@ -16,31 +16,39 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsc && npm run copy-css",
+    "build": "tsc && bun run copy-css",
     "copy-css": "mkdir -p dist/components && cp src/components/*.css dist/components/ 2>/dev/null || true && cp src/*.css dist/ 2>/dev/null || true",
     "dev": "tsc --watch",
     "typecheck": "tsc --noEmit",
-    "compile": "npm run typecheck",
+    "compile": "bun run typecheck",
     "lint": "eslint \"src/**/*.ts*\" -c ./.eslintrc.cjs",
     "lint:format": "prettier --check \"src/**/*.{ts,tsx,md}\"",
     "test": "vitest run",
     "clean": "rm -rf dist",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@curvenote/theme-ui": "^1.0.1",
-    "@curvenote/any-widget": "^0.2.1",
-    "@curvenote/common": "^0.3.4",
-    "@curvenote/ext-blog": "^1.0.1",
-    "@curvenote/ext-person": "^1.0.1",
-    "@curvenote/react-utils": "^1.0.1",
-    "@scienceicons/react": "^0.0.13",
+    "@curvenote/any-widget": "^0.2.3",
+    "@curvenote/common": "^0.4.0",
+    "@curvenote/ext-blog": "^2.0.0",
+    "@curvenote/ext-person": "^2.0.0",
+    "@curvenote/react-utils": "^2.0.0",
+    "@curvenote/theme-ui": "^2.0.0",
+    "@heroicons/react": "^2.0.18",
+    "@myst-theme/anywidget": "^1.3.0",
+    "@myst-theme/common": "^1.3.0",
+    "@myst-theme/providers": "^1.3.0",
+    "@radix-ui/react-hover-card": "^1.0.6",
+    "@scienceicons/react": "^0.0.14",
     "class-variance-authority": "^0.7.1",
     "hast-util-from-html": "^2.0.3",
-    "hast-util-to-mdast": "^10.1.2",
+    "hast-util-to-mdast": "^8.4.1",
     "lucide-react": "^0.525.0",
     "mermaid": "^11.12.1",
-    "myst-common": "^1.9.3",
+    "myst-common": "^1.9.5",
+    "myst-migrate": "^1.9.0",
+    "myst-to-react": "^1.3.0",
+    "react-syntax-highlighter": "15.5.0",
     "p-limit": "^3.1.0",
     "react-router": "^7.1.1",
     "sonner": "^2.0.6",
@@ -53,6 +61,7 @@
     "react-dom": "^16.8 || ^17.0 || ^18.0 || ^19.0"
   },
   "devDependencies": {
+    "@types/react-syntax-highlighter": "^15.5.13",
     "vitest": "^4.0.16"
   },
   "publishConfig": {