@devslab/site-kit 0.6.0 → 0.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devslab/site-kit",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "Strict i18n, SEO/GEO, and Solid public-site shells for DevsLab products",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
@@ -32,6 +32,10 @@
   "main": "./src/core/index.mjs",
   "types": "./src/core/index.d.mts",
   "exports": {
+    "./devslab": {
+      "types": "./src/core/devslab.d.mts",
+      "import": "./src/core/devslab.mjs"
+    },
     ".": {
       "types": "./src/core/index.d.mts",
       "import": "./src/core/index.mjs"
@@ -56,7 +60,7 @@
     "./site-sections.css": "./site-sections.css"
   },
   "dependencies": {
-    "@devslab/dds-solid": "0.6.0"
+    "@devslab/dds-solid": "0.8.0"
   },
   "peerDependencies": {
     "@tanstack/solid-router": "1.170.30",

package/src/core/devslab.d.mts

@@ -0,0 +1,2 @@
+import type { PublisherIdentity } from "./publisher.mjs";
+export declare const DEVSLAB_PUBLISHER: Readonly<PublisherIdentity>;

package/src/core/devslab.mjs

@@ -0,0 +1,12 @@
+import { definePublisher } from "./publisher.mjs";
+
+/** Shared DevsLab identity. Product names, capabilities and policies stay with consumers. */
+export const DEVSLAB_PUBLISHER = definePublisher({
+  id: "https://devslab.kr/#organization",
+  name: "DevsLab",
+  alternateName: ["데브스랩", "devslab"],
+  url: "https://devslab.kr/",
+  sameAs: ["https://github.com/devslab-kr", "https://devslab-kr.github.io/"],
+  defaultLabel: "데브스랩(DevsLab)",
+  labels: { ko: "데브스랩(DevsLab)", en: "DevsLab" },
+});

package/src/core/index.d.mts

@@ -2,3 +2,4 @@ export * from "./locales.mjs";
 export * from "./catalog.mjs";
 export * from "./seo.mjs";
 export * from "./geo.mjs";
+export * from "./publisher.mjs";

package/src/core/index.mjs

@@ -2,3 +2,4 @@ export { FAMILY_LOCALES, LOCALES, canonicalLocale, defineLocaleRegistry, localeA
 export { CatalogValidationError, createTranslator, validateCatalogs } from "./catalog.mjs";
 export { ROBOTS_USER_AGENTS, buildMetadata, buildRobots, buildSitemap, localizedPath, localizedUrl, renderSitemapXml } from "./seo.mjs";
 export { VerifiedFactRegistry, buildVerifiedJsonLd, renderLlmsTxt } from "./geo.mjs";
+export { definePublisher, buildPublisher, serializeJsonLd, renderPublisherHtml } from "./publisher.mjs";

package/src/core/publisher.d.mts

@@ -0,0 +1,27 @@
+export interface PublisherIdentity {
+  readonly id: string;
+  readonly name: string;
+  readonly url: string;
+  readonly alternateName?: string | readonly string[];
+  readonly sameAs?: readonly string[];
+  readonly labels?: Readonly<Record<string, string>>;
+  readonly defaultLabel?: string;
+}
+export interface PublisherOrganization {
+  "@context": "https://schema.org";
+  "@type": "Organization";
+  "@id": string;
+  name: string;
+  url: string;
+  alternateName?: string | readonly string[];
+  sameAs?: readonly string[];
+}
+export interface BuiltPublisher {
+  organization: PublisherOrganization;
+  reference: { "@id": string };
+  link: { href: string; label: string };
+}
+export declare function definePublisher(input: PublisherIdentity): Readonly<PublisherIdentity>;
+export declare function buildPublisher(identity: PublisherIdentity, options?: { locale?: string }): BuiltPublisher;
+export declare function serializeJsonLd(value: unknown): string;
+export declare function renderPublisherHtml(identity: PublisherIdentity, options?: { locale?: string; nonce?: string }): string;

package/src/core/publisher.mjs

@@ -0,0 +1,62 @@
+function text(value, field) {
+  if (typeof value !== "string" || !value.trim()) throw new TypeError(`Publisher ${field} must be a nonempty string`);
+  return value;
+}
+
+function webUrl(value, field) {
+  text(value, field);
+  let parsed;
+  try { parsed = new URL(value); } catch { throw new TypeError(`Publisher ${field} must be an absolute HTTP(S) URL`); }
+  if (!["http:", "https:"].includes(parsed.protocol) || parsed.username || parsed.password) throw new TypeError(`Publisher ${field} must be an HTTP(S) URL without credentials`);
+  return parsed.href;
+}
+
+/** Identity only. Capabilities, endorsements and other GEO claims remain verified facts. */
+export function definePublisher(input) {
+  const labels = Object.fromEntries(Object.entries(input.labels ?? {}).map(([locale, label]) => [locale, text(label, "label")]));
+  const alternateName = input.alternateName === undefined ? undefined : Array.isArray(input.alternateName)
+    ? Object.freeze(input.alternateName.map((name) => text(name, "alternateName"))) : text(input.alternateName, "alternateName");
+  const sameAs = input.sameAs === undefined ? undefined : Object.freeze(input.sameAs.map((url) => webUrl(url, "sameAs URL")));
+  return Object.freeze({
+    id: webUrl(input.id, "id URL"), name: text(input.name, "name"), url: webUrl(input.url, "url URL"),
+    ...(alternateName === undefined ? {} : { alternateName }),
+    ...(sameAs === undefined ? {} : { sameAs }),
+    labels: Object.freeze(labels),
+    defaultLabel: text(input.defaultLabel ?? input.name, "defaultLabel"),
+  });
+}
+
+export function buildPublisher(input, { locale } = {}) {
+  const identity = definePublisher(input);
+  const language = locale?.toLowerCase();
+  const labelFor = (key) => Object.hasOwn(identity.labels, key) ? identity.labels[key] : undefined;
+  const label = labelFor(locale) ?? labelFor(language) ?? labelFor(language?.split("-")[0]) ?? identity.defaultLabel;
+  return {
+    organization: {
+      "@context": "https://schema.org", "@type": "Organization", "@id": identity.id,
+      name: identity.name, url: identity.url,
+      ...(identity.alternateName === undefined ? {} : { alternateName: identity.alternateName }),
+      ...(identity.sameAs === undefined ? {} : { sameAs: identity.sameAs }),
+    },
+    reference: { "@id": identity.id },
+    link: { href: identity.url, label },
+  };
+}
+
+/** Safe inside an HTML script element, including when values contain </script>. */
+export function serializeJsonLd(value) {
+  const json = JSON.stringify(value);
+  if (json === undefined) throw new TypeError("JSON-LD must be JSON serializable");
+  return json.replace(/</g, "\\u003c").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+}
+
+function escapeHtml(value) {
+  return String(value).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+
+/** Build-time/SSR snippet: a visible attribution link and its matching identity. */
+export function renderPublisherHtml(identity, { locale, nonce } = {}) {
+  const { organization, link } = buildPublisher(identity, { locale });
+  const nonceAttribute = nonce === undefined ? "" : ` nonce="${escapeHtml(nonce)}"`;
+  return `<a href="${escapeHtml(link.href)}">${escapeHtml(link.label)}</a>\n<script type="application/ld+json"${nonceAttribute}>${serializeJsonLd(organization)}</script>`;
+}

package/styles.css

@@ -19,6 +19,15 @@
 .site-locale { inline-size: auto; min-inline-size: 9rem; }
 .site-footer { border-block-start: 1px solid var(--dds-color-border-default); margin-block-start: var(--dds-space-64); padding-block: var(--dds-space-32); }
 .site-footer__inner { inline-size: min(100% - var(--dds-space-32), 1120px); margin-inline: auto; display: grid; gap: var(--dds-space-16); }
+.site-footer__langs { display: flex; flex-wrap: wrap; gap: var(--dds-space-8) var(--dds-space-16); font-size: var(--dds-typo-caption-font-size); }
+.site-footer__langs a { color: var(--dds-color-text-muted); text-decoration: none; }
+.site-footer__langs a:hover { color: var(--dds-color-text-primary); }
+.site-footer__langs a[aria-current="page"] { color: var(--dds-color-text-primary); font-weight: 600; }
+.site-footer__row { display: flex; flex-wrap: wrap; justify-content: space-between; align-items: center; gap: var(--dds-space-16) var(--dds-space-32); }
+.site-footer__brand { display: inline-flex; align-items: center; gap: var(--dds-space-8); margin: 0; color: var(--dds-color-text-secondary); }
+.site-footer__brand img, .site-footer__brand svg { block-size: 16px; inline-size: 16px; }
+.site-footer__brand a { color: inherit; text-decoration: none; }
+.site-footer__brand a:hover { color: var(--dds-color-text-primary); text-decoration: underline; }
 .site-legal { max-inline-size: 760px; margin-inline: auto; padding-block: var(--dds-space-40); }
 .site-status { border: 1px solid var(--dds-color-border-default); border-inline-start-width: var(--dds-space-4); border-radius: var(--dds-radius-md); padding: var(--dds-space-12) var(--dds-space-16); }
 .site-status--danger { border-inline-start-color: var(--dds-color-status-danger); }