@airdraft/content 0.1.0

package/dist/body.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Parse a Markdown string to sanitised HTML.
+ * Safe for use with `dangerouslySetInnerHTML` in React.
+ *
+ * The underlying parser is `marked`. Configure a custom renderer via
+ * the `render` prop on `<BodyField>` instead of tweaking this function.
+ */
+export declare function parseMarkdown(text: string): string;
+/**
+ * Split a plain `text` field value into paragraphs.
+ * Paragraphs are separated by blank lines (`\n\n`).
+ * Within each paragraph, single newlines are preserved (rendered as `<br>`).
+ */
+export declare function parseText(text: string): string[];
+//# sourceMappingURL=body.d.ts.map

package/dist/body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body.d.ts","sourceRoot":"","sources":["../src/body.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKlD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAMhD"}

package/dist/body.js

@@ -0,0 +1,30 @@
+import { marked } from 'marked';
+import DOMPurify from 'isomorphic-dompurify';
+/**
+ * Parse a Markdown string to sanitised HTML.
+ * Safe for use with `dangerouslySetInnerHTML` in React.
+ *
+ * The underlying parser is `marked`. Configure a custom renderer via
+ * the `render` prop on `<BodyField>` instead of tweaking this function.
+ */
+export function parseMarkdown(text) {
+    if (!text)
+        return '';
+    // marked.parse is sync when not given async extensions
+    const raw = marked.parse(text, { async: false });
+    return DOMPurify.sanitize(raw);
+}
+/**
+ * Split a plain `text` field value into paragraphs.
+ * Paragraphs are separated by blank lines (`\n\n`).
+ * Within each paragraph, single newlines are preserved (rendered as `<br>`).
+ */
+export function parseText(text) {
+    if (!text)
+        return [];
+    return text
+        .split(/\n{2,}/)
+        .map((p) => p.trim())
+        .filter(Boolean);
+}
+//# sourceMappingURL=body.js.map

package/dist/body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body.js","sourceRoot":"","sources":["../src/body.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,SAAS,MAAM,sBAAsB,CAAA;AAE5C;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAA;IACpB,uDAAuD;IACvD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAW,CAAA;IAC1D,OAAO,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAA;IACpB,OAAO,IAAI;SACR,KAAK,CAAC,QAAQ,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAA;AACpB,CAAC"}

package/dist/image.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Resolve the URL for an image field.
+ *
+ * Resolution chain (first truthy wins):
+ *   1. data[`${fieldName}_media`]?.url  — airdraft-managed media object URL
+ *   2. data[`${fieldName}_url`]         — raw URL string stored alongside the key
+ *   3. data[fieldName] as string        — raw key; prefixed with '/' if it looks relative
+ *
+ * @param fieldName - e.g. 'cover', 'thumbnail'
+ * @param data      - entry data object
+ */
+export declare function resolveImageUrl(fieldName: string, data: Record<string, unknown>): string | undefined;
+/**
+ * Resolve dimensions for an image field from the airdraft media object,
+ * if available. Used by the Next.js `<AirdraftImage>` component to pass
+ * explicit width/height to `next/image`.
+ */
+export declare function resolveImageDimensions(fieldName: string, data: Record<string, unknown>): {
+    width: number;
+    height: number;
+} | undefined;
+//# sourceMappingURL=image.d.ts.map

package/dist/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../src/image.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,GAAG,SAAS,CAwBpB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAS/C"}

package/dist/image.js

@@ -0,0 +1,51 @@
+/**
+ * Resolve the URL for an image field.
+ *
+ * Resolution chain (first truthy wins):
+ *   1. data[`${fieldName}_media`]?.url  — airdraft-managed media object URL
+ *   2. data[`${fieldName}_url`]         — raw URL string stored alongside the key
+ *   3. data[fieldName] as string        — raw key; prefixed with '/' if it looks relative
+ *
+ * @param fieldName - e.g. 'cover', 'thumbnail'
+ * @param data      - entry data object
+ */
+export function resolveImageUrl(fieldName, data) {
+    // 1. Managed media object
+    const mediaObj = data[`${fieldName}_media`];
+    if (mediaObj && typeof mediaObj === 'object' && 'url' in mediaObj) {
+        const url = mediaObj['url'];
+        if (typeof url === 'string' && url)
+            return url;
+    }
+    // 2. Explicit URL field
+    const rawUrl = data[`${fieldName}_url`];
+    if (typeof rawUrl === 'string' && rawUrl)
+        return rawUrl;
+    // 3. Raw key / path stored in the field itself
+    const key = data[fieldName];
+    if (typeof key === 'string' && key) {
+        // If it's already an absolute URL or absolute path, return as-is
+        if (key.startsWith('http://') || key.startsWith('https://') || key.startsWith('/')) {
+            return key;
+        }
+        // Treat as a relative storage key — prefix with /
+        return `/${key}`;
+    }
+    return undefined;
+}
+/**
+ * Resolve dimensions for an image field from the airdraft media object,
+ * if available. Used by the Next.js `<AirdraftImage>` component to pass
+ * explicit width/height to `next/image`.
+ */
+export function resolveImageDimensions(fieldName, data) {
+    const mediaObj = data[`${fieldName}_media`];
+    if (mediaObj && typeof mediaObj === 'object') {
+        const m = mediaObj;
+        if (typeof m['width'] === 'number' && typeof m['height'] === 'number') {
+            return { width: m['width'], height: m['height'] };
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=image.js.map

package/dist/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../src/image.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC7B,SAAiB,EACjB,IAA6B;IAE7B,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,SAAS,QAAQ,CAAC,CAAA;IAC3C,IAAI,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,KAAK,IAAI,QAAQ,EAAE,CAAC;QAClE,MAAM,GAAG,GAAI,QAAoC,CAAC,KAAK,CAAC,CAAA;QACxD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG;YAAE,OAAO,GAAG,CAAA;IAChD,CAAC;IAED,wBAAwB;IACxB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,SAAS,MAAM,CAAC,CAAA;IACvC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEvD,+CAA+C;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAA;IAC3B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,EAAE,CAAC;QACnC,iEAAiE;QACjE,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACnF,OAAO,GAAG,CAAA;QACZ,CAAC;QACD,kDAAkD;QAClD,OAAO,IAAI,GAAG,EAAE,CAAA;IAClB,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,SAAiB,EACjB,IAA6B;IAE7B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,SAAS,QAAQ,CAAC,CAAA;IAC3C,IAAI,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,QAAmC,CAAA;QAC7C,IAAI,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,QAAQ,EAAE,CAAC;YACtE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAA;QACnD,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { resolveImageUrl, resolveImageDimensions } from './image.js';
+export { parseMarkdown, parseText } from './body.js';
+export { resolveRelation, resolveRelations } from './relation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACpE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { resolveImageUrl, resolveImageDimensions } from './image.js';
+export { parseMarkdown, parseText } from './body.js';
+export { resolveRelation, resolveRelations } from './relation.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACpE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA"}

package/dist/relation.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Resolve the display label for a single `relation` field.
+ *
+ * When the relation is expanded (i.e. an object with a `data` property),
+ * we attempt to derive a display label from common name fields.
+ * Falls back to the raw slug string.
+ *
+ * @param fieldName - e.g. 'author', 'category'
+ * @param data      - entry data object
+ * @returns display label, or null if the field is absent
+ */
+export declare function resolveRelation(fieldName: string, data: Record<string, unknown>): string | null;
+/**
+ * Resolve display labels for a `relations` (multi-relation) field.
+ *
+ * @param fieldName - e.g. 'authors', 'tags'
+ * @param data      - entry data object
+ * @returns array of display labels (empty array if field is absent)
+ */
+export declare function resolveRelations(fieldName: string, data: Record<string, unknown>): string[];
+//# sourceMappingURL=relation.d.ts.map

package/dist/relation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation.d.ts","sourceRoot":"","sources":["../src/relation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,GAAG,IAAI,CAoBf;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,EAAE,CAuBV"}

package/dist/relation.js

@@ -0,0 +1,67 @@
+/**
+ * Resolve the display label for a single `relation` field.
+ *
+ * When the relation is expanded (i.e. an object with a `data` property),
+ * we attempt to derive a display label from common name fields.
+ * Falls back to the raw slug string.
+ *
+ * @param fieldName - e.g. 'author', 'category'
+ * @param data      - entry data object
+ * @returns display label, or null if the field is absent
+ */
+export function resolveRelation(fieldName, data) {
+    const value = data[fieldName];
+    if (value === undefined || value === null)
+        return null;
+    // Expanded entry object
+    if (typeof value === 'object' && value !== null && 'data' in value) {
+        const entryData = value['data'];
+        if (entryData && typeof entryData === 'object') {
+            const d = entryData;
+            const label = d['name'] ?? d['title'] ?? d['label'] ?? d['slug'];
+            if (typeof label === 'string')
+                return label;
+        }
+        const slug = value['slug'];
+        if (typeof slug === 'string')
+            return slug;
+    }
+    // Raw slug string
+    if (typeof value === 'string')
+        return value;
+    return null;
+}
+/**
+ * Resolve display labels for a `relations` (multi-relation) field.
+ *
+ * @param fieldName - e.g. 'authors', 'tags'
+ * @param data      - entry data object
+ * @returns array of display labels (empty array if field is absent)
+ */
+export function resolveRelations(fieldName, data) {
+    const value = data[fieldName];
+    if (!Array.isArray(value))
+        return [];
+    return value.flatMap((item) => {
+        if (item === null || item === undefined)
+            return [];
+        // Expanded entry object
+        if (typeof item === 'object' && 'data' in item) {
+            const entryData = item['data'];
+            if (entryData && typeof entryData === 'object') {
+                const d = entryData;
+                const label = d['name'] ?? d['title'] ?? d['label'] ?? d['slug'];
+                if (typeof label === 'string')
+                    return [label];
+            }
+            const slug = item['slug'];
+            if (typeof slug === 'string')
+                return [slug];
+            return [];
+        }
+        if (typeof item === 'string')
+            return [item];
+        return [];
+    });
+}
+//# sourceMappingURL=relation.js.map

package/dist/relation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation.js","sourceRoot":"","sources":["../src/relation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC7B,SAAiB,EACjB,IAA6B;IAE7B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAA;IAC7B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAEtD,wBAAwB;IACxB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QACnE,MAAM,SAAS,GAAI,KAAiC,CAAC,MAAM,CAAC,CAAA;QAC5D,IAAI,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC/C,MAAM,CAAC,GAAG,SAAoC,CAAA;YAC9C,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAA;YAChE,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAA;QAC7C,CAAC;QACD,MAAM,IAAI,GAAI,KAAiC,CAAC,MAAM,CAAC,CAAA;QACvD,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAA;IAC3C,CAAC;IAED,kBAAkB;IAClB,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAE3C,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,SAAiB,EACjB,IAA6B;IAE7B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAA;IAC7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAEpC,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC5B,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,EAAE,CAAA;QAElD,wBAAwB;QACxB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YAC/C,MAAM,SAAS,GAAI,IAAgC,CAAC,MAAM,CAAC,CAAA;YAC3D,IAAI,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAC/C,MAAM,CAAC,GAAG,SAAoC,CAAA;gBAC9C,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAA;gBAChE,IAAI,OAAO,KAAK,KAAK,QAAQ;oBAAE,OAAO,CAAC,KAAK,CAAC,CAAA;YAC/C,CAAC;YACD,MAAM,IAAI,GAAI,IAAgC,CAAC,MAAM,CAAC,CAAA;YACtD,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAO,CAAC,IAAI,CAAC,CAAA;YAC3C,OAAO,EAAE,CAAA;QACX,CAAC;QAED,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,CAAC,IAAI,CAAC,CAAA;QAC3C,OAAO,EAAE,CAAA;IACX,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@airdraft/content",
+  "version": "0.1.0",
+  "description": "Airdraft framework-agnostic content rendering utilities — URL resolution, Markdown parsing, relation helpers",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": ["dist", "README.md", "CHANGELOG.md"],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "release": "standard-version",
+    "release:patch": "standard-version --release-as patch",
+    "release:minor": "standard-version --release-as minor",
+    "release:major": "standard-version --release-as major"
+  },
+  "publishConfig": { "access": "public" },
+  "license": "MIT",
+  "dependencies": {
+    "dompurify": "^3.2.6",
+    "isomorphic-dompurify": "^2.26.0",
+    "marked": "^12.0.0"
+  },
+  "devDependencies": {
+    "@types/dompurify": "^3.0.5",
+    "typescript": "^5.7.2"
+  }
+}