// --- Base Config --- window.projectSlug = window.location.pathname.split("/").find(Boolean) || ""; const TechDocsConfig = { debug: true, selectors: { superHub: "#ssr-main > div > div[class^='SuperHub']", pageNotFound: "div[class^='PageNotFound'].rm-Container", ssrProps: "#ssr-props", searchModal: ".rm-SearchModal, [class*='SearchModal']", primaryNav: 'nav[aria-label="Primary navigation"]', changelogPost: ".rm-Changelog article[class*='ChangelogPostExcerpt']", apiTitle: ".rm-Sidebar-section .rm-Sidebar-link:not([class*='Sidebar-link_hidden'])", aiSelectorsBtn: 'button, a.Menu-Item[role="button"], div.Menu-Item[role="button"]' }, projects: { onlyAuthHelp: [ "aura-secret-mgmt", "aura-lcdn-services", "aura-network-policy", "aura-lcdn-mapping", "aura-log-streaming", "aura-infrastructure", "aura-lcdn-deployment", "aura-lcdn-content-delivery", "aura-lcdn-content-control", "linode-api", "cloudtest", "msl5-harmonic" ], mutualAuth: ["iot-edge-message-stream", "iot-edge-connect-msg-store"], skipCodeComments: ["mpulse", "aura-secret-mgmt", "aura-lcdn-services", "aura-network-policy"], // Extracted dynamically if needed authLinks: ["mpulse", "cloudtest", "identity-cloud", "netstorage-usage", "iot-edge-message-stream", "iot-edge-connect-msg-store"], collapseTablesByDefault: ["terraform", "powershell", "quick-deploy-apps", "internal-poc-api"] }, trackedButtons: new Set(['Copy Page', 'Open in ChatGPT', 'Open in Claude', 'View as Markdown']) }; const Logger = { log: (msg, ...args) => console.log(`%c[TechDocs]`, 'color: #0174BC; font-weight: bold;', msg, ...args), error: (msg, ...args) => console.error(`%c[TechDocs]`, 'color: red; font-weight: bold;', msg, ...args), warn: (msg, ...args) => console.warn(`%c[TechDocs]`, 'color: #ff8b00; font-weight: bold;', msg, ...args), debug: TechDocsConfig.debug ? (msg, ...args) => console.log(`%c[TechDocs]`, 'color: #0174BC; font-weight: bold;', msg, ...args) : () => {} }; const Utils = { delay: (ms = 500) => new Promise(resolve => setTimeout(resolve, ms)), debounce(func, wait) { let timeout; return function (...args) { clearTimeout(timeout); timeout = setTimeout(() => func.apply(this, args), wait); }; }, async fetchData(url, isText = false) { try { const response = await fetch(url, { method: "GET", cache: "default", headers: { Accept: "application/json" }, redirect: "follow" }); Logger.debug(`Fetched data from ${url}`); return isText ? await response.text() : await response.json(); } catch (e) { Logger.error(`Fetch failure on ${url}`, e); return null; } }, isExternalLink(link) { if (!link || link.startsWith("/") || link.startsWith("#")) return false; const isSameSite = link.startsWith(window.location.origin); const isPdf = link.endsWith(".pdf") || link.includes(".pdf#"); return (isSameSite && isPdf) || !isSameSite; }, isPrivateLink(href, privateProjects = []) { return privateProjects.some(p => href.includes(p)); }, waitFor(selectors, { all = false, settleTime = 0, maxWait = 5000, root = document.body } = {}) { const selectorList = Array.isArray(selectors) ? selectors : [selectors]; // Helper to find elements based on the 'all' flag const findElements = () => { const results = selectorList.map(selector => { if (all) { const elements = [...document.querySelectorAll(selector)]; return elements.length ? elements : null; } return document.querySelector(selector); }); // Ensure every selector found at least one match if (results.every(Boolean)) { return selectorList.length > 1 ? results : results[0]; } return null; }; return new Promise(resolve => { let settleTimer; let failSafeTimer; const finish = (result) => { observer?.disconnect(); clearTimeout(failSafeTimer); clearTimeout(settleTimer); Logger.debug(`Element(s) found for selector(s): ${selectorList.join(", ")}`); resolve(result); }; // Check immediately const existing = findElements(); // If found immediately and no settle time is needed, resolve right away if (existing && !settleTime) { Logger.debug(`Element(s) found for selector(s): ${selectorList.join(", ")}`); return resolve(existing); } const observer = new MutationObserver(() => { const result = findElements(); if (!result) { // If element disappears during the settle period, reset the timer clearTimeout(settleTimer); return; } clearTimeout(settleTimer); if (settleTime) { settleTimer = setTimeout(() => finish(result), settleTime); } else { finish(result); } }); observer.observe(root, { childList: true, subtree: true }); // If it existed immediately but requires settleTime, kick off the first debounce timer if (existing && settleTime) { settleTimer = setTimeout(() => finish(existing), settleTime); } // Setup Fail-safe Timeout failSafeTimer = setTimeout(() => { observer.disconnect(); clearTimeout(settleTimer); Logger.warn(`Timed out waiting for selector(s) ${selectorList.join(", ")}`); resolve(null); }, maxWait); }); }, retryUntilReady(checkAndApply, { interval = 100, maxTries = 30 } = {}) { let tries = 0; const id = setInterval(() => { tries++; const done = checkAndApply(); if (done || tries >= maxTries) { Logger.debug(`Retry check completed for ${checkAndApply.name || "anonymous"}. Success: ${done}, Tries: ${tries}`); clearInterval(id); } }, interval); }, normalizeText(value) { return (value || "").replace(/\s+/g, " ").trim().toLowerCase(); }, isExactMatch(element, txt) { return element.innerText.trim() === txt; } }; const ContextManager = { init() { try { const element = document.getElementById("ssr-props"); if (element) { window.initialProps = JSON.parse(element.innerHTML); window.initialPropsData = window.initialProps.context?.variables || {}; window.glossaryPropsData = window.initialProps.context?.terms || {}; Logger.debug("initialProps parsed successfully."); } else { // see compatibility from #hub-me? window.initialProps = {}; window.initialPropsData = {}; window.glossaryPropsData = {}; } } catch (e) { Logger.error("initialProps parse failed — fallback defaults used.", e); window.initialProps = {}; window.initialPropsData = {}; window.glossaryPropsData = {}; } const meta = document.querySelector('meta[property="og:site_name"]'); window.projectLabel = (meta?.getAttribute("content") || window.projContentName || "").trim(); }, projectLabel() { const meta = document.querySelector('meta[property="og:site_name"]'); return (meta?.getAttribute("content") || window.projContentName || "").trim(); }, productSlug() { return window.location.pathname.split("/").find(Boolean) || ""; }, isHomePage() { const path = window.location.pathname; return path.includes("home") || path.includes("home-v6"); }, isSection(type) { return window.location.pathname.includes(`/${type}`); }, isReferenceSection() { return this.isSection("reference/"); }, isRecipesSection() { return this.isSection("recipes/"); }, isChangelogSection() { return this.isSection("changelog"); } }; const AnalyticsEngine = { init() { this.bindEvents(); }, trackPageView() { if (window._satellite?.track) { window._satellite.track("page_view", { url: window.location.href, adobeDataLayer: window.adobeDataLayer }); Logger.debug(`AA view: ${window.location.href}`); } }, trackInteraction(linkValue) { if (window._satellite?.track) { window._satellite.track("click_interaction", { linkValue, adobeDataLayer: window.adobeDataLayer }); Logger.debug(`AA click: ${linkValue}`); } }, trackSearchInteraction(searchTerm) { if (window._satellite?.track) { window._satellite.track("site_search", { "search term": searchTerm, "search type": "project search", url: window.location.href, adobeDataLayer: window.adobeDataLayer }); Logger.debug(`AA search: ${searchTerm}`); } }, getLanguageSelection(isDefault = true, isRef = true) { const referenceLanguageSelector = ".rm-LanguageButton_active"; const recipeLanguageSelector = "section[aria-hidden='false'] button[class*='TutorialEditor-Nav-Tab_active']"; const classSelector = isRef ? referenceLanguageSelector : recipeLanguageSelector; // using cash-dom $ which is globally available const langText = window.$(classSelector).text(); if (!langText?.trim()) return ""; const clickedText = isDefault ? '(Default)' : '(Clicked)'; const isSection = isRef ? "api:reference" : "recipes:recipe"; return `${isSection} language:${langText.trim()} ${clickedText}`; }, trackReferenceLanguageSelection() { if (ContextManager.isReferenceSection()) { const selectorValue = this.getLanguageSelection(); const trigger = typeof window.isMultipleRefLangClicked === "function" ? window.isMultipleRefLangClicked(selectorValue) : false; if (!trigger) { this.trackInteraction(selectorValue); } } }, trackRecipeLanguageSelection() { if (ContextManager.isRecipesSection()) { const selectorValue = this.getLanguageSelection(false, false); const trigger = typeof window.isMultipleRefLangClicked === "function" ? window.isMultipleRefLangClicked(selectorValue) : false; if (!trigger) { this.trackInteraction(selectorValue); } } }, triggerLytics() { if (!window.lyticsTagFunction || typeof window.lyticsTagFunction !== "function" || navigator.userAgent.includes("Sinequa")) return; const groups = window.OptanonActiveGroups; const hasRequiredConsent = groups?.includes("C0002") && groups?.includes("C0004"); if (!hasRequiredConsent) return; if (typeof window.setNewSlug === "function" && window.setNewSlug()) { window.lyticsTagFunction(); Logger.debug("AA Lytics."); } }, bindStaticClickTrackers() { // Track AI / Copy Interactions document.addEventListener('click', (event) => { const targetElement = event.target.closest(TechDocsConfig.selectors.aiSelectorsBtn); if (!targetElement) return; const elementText = (targetElement.textContent || '').trim(); if (TechDocsConfig.trackedButtons.has(elementText)) { this.trackInteraction(`ai:${elementText}`); } }, { capture: true }); }, bindEvents() { $(window).on("click", ".rm-LanguageButton", function () { const selectorValue = AnalyticsEngine.getLanguageSelection(false); const trigger = typeof window.isMultipleRefLangClicked === "function" ? window.isMultipleRefLangClicked(selectorValue) : false; if (!trigger) { AnalyticsEngine.trackInteraction(selectorValue); } }); $(window).on("click", ".postman-run-button", function () { AnalyticsEngine.trackInteraction(`api:${document.querySelector("title").innerText}:run in postman`); }); $(window).on("click", "a.rm-Header-link.rm-Header-bottom-link", function (e) { AnalyticsEngine.trackInteraction(`navigation:${e.target.textContent}`); }); $(document).on("click", ".rm-LanguagePicker div[class*='LanguagePicker-MenuItem']", function () { setTimeout(() => { const selectorValue = AnalyticsEngine.getLanguageSelection(false); const trigger = typeof window.isMultipleRefLangClicked === "function" ? window.isMultipleRefLangClicked(selectorValue) : false; if (!trigger) { AnalyticsEngine.trackInteraction(selectorValue); } }, 5); }); $(window).on("click", ".TutorialEditor-Nav button", function () { const selectorValue = AnalyticsEngine.getLanguageSelection(false, false); const trigger = typeof window.isMultipleRecipeLang === "function" ? window.isMultipleRecipeLang(selectorValue) : false; if (!trigger) { AnalyticsEngine.trackInteraction(selectorValue); } }); $(document).on("keyup", ".docsearch-wrapper input", function (e) { if (e.keyCode === 13) { const searchInputs = document.querySelectorAll(".docsearch-wrapper input"); let searchTerm = searchInputs[1]?.value; if (searchTerm == undefined || searchTerm === "") searchTerm = searchInputs[0]?.value; if (!searchTerm?.trim()) return ""; AnalyticsEngine.trackSearchInteraction(searchTerm.trim()); } }); } }; const AuthUserNavMenu = { init() { this.bindEvents(); }, updateLoggedInDetailsOverride(duration = 200) { const isLoggedIn = document.documentElement.classList.contains("userLoggedIn"); const initialPropsData = window.initialPropsData || {}; const productSlugName = ContextManager.productSlug(); const privateProjects = window.privateProjects || []; const replaceLink = (element, loggedIn = false) => { if (!element) return; try { const url = new URL(element.href, window.location.origin); const key = loggedIn ? "redirect_uri" : "redirect"; const path = window.location.pathname; if (url.searchParams.get(key) !== path) { url.searchParams.set(key, path); element.href = url.toString(); } } catch (e) { Logger.error("Failed to update redirect URL", e); } }; let ele; if (!privateProjects.includes(productSlugName)) { ele = document.querySelector("a.td-logout"); replaceLink(ele, true); ele = document.querySelector("div.td-logout a"); replaceLink(ele, true); } if (!isLoggedIn || !initialPropsData.user?.email) { setTimeout(() => { ele = document.querySelector(".td-login"); replaceLink(ele); ele = document.querySelector(".td-mobile-login"); replaceLink(ele); }, duration); } if (isLoggedIn) { setTimeout(() => { let email = initialPropsData?.user?.email; if (!email) { try { const hubMe = document.querySelector("#hub-me"); if (hubMe?.dataset.json) { email = JSON.parse(hubMe.dataset.json).user.email; } } catch (e) { Logger.error("Error parsing user email", e.message); } } $(".td-user-icon").show(); if (email) { $(".td-login .td-login-text").text(email).addClass("td-user"); $(".td-login").attr("data-tooltip", email); $(".td-mobile-login .td-login-text").text(email).addClass("td-user"); } $(".td-login").attr("href", ""); $(".td-mobile-login").attr("href", ""); }, duration); } }, bindEvents() { $(window).on("click", "a.td-contact", function () { $("a.td-contact .td-icon-nav-up").toggleClass("td-icon-down"); $(".td-contact-dropdown-content").toggle(); $(".td-login-dropdown-content").hide(); }); $(window).on("click", ".td-login", function (e) { if (!$(".td-login").attr("href")) { e.preventDefault(); } $(".td-login-dropdown-content").toggle(); $(".td-contact-dropdown-content").hide(); $(".td-contact .td-icon").removeClass("td-icon-down"); }); $(window).on("click", ".td-mobile-nav-icons .td-icon-menu", function () { $(".td-mobile").toggle(); $(".td-search-flyout").hide(); $(".td-mobile-nav-icons .icon-search1").removeClass("td-active"); $(".td-icon-menu").toggleClass("td-icon-hover"); }); $(window).on("click", ".err .td-mobile-nav-icons-1 .td-icon-menu", function () { $(".td-mobile").toggle(); $(".err .td-search-flyout-1").hide(); $(".err .td-mobile-nav-icons-1 .icon-search1").removeClass("td-active"); $(".td-icon-menu").toggleClass("td-icon-hover"); }); $(window).on("blur", ".td-contact-dropdown", function (e) { if (!e.relatedTarget) { $(".td-contact-dropdown-content").hide(); $(".td-contact .td-icon").removeClass("td-icon-down"); } }); $(window).on("blur", ".td-login", function (e) { if (!e.relatedTarget) { $(".td-login-dropdown-content").hide(); } }); $(window).on("click", ".td-mobile-nav-icons .icon-search1", function () { $(".td-search-flyout").toggle(); $(".td-mobile").hide(); $(".td-icon-menu").removeClass("td-icon-hover"); $(".td-mobile-nav-icons .icon-search1").toggleClass("td-active"); }); $(window).on("click", ".err .td-mobile-nav-icons-1 .icon-search1", function () { $(".err .td-search-flyout-1").toggle(); $(".td-mobile").hide(); $(".td-icon-menu").removeClass("td-icon-hover"); $(".err .td-mobile-nav-icons-1 .icon-search1").toggleClass("td-active"); }); } }; const ChangelogFeatures = { init() { this.bindEvents(); }, readMore() { if (!ContextManager.isChangelogSection()) return; const hasReadMore = document.querySelectorAll(".ch-release-note").length; if (hasReadMore) return; document.querySelectorAll(TechDocsConfig.selectors.changelogPost) .forEach(post => { const href = post.querySelectorAll("h2 a")[0]?.getAttribute("href"); if (!href) return; const span = document.createElement("span"); span.classList.add("ch-release-note"); span.innerText = "Read full release note"; post.querySelector("section.markdown-body")?.append(span); }); Logger.debug("'Read full release note' links added."); }, releaseNotesBackButton() { if (!ContextManager.isChangelogSection()) return; const backBtnDiv = document.querySelector(".rm-Changelog article.rm-Changelog-post > div"); if (!backBtnDiv) return; const btnText = ContextManager.projectLabel() + " release notes"; const span = backBtnDiv.querySelectorAll("button span")[1]; if (span) { span.innerText = btnText; } else { const firstLink = backBtnDiv.querySelector("a"); if (firstLink) { const spanIcon = firstLink.querySelector("span")?.outerHTML || ""; firstLink.innerHTML = spanIcon + `${btnText}`; firstLink.style.display = "flex"; } } const backToAllBtn = document.querySelector(".rm-Changelog a.to_all_notes"); if (!backToAllBtn) { const anchor = document.createElement("a"); anchor.className = "Button Button_sm Button Button_sm Button_text to_all_notes ChangelogPost_backVFYixWm1Jvy7 Button_primary"; anchor.type = "button"; anchor.href = "/release-notes/docs"; anchor.innerHTML = 'All release notes'; anchor.style.display = "flex"; backBtnDiv.appendChild(anchor); } const div = document.querySelector("article.rm-Changelog-post div[class*='ChangelogPage_back']"); if (div) div.style.display = "flex"; Logger.debug("Changelog back button updated."); }, bindEvents() { $(window).on("click", "a.rm-Header-bottom-link, a[class*='Pagination-link']", (e) => { if (e.currentTarget.getAttribute("href")?.includes("changelog")) this.readMore(); }); $(document).on("click", ".ch-release-note", function () { $(this).parent().siblings("h2").children("a").trigger("click"); }); } }; const AuthSectionUI = { init() { this.bindEvents(); }, commentCodeLine(commentText = "") { return `

${commentText}

`; }, injectCodeComment() { if (!ContextManager.isReferenceSection()) return; const productSlug = ContextManager.productSlug(); if (TechDocsConfig.projects.skipCodeComments?.includes(productSlug)) return; const codeHeaderExists = $(".CodeSnippet").text().includes("header"); const languageCommentSymbol = $(".rm-LanguageButton_active").text() === "Node" ? "//" : "#"; const authDiv = $("div.auth-code-comment"); if (authDiv.length) return; const commentText = TechDocsConfig.projects.mutualAuth?.includes(productSlug) ? "Use mutual auth or add JWT to this snippet" : "Add Authorization header to this snippet"; const commentLine = AuthSectionUI.commentCodeLine(`${languageCommentSymbol} ${commentText}`); const codeLines = document.querySelectorAll(".CodeSnippet .CodeMirror-code > div"); for (const codeElement of codeLines) { const txt = codeElement.textContent; const addElementBefore = txt.includes("options") || txt.includes("header") || txt.includes("sdk.") || txt.includes("sdk["); if (addElementBefore) { $(codeElement).before(commentLine); break; } if (!codeHeaderExists && txt.includes("url") && !txt.includes("curl")) { $(commentLine).insertAfter($(codeElement)); break; } } Logger.debug("Auth code comment injected."); }, addPostmanButton(pmApiUrl, docsUrl, target) { const infoEle = `To run this code or try it in Postman, set up your authentication credentials.`; const auth = `

Not familiar with Postman? Learn how to use collections.

`; const button = `

`; const ele = $(`

AUTHENTICATE & TRY IT

${infoEle}${auth}${button}

`); ele.insertAfter($("#ReferencePlayground > section:nth-child(1)")); }, async postmanAuth() { if (!ContextManager.isReferenceSection()) return false; const postmanSessionItem = "akam_pm_info"; const apiTitle = document.querySelector(TechDocsConfig.selectors.apiTitle)?.innerText; Logger.debug("API Title", apiTitle); if (!apiTitle) return false; let pmInfo = sessionStorage.getItem(postmanSessionItem); pmInfo = pmInfo ? JSON.parse(pmInfo) : null; if (!pmInfo) { pmInfo = await Utils.fetchData("/assets/postman.json"); if (pmInfo) { sessionStorage.setItem(postmanSessionItem, JSON.stringify(pmInfo)); } } if (!pmInfo) return false; Logger.debug("Postman Info fetched successfully."); const { collections, collectionBaseUrl } = pmInfo; if (!collections?.hasOwnProperty(apiTitle)) return false; const groupId = apiTitle.replaceAll(' ', "_"); await Utils.delay(350); // Ensure the DOM is fully loaded before proceeding const docsTitle = document.querySelector("title")?.innerText; const itemId = docsTitle ?.replaceAll(' ', "_") .replaceAll('\'', "") .replaceAll('/', ""); if (!itemId) { Logger.debug("Item ID not found."); return false; } const ssKey = `${groupId}-${itemId}`; let endpointIdInSession = sessionStorage.getItem(ssKey); if (!endpointIdInSession) { const endpointIdFromEW = await Utils.fetchData(`/api/ew?groupId=${groupId}&itemId=${itemId}`, true); if (!endpointIdFromEW || endpointIdFromEW.includes("Error")) { $("section.PostmanSection").remove(); Logger.debug(`Postman endpoint ID not found for ${itemId} received from EW: ${endpointIdFromEW}`); return false; } endpointIdInSession = endpointIdFromEW.replaceAll('"', ""); sessionStorage.setItem(ssKey, endpointIdInSession); } $("span.auth-section-info").parent().remove(); const partialUrl = collections[apiTitle][0]; const pmApiUrlToUse = `${collectionBaseUrl}/${partialUrl}${endpointIdInSession}`; let target = "_blank"; let docsUrl = "https://techdocs.akamai.com/developer/docs/set-up-authentication-credentials"; if (!partialUrl.startsWith("akamai-apis/")) { document.querySelectorAll(".rm-Sidebar-section:first-child .rm-Sidebar-link").forEach(a => { if (a.textContent?.toLowerCase().includes("get started")) { docsUrl = a.href; target = "_self"; } }); } this.addPostmanButton(pmApiUrlToUse, docsUrl, target); Logger.debug("Postman button added successfully."); return true; }, async authHelp() { if (!ContextManager.isReferenceSection()) return; const productSlug = ContextManager.productSlug(); function credentialElementLink() { const isIncluded = TechDocsConfig.projects.authLinks?.includes(productSlug) || TechDocsConfig.projects.onlyAuthHelp?.includes(productSlug); const target = isIncluded ? "_self" : "_blank"; let link = isIncluded ? `${productSlug}/reference/get-started` : "developer/docs/set-up-authentication-credentials"; let txt = TechDocsConfig.projects.onlyAuthHelp?.includes(productSlug) ? "authorization token" : "authentication credentials"; if (productSlug === "mpulse") { const category = $(".rm-Sidebar-section .subnav-expanded .rm-Sidebar-link.active") .first() .parents(".rm-Sidebar-section") .children() .first() .text(); if (["Beacons"].includes(category)) { link = "mpulse/reference/beacons#getting-started"; txt = "API key"; } else { txt = "authentication token"; } } return `${txt}`; } function addAuthSection() { const isOnlyAuth = (TechDocsConfig.projects.onlyAuthHelp ?? []).includes(productSlug); const authHeaderText = `Remember to ${isOnlyAuth ? "get" : "add"} your ${credentialElementLink()} to run this code.`; const infoEle = `${authHeaderText}`; const header = $(".APIAuth [class*='APISectionHeader3LN'] [class*='APISectionHeader']"); if (header.length > 0) { if (header.text() === "Authorization") { header.text("Authentication"); if (!header.parent().next().hasClass("auth-section-info")) { header.parent().after(infoEle); } } } else if (productSlug !== "linode-api") { if ($("span.auth-section-info").length === 0) { const authEleSection = `

Authentication

${infoEle}

`; $("#ReferencePlayground").children().eq(1).before(authEleSection); } } Logger.debug("Auth section added successfully."); } if (!TechDocsConfig.projects.onlyAuthHelp?.includes(productSlug)) { $("section.InputGroup").hide(); } const hasPostman = await this.postmanAuth(); Logger.debug(`Postman auth check: ${hasPostman}`); $("span.auth-section-info").show(); if (!hasPostman) { addAuthSection(); } if (!$("div.auth-code-comment").length) { this.injectCodeComment(); } }, bindEvents() { $(document).on("focus", ".CodeSnippet, .rm-ParamInput, .ServerVars-form .ServerVars-input", () => this.injectCodeComment()); $(document).on("change", ".CodeMirror-code", () => this.injectCodeComment()); $(document).on("blur", ".CodeSnippet, .rm-ParamInput, .ServerVars-form .ServerVars-input", () => this.injectCodeComment()); $(document).on("click", ".rm-PlaygroundRequest div[class*='APIRequest-menu-item'], div[class*='LanguagePicker-MenuItem']", () => { setTimeout(() => this.injectCodeComment(), 250); }); $(document).on("click", ".rm-LanguagePicker .rm-LanguageButton", () => { setTimeout(() => this.injectCodeComment(), 250); }); $(window).on("resize", Utils.debounce(() => { if (ContextManager.isReferenceSection() && !$("div.auth-code-comment").length) { this.injectCodeComment(); } }, 300)); } }; const UIHelpers = { init() { this.bindEvents(); }, resetScroll() { const hub = document.querySelector(TechDocsConfig.selectors.superHub); if (hub) hub.scrollTop = 0; }, check404ErrorPage() { const is404 = !!document.querySelector(TechDocsConfig.selectors.pageNotFound); if (is404) { document.documentElement.classList.add("err"); Logger.debug("PageNotFound 'err' added to DOM."); } }, addSidebarErrorIndicators() { $(".rm-Sidebar-link > span").each(function () { const parentCode = $(this).children().first().text(); const statusGroup = /^(\d)\d{2}$/.exec(parentCode)?.[1]; let iconClass = null; if (statusGroup === "5") { iconClass = "server-type"; } if (statusGroup === "4") { iconClass = "error-type"; } if (iconClass && !$(this).find('.status-code').length) { const icon = $(``); $(this).prepend(icon); } }); }, openNewTab() { const list = document.querySelectorAll("a[href]:not(.external-link)"); const privateProjects = window.privateProjects || []; list.forEach(function (a) { const href = a.getAttribute("href"); if (Utils.isExternalLink(href) && !Utils.isPrivateLink(href, privateProjects)) { a.setAttribute("target", "_blank"); a.classList.add("external-link"); } }); }, collapsibleTableRows() { const tables = document.querySelectorAll("table"); if (!tables.length) return; const expandableRows = document.querySelectorAll("tr.expand"); if (expandableRows.length) return; const productSlug = ContextManager.productSlug(); const shouldCollapse = TechDocsConfig.projects.collapseTablesByDefault?.includes(productSlug); $("table").each(function () { const colLength = $(this).children().first().children().first().children().length; const tRows = $(this).children().find("tr"); tRows.each(function (j, tRow) { if (j === tRows.length - 1) return; const rowChilds = $(this).children(); let len = 0; rowChilds.length && rowChilds.each(function () { if ($(this).html() === "") len += 1; }); if (len === rowChilds.length - 1 && $(rowChilds[0]).html() !== "") { if ($(this).hasClass("expand")) return; $(this).addClass("expand"); rowChilds.first().siblings().remove().wrapInner(""); const initialTriangleClass = shouldCollapse ? "triangle-right" : "triangle-bottom"; rowChilds .prepend(``) .wrapInner(''); tRow.firstElementChild.setAttribute("colspan", colLength); tRow.firstElementChild.style.fontWeight = "600"; } }); // If configured to collapse by default, hide the child rows immediately if (shouldCollapse) { $(this) .find("tr.expand") .each(function () { $(this).nextUntil("tr.expand").hide(); }); } }); Logger.debug("Collapsible table rows initialized.", shouldCollapse); }, bindEvents() { $(document).on("click", ".clickable-triangle", function () { const triangleSpan = $(this).children().first(); triangleSpan.toggleClass("triangle-right"); triangleSpan.toggleClass("triangle-bottom"); $(this).parent().parent().nextUntil("tr.expand").toggle(); }); } }; // SEARCH DEBUG + BEHAVIOR // 1) Top/global search input opens modal and clears project filters // 2) Native header search button opens modal and auto-checks current project // 3) Invalid tabs remain visible, but are fully blocked when scoped to a project // 4) If current project is manually unchecked, tabs behave normally again const SearchBehavior = { init() { const HEADER_SEARCH_BUTTON_SELECTOR = ".rm-Header-search .rm-SearchToggle"; const TOP_SEARCH_INPUT_SELECTOR = ".docsearch-bar input, .docsearch-wrapper input"; const SEARCH_MODAL_SELECTOR = ".rm-SearchModal, [class*='SearchModal']"; const PRIMARY_NAV_SELECTOR = 'nav[aria-label="Primary navigation"]'; const PROJECT_SLUG = window.location.pathname.split("/").find(Boolean) || ""; const LOCAL_PROJECT_PREFIX = PROJECT_SLUG ? `/${PROJECT_SLUG}/` : ""; const PROJECT_LABEL = window.projectLabel || ""; if (!PROJECT_LABEL || !PROJECT_SLUG) { return; } let pendingProjectScope = false; let appliedForCurrentOpen = false; let pollTimer = null; let globalFilterTimer = null; let activeModal = null; let isProgrammaticOpen = false; function clearPoll() { if (pollTimer) { clearInterval(pollTimer); pollTimer = null; } } function clearGlobalFilterPoll() { if (globalFilterTimer) { clearInterval(globalFilterTimer); globalFilterTimer = null; } } function getModal() { return document.querySelector(SEARCH_MODAL_SELECTOR); } function isModalVisible(modal) { return !!(modal && (modal.classList.contains("show-modal") || modal.offsetParent !== null)); } function getSearchProjectInputs(modal) { if (!modal) return []; return [...modal.querySelectorAll("label")] .map((label) => { const textEl = label.querySelector(".Toggle-label, .Toggle-label_md, [class*='Toggle-label']"); const input = label.querySelector('input[type="checkbox"]'); if (!textEl || !input) return null; return { label, input, text: Utils.normalizeText(textEl.textContent), rawText: textEl.textContent }; }) .filter(Boolean); } function prioritizeSelectedProjects(modal) { getSearchProjectInputs(modal).forEach(({ label, input }) => { const item = label.closest(".rm-SearchFilter-list-item"); if (!item) return; const order = input.checked ? "-1" : ""; if (item.style.order !== order) { item.style.order = order; } }); } function getCurrentProjectInput(modal) { const target = Utils.normalizeText(PROJECT_LABEL); const options = getSearchProjectInputs(modal); const match = options.find((option) => option.text === target); return match?.input || null; } function tryCheckProjectBox(modal) { if (!isModalVisible(modal) || !pendingProjectScope || appliedForCurrentOpen) { return false; } const matchedInput = getCurrentProjectInput(modal); if (!matchedInput) { return false; } if (!matchedInput.checked) { matchedInput.click(); } prioritizeSelectedProjects(modal); appliedForCurrentOpen = true; pendingProjectScope = false; clearPoll(); return true; } function startProjectScopePolling() { if (pollTimer) return; let attempts = 0; const maxAttempts = 30; pollTimer = setInterval(() => { attempts += 1; const worked = tryCheckProjectBox(getModal()); if (worked || attempts >= maxAttempts) { clearPoll(); } }, 100); } function clearAllProjectFilters(modal) { if (!modal) return; const inputs = getSearchProjectInputs(modal) .map(option => option.input) .filter(Boolean); inputs.forEach((input) => { if (input.checked) { input.click(); } }); prioritizeSelectedProjects(modal); } function clearAllProjectFiltersWhenReady() { clearGlobalFilterPoll(); let attempts = 0; const maxAttempts = 20; globalFilterTimer = setInterval(() => { attempts += 1; const modal = getModal(); if (!isModalVisible(modal)) { if (attempts >= maxAttempts) clearGlobalFilterPoll(); return; } const inputs = getSearchProjectInputs(modal); if (inputs.length) { clearAllProjectFilters(modal); clearGlobalFilterPoll(); return; } if (attempts >= maxAttempts) { clearGlobalFilterPoll(); } }, 100); } function resetModalState() { appliedForCurrentOpen = false; pendingProjectScope = false; clearPoll(); clearGlobalFilterPoll(); activeModal = null; isProgrammaticOpen = false; } $(document).off("click.searchDebugHeader", HEADER_SEARCH_BUTTON_SELECTOR); $(document).on("click.searchDebugHeader", HEADER_SEARCH_BUTTON_SELECTOR, function (e) { if (isProgrammaticOpen) return; clearGlobalFilterPoll(); pendingProjectScope = true; appliedForCurrentOpen = false; startProjectScopePolling(); }); $(document).off("mousedown.searchDebugTop", TOP_SEARCH_INPUT_SELECTOR); $(document).on("mousedown.searchDebugTop", TOP_SEARCH_INPUT_SELECTOR, function (e) { e.preventDefault(); e.stopImmediatePropagation(); clearPoll(); clearGlobalFilterPoll(); pendingProjectScope = false; appliedForCurrentOpen = false; if (typeof this.blur === "function") { this.blur(); } const btn = document.querySelector(HEADER_SEARCH_BUTTON_SELECTOR); if (btn) { isProgrammaticOpen = true; btn.click(); isProgrammaticOpen = false; clearAllProjectFiltersWhenReady(); } }); $(document).off("click.searchDebugTop", TOP_SEARCH_INPUT_SELECTOR); $(document).on("click.searchDebugTop", TOP_SEARCH_INPUT_SELECTOR, function (e) { e.preventDefault(); e.stopImmediatePropagation(); }); $(document).off("change.searchProjectOrder", ".rm-SearchFilter-list-item input[type='checkbox']"); $(document).on("change.searchProjectOrder", ".rm-SearchFilter-list-item input[type='checkbox']", function () { prioritizeSelectedProjects(getModal()); }); const observer = new MutationObserver(() => { const modal = getModal(); if (!isModalVisible(modal)) { if (activeModal) resetModalState(); return; } if (modal !== activeModal) { activeModal = modal; appliedForCurrentOpen = false; } if (pendingProjectScope && !appliedForCurrentOpen) { startProjectScopePolling(); } prioritizeSelectedProjects(modal); }); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ["class"] }); } }; // -- Event execution on page load and SPA navigation $(window).on("pageLoad", UIHelpers.resetScroll); UIHelpers.check404ErrorPage(); ContextManager.init(); AuthUserNavMenu.init(); AnalyticsEngine.init(); if (!ContextManager.isHomePage()) { window.openNewTab = UIHelpers.openNewTab; AnalyticsEngine.bindStaticClickTrackers(); ChangelogFeatures.init(); AuthSectionUI.init(); UIHelpers.init(); // load Event window.addEventListener("load", () => { Logger.debug("load event."); setTimeout(() => { document.querySelectorAll(".rm-SearchToggle-placeholder")?.forEach(x => (x.innerHTML = "Search this doc set")); setTimeout(UIHelpers.collapsibleTableRows, 1000); }, 1000); if (ContextManager.isChangelogSection()) { Utils.waitFor(TechDocsConfig.selectors.changelogPost, { all: true, settleTime: 150 }) .then(ChangelogFeatures.readMore); } }); } // SPA navigation event $(window).on("pageLoad", async function () { Logger.debug("pageLoad event."); AuthUserNavMenu.updateLoggedInDetailsOverride(); // OneTrust compliance if (window.reWriteTags && typeof window.reWriteTags === "function") { window.reWriteTags(); } const isPerfCookieEnabled = typeof window.perfCookieEnabled === "function" ? window.perfCookieEnabled() : false; const isMultipleTrigger = typeof window.isMultipleSlug === "function" ? window.isMultipleSlug() : false; if (isPerfCookieEnabled && !isMultipleTrigger) AnalyticsEngine.trackPageView(); AnalyticsEngine.triggerLytics(); // Execute only for projects not home if (!ContextManager.isHomePage()) { setTimeout(() => { document .querySelectorAll(".rm-SearchToggle-placeholder") .forEach(x => (x.innerHTML = "Search this doc set")); AuthUserNavMenu.updateLoggedInDetailsOverride(); }, 100); if (ContextManager.isChangelogSection()) { Utils.waitFor(TechDocsConfig.selectors.changelogPost, { all: true, settleTime: 150 }) .then(ChangelogFeatures.readMore); Utils.waitFor(".rm-Changelog article.rm-Changelog-post > div") .then(ChangelogFeatures.releaseNotesBackButton); } if (ContextManager.isReferenceSection()) { Utils.waitFor([".rm-PlaygroundRequest", TechDocsConfig.selectors.apiTitle]) .then(async () => { await AuthSectionUI.authHelp(); }); Utils.waitFor(".rm-Playground .CodeSnippet .CodeMirror") .then(AuthSectionUI.injectCodeComment); } UIHelpers.addSidebarErrorIndicators(); Utils.waitFor("table", { all: true, settleTime: 100 }) .then(UIHelpers.collapsibleTableRows); if (isPerfCookieEnabled) { setTimeout(() => { AnalyticsEngine.trackReferenceLanguageSelection(); AnalyticsEngine.trackRecipeLanguageSelection(); }, 10); } } }); SearchBehavior.init(); function removeBetaAndPillClasses() { const tocBetas = [ "li.toc-children a", "span[class*='Sidebar-link-text'] span" ]; tocBetas.forEach(selector => { const elements = document.querySelectorAll(selector); elements.forEach(element => { element.querySelectorAll("span.beta").forEach(span => span.classList.remove("beta")); element.querySelectorAll("span.toc-beta").forEach(span => span.classList.remove("toc-beta")); element.querySelectorAll("span.pill").forEach(span => span.classList.remove("pill")); }); }); } document.addEventListener("DOMContentLoaded", function () { if (window.location.href.includes("reference")) { setTimeout(removeBetaAndPillClasses, 100); } const ob_beta = new MutationObserver(function () { if (window.location.href.includes("reference")) { setTimeout(removeBetaAndPillClasses, 100); } }); const config = { childList: true, subtree: true, characterData: true }; ob_beta.observe(document.body, config); }); // DOCHUB 4302 (function () { let currentUrl = location.href; function isExactMatchLocal(element, txt) { return element.innerText.trim() === txt; } function upgradeApiStatusLabelsLocal(isParameterOption = true) { if (window.location.href.includes("/docs/")) { return; } const selector = isParameterOption ? ".param-type" : ""; document.querySelectorAll(`#content.rm-Article ${selector} strong`).forEach((strongElement) => { strongElement.classList.remove("deprecated", "beta", "la"); if (isExactMatchLocal(strongElement, "Deprecated")) { strongElement.classList.add("deprecated"); } if (isExactMatchLocal(strongElement, "Beta")) { strongElement.classList.add("beta"); } if (isExactMatchLocal(strongElement, "Limited availability")) { strongElement.classList.add("la"); } }); } function waitForApiResponseSchemaAndRun() { const targetClass = "APIResponseSchemaPicker-items2bs6Pzrheef_"; const observer = new MutationObserver((mutations, obs) => { const el = document.querySelector(`[class*="${targetClass}"]`); if (el) { obs.disconnect(); setTimeout(upgradeApiStatusLabelsLocal, 200); } }); observer.observe(document.body, { childList: true, subtree: true, }); } function hookHistoryChanges() { const originalPush = history.pushState; const originalReplace = history.replaceState; const onChange = () => { if (location.href !== currentUrl) { currentUrl = location.href; console.log("[Router] URL changed to", currentUrl); waitForApiResponseSchemaAndRun(); } }; history.pushState = function () { originalPush.apply(this, arguments); onChange(); }; history.replaceState = function () { originalReplace.apply(this, arguments); onChange(); }; window.addEventListener("popstate", onChange); } const cancelUpgradeApiStatusLabels = () => { if (typeof window.upgradeApiStatusLabelsInSchema === "function") { window.upgradeApiStatusLabelsInSchema = function () {}; } else { setTimeout(cancelUpgradeApiStatusLabels, 10); } }; cancelUpgradeApiStatusLabels(); hookHistoryChanges(); waitForApiResponseSchemaAndRun(); })(); // Beta pills upgrade for refactored $(document).on("click", ".Button_slate_text.Button_md.rm-Header-bottom-link", function () { setTimeout(function () { const spans = document.querySelectorAll('span[class^="VersionBadge"]'); spans.forEach((span) => { console.log(span); if (span.textContent.trim() === "Beta") { span.classList.add("beta"); } }); }, 100); }); // README-532 do not create beta pills in text content function isExactMatch(element, txt) { return element.innerText.trim() === txt; } function upgradeApiStatusLabels(isParameterOption = true) { if (window.location.href.includes("/docs/")) { return; } const selector = isParameterOption ? ".param-type" : ""; document.querySelectorAll(`#content.rm-Article ${selector} strong`).forEach((strongElement) => { strongElement.classList.remove("deprecated", "beta", "la"); if (isExactMatch(strongElement, "Deprecated")) { strongElement.classList.add("deprecated"); } if (isExactMatch(strongElement, "Beta")) { strongElement.classList.add("beta"); } if (isExactMatch(strongElement, "Limited availability")) { strongElement.classList.add("la"); } }); } function upgradeApiStatusLabelsInSchema() { const buttons = document.querySelectorAll('[class*="APIResponseSchemaPicker-option"]'); buttons.forEach(function (button) { button.addEventListener("click", () => { setTimeout(upgradeApiStatusLabels, 5); }); }); } function upgradeApiStatusLabelsInNav() { function replaceNavStatus(labelType, element, text) { const remainingText = text.substring(labelType.length); const strongTag = document.createElement("strong"); strongTag.textContent = labelType.charAt(0).toUpperCase() + labelType.slice(1); strongTag.className = labelType; element.innerHTML = ""; element.appendChild(strongTag); element.appendChild(document.createTextNode(`${remainingText}`)); } const swaggerTitlesNav = document.querySelectorAll(".rm-Sidebar h3"); swaggerTitlesNav.forEach((title) => { const text = title.textContent.trim(); if (text.startsWith("Beta")) { replaceNavStatus("beta", title, text); } if (text.startsWith("Deprecated")) { replaceNavStatus("deprecated", title, text); } if (text.startsWith("Limited availability")) { replaceNavStatus("la", title, text); } }); } // README-468 Beta labels nested in clickable properties in schemas function schemaNestedStatusLabels() { document.querySelectorAll("button[class*='Param-expand']").forEach(button => { button.addEventListener("click", function () { setTimeout(() => { const container = this.parentElement.querySelector("[class*='Param-children']"); if (container && container.style.display !== "none" && getComputedStyle(container).display !== "none") { container.querySelectorAll("p strong").forEach(strongElement => { if (isExactMatch(strongElement, "Deprecated")) { strongElement.classList.add("deprecated"); } if (isExactMatch(strongElement, "Beta")) { strongElement.classList.add("beta"); } if (isExactMatch(strongElement, "Limited availability")) { strongElement.classList.add("la"); } }); } }, 200); }); }); } // README-408 Beta labels in guides function handleBetaInHeadings(heading, size, isApi = false) { if (!isApi && window.location.href.includes("/docs/")) { const headingTextDivs = document.querySelectorAll(heading); headingTextDivs.forEach(div => { const betaRegex = /$Beta$/i; const laRegex = /$Limited availability$/i; const deprecatedRegex = /$Deprecated$/i; if (betaRegex.test(div.innerHTML)) { div.innerHTML = div.innerHTML.replace( betaRegex, `(Beta)` ); } if (laRegex.test(div.innerHTML)) { div.innerHTML = div.innerHTML.replace( laRegex, `(Limited availability)` ); } if (deprecatedRegex.test(div.innerHTML)) { div.innerHTML = div.innerHTML.replace( deprecatedRegex, `(Deprecated)` ); } }); } } function applyBetaChanges() { const bodyBetas = [ "h1.heading .heading-text", "h2.heading .heading-text", "h3.heading .heading-text", ".col-xs-9 h1" ]; const tocBetas = [ "li.toc-children a", "span[class*='Sidebar-link-text'] span" ]; bodyBetas.forEach(selector => { handleBetaInHeadings(selector, "super-text"); }); tocBetas.forEach(selector => { handleBetaInHeadings(selector, "toc-beta"); }); } function applyAllBetaChanges() { applyBetaChanges(); upgradeApiStatusLabels(false); setTimeout(() => upgradeApiStatusLabels(true), 50); upgradeApiStatusLabelsInNav(); setTimeout(upgradeApiStatusLabelsInSchema, 200); setTimeout(schemaNestedStatusLabels, 100); } document.addEventListener("DOMContentLoaded", function () { applyAllBetaChanges(); let labelTimer = null; const config = { childList: true, subtree: true, characterData: true }; const observer = new MutationObserver(function () { observer.disconnect(); clearTimeout(labelTimer); labelTimer = setTimeout(() => { applyAllBetaChanges(); observer.observe(document.body, config); }, 50); }); observer.observe(document.body, config); }); $(window).on("pageLoad", function () { setTimeout(applyAllBetaChanges, 200); }); function updateCSSRules () { let styleSheet let styleElement = document.querySelector('head style#dynamic-styles') if (!styleElement) { styleElement = document.createElement('style') styleElement.id = 'dynamic-styles' document.head.appendChild(styleElement) } styleSheet = styleElement.sheet const newRule = '.rm-PlaygroundResponse .APIResponse-action-button { display: none; }' styleSheet.insertRule(newRule, styleSheet.cssRules.length) // If you want to remove the old rule, we assume you have a method to handle cross-origin issues. // Since we can't reliably access cross-origin stylesheets, we won't attempt to remove the rule here. // However, you can manage it within your own styles if needed. } $(window).on('pageLoad', function (e, state) { /* ---------------------------------------------------- 1. For: /reference/api-summary Fix overflow only ---------------------------------------------------- */ if ( window.location.href === 'https://techdocs.akamai.com/property-mgr/reference/api-summary' ) { var tableInnerElements = document.querySelectorAll('.rdmd-table-inner'); tableInnerElements.forEach(function (el) { el.style.removeProperty('overflow'); el.style.cssText += 'overflow: unset !important;'; }); } /* ---------------------------------------------------- 2. For: /reference/validation-errors-copy Add word-break + class replacement ---------------------------------------------------- */ if ( window.location.href === 'https://techdocs.akamai.com/property-mgr/reference/validation-errors-copy' ) { // Add word-break to all tables const style = document.createElement("style"); style.textContent = ` table, table * { word-break: break-word !important; white-space: normal !important; } `; document.head.appendChild(style); // Replace .sticky-overflow → remove & add .sticky document.querySelectorAll('.rdmd-table-inner.sticky-overflow') .forEach(function (el) { el.classList.remove('sticky-overflow'); el.classList.add('sticky'); }); } }); /* PAPI builder */ // Released 27.04.2026 function initPapiBuilder () { function normalizeStr (s) { return (s || '') .replace(/\u200b/g, '') .replace(/\u00ad/g, '') .trim() } const table = document.querySelector('.rdmd-table-inner table') const href = window.location.href const isAllowedReferencePage = [ 'reference/latest-', 'reference/ga-', 'reference/deprecated-' ].some(segment => href.includes(segment)) if (!table || href.includes('/docs/') || !isAllowedReferencePage) return if (table.dataset.papiReady) return const ths = table.querySelectorAll('thead th') // =============== Move "Requires" into Description and hide the column =============== let reqIdx = -1 ths.forEach((th, i) => { if (th.textContent.trim().startsWith('Requires')) reqIdx = i }) table.querySelectorAll('tbody tr').forEach(tr => { const tds = tr.children if (reqIdx !== -1 && tds[reqIdx]) { const reqTd = tds[reqIdx] let requiresHtml = '' const tmp = document.createElement('div') tmp.innerHTML = reqTd.innerHTML.trim() tmp .querySelectorAll('button.rdmd-code-copy') .forEach(btn => btn.remove()) const cleaned = tmp.innerHTML.trim() if (cleaned) { requiresHtml = `

Requires: ${cleaned}

` } // Find description cell (prefer .description-col) let descTd = null for (let td of tds) { if (td.classList && td.classList.contains('description-col')) { descTd = td break } } if (!descTd) descTd = tds[2] || tds[1] if (descTd && requiresHtml) { const wrap = document.createElement('div') wrap.innerHTML = requiresHtml const metaDiv = wrap.firstElementChild const oldMeta = descTd.querySelector('.ps-metadata') if (oldMeta) oldMeta.remove() descTd.insertBefore(metaDiv, descTd.firstChild) descTd.insertBefore(document.createElement('br'), metaDiv.nextSibling) } } }) if (reqIdx !== -1) ths[reqIdx].style.display = 'none' table.querySelectorAll('tbody tr').forEach(tr => { const tds = tr.children if (reqIdx !== -1 && tds[reqIdx]) tds[reqIdx].style.display = 'none' }) // =============== Hide "Value" column if present =============== let optionIdx = -1 let valueIdx = -1 ths.forEach((th, i) => { if (th.textContent.trim().startsWith('Option')) optionIdx = i if (th.textContent.trim().startsWith('Value')) valueIdx = i }) if (valueIdx !== -1) ths[valueIdx].style.display = 'none' table.querySelectorAll('tbody tr').forEach(tr => { const tds = tr.children if (valueIdx !== -1 && tds[valueIdx]) tds[valueIdx].style.display = 'none' }) // =============== Helpers =============== function parsePre (row, cls) { const pre = row.querySelector('pre.' + cls) if (!pre) return null try { return JSON.parse(pre.textContent) } catch { return null } } // Symbol to indicate an external/unresolvable attribute reference const UNRESOLVABLE = Symbol('UNRESOLVABLE') function getAttrValue (attr, stateObj) { // Handle dot-notation like "policySet.region" if (attr && attr.includes('.')) { const parts = attr.split('.') let current = stateObj for (const part of parts) { if (current === undefined || current === null) { // Path doesn't exist - unresolvable return UNRESOLVABLE } if (typeof current !== 'object') { // Parent exists but is not an object (e.g., policySet is a string ID) // This is an external reference that can't be resolved from table data return UNRESOLVABLE } current = current[part] } return current } return stateObj[attr] } function evalVisible (visible, stateObj) { if (!visible) return true const v = visible.if if (!v) return true // Global-scope conditions reference external data (e.g. modulesOnContract) // not available in the table; assume fulfilled if (v.scope === 'global') return true // Supported ops: eq, neq, in, not, and, or, contains, type // "type" checks the runtime data-type of a value (e.g. ipv4_address); // we can't determine this from table data, so assume fulfilled. if (v.op === 'type') return true if (v.op === 'not') { const inner = v.expression || (v.params && v.params[0]) if (!inner) return true return !evalVisible({ if: inner }, stateObj) } if (v.op === 'eq') { const val = getAttrValue(v.attribute, stateObj) // If attribute is unresolvable (external reference), assume condition is fulfilled if (val === UNRESOLVABLE) return true return val == v.value } if (v.op === 'neq') { const val = getAttrValue(v.attribute, stateObj) if (val === UNRESOLVABLE) return true return val != v.value } if (v.op === 'in') { const val = getAttrValue(v.attribute, stateObj) if (val === UNRESOLVABLE) return true const arr = v.value || [] return arr.includes(val) } if (v.op === 'contains') { const val = getAttrValue(v.attribute, stateObj) // Contains typically checks if array contains value; if unresolvable, assume fulfilled if (val === UNRESOLVABLE) return true if (Array.isArray(val)) return val.includes(v.value) return false } if (v.op === 'or') return (v.params || []).some(p => evalVisible({ if: p }, stateObj)) if (v.op === 'and') return (v.params || []).every(p => evalVisible({ if: p }, stateObj)) return true // Fallback for unhandled ops } function parseValueByType (type, value) { if (type === 'integer' || type === 'number') { if (value === '' || value === undefined) return undefined const n = Number(value) return isNaN(n) ? value : n } if (type === 'boolean') return value === 'true' || value === true return value } function readTextArray (container) { const arr = [] container.querySelectorAll('input[type="text"]').forEach(inp => { const v = inp.value.trim() if (v !== '') arr.push(v) }) return arr.length ? arr : undefined } // =============== Collect rows =============== const optionRows = Array.from(table.querySelectorAll('tr.row_option, tr.preview_option')) const schemaRows = Array.from(table.querySelectorAll('tr.row_schema, tr.preview_schema')) const options = {} const objectSchemas = {} // single-object schemas const objectArrayPropDefs = {} // { parentArrayName: [{propName, inputDef, type, displayType}] } const optionsByName = {} const optionsById = {} const readOnlySchemaRows = [] // Track read-only schema rows for conditional hiding // Build map for options optionRows.forEach(row => { const id = row.id const inputDef = parsePre(row, 'input') const visibleDef = parsePre(row, 'visible') const code = row.querySelector('code') const rawName = code ? code.textContent.replace(/\u200b/g, '') : id // strip ZW chars const name = rawName const o = { row, inputDef, visibleDef, name, value: undefined, input: null } // Detect object-array property rows like: failoverOriginMap[].fromOriginId const arrMatch = name.match(/^([^.]+)\[\]\.(.+)$/) if (arrMatch) { o.isArrayProp = true o.parentArrayName = arrMatch[1] o.propName = arrMatch[2] if (!objectArrayPropDefs[o.parentArrayName]) objectArrayPropDefs[o.parentArrayName] = [] // Inspect type from the row's "Type" column - get FULL type text (e.g., "string array") const tds = row.querySelectorAll('td') let type = '' let displayType = '' if (tds[1]) { const fullTypeText = normalizeStr(tds[1].textContent) type = fullTypeText.split(' ')[0].toLowerCase() // first word for internal use displayType = fullTypeText // full text for display (e.g., "string array") } objectArrayPropDefs[o.parentArrayName].push({ propName: o.propName, inputDef, visibleDef, // Store visibility definition for filtering type, displayType // NEW: store full type for display }) // Hide this template row; we'll render inputs in entry blocks row.classList.add('hidden-row') } options[id] = o optionsById[id] = o optionsByName[name] = o // Detect parent object/object-array options if ( inputDef && (inputDef.displayType === 'object' || inputDef.displayType === 'object array') ) { if (inputDef.displayType === 'object') { objectSchemas[name] = [] o.isObject = true } else if (inputDef.displayType === 'object array') { o.isObject = true o.isObjectArray = true if (!objectArrayPropDefs[name]) objectArrayPropDefs[name] = [] // ensure bucket exists } } }) // Schema rows (for single object properties like cloudletPolicy.id) schemaRows.forEach(row => { const code = row.querySelector('code') if (!code) return const dotName = code.textContent.replace(/\u200b/g, '') const [objectName, propName] = dotName.split('.', 2) // Ignore if this is an object-array schema variant (we handle via row_option form) if (objectName.endsWith('[]')) return const tds = row.querySelectorAll('td') let type = '' if (tds[2]) type = (tds[1].textContent || '').trim().split(' ')[0].toLowerCase() const descTd = tds[2] || null const firstPara = descTd?.querySelector('p') const firstParaText = firstPara?.innerText.trim() || '' if (firstParaText.startsWith('Read-only')) { // Track read-only rows for conditional hiding (visible when empty, hidden when values exist) row._objectName = objectName row._propName = propName row._isReadOnly = true readOnlySchemaRows.push(row) return } const input = document.createElement('input') input.type = 'text' input.className = 'Input Input_sm' input.style.minWidth = '120px' input.style.display = 'block' input.style.marginTop = '4px' input.addEventListener('input', updateState) const optionTd = optionIdx !== -1 ? tds[optionIdx] : tds[0] optionTd.appendChild(input) row._objectName = objectName row._propName = propName row._input = input row._type = type if (!objectSchemas[objectName]) objectSchemas[objectName] = [] objectSchemas[objectName].push(row) }) // =============== Handle row_option sub-properties of objects (dot-notation, no inputDef) =============== // Some tables use row_option (not row_schema) for object sub-properties like firewallConfiguration.configId. // These rows have no

, so we detect them by dot-notation name and build inputs manually.
    Object.values(options).forEach(opt => {
      if (opt.inputDef) return // already has an input definition, handled later
      if (opt.isArrayProp) return // array props handled separately
      const dotIdx = opt.name.indexOf('.')
      if (dotIdx === -1) return // not a sub-property
      const objectName = opt.name.substring(0, dotIdx)
      const propName = opt.name.substring(dotIdx + 1)
      // Only process if parent is a known object
      const parentOpt = optionsByName[objectName]
      if (!parentOpt || !parentOpt.isObject) return
      // Skip if parent is an object array (those use [] notation)
      if (parentOpt.isObjectArray) return

      const tds = opt.row.querySelectorAll('td')
      let type = ''
      if (tds[1]) type = (tds[1].textContent || '').trim().split(' ')[0].toLowerCase()
      const descTd = tds[2] || null
      const firstPara = descTd?.querySelector('p')
      const firstParaText = firstPara?.innerText.trim() || ''
      if (firstParaText.startsWith('Read-only')) {
        opt.row._objectName = objectName
        opt.row._propName = propName
        opt.row._isReadOnly = true
        readOnlySchemaRows.push(opt.row)
        return
      }

      const input = document.createElement('input')
      input.type = 'text'
      input.className = 'Input Input_sm'
      input.style.minWidth = '120px'
      input.style.display = 'block'
      input.style.marginTop = '4px'
      input.addEventListener('input', updateState)
      const optionTd = optionIdx !== -1 ? tds[optionIdx] : tds[0]
      optionTd.appendChild(input)

      opt.row._objectName = objectName
      opt.row._propName = propName
      opt.row._input = input
      opt.row._type = type
      // Mark the option so the main input-building loop skips it
      opt._handledAsSchema = true

      if (!objectSchemas[objectName]) objectSchemas[objectName] = []
      objectSchemas[objectName].push(opt.row)
      // Also add to schemaRows so reset/listeners work
      schemaRows.push(opt.row)
    })

    // =============== Build inputs for option rows ===============
    Object.values(options).forEach(opt => {
      if (!opt.inputDef) return
      if (opt._handledAsSchema) return
      if (opt.isArrayProp) {
        opt.row.classList.add('hidden-row')
        return
      }

      const tds = opt.row.querySelectorAll('td')
      const optionTd = optionIdx !== -1 ? tds[optionIdx] : tds[0]
      let input

      if (opt.inputDef.displayType === 'string array') {
        const wrapper = document.createElement('div')
        wrapper.className = 'array-input-wrapper'
        wrapper.style.marginTop = '4px'
        function addField (val) {
          const div = document.createElement('div')
          div.style.display = 'flex'
          div.style.marginBottom = '2px'
          const inp = document.createElement('input')
          inp.type = 'text'
          inp.className = 'Input Input_sm'
          inp.style.minWidth = '120px'
          inp.value = val || ''
          inp.addEventListener('input', updateState)
          const btn = document.createElement('button')
          btn.type = 'button'
          btn.textContent = '−'
          btn.className = 'Button Button_xs'
          btn.style.marginLeft = '4px'
          btn.onclick = function () {
            const hadValue = inp.value.trim() !== ''
            wrapper.removeChild(div)
            if (hadValue) updateState()
          }
          div.appendChild(inp)
          div.appendChild(btn)
          const plusBtn = wrapper.querySelector('button.Button_xs:last-of-type')
          if (plusBtn && plusBtn.textContent === '+') {
            wrapper.insertBefore(div, plusBtn)
          } else {
            wrapper.appendChild(div)
          }
        }
        const addBtn = document.createElement('button')
        addBtn.type = 'button'
        addBtn.textContent = '+'
        addBtn.className = 'Button Button_xs'
        addBtn.style.marginTop = '2px'
        addBtn.onclick = function () {
          addField()
          // Don't call updateState() here - adding empty field doesn't change state
          // The input's own event listener will trigger updateState when user types
        }
        wrapper.appendChild(addBtn)
        addField()
        optionTd.appendChild(wrapper)
        opt.input = wrapper
        opt.isArray = true
      } else if (opt.inputDef.displayType === 'object array') {
        // Build object-array wrapper with + Add button; properties are hidden until clicked
        const wrapper = document.createElement('div')
        wrapper.className = 'object-array-wrapper'
        wrapper.style.marginTop = '4px'

        const addBtn = document.createElement('button')
        addBtn.type = 'button'
        addBtn.textContent = '+ Add ' + opt.name
        addBtn.className = 'Button Button_xs'
        addBtn.onclick = function () {
          addObjectArrayEntry(wrapper, opt.name)
          // IMPORTANT: do not call updateState() here; we DON'T want filtering yet
          // We only update state when a property inside the new entry is filled.
        }
        wrapper.appendChild(addBtn)

        optionTd.appendChild(wrapper)
        opt.input = wrapper
        opt.isObjectArray = true
        opt.isObject = true
      } else if (opt.inputDef.displayType === 'object') {
        opt.isObject = true // handled in schemaRows
      } else if (
        opt.inputDef.tag === 'input' &&
        opt.inputDef.type === 'checkbox'
      ) {
        // boolean -> select true/false (no default)
        const sel = document.createElement('select')
        sel.className = 'Select Select_sm'
        sel.style.minWidth = '120px'
        sel.style.display = 'block'
        sel.style.marginTop = '4px'
        const placeholder = document.createElement('option')
        placeholder.value = ''
        placeholder.textContent = 'Choose true/false'
        placeholder.disabled = true
        placeholder.hidden = true
        placeholder.selected = true
        sel.appendChild(placeholder)
        ;['false', 'true'].forEach(val => {
          const o = document.createElement('option')
          o.value = val
          o.textContent = val
          sel.appendChild(o)
        })
        sel.addEventListener('change', updateState)
        optionTd.appendChild(sel)
        opt.input = sel
        opt.isBooleanSelect = true
      } else if (opt.inputDef.tag === 'select') {
        // enum -> select with placeholder
        const sel = document.createElement('select')
        sel.className = 'Select Select_sm'
        sel.style.minWidth = '120px'
        sel.style.display = 'block'
        sel.style.marginTop = '4px'
        const placeholder = document.createElement('option')
        placeholder.value = ''
        placeholder.textContent = 'Choose an option'
        placeholder.disabled = true
        placeholder.hidden = true
        placeholder.selected = true
        sel.appendChild(placeholder)
        ;(opt.inputDef.options || []).forEach(val => {
          const clean = normalizeStr(val)
          const o = document.createElement('option')
          o.value = clean
          o.textContent = clean
          sel.appendChild(o)
        })
        sel.addEventListener('change', updateState)
        optionTd.appendChild(sel)
        opt.input = sel
      } else if (
        opt.inputDef.displayType === 'number' ||
        opt.inputDef.displayType === 'integer'
      ) {
        input = document.createElement('input')
        input.type = 'text'
        input.className = 'Input Input_sm'
        input.style.minWidth = '120px'
        input.style.display = 'block'
        input.style.marginTop = '4px'
        input.addEventListener('input', updateState)
        optionTd.appendChild(input)
        opt.input = input
      } else if (
        opt.inputDef.type === 'text' ||
        opt.inputDef.type === 'datetime-local'
      ) {
        input = document.createElement('input')
        input.type = 'text'
        input.className = 'Input Input_sm'
        input.style.minWidth = '120px'
        input.style.display = 'block'
        input.style.marginTop = '4px'
        input.addEventListener('input', updateState)
        optionTd.appendChild(input)
        opt.input = input
      }
    })

    // =============== Build one object-array entry (UI block with all props) ===============
    function buildArrayPropInput (def) {
      // Returns an element for one property inside object-array entry
      const wrap = document.createElement('div')
      wrap.className = 'object-array-prop'
      wrap.style.margin = '4px 0'
      wrap.dataset.prop = def.propName
      wrap.dataset.type = (def.type || '').toLowerCase()

      // NEW: Build label with type in parentheses
      const label = document.createElement('div')
      const typeDisplay = def.displayType || def.type || ''
      const typeStr = typeDisplay ? ` (${typeDisplay})` : ''
      label.textContent = def.propName + typeStr
      label.style.fontSize = '12px'
      label.style.opacity = '0.8'
      wrap.appendChild(label)

      const idf = def.inputDef || {}

      if (idf.displayType === 'string array') {
        // Nested array input (like toOriginIds)
        const arrWrap = document.createElement('div')
        arrWrap.className = 'array-input-wrapper'
        arrWrap.style.marginTop = '2px'

        function addField (val) {
          const row = document.createElement('div')
          row.style.display = 'flex'
          row.style.marginBottom = '2px'
          const inp = document.createElement('input')
          inp.type = 'text'
          inp.className = 'Input Input_sm'
          inp.style.minWidth = '120px'
          inp.value = val || ''
          inp.addEventListener('input', updateState)
          const btn = document.createElement('button')
          btn.type = 'button'
          btn.textContent = '−'
          btn.className = 'Button Button_xs'
          btn.style.marginLeft = '4px'
          btn.onclick = function () {
            const hadValue = inp.value.trim() !== ''
            arrWrap.removeChild(row)
            if (hadValue) updateState()
          }
          row.appendChild(inp)
          row.appendChild(btn)
          const plusBtn = arrWrap.querySelector('button.Button_xs:last-of-type')
          if (plusBtn && plusBtn.textContent === '+') {
            arrWrap.insertBefore(row, plusBtn)
          } else {
            arrWrap.appendChild(row)
          }
        }

        const addBtn = document.createElement('button')
        addBtn.type = 'button'
        addBtn.textContent = '+'
        addBtn.className = 'Button Button_xs'
        addBtn.style.marginTop = '2px'
        addBtn.onclick = function () {
          addField()
          // Don't call updateState() here - adding empty field doesn't change state
        }
        arrWrap.appendChild(addBtn)
        addField()

        wrap.appendChild(arrWrap)
        return wrap
      }

      if (idf.tag === 'select') {
        const sel = document.createElement('select')
        sel.className = 'Select Select_sm'
        sel.style.minWidth = '120px'
        sel.style.display = 'block'
        sel.style.marginTop = '2px'
        const placeholder = document.createElement('option')
        placeholder.value = ''
        placeholder.textContent = 'Choose an option'
        placeholder.disabled = true
        placeholder.hidden = true
        placeholder.selected = true
        sel.appendChild(placeholder)
        ;(idf.options || []).forEach(val => {
          const o = document.createElement('option')
          o.value = val
          o.textContent = val
          sel.appendChild(o)
        })
        sel.addEventListener('change', updateState)
        wrap.appendChild(sel)
        return wrap
      }

      if (idf.tag === 'input' && idf.type === 'checkbox') {
        const sel = document.createElement('select')
        sel.className = 'Select Select_sm'
        sel.style.minWidth = '120px'
        sel.style.display = 'block'
        sel.style.marginTop = '2px'
        const ph = document.createElement('option')
        ph.value = ''
        ph.textContent = 'Choose true/false'
        ph.disabled = true
        ph.hidden = true
        ph.selected = true
        sel.appendChild(ph)
        ;['false', 'true'].forEach(v => {
          const o = document.createElement('option')
          o.value = v
          o.textContent = v
          sel.appendChild(o)
        })
        sel.addEventListener('change', updateState)
        wrap.appendChild(sel)
        wrap.dataset.booleanSelect = '1'
        return wrap
      }

      // Numbers/integers default text with validation
      const inp = document.createElement('input')
      inp.type = 'text'
      inp.className = 'Input Input_sm'
      inp.style.minWidth = '120px'
      inp.style.display = 'block'
      inp.style.marginTop = '2px'
      inp.addEventListener('input', updateState)
      wrap.appendChild(inp)
      return wrap
    }

    // =============== Entry-level visibility for object array properties ===============
    function getEntryLocalState (entry, props) {
      // Build a local state object from values within this entry
      const localState = {}
      props.forEach(def => {
        const propWrap = entry.querySelector(`.object-array-prop[data-prop="${def.propName}"]`)
        if (!propWrap) return
        const type = (propWrap.dataset.type || '').toLowerCase()
        
        // Check for nested array
        const nestedArrWrap = propWrap.querySelector('.array-input-wrapper')
        if (nestedArrWrap) {
          const arrVal = readTextArray(nestedArrWrap)
          if (arrVal !== undefined) localState[def.propName] = arrVal
          return
        }
        
        // Check for select
        const sel = propWrap.querySelector('select')
        if (sel && sel.value !== '') {
          if (propWrap.dataset.booleanSelect === '1') {
            localState[def.propName] = sel.value === 'true'
          } else {
            localState[def.propName] = sel.value
          }
          return
        }
        
        // Check for text input
        const inp = propWrap.querySelector('input[type="text"]')
        if (inp && inp.value.trim() !== '') {
          const parsed = parseValueByType(type, inp.value.trim())
          if (parsed !== undefined && parsed !== '') {
            localState[def.propName] = parsed
          }
        }
      })
      return localState
    }
    
    function updateEntryPropVisibility (entry, props, initial) {
      // Get the current values within this entry to evaluate visibility conditions
      const localState = getEntryLocalState(entry, props)
      
      props.forEach(def => {
        const propWrap = entry.querySelector(`.object-array-prop[data-prop="${def.propName}"]`)
        if (!propWrap) return
        
        // Evaluate visibility based on local state within the entry
        let show = true
        if (!initial && def.visibleDef && def.visibleDef.if) {
          show = evalVisible(def.visibleDef, localState)
        }
        
        propWrap.style.display = show ? '' : 'none'
      })
    }

    function addObjectArrayEntry (wrapper, parentName) {
      const defs = objectArrayPropDefs[parentName] || []
      const container = document.createElement('div')
      container.className = 'object-array-entry'
      container.style.border = '1px solid #ccc'
      container.style.padding = '6px'
      container.style.margin = '6px 0'

      // Build inputs for each prop
      defs.forEach(def => {
        const el = buildArrayPropInput(def)
        container.appendChild(el)
      })

      const removeBtn = document.createElement('button')
      removeBtn.type = 'button'
      removeBtn.textContent = '− Remove'
      removeBtn.className = 'Button Button_xs'
      removeBtn.style.marginTop = '6px'
      removeBtn.onclick = function () {
        wrapper.removeChild(container)
        updateState() // removing can change state -> filtering allowed
      }
      container.appendChild(removeBtn)

      // Insert before the + Add button (which is the last child)
      wrapper.insertBefore(container, wrapper.lastChild)

      // Apply initial visibility for the new entry (show all properties initially)
      updateEntryPropVisibility(container, defs, true)
    }

    // =============== State + back-propagation (original) ===============
    let state = {}
    function findOption (attr) {
      return optionsByName[attr] || optionsById[attr] || null
    }
    function firstAllowedEnumValue (opt, forbidden) {
      const opts = (opt?.inputDef?.options || []).filter(v => v !== forbidden)
      return opts.length ? opts[0] : undefined
    }
    function getDeterministicAssignments (visibleDef) {
      // Returns array of { attribute, value|notValue, type: 'eq'|'in'|'neq' }
      const res = []
      if (!visibleDef || !visibleDef.if) return res
      const v = visibleDef.if
      function handleClause (clause) {
        if (!clause) return
        if (clause.op === 'eq')
          res.push({
            attribute: clause.attribute,
            value: clause.value,
            type: 'eq'
          })
        else if (clause.op === 'in')
          res.push({
            attribute: clause.attribute,
            value: Array.isArray(clause.value)
              ? clause.value.slice()
              : clause.value,
            type: 'in'
          })
        else if (clause.op === 'neq')
          res.push({
            attribute: clause.attribute,
            notValue: clause.value,
            type: 'neq'
          })
        else if (clause.op === 'and')
          (clause.params || []).forEach(handleClause)
        else if (clause.op === 'or') {
          const params = clause.params || []
          const alreadySatisfied = params.some(p =>
            evalVisible({ if: p }, state)
          )
          if (alreadySatisfied) return
          if (params.length > 0) handleClause(params[0])
        }
      }
      handleClause(v)
      return res
    }
    function setInputForAttribute (attr, value) {
      const opt = findOption(attr)
      if (!opt || !opt.input) {
        state[attr] = value
        return
      }
      if (opt.isBooleanSelect) opt.input.value = String(value)
      else if (opt.input.tagName === 'SELECT') opt.input.value = String(value)
      else if (opt.input.type === 'checkbox') opt.input.checked = !!value
      else opt.input.value = value == null ? '' : String(value)
      // Mirror into cached value/state immediately
      if (opt.isBooleanSelect) opt.value = opt.input.value === 'true'
      else if (opt.input.tagName === 'SELECT') opt.value = opt.input.value
      else if (opt.input.type === 'checkbox') opt.value = opt.input.checked
      else opt.value = opt.input.value
      state[opt.name] = opt.value
    }
    function chooseValueForIn (attribute, allowed) {
      const current = state[attribute]
      if (Array.isArray(allowed) && allowed.includes(current)) return current
      return Array.isArray(allowed) && allowed.length ? allowed[0] : undefined
    }
    function backPropagateFromElement (target) {
      if (!target) return
      const schemaRow = target.closest && target.closest('tr.row_schema')
      let startOpt = null
      if (schemaRow && schemaRow._objectName)
        startOpt = findOption(schemaRow._objectName)
      else {
        const optionRow = target.closest && target.closest('tr.row_option')
        if (optionRow) startOpt = options[optionRow.id]
      }
      const visited = new Set()
      let stack = startOpt ? [startOpt] : []
      while (stack.length) {
        const currentOpt = stack.pop()
        if (!currentOpt || visited.has(currentOpt.name)) continue
        visited.add(currentOpt.name)

        const assigns = getDeterministicAssignments(currentOpt.visibleDef)
        for (const a of assigns) {
          if (a.type === 'eq') {
            setInputForAttribute(a.attribute, a.value)
          } else if (a.type === 'in') {
            const picked = chooseValueForIn(a.attribute, a.value)
            if (picked !== undefined) setInputForAttribute(a.attribute, picked)
          } else if (a.type === 'neq') {
            const parentOpt = findOption(a.attribute)
            if (
              parentOpt &&
              parentOpt.input &&
              parentOpt.input.tagName === 'SELECT'
            ) {
              // Set a value if current equals forbidden OR is undefined (not set)
              const currentVal = state[a.attribute]
              if (currentVal === a.notValue || currentVal === undefined) {
                const fallback = firstAllowedEnumValue(parentOpt, a.notValue)
                if (fallback !== undefined)
                  setInputForAttribute(a.attribute, fallback)
              }
            }
          }
          const parentOpt = findOption(a.attribute)
          if (parentOpt) stack.push(parentOpt)
        }
      }
    }

    // =============== UI update ===============
    
    // FIXED: Transitive visibility check - a field is only visible if all its dependencies are also visible
    function isFullyVisible (opt, visited = new Set()) {
      if (!opt) return true
      
      // Prevent infinite recursion
      if (visited.has(opt.name)) return true
      visited.add(opt.name)
      
      // If no visibility condition, it's always visible
      if (!opt.visibleDef || !opt.visibleDef.if) return true
      
      // First check if this option's direct visibility condition is met
      if (!evalVisible(opt.visibleDef, state)) return false
      
      // Then check if all parent dependencies are also visible (transitive check)
      const v = opt.visibleDef.if
      
      function checkDependencyVisible (clause) {
        if (!clause) return true
        
        // If this clause references an attribute, check if that attribute's option is visible
        if (clause.attribute) {
          const parentOpt = findOption(clause.attribute)
          if (parentOpt && !isFullyVisible(parentOpt, visited)) {
            return false // Parent is hidden, so this should be hidden too
          }
        }
        
        // For compound conditions, check all referenced attributes
        if (clause.op === 'and') {
          return (clause.params || []).every(p => checkDependencyVisible(p))
        }
        if (clause.op === 'or') {
          // For OR, we need at least one branch's dependencies to be visible
          // But if all branches have hidden dependencies, hide this option
          const params = clause.params || []
          if (params.length === 0) return true
          
          // Check if any branch has visible dependencies AND passes its condition
          return params.some(p => {
            const depVisible = checkDependencyVisible(p)
            const condPasses = evalVisible({ if: p }, state)
            return depVisible && condPasses
          })
        }
        
        return true
      }
      
      return checkDependencyVisible(v)
    }
    
    function updateState (ev) {
      // Back-prop first based on changed element
      backPropagateFromElement(ev && ev.target)
      updateUI()
    }
    function updateUI (initial = false) {
      // 1) read values from option inputs (primitives, enums, standalone string arrays)
      Object.values(options).forEach(opt => {
        if (!opt.input || opt.isObjectArray) return // arrays handled later
        if (opt.isArray) {
          const arrVal = readTextArray(opt.input)
          opt.value = arrVal
          if (arrVal !== undefined) state[opt.name] = arrVal
          else delete state[opt.name]
        } else if (opt.isBooleanSelect) {
          opt.value =
            opt.input.value === '' ? undefined : opt.input.value === 'true'
          if (opt.value === undefined) delete state[opt.name]
          else state[opt.name] = opt.value
        } else if (opt.input.type === 'checkbox') {
          opt.value = opt.input.checked
          state[opt.name] = opt.value
        } else if (
          opt.inputDef &&
          (opt.inputDef.displayType === 'number' ||
            opt.inputDef.displayType === 'integer')
        ) {
          // original behavior: keep raw invalid + highlight
          if (opt.input.value !== '' && isNaN(Number(opt.input.value))) {
            opt.input.classList.add('invalid-input')
            opt.value = opt.input.value // keep raw
          } else {
            opt.input.classList.remove('invalid-input')
            opt.value =
              opt.input.value === '' ? undefined : Number(opt.input.value)
          }
          if (opt.value === undefined) delete state[opt.name]
          else state[opt.name] = opt.value
        } else {
          opt.value = normalizeStr(opt.input.value)
          if (opt.value === '') delete state[opt.name]
          else state[opt.name] = opt.value
        }
      })

      // 2) validate schema numeric inputs + attach into single objects
      schemaRows.forEach(row => {
        if (!row._input) return
        if (row._type === 'number' || row._type === 'integer') {
          if (row._input.value !== '' && isNaN(Number(row._input.value))) {
            row._input.classList.add('invalid-input')
          } else {
            row._input.classList.remove('invalid-input')
          }
        }
      })
      Object.keys(objectSchemas).forEach(objectName => {
        const parentOpt = optionsByName[objectName]
        if (parentOpt && parentOpt.isObjectArray) return // skip, handled below
        let anyFilled = false
        const obj = {}
        ;(objectSchemas[objectName] || []).forEach(row => {
          if (!row._input) return
          const val = row._input.value
          const parsed = parseValueByType(row._type, val)
          if (parsed !== undefined && parsed !== '') {
            obj[row._propName] = parsed
            anyFilled = true
          }
        })
        if (anyFilled) state[objectName] = obj
        else delete state[objectName]
      })

      // 3) Object arrays: only include filled entries. (+ Add does NOT filter)
      Object.values(options).forEach(opt => {
        if (!opt.isObjectArray || !opt.input) return
        const arr = []
        const entries = opt.input.querySelectorAll('.object-array-entry')
        entries.forEach(entry => {
          const obj = {}
          let any = false
          const props = objectArrayPropDefs[opt.name] || []
          props.forEach(def => {
            const propWrap = entry.querySelector(
              `.object-array-prop[data-prop="${def.propName}"]`
            )
            if (!propWrap) return
            const type = (propWrap.dataset.type || '').toLowerCase()
            // nested array?
            const nestedArrWrap = propWrap.querySelector('.array-input-wrapper')
            if (nestedArrWrap) {
              const arrVal = readTextArray(nestedArrWrap)
              if (arrVal !== undefined) {
                obj[def.propName] = arrVal
                any = true
              }
              return
            }
            const sel = propWrap.querySelector('select')
            if (sel) {
              if (sel.value !== '') {
                obj[def.propName] =
                  sel.dataset.booleanSelect === '1'
                    ? sel.value === 'true'
                    : sel.value
                any = true
              }
              return
            }
            const inp = propWrap.querySelector('input[type="text"]')
            if (inp) {
              if (
                (type === 'number' || type === 'integer') &&
                inp.value !== '' &&
                isNaN(Number(inp.value))
              ) {
                inp.classList.add('invalid-input')
                obj[def.propName] = inp.value // keep raw invalid
                any = true
              } else {
                inp.classList.remove('invalid-input')
                const parsed = parseValueByType(type, inp.value)
                if (parsed !== undefined && parsed !== '') {
                  obj[def.propName] = parsed
                  any = true
                }
              }
            }
          })
          if (any) arr.push(obj)
        })
        if (arr.length) {
          state[opt.name] = arr
          opt.value = arr
        } else {
          delete state[opt.name]
          opt.value = undefined
        }
      })

      // 4) show/hide option rows according to visibility (with transitive check)
      Object.values(options).forEach(opt => {
        // Sub-property rows handled as schema are controlled by their parent object
        if (opt._handledAsSchema) return

        const show = initial ? true : isFullyVisible(opt)
        // Array-prop template rows remain hidden regardless
        if (opt.isArrayProp) {
          opt.row.classList.add('hidden-row')
        } else {
          opt.row.classList.toggle('hidden-row', !show)
        }

        // For single-object schemas, follow parent visibility
        if (opt.isObject && objectSchemas[opt.name]) {
          objectSchemas[opt.name].forEach(row => {
            row.classList.toggle('hidden-row', !show)
          })
        }

        // For object arrays, show/hide the wrapper UI with parent visibility
        if (opt.isObjectArray && opt.input) {
          opt.input.style.display = show ? '' : 'none'
          // Also update property visibility within each entry
          const props = objectArrayPropDefs[opt.name] || []
          const entries = opt.input.querySelectorAll('.object-array-entry')
          entries.forEach(entry => {
            updateEntryPropVisibility(entry, props, initial)
          })
        }
      })

      // 5) show/hide enum/list rows based on their owning option
      Array.from(table.querySelectorAll('tr.row_enum, tr.row_list, tr.preview_enum, tr.preview_list')).forEach(
        row => {
          let prev = row.previousElementSibling
          while (prev && !prev.classList.contains('row_option'))
            prev = prev.previousElementSibling
          if (!prev) return
          row.classList.toggle(
            'hidden-row',
            prev.classList.contains('hidden-row')
          )
        }
      )

      // 6) show/hide read-only schema rows: visible when empty, hidden when values exist
      const formHasValues = Object.keys(state).length > 0
      readOnlySchemaRows.forEach(row => {
        // Check if parent object option is visible too
        const parentOpt = optionsByName[row._objectName]
        const parentVisible = parentOpt ? !parentOpt.row.classList.contains('hidden-row') : true
        // Hide read-only rows if form has values OR parent is hidden
        row.classList.toggle('hidden-row', formHasValues || !parentVisible)
      })

      // 7) update JSON snippet
      updateJsonSnippet()
    }

    // =============== JSON snippet UI (copy/reset) ===============
    function updateJsonSnippet () {
      let name = ''
      const header = document.querySelector('#content-head h1')
      if (header) name = header.textContent.trim()
      const optionsObj = {}
      Object.values(options).forEach(opt => {
        // Include object arrays even if parent row hidden (so entries reflect)
        const parentVisible = !opt.row.classList.contains('hidden-row')
        const include = parentVisible || opt.isObjectArray
        if (!include) return

        if (opt.isObject || opt.isObjectArray) {
          if (state[opt.name] !== undefined)
            optionsObj[opt.name] = state[opt.name]
        } else if (typeof opt.value === 'boolean') {
          optionsObj[opt.name] = opt.value
        } else if (opt.value !== undefined && opt.value !== '') {
          optionsObj[opt.name] = opt.value
        }
      })
      const snippet = { name, options: optionsObj }
      const jsonPre = document.getElementById('json-snippet-pre')
      const jsonBox = document.getElementById('json-snippet-box')
      if (jsonPre) {
        jsonPre.textContent = JSON.stringify(snippet, null, 2)
      } else if (jsonBox) {
        jsonBox.textContent = JSON.stringify(snippet, null, 2)
      }
    }

    // Build snippet container (with Copy + Reset) once — ORIGINAL BUTTONS + TOOLTIPS preserved
    let jsonDiv = document.getElementById('json-snippet-box')
    if (!jsonDiv) {
      jsonDiv = document.createElement('div')
      jsonDiv.id = 'json-snippet-box'
      jsonDiv.style.position = 'relative'
      jsonDiv.style.paddingTop = '2.5em'
      const jsonPre = document.createElement('pre')
      jsonPre.id = 'json-snippet-pre'
      jsonPre.style.margin = '0'
      jsonPre.style.fontFamily = 'monospace'
      jsonDiv.appendChild(jsonPre)

      // Override iOS Safari's UA stylesheet which forces -webkit-text-fill-color: blue on