@dogsbay/adapter-tigera 0.2.0-beta.140 → 0.2.0-beta.141

package/dist/data-components.d.ts

@@ -20,6 +20,13 @@
  *   - `<InstallOpenShiftManifests />` (Calico 3.30 on): the download with its `--exclude` flags,
  *     then Tigera's own `<ConfigDataplaneOpenShiftManifests />`, included as converted.
  *   - `<FossaReport />` (Calico Enterprise): a link to the attribution report.
+ *   - `<TechPreviewTable />` and `<DeprecatedFeaturesTable />` (release notes; Calico Cloud's
+ *     feature lifecycle reference) over `data/feature-status.yaml`, as
+ *     `src/components/FeatureStatusTable/featureStatus.ts` builds them. The release window is the
+ *     page's: worked out here from the docs folder's version (Calico Cloud: from `cloudversion`,
+ *     its columns relabelled), so a versioned snapshot keeps its window; the unversioned docs
+ *     have none and show nothing, as on the site. The template does the rest over the YAML:
+ *     carry-forward, `confirmed: false`, row order, cell labels and the fixed legend.
  *   - `<CalicoProducts />` (every product's "about" pages): a card per product, title and
  *     description, from the `products` list in the component's own source, read as data (it is
  *     not exported) and written as `calico-products.json` for `::data-cards`.
@@ -71,6 +78,8 @@ declare function alternateRegistry(ctx: PreprocessContext): TemplateComponent |
 declare function openshiftManifests(ctx: PreprocessContext): TemplateComponent | undefined;
 declare function calicoProducts(ctx: PreprocessContext): TemplateComponent | undefined;
 export declare const TIGERA_DATA_COMPONENTS: {
+    TechPreviewTable: (ctx: PreprocessContext) => TemplateComponent | undefined;
+    DeprecatedFeaturesTable: (ctx: PreprocessContext) => TemplateComponent | undefined;
     CalicoProducts: typeof calicoProducts;
     MaintenanceImageOptionsAlternateRegistry: typeof alternateRegistry;
     InstallOpenShiftManifests: typeof openshiftManifests;

package/dist/data-components.js

@@ -20,6 +20,13 @@
  *   - `<InstallOpenShiftManifests />` (Calico 3.30 on): the download with its `--exclude` flags,
  *     then Tigera's own `<ConfigDataplaneOpenShiftManifests />`, included as converted.
  *   - `<FossaReport />` (Calico Enterprise): a link to the attribution report.
+ *   - `<TechPreviewTable />` and `<DeprecatedFeaturesTable />` (release notes; Calico Cloud's
+ *     feature lifecycle reference) over `data/feature-status.yaml`, as
+ *     `src/components/FeatureStatusTable/featureStatus.ts` builds them. The release window is the
+ *     page's: worked out here from the docs folder's version (Calico Cloud: from `cloudversion`,
+ *     its columns relabelled), so a versioned snapshot keeps its window; the unversioned docs
+ *     have none and show nothing, as on the site. The template does the rest over the YAML:
+ *     carry-forward, `confirmed: false`, row order, cell labels and the fixed legend.
  *   - `<CalicoProducts />` (every product's "about" pages): a card per product, title and
  *     description, from the `products` list in the component's own source, read as data (it is
  *     not exported) and written as `calico-products.json` for `::data-cards`.
@@ -524,7 +531,115 @@ function calicoProducts(ctx) {
         data: { "calico-products.json": { module: `${up}/${CALICO_PRODUCTS}`, binding: "products" } },
     };
 }
+/** The feature status data, beside the site's config. */
+const FEATURE_STATUS = "data/feature-status.yaml";
+/** Statuses as featureStatus.ts's STATUSES: cell label and legend gloss, in progression order. */
+const STATUSES = [
+    ["tech-preview", "TP", "technology preview"],
+    ["ga", "GA", "generally available"],
+    ["deprecated", "Deprecated", "scheduled for removal"],
+    ["removed", "Removed", "no longer present"],
+];
+/** featureStatus.ts's PREVIEW_TABLE and DEPRECATION_TABLE. */
+const FEATURE_TABLES = {
+    TechPreviewTable: { name: "tech-preview-table", include: ["tech-preview"], legend: ["tech-preview", "ga"] },
+    DeprecatedFeaturesTable: { name: "deprecated-features-table", include: ["deprecated", "removed"], legend: ["ga", "deprecated", "removed"] },
+};
+/** featureStatus.ts `buildLegend`: the table's fixed statuses, then the dash. */
+const legendText = (statuses) => `${[...STATUSES.filter(([s]) => statuses.includes(s)).map(([, label, gloss]) => `${label} = ${gloss}`), "– = not available in that release"].join(", ")}.`;
+/**
+ * One table, as the component renders it. `window` is the page's three release lines (`3.31,…`),
+ * `labels` its column headers, `product` the docs plugin id: all from the adapter, plain text. A
+ * version key or status from the YAML is compared, never printed; a feature's name prints through
+ * `| cell`. Nothing is shown with no window or no row, as the component returns null.
+ */
+const featureTableText = (include, legend) => `{%- set statuses = ${JSON.stringify(STATUSES.map(([s]) => s))} -%}
+{%- set labels_of = ${JSON.stringify(Object.fromEntries(STATUSES.map(([s, l]) => [s, l])))} -%}
+{%- set include = ${JSON.stringify(include)} -%}
+{%- set rows = namespace(list=[]) -%}
+{%- if window -%}
+{%- set cols = window.split(",") -%}
+{%- for f in (data.feature_status.features if data.feature_status.features is defined else []) -%}
+{%- set order = loop.index -%}
+{%- set h = f.products[product] if f.products is defined and f.products and product in f.products else none -%}
+{%- if h and not ("confirmed" in h and h.confirmed == false) -%}
+{%- set changes = namespace(list=[]) -%}
+{%- for k, v in h | items -%}
+{%- set parts = (k ~ "").split(".") -%}
+{%- if v in statuses and parts | length == 2 -%}
+{%- set changes.list = changes.list + [{"at": (parts[0] | int) * 1000 + (parts[1] | int), "status": v}] -%}
+{%- endif -%}
+{%- endfor -%}
+{%- if changes.list -%}
+{%- set sorted = changes.list | sort(attribute="at") -%}
+{%- set cells = namespace(list=[], hit=false) -%}
+{%- for c in cols -%}
+{%- set cp = c.split(".") -%}
+{%- set at = (cp[0] | int) * 1000 + (cp[1] | int) -%}
+{%- set now = namespace(status=none) -%}
+{%- for ch in sorted -%}{%- if ch.at <= at -%}{%- set now.status = ch.status -%}{%- endif -%}{%- endfor -%}
+{%- set cells.list = cells.list + [now.status] -%}
+{%- if now.status in include -%}{%- set cells.hit = true -%}{%- endif -%}
+{%- endfor -%}
+{%- if cells.hit -%}
+{%- set rows.list = rows.list + [{"name": f.name if f.name is defined else "", "cells": cells.list, "since": sorted[0].at, "order": order}] -%}
+{%- endif -%}
+{%- endif -%}
+{%- endif -%}
+{%- endfor -%}
+{%- endif -%}
+{%- if rows.list %}
+| Feature |{% for l in labels.split(",") %} {{ l | cell }} |{% endfor %}
+| --- |{% for l in labels.split(",") %} --- |{% endfor %}
+{% for r in rows.list | sort(attribute="order") | sort(attribute="since") -%}
+| {{ r.name | text | cell }} |{% for cell in r.cells %} {{ labels_of[cell] if cell else "–" }} |{% endfor %}
+{% endfor %}
+${legendText(legend)}
+{%- endif %}
+`;
+/**
+ * A feature status table on a page of `product`: its window from the docs folder's version, or
+ * from Calico Cloud's `cloudversion` (featureStatus.ts `releaseWindow`, `ceVersionFromCloudversion`,
+ * `ccVersionLabel`). The page's `version="$[cloudversion]"` is that same value, so it is left out.
+ */
+function featureTable(kind) {
+    return (ctx) => {
+        const project = ctx.projectRoot ? `${ctx.projectRoot}/` : "";
+        const inside = (ctx.instanceRoot ?? "").slice(project.length);
+        const m = /^(calico|calico-enterprise|calico-cloud)(?:_versioned_docs\/version-([^/]+))?$/.exec(inside);
+        if (!m)
+            return undefined;
+        const product = m[1];
+        let line;
+        let cloud = false;
+        if (product === "calico-cloud") {
+            const cv = loadVariables(ctx).cloudversion;
+            line = typeof cv === "string" ? /^v?(\d+\.\d+)/.exec(cv)?.[1] : undefined;
+            cloud = true;
+        }
+        else if (m[2]) {
+            line = /^(\d+)\.(\d+)/.exec(m[2])?.[0];
+        }
+        let window = [];
+        if (line) {
+            const [major, minor] = line.split(".").map(Number);
+            window = [0, 1, 2].map((i) => `${major}.${minor - 2 + i}`);
+        }
+        const labels = window.map((v) => (cloud ? v.replace(/^3\./, "") : v));
+        const up = inside ? inside.split("/").map(() => "..").join("/") : ".";
+        const table = FEATURE_TABLES[kind];
+        return {
+            name: table.name,
+            text: featureTableText(table.include, table.legend),
+            values: { product, window: window.join(","), labels: labels.join(",") },
+            fromData: ["version"],
+            data: { "feature-status.yaml": `${up}/${FEATURE_STATUS}` },
+        };
+    };
+}
 export const TIGERA_DATA_COMPONENTS = {
+    TechPreviewTable: featureTable("TechPreviewTable"),
+    DeprecatedFeaturesTable: featureTable("DeprecatedFeaturesTable"),
     CalicoProducts: calicoProducts,
     MaintenanceImageOptionsAlternateRegistry: alternateRegistry,
     InstallOpenShiftManifests: openshiftManifests,

package/dist/index.js

@@ -52,6 +52,8 @@ const TIGERA_JS_COMPONENTS = [
     "AutoHostendpointsMigrate",
     "CalicoProducts",
     "CalicoWindowsInstall",
+    "TechPreviewTable",
+    "DeprecatedFeaturesTable",
     "ComponentVersions",
     "ConfigDataplaneOpenShiftManifests",
     "DownloadOpenShiftManifests",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dogsbay/adapter-tigera",
-  "version": "0.2.0-beta.140",
+  "version": "0.2.0-beta.141",
   "description": "Tigera/Calico site adapter for @dogsbay/format-docusaurus — resolves $[variable] substitution and Tigera-specific MDX components.",
   "type": "module",
   "exports": {
@@ -11,8 +11,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@dogsbay/corpus": "0.2.0-beta.140",
-    "@dogsbay/format-docusaurus": "0.2.0-beta.140"
+    "@dogsbay/corpus": "0.2.0-beta.141",
+    "@dogsbay/format-docusaurus": "0.2.0-beta.141"
   },
   "devDependencies": {
     "@types/node": "^22.20.1",