npm - @duffcloudservices/cms - Versions diffs - 0.5.1 → 0.7.1 - Mend

@duffcloudservices/cms 0.5.1 → 0.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (22) hide show

package/dist/chunk-FUNIALH6.js +1003 -0
package/dist/chunk-FUNIALH6.js.map +1 -0
package/dist/chunk-KCWMS7P4.js +3 -0
package/dist/chunk-KCWMS7P4.js.map +1 -0
package/dist/index.d.ts +4 -195
package/dist/index.js +3 -2
package/dist/index.js.map +1 -1
package/dist/plugins/index.d.ts +72 -28
package/dist/plugins/index.js +221 -12
package/dist/plugins/index.js.map +1 -1
package/dist/seo/index.d.ts +248 -0
package/dist/seo/index.js +4 -0
package/dist/seo/index.js.map +1 -0
package/dist/vitepressTransform-y8Ru9elj.d.ts +971 -0
package/package.json +8 -3
package/src/components/ManagedImage.test.ts +75 -0
package/src/components/ManagedImage.vue +19 -3
package/src/components/ResponsiveImage.test.ts +47 -0
package/src/components/ResponsiveImage.vue +15 -3
package/dist/chunk-JJK7OGC2.js +0 -459
package/dist/chunk-JJK7OGC2.js.map +0 -1
package/dist/vitepressTransform-D9P9D7So.d.ts +0 -479

package/dist/seo/index.d.ts ADDED Viewed

@@ -0,0 +1,248 @@
+import { S as SeoConfiguration, z as BreadcrumbCrumb, F as ReviewSource, H as FaqSource, E as BlogMeta, W as ResolvedPageSeo, O as SeoSchemaConfig, G as GlobalSeoConfig, M as SeoOpenGraphConfig, N as SeoTwitterConfig } from '../vitepressTransform-y8Ru9elj.js';
+export { A as AI_BOTS, x as BuildLlmsParams, w as BuildRobotsParams, B as BuildSitemapParams, C as ContentConfig, a as CreateSeoTransformPageDataOptions, D as DcsRobotsOptions, a5 as NormalisedFaq, a4 as NormalisedReview, P as PageRouteEntry, R as ResolvedPageOverrides, a6 as ReviewSchemaParts, y as SchemaObject, e as SeoPageContext, f as SeoPageTypeRule, g as VitePressHeadConfig, V as VitePressPageData, u as absolutizeUrl, n as breadcrumbTrailFromRoute, o as buildBlogPosting, m as buildBreadcrumbList, p as buildFaqPage, l as buildGlobalGraph, j as buildLlmsTxt, q as buildReviewSchemaParts, i as buildRobotsTxt, h as buildSitemapXml, b as buildVitePressSeoHead, c as createSeoTransformPageData, d as defaultRelativePathToRoute, a1 as deriveSameAs, s as filterRealFaq, r as filterRealReviews, $ as findLocalBusinessSchema, t as findReviewItemsForPage, a0 as graphAbsorbs, a2 as graphIds, a3 as isLocalBusinessType, k as isRouteIndexable, Z as loadPagesManifest, _ as parsePagesManifest, v as slugToTitle } from '../vitepressTransform-y8Ru9elj.js';
+import 'vue';
+/**
+ * Framework-agnostic SEO head-tag resolution.
+ *
+ * This module is the single source of truth for turning a
+ * (`pageSlug`, `pagePath`, `SeoConfiguration`) triple into a plain,
+ * serialisable description of the `<head>` tags a page should carry:
+ * resolved title, meta[], link[], and JSON-LD script[].
+ *
+ * It is consumed by:
+ *   - `useSEO` (runtime, via `@unhead/vue`) — see `../composables/useSEO.ts`
+ *   - `dcsSeoPlugin`'s build-time static-HTML emitter — see
+ *     `../plugins/dcsSeoPlugin.ts`
+ *
+ * Keeping the resolution here (rather than inside the Vue composable) means
+ * the runtime and the build-time emitter produce byte-identical tags from the
+ * same `seo.yaml`, with no Vue/unhead dependency required at build time.
+ *
+ * Runtime behaviour is intentionally identical to the previous in-composable
+ * logic **except** for one corrected bug: `og:title` now falls back to the
+ * fully-resolved (template-applied) page title instead of the raw, untemplated
+ * `page.title`. Previously `og:title` could diverge from the `<title>` element
+ * (e.g. `<title>Iron Oak Contractors | Our Services</title>` but
+ * `og:title = "Our Services"`).
+ */
+/** A `<meta>` tag — either a `name=`/`content=` or `property=`/`content=` pair. */
+interface HeadMetaTag {
+    name?: string;
+    property?: string;
+    content: string;
+}
+/** A `<link>` tag (canonical, alternate, etc.). */
+interface HeadLinkTag {
+    rel: string;
+    href: string;
+    hreflang?: string;
+}
+/** A `<script type="application/ld+json">` tag carrying serialised JSON-LD. */
+interface HeadScriptTag {
+    type: string;
+    /** Pre-serialised JSON-LD string (already `JSON.stringify`-ed). */
+    children: string;
+}
+/**
+ * The complete, framework-agnostic set of resolved `<head>` tags for a page.
+ *
+ * - `title` is the final, template-applied title (what goes in `<title>`).
+ * - `meta` covers description, keywords, robots, verification, OG, Twitter.
+ * - `link` covers canonical + hreflang alternates.
+ * - `script` covers JSON-LD (global + page schemas).
+ * - `jsonLd` is the same JSON-LD as parsed objects, for callers that want the
+ *   structured form (e.g. `useSEO().getSchema()`).
+ */
+interface ResolvedHeadTags {
+    title: string;
+    meta: HeadMetaTag[];
+    link: HeadLinkTag[];
+    script: HeadScriptTag[];
+    jsonLd: object[];
+    /** The fully-resolved page SEO (merged global + page) used to build tags. */
+    resolved: ResolvedPageSeo;
+}
+/** Optional overrides applied on top of the resolved config when building tags. */
+interface HeadTagOverrides {
+    /** Override the resolved `<title>`. */
+    title?: string;
+    /**
+     * Page-specific title fallback used when `seo.yaml` has no `title` for this
+     * page (e.g. the route `title` from `pages.yaml`). Unlike `global.defaultTitle`
+     * this IS run through `titleTemplate`, so un-configured routes (blog posts,
+     * etc.) get unique titles rather than the global default.
+     */
+    fallbackTitle?: string;
+    /** Override the resolved meta description. */
+    description?: string;
+    /** Override the meta keywords value. */
+    keywords?: string;
+    /**
+     * Force the robots directive (e.g. `'noindex, nofollow'`). When supplied this
+     * wins over both page- and global-level robots.
+     */
+    robots?: string;
+    /** Replace the JSON-LD schema objects entirely (already-built objects). */
+    schemas?: object[];
+    /** Extra meta tags appended after the generated ones. */
+    meta?: HeadMetaTag[];
+    /**
+     * Emit a `<meta name="keywords">` tag from the page's `keywords` field.
+     *
+     * Defaults to `false` so the `useSEO` runtime path stays byte-identical to
+     * its historical output (which never emitted keywords). The static-HTML
+     * emitter opts in (`true`) to surface page keywords in the baked `<head>`.
+     */
+    includeKeywords?: boolean;
+    /**
+     * Emit the global `@graph` spine (Organization + WebSite + the promoted
+     * LocalBusiness node, cross-linked by `@id`) PREPENDED before the per-schema
+     * JSON-LD. When true, the LocalBusiness subtype already present in
+     * `global.schemas` is ABSORBED into the graph (not emitted a second time).
+     * Default `false`.
+     */
+    emitGraph?: boolean;
+    /**
+     * Ordered Home → … → current breadcrumb trail (absolute item URLs). When it
+     * has more than one hop a `BreadcrumbList` is emitted; the home page (≤ 1 hop)
+     * emits none.
+     */
+    breadcrumbTrail?: BreadcrumbCrumb[];
+    /**
+     * REAL review items (from `.dcs/content.yaml`) for the LocalBusiness node.
+     * Honest Review[] + aggregateRating are emitted ONLY for items with a numeric
+     * rating + non-empty text + authorName; empty/missing ⇒ nothing.
+     */
+    reviews?: ReviewSource[];
+    /**
+     * Structured FAQ pairs (frontmatter `faq:` / `.dcs/faq.yaml`). A `FAQPage` is
+     * emitted ONLY when at least one entry has a non-empty question AND answer.
+     */
+    faq?: FaqSource[];
+    /**
+     * Blog-post metadata. When `headline` is present a `BlogPosting` is emitted —
+     * UNLESS the page's own schemas already hand-author a `BlogPosting` (then the
+     * builder defers to the authored copy to avoid duplication).
+     */
+    blogMeta?: BlogMeta;
+}
+/**
+ * Generate Open Graph meta tags from config.
+ *
+ * @param resolvedTitle - the final, template-applied page title. Used as the
+ *   `og:title` fallback so OG stays consistent with `<title>`.
+ */
+declare function generateOpenGraphMeta(og: SeoOpenGraphConfig, global: GlobalSeoConfig, resolvedTitle: string, pageDescription: string, canonical: string): Array<{
+    property: string;
+    content: string;
+}>;
+/**
+ * Generate Twitter Card meta tags from config.
+ *
+ * @param resolvedTitle - the final, template-applied page title (Twitter title
+ *   fallback), mirroring the OG behaviour.
+ */
+declare function generateTwitterMeta(twitter: SeoTwitterConfig, global: GlobalSeoConfig, resolvedTitle: string, pageDescription: string): Array<{
+    name: string;
+    content: string;
+}>;
+/**
+ * Generate JSON-LD schema objects from schema configs, auto-populating common
+ * WebSite properties from global config.
+ */
+declare function generateJsonLd(schemas: SeoSchemaConfig[], global: GlobalSeoConfig): object[];
+/**
+ * Resolve page SEO by merging global defaults with page-specific config.
+ *
+ * Behavioural changes from the historical in-composable version (both bug
+ * fixes):
+ *   1. `openGraph.title` falls back to the **template-applied** page title, not
+ *      the raw `page.title`, so `og:title` matches `<title>`.
+ *   2. The `titleTemplate` is applied **only** to a page-specific title
+ *      (`page.title`, or the `fallbackTitle` arg). It is no longer applied to
+ *      `global.defaultTitle`, which is already the complete brand title —
+ *      templating it produced `"Brand | Default Title | Brand"` doubling on any
+ *      page without its own `seo.yaml` entry.
+ *
+ * @param fallbackTitle - a page-specific title to use when `seo.yaml` has no
+ *   `title` for this page (e.g. the route `title` from `pages.yaml`). It IS run
+ *   through `titleTemplate`; `global.defaultTitle` is the last resort and is not.
+ */
+declare function resolvePageSeo(pageSlug: string, pagePath: string | undefined, seoConfig: SeoConfiguration | undefined, fallbackTitle?: string): ResolvedPageSeo;
+/**
+ * Build the complete, framework-agnostic set of `<head>` tags for a page.
+ *
+ * This is the function both the `useSEO` runtime and the build-time emitter
+ * call, guaranteeing identical output. Pass `overrides` to mirror the
+ * composable's `applyHead(overrides)` behaviour, or to force `robots` (used by
+ * the emitter's `noindex` option).
+ */
+declare function buildHeadTags(pageSlug: string, pagePath: string | undefined, seoConfig: SeoConfiguration | undefined, overrides?: HeadTagOverrides): ResolvedHeadTags;
+/**
+ * Pure, framework-free `<head>` splicing for the build-time SEO emitter.
+ *
+ * Given a built `index.html` shell and a set of resolved head tags (from
+ * `buildHeadTags`), this produces a new HTML string where the SEO-managed
+ * tags — `<title>`, `description`, `keywords`, `robots`, `canonical`,
+ * verification, all `og:*` / `article:*` properties, all `twitter:*` names,
+ * and `application/ld+json` scripts — have been **replaced** (not duplicated)
+ * with the resolved set.
+ *
+ * Design goals:
+ *   - **Idempotent**: running it twice yields the same output (it strips the
+ *     managed tags first, then re-inserts the canonical set).
+ *   - **Deterministic**: tag order is fixed by `renderHeadTags`.
+ *   - **Conservative**: only tags we own are touched. Charset, viewport, CSP,
+ *     theme-color, favicons, stylesheets, and the app script are left intact.
+ *
+ * This is intentionally regex-based (no DOM dependency) to mirror the existing
+ * `dcsCdnImagePlugin` post-build HTML rewriting and to keep the emitter free of
+ * heavy parser deps at build time.
+ */
+/**
+ * Escape a JSON-LD string for safe inclusion inside an HTML `<script>` element.
+ *
+ * A `<script type="application/ld+json">` is a DATA block, but the HTML parser
+ * still scans its raw text for `</script` (and `<!--`) — so untrusted CMS free
+ * text (review bodies, FAQ Q&A, blog descriptions) carrying `</script>` could
+ * break out of the script and inject markup (stored XSS).
+ *
+ * Per OWASP "JSON in an HTML context", we escape the three HTML-significant
+ * characters as their `\uXXXX` JSON escapes. Because these characters only ever
+ * appear INSIDE JSON string literals (never as JSON structure), the result is
+ * still byte-for-byte valid JSON that `JSON.parse` round-trips:
+ *   `<` → `<`  (defeats `</script>` and `<!--` breakout)
+ *   `>` → `>`
+ *   `&` → `&`
+ *
+ * Exported so BOTH static-SEO sinks (the SPA `spliceHeadHtml` path AND the
+ * VitePress `transformPageData` head emit) share one guard.
+ */
+declare function escapeJsonLd(json: string): string;
+/**
+ * Render the resolved head tags to a deterministic HTML fragment.
+ * Order: title, meta (in the order produced by buildHeadTags), link, script.
+ */
+declare function renderHeadTags(tags: ResolvedHeadTags, indent?: string): string;
+/**
+ * Strip the SEO-managed tags from a `<head>` block so they can be re-inserted
+ * without duplication. Operates only within `<head>...</head>` to avoid
+ * touching body content.
+ */
+declare function stripManagedHeadTags(html: string): string;
+/**
+ * Splice resolved SEO head tags into an HTML document.
+ *
+ * Strips the existing managed tags, then inserts the rendered canonical set
+ * immediately before `</head>`. If no `<head>` is present the HTML is returned
+ * unchanged (defensive — the emitter logs and no-ops in that case).
+ *
+ * Idempotent: applying twice produces identical output.
+ */
+declare function spliceHeadHtml(html: string, tags: ResolvedHeadTags): string;
+export { BlogMeta, BreadcrumbCrumb, FaqSource, type HeadLinkTag, type HeadMetaTag, type HeadScriptTag, type HeadTagOverrides, type ResolvedHeadTags, ReviewSource, buildHeadTags, escapeJsonLd, generateJsonLd, generateOpenGraphMeta, generateTwitterMeta, renderHeadTags, resolvePageSeo, spliceHeadHtml, stripManagedHeadTags };

package/dist/seo/index.js ADDED Viewed

@@ -0,0 +1,4 @@
+import '../chunk-KCWMS7P4.js';
+export { AI_BOTS, absolutizeUrl, breadcrumbTrailFromRoute, buildBlogPosting, buildBreadcrumbList, buildFaqPage, buildGlobalGraph, buildHeadTags, buildLlmsTxt, buildReviewSchemaParts, buildRobotsTxt, buildSitemapXml, buildVitePressSeoHead, createSeoTransformPageData, defaultRelativePathToRoute, deriveSameAs, escapeJsonLd, filterRealFaq, filterRealReviews, findLocalBusinessSchema, findReviewItemsForPage, generateJsonLd, generateOpenGraphMeta, generateTwitterMeta, graphAbsorbs, graphIds, isLocalBusinessType, isRouteIndexable, loadPagesManifest, parsePagesManifest, renderHeadTags, resolvePageSeo, slugToTitle, spliceHeadHtml, stripManagedHeadTags } from '../chunk-FUNIALH6.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/seo/index.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}