@jxsuite/studio 0.0.1

package/src/site-context.js

@@ -0,0 +1,122 @@
+/**
+ * Site context helpers - merge site-level definitions with file-level.
+ *
+ * When a project has a project.json, its $media and style cascade into every file. File-level
+ * definitions merge on top (file wins on conflict).
+ */
+
+import { projectState, setProjectState } from "./store.js";
+import { getPlatform } from "./platform.js";
+
+/**
+ * Merge site $media with document $media. Document keys win on conflict.
+ *
+ * @param {any} docMedia - The current document's $media (may be undefined)
+ * @returns {any}
+ */
+export function getEffectiveMedia(docMedia) {
+  const siteMedia = projectState?.projectConfig?.$media;
+  if (!siteMedia) return docMedia || {};
+  if (!docMedia) return { ...siteMedia };
+  return { ...siteMedia, ...docMedia };
+}
+
+/**
+ * Merge site style with document style. Document keys win on conflict. Nested selector objects
+ * (e.g. `& li`) are shallow-merged individually.
+ *
+ * @param {any} docStyle - The current document's style (may be undefined)
+ * @returns {any}
+ */
+export function getEffectiveStyle(docStyle) {
+  const siteStyle = projectState?.projectConfig?.style;
+  if (!siteStyle) return docStyle || {};
+  if (!docStyle) return { ...siteStyle };
+  const merged = { ...siteStyle };
+  for (const [k, v] of Object.entries(docStyle)) {
+    if (
+      typeof v === "object" &&
+      v !== null &&
+      typeof merged[k] === "object" &&
+      merged[k] !== null
+    ) {
+      merged[k] = { ...merged[k], ...v };
+    } else {
+      merged[k] = v;
+    }
+  }
+  return merged;
+}
+
+/**
+ * Merge site imports with document imports. Document keys win on conflict.
+ *
+ * @param {any} docImports - The current document's imports (may be undefined)
+ * @returns {any}
+ */
+export function getEffectiveImports(docImports) {
+  const siteImports = projectState?.projectConfig?.imports;
+  if (!siteImports) return docImports || {};
+  if (!docImports) return { ...siteImports };
+  return { ...siteImports, ...docImports };
+}
+
+/**
+ * Merge site $elements with document $elements. Union with dedup by $ref or string value.
+ *
+ * @param {any[]} [docElements] - The current document's $elements (may be undefined)
+ * @returns {any[]}
+ */
+export function getEffectiveElements(docElements) {
+  const siteElements = projectState?.projectConfig?.$elements;
+  if (!siteElements?.length) return docElements || [];
+  if (!docElements?.length) return [...siteElements];
+  /** @type {Set<string>} */
+  const seen = new Set();
+  /** @type {any[]} */
+  const merged = [];
+  for (const entry of [...siteElements, ...docElements]) {
+    const key = typeof entry === "string" ? entry : entry?.$ref;
+    if (key && !seen.has(key)) {
+      seen.add(key);
+      merged.push(entry);
+    }
+  }
+  return merged;
+}
+
+/**
+ * Merge site $head with document $head. Union with dedup by href/src.
+ *
+ * @param {any[]} [docHead] - The current document's $head (may be undefined)
+ * @returns {any[]}
+ */
+export function getEffectiveHead(docHead) {
+  const siteHead = projectState?.projectConfig?.$head;
+  if (!siteHead?.length) return docHead || [];
+  if (!docHead?.length) return [...siteHead];
+  /** @type {Set<string>} */
+  const seen = new Set();
+  /** @type {any[]} */
+  const merged = [];
+  for (const entry of [...siteHead, ...docHead]) {
+    const key = entry?.attributes?.href || entry?.attributes?.src || JSON.stringify(entry);
+    if (!seen.has(key)) {
+      seen.add(key);
+      merged.push(entry);
+    }
+  }
+  return merged;
+}
+
+/**
+ * Update the project's project.json with a partial patch and persist to disk.
+ *
+ * @param {Record<string, any>} patch - Fields to merge into the current projectConfig
+ */
+export async function updateSiteConfig(patch) {
+  const platform = getPlatform();
+  const config = { ...projectState.projectConfig, ...patch };
+  await platform.writeFile("project.json", JSON.stringify(config, null, 2));
+  setProjectState({ ...projectState, projectConfig: config });
+}