diff --git a/docs/features/event-handler/appsync-graphql.md b/docs/features/event-handler/appsync-graphql.md
index fc97428b55..e0920f6ea2 100644
--- a/docs/features/event-handler/appsync-graphql.md
+++ b/docs/features/event-handler/appsync-graphql.md
@@ -1,7 +1,6 @@
---
title: AppSync GraphQL
description: Event Handler for AppSync GraphQL APIs
-status: new
---
Event Handler for AWS AppSync GraphQL APIs simplifies routing and processing of events in AWS Lambda functions. It allows you to define resolvers for GraphQL types and fields, making it easier to handle GraphQL requests without the need for complex VTL or JavaScript templates.
diff --git a/docs/features/event-handler/http.md b/docs/features/event-handler/http.md
index 3a93b51857..417ed9d511 100644
--- a/docs/features/event-handler/http.md
+++ b/docs/features/event-handler/http.md
@@ -1,7 +1,6 @@
---
title: HTTP API
description: Event handler for building HTTP APIs in AWS Lambda
-status: new
---
Event handler for Amazon API Gateway REST and HTTP APIs, Application Loader Balancer (ALB), and Lambda Function URLs.
diff --git a/docs/features/metadata.md b/docs/features/metadata.md
index e820bec9b2..5b521b6cd4 100644
--- a/docs/features/metadata.md
+++ b/docs/features/metadata.md
@@ -1,7 +1,6 @@
---
title: Metadata
description: Utility to fetch data from the AWS Lambda Metadata endpoint
-status: new
---
diff --git a/docs/index.md b/docs/index.md
index d3da99e342..800af326b4 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -7,36 +7,9 @@ description: Powertools for AWS Lambda (TypeScript)
Powertools for AWS Lambda (TypeScript) is a developer toolkit to implement Serverless best practices and increase developer velocity.
-You can use Powertools for AWS Lambda in both TypeScript and JavaScript code bases.
+You can use Powertools for AWS Lambda also in [Python](https://docs.aws.amazon.com/powertools/python/latest/){target="_blank" }, [Java](https://docs.aws.amazon.com/powertools/java/){target="_blank"}, and [.NET](https://docs.aws.amazon.com/powertools/dotnet/){target="_blank"}.
-
-
-- :material-battery-charging:{ .lg .middle } __Features__
-
- ---
-
- Adopt one, a few, or all industry practices. **Progressively**.
-
- [:octicons-arrow-right-24: All features](./features/index.md)
-
-- :heart:{ .lg .middle } __Support this project__
-
- ---
-
- Become a public reference customer, share your work, contribute, use Lambda Layers, etc.
-
- [:octicons-arrow-right-24: Support](#support-powertools-for-aws)
-
-- :material-file-code:{ .lg .middle } __Available languages__
-
- ---
-
- Powertools for AWS Lambda is also available in other languages
-
- :octicons-arrow-right-24: [Python](https://docs.aws.amazon.com/powertools/python/latest/){target="_blank" }, [Java](https://docs.aws.amazon.com/powertools/java/){target="_blank"}, and [.NET](https://docs.aws.amazon.com/powertools/dotnet/){target="_blank"}
-
-
## Features
diff --git a/docs/javascript/aws-header.js b/docs/javascript/aws-header.js
new file mode 100644
index 0000000000..3990060273
--- /dev/null
+++ b/docs/javascript/aws-header.js
@@ -0,0 +1,189 @@
+(() => {
+ if (window.__awsHeaderMenusBound) {
+ return;
+ }
+
+ window.__awsHeaderMenusBound = true;
+
+ const menuSelector = ".aws-header__menu";
+ const summarySelector = ".aws-header__menu-summary";
+
+ const closeMenus = (except) => {
+ document.querySelectorAll(`${menuSelector}[open]`).forEach((menu) => {
+ if (menu !== except) {
+ menu.removeAttribute("open");
+ }
+ });
+ };
+
+ document.addEventListener("click", (event) => {
+ const summary = event.target.closest(summarySelector);
+
+ if (summary) {
+ const menu = summary.closest(menuSelector);
+ if (menu && !menu.open) {
+ closeMenus(menu);
+ }
+ return;
+ }
+
+ if (!event.target.closest(menuSelector)) {
+ closeMenus();
+ }
+ });
+
+ document.addEventListener("keydown", (event) => {
+ if (event.key !== "Escape") {
+ return;
+ }
+
+ const openMenu = document.querySelector(`${menuSelector}[open]`);
+ if (!openMenu) {
+ return;
+ }
+
+ const summary = openMenu.querySelector(summarySelector);
+ closeMenus();
+ if (summary) {
+ summary.focus();
+ }
+ });
+})();
+
+(() => {
+ if (window.__awsNavCollapseBound) {
+ return;
+ }
+
+ window.__awsNavCollapseBound = true;
+
+ const collapsedClass = "aws-nav-collapsed";
+ const collapseButtonClass = "aws-nav-collapse";
+ const reopenButtonClass = "aws-nav-reopen";
+ const storageKey = "aws-nav-collapsed";
+
+ const chevronSvg = (direction) => `
+
+
+ `;
+
+ const menuSvg = () => `
+
+
+ `;
+
+ const setReopenPosition = () => {
+ const mainInner = document.querySelector(".md-main__inner");
+ if (!mainInner) {
+ return;
+ }
+
+ const rect = mainInner.getBoundingClientRect();
+ document.documentElement.style.setProperty(
+ "--aws-nav-reopen-left",
+ `${Math.max(rect.left + 12, 12)}px`
+ );
+ document.documentElement.style.setProperty(
+ "--aws-nav-reopen-top",
+ `${Math.max(rect.top + window.scrollY, 0)}px`
+ );
+ };
+
+ const queueReopenPosition = () => {
+ window.requestAnimationFrame(setReopenPosition);
+ };
+
+ const restoreState = () => {
+ let isCollapsed = false;
+
+ try {
+ isCollapsed = localStorage.getItem(storageKey) === "true";
+ } catch (_) {
+ isCollapsed = false;
+ }
+
+ document.documentElement.classList.toggle(collapsedClass, isCollapsed);
+ };
+
+ const setCollapsed = (isCollapsed) => {
+ document.documentElement.classList.toggle(collapsedClass, isCollapsed);
+ queueReopenPosition();
+
+ try {
+ localStorage.setItem(storageKey, String(isCollapsed));
+ } catch (_) {
+ // Ignore storage failures in private browsing or locked-down contexts.
+ }
+ };
+
+ const createButton = ({ className, label, direction, icon }) => {
+ const button = document.createElement("button");
+ button.type = "button";
+ button.className = className;
+ button.setAttribute("aria-label", label);
+ button.innerHTML = icon === "menu" ? menuSvg() : chevronSvg(direction);
+ return button;
+ };
+
+ const ensureButtons = () => {
+ const sidebar = document.querySelector(".md-sidebar--primary");
+ const collapseButtonHost =
+ sidebar?.querySelector(".md-sidebar__scrollwrap") ?? sidebar;
+
+ if (collapseButtonHost && !sidebar.querySelector(`.${collapseButtonClass}`)) {
+ collapseButtonHost.append(
+ createButton({
+ className: collapseButtonClass,
+ label: "Collapse navigation",
+ direction: "left",
+ })
+ );
+ }
+
+ if (!document.querySelector(`.${reopenButtonClass}`)) {
+ document.body.append(
+ createButton({
+ className: reopenButtonClass,
+ label: "Open navigation",
+ icon: "menu",
+ })
+ );
+ }
+ };
+
+ restoreState();
+
+ document.addEventListener("click", (event) => {
+ const collapseButton = event.target.closest(`.${collapseButtonClass}`);
+ const reopenButton = event.target.closest(`.${reopenButtonClass}`);
+
+ if (collapseButton) {
+ setCollapsed(true);
+ return;
+ }
+
+ if (reopenButton) {
+ setCollapsed(false);
+ }
+ });
+
+ const init = () => {
+ restoreState();
+ ensureButtons();
+ queueReopenPosition();
+ };
+
+ window.addEventListener("resize", queueReopenPosition);
+
+ if (document.readyState === "loading") {
+ document.addEventListener("DOMContentLoaded", init, { once: true });
+ } else {
+ init();
+ }
+
+ if (window.document$ && typeof window.document$.subscribe === "function") {
+ window.document$.subscribe(init);
+ }
+})();
diff --git a/docs/javascript/extra.js b/docs/javascript/extra.js
index f0df000448..485de99ba4 100644
--- a/docs/javascript/extra.js
+++ b/docs/javascript/extra.js
@@ -11,6 +11,12 @@ function enableClipboardElements() {
});
}
+document.addEventListener('click', (event) => {
+ document.querySelectorAll('.aws-prefs[open]').forEach((details) => {
+ if (!details.contains(event.target)) details.removeAttribute('open');
+ });
+});
+
const attachListeners = () => {
enableSearchOnBlurElement();
enableClipboardElements();
diff --git a/docs/media/aws-logo-dark.svg b/docs/media/aws-logo-dark.svg
new file mode 100644
index 0000000000..4a79380f34
--- /dev/null
+++ b/docs/media/aws-logo-dark.svg
@@ -0,0 +1,38 @@
+
+
+
+
+
+
+
+
+
diff --git a/docs/overrides/main.html b/docs/overrides/main.html
index 64dcbf5499..0fef10f733 100644
--- a/docs/overrides/main.html
+++ b/docs/overrides/main.html
@@ -10,4 +10,8 @@
{% block extrahead %}
+
+
+ {% if config.theme.palette %}
+ {% if not config.theme.palette is mapping %}
+
+ {% endif %}
+ {% endif %}
+ {% if not config.theme.palette is mapping %}
+ {% include "partials/javascripts/palette.html" %}
+ {% endif %}
+ Contact Us
+ Feedback
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/overrides/partials/search.html b/docs/overrides/partials/search.html
new file mode 100644
index 0000000000..607ca947bc
--- /dev/null
+++ b/docs/overrides/partials/search.html
@@ -0,0 +1,43 @@
+{#-
+ This file is copied from Material for MkDocs' partials/search.html and only
+ changes the visible placeholder/label copy for the AWS docs header.
+-#}
+
diff --git a/docs/overrides/partials/toc.html b/docs/overrides/partials/toc.html
new file mode 100644
index 0000000000..5caa2381af
--- /dev/null
+++ b/docs/overrides/partials/toc.html
@@ -0,0 +1,30 @@
+{#-
+ This file was automatically generated - do not edit
+-#}
+{% set title = "On this page" %}
+
+ {% set toc = page.toc %}
+ {% set first = toc | first %}
+ {% if first and first.level == 1 %}
+ {% set toc = first.children %}
+ {% endif %}
+ {% if toc %}
+
+
+
+ {% for toc_item in toc %}
+ {% include "partials/toc-item.html" %}
+ {% endfor %}
+
+
+ {% endif %}
+
diff --git a/docs/stylesheets/aws-content.css b/docs/stylesheets/aws-content.css
new file mode 100644
index 0000000000..0649e449aa
--- /dev/null
+++ b/docs/stylesheets/aws-content.css
@@ -0,0 +1,129 @@
+/* AWS docs restyle: content typography + layout (owned by Minion C) */
+
+/* --------------------------------------------------------------------------
+ * Main layout: keep the page shell broad, but the prose column readable.
+ * Material uses 20px root rems, so 45rem is approximately a 900px column.
+ * ------------------------------------------------------------------------ */
+.md-grid {
+ max-width: 1440px;
+}
+
+.md-content__inner {
+ max-width: 45rem;
+ padding-top: 0;
+}
+
+.md-main__inner {
+ margin-top: 0.8rem;
+}
+
+/* --------------------------------------------------------------------------
+ * Light-scheme content colors from current AWS Developer Guide docs.
+ * Dark mode inherits the existing Material/Powertools slate palette.
+ * ------------------------------------------------------------------------ */
+[data-md-color-scheme="default"] .md-typeset {
+ color: #0f141a;
+}
+
+.md-typeset {
+ font-family: "Amazon Ember", Helvetica, Arial, sans-serif;
+}
+
+[data-md-color-scheme="default"] .md-typeset h1,
+[data-md-color-scheme="default"] .md-typeset h2,
+[data-md-color-scheme="default"] .md-typeset h3,
+[data-md-color-scheme="default"] .md-typeset h4,
+[data-md-color-scheme="default"] .md-typeset h5 {
+ color: #0f141a;
+}
+
+/* --------------------------------------------------------------------------
+ * Typography: current AWS Developer Guide content column.
+ * The live page promotes the document title into a generated Cloudscape
+ * display heading (42px/700); the older in-body h1 rule was 36px/300.
+ * ------------------------------------------------------------------------ */
+.md-typeset h1,
+.md-typeset h2,
+.md-typeset h3,
+.md-typeset h4,
+.md-typeset h5 {
+ font-family: "Amazon Ember", Helvetica, Arial, sans-serif;
+ letter-spacing: normal;
+}
+
+.md-typeset h1 {
+ font-size: 2.625em;
+ font-weight: 700;
+ line-height: 1;
+ margin: 0 0 10px;
+ padding: 0;
+}
+
+.md-typeset h2 {
+ font-size: 1.625em;
+ font-weight: 600;
+ line-height: 1.226em;
+ margin: 1em 0 0.75em;
+ padding: 1em 0 0;
+}
+
+.md-typeset h3 {
+ font-size: 1.375em;
+ font-weight: 700;
+ line-height: 1.226em;
+ margin: 1.25em 0 0.75em;
+ padding: 0;
+}
+
+.md-typeset h4 {
+ font-size: 1.25em;
+ font-weight: 700;
+ line-height: 1.267em;
+ margin: 1.2em 0 0.75em;
+ padding: 0;
+}
+
+.md-typeset h5 {
+ font-size: 1.125em;
+ font-weight: 700;
+ line-height: 1.267em;
+ margin: 1.2em 0 1em;
+ padding: 0;
+}
+
+.md-typeset p {
+ line-height: 1.5;
+ margin: 1em 0;
+}
+
+/* --------------------------------------------------------------------------
+ * Lists: AWS-style top-level spacing with standard markers.
+ * Keep card grids and nested lists on Material's existing spacing.
+ * ------------------------------------------------------------------------ */
+.md-typeset > ul {
+ list-style-type: disc;
+}
+
+.md-typeset > ol {
+ list-style-type: decimal;
+}
+
+.md-typeset > ul > li + li,
+.md-typeset > ol > li + li {
+ margin-top: 1em;
+}
+
+.md-typeset li::marker {
+ color: currentColor;
+}
+
+/* --------------------------------------------------------------------------
+ * Section dividers.
+ * ------------------------------------------------------------------------ */
+.md-typeset hr {
+ border-bottom: 1px solid var(--aws-border-secondary, #ebebf0);
+}
+
+[data-md-color-scheme="default"] .md-typeset hr {
+ border-bottom-color: #ebebf0;
+}
diff --git a/docs/stylesheets/aws-footer.css b/docs/stylesheets/aws-footer.css
new file mode 100644
index 0000000000..f09068f688
--- /dev/null
+++ b/docs/stylesheets/aws-footer.css
@@ -0,0 +1,224 @@
+/* AWS docs restyle: footer (owned by Minion B) */
+
+.aws-footer.md-footer {
+ background: #fff;
+ color: #0f141a;
+}
+
+.aws-footer__pager {
+ background: #fff;
+ border-top: 1px solid #ebebf0;
+ color: #0f141a;
+ display: block;
+ padding-bottom: 24px;
+ padding-top: 24px;
+}
+
+.aws-footer__pager-line {
+ color: #0f141a;
+ font-size: 15px;
+ line-height: 22px;
+ margin: 0;
+}
+
+.aws-footer__pager-line + .aws-footer__pager-line {
+ margin-top: 8px;
+}
+
+.aws-footer__pager-line strong {
+ color: #0f141a;
+ font-weight: 700;
+}
+
+.aws-footer__pager-line a {
+ color: #006ce0;
+ font-weight: 400;
+ text-decoration: none;
+}
+
+.aws-footer__pager-line a:hover,
+.aws-footer__pager-line a:focus-visible {
+ color: #006ce0;
+ text-decoration: underline;
+ text-underline-offset: 0.25em;
+}
+
+.aws-footer__panel {
+ background: #161d26;
+ color: rgba(255, 255, 255, 0.85);
+ font-family: var(--md-text-font), sans-serif;
+ padding: 48px 0 0;
+ position: relative;
+}
+
+.aws-footer__panel-inner {
+ box-sizing: border-box;
+ margin-left: auto;
+ margin-right: auto;
+ max-width: 1440px;
+ padding-left: 40px;
+ padding-right: 40px;
+ position: relative;
+ width: 100%;
+}
+
+.aws-footer__columns {
+ box-sizing: border-box;
+ display: grid;
+ gap: 32px 40px;
+ grid-template-columns: repeat(4, minmax(0, 1fr));
+}
+
+.aws-footer__column {
+ margin: 0;
+}
+
+.aws-footer__heading {
+ color: #fff;
+ font-family: var(--md-text-font), sans-serif;
+ font-size: 16px;
+ font-weight: 700;
+ line-height: 22px;
+ margin: 0 0 16px;
+}
+
+.aws-footer__list {
+ list-style: none;
+ margin: 0;
+ padding: 0;
+}
+
+.aws-footer__list li + li {
+ margin-top: 11px;
+}
+
+.aws-footer__link {
+ color: rgba(255, 255, 255, 0.85);
+ font-family: var(--md-text-font), sans-serif;
+ font-size: 14px;
+ font-weight: 400;
+ line-height: 1.4;
+ text-decoration: none;
+}
+
+.aws-footer__link:hover,
+.aws-footer__link:focus-visible {
+ color: #fff;
+ text-decoration: underline;
+ text-underline-offset: 0.25em;
+}
+
+.aws-footer__external-icon {
+ color: currentcolor;
+ display: inline-flex;
+ height: 12px;
+ margin-left: 4px;
+ vertical-align: -1px;
+ width: 12px;
+}
+
+.aws-footer__external-icon svg {
+ display: block;
+ fill: none;
+ height: 12px;
+ stroke: currentcolor;
+ stroke-linecap: square;
+ stroke-linejoin: miter;
+ stroke-width: 1.5;
+ width: 12px;
+}
+
+.aws-footer__legal {
+ border-top: 1px solid rgba(255, 255, 255, 0.2);
+ color: rgba(255, 255, 255, 0.72);
+ font-family: var(--md-text-font), sans-serif;
+ font-size: 12px;
+ font-weight: 400;
+ line-height: 18px;
+ margin-top: 40px;
+ padding-bottom: 24px;
+ padding-top: 24px;
+}
+
+.aws-footer__legal .md-copyright,
+.aws-footer__legal .md-copyright__highlight,
+.aws-footer__legal #awsdocs-legal-zone-copyright,
+.aws-footer__legal .copyright {
+ color: rgba(255, 255, 255, 0.72);
+ font-family: var(--md-text-font), sans-serif;
+ font-size: 12px;
+ font-weight: 400;
+ line-height: 18px;
+}
+
+.aws-footer__legal .md-copyright {
+ max-width: none;
+ padding: 0;
+ width: 100%;
+}
+
+.aws-footer__legal a {
+ color: rgba(255, 255, 255, 0.72);
+ font-weight: 400;
+ margin-left: 10px;
+ margin-right: 10px;
+ text-decoration: none;
+}
+
+.aws-footer__legal a:first-child {
+ margin-left: 0;
+}
+
+.aws-footer__legal a:hover,
+.aws-footer__legal a:focus-visible {
+ color: #fff;
+ text-decoration: underline;
+ text-underline-offset: 0.25em;
+}
+
+@media screen and (max-width: 62.5em) {
+ .aws-footer__columns {
+ grid-template-columns: repeat(2, minmax(0, 1fr));
+ }
+}
+
+@media screen and (max-width: 44.9375em) {
+ .aws-footer__pager {
+ padding-bottom: 20px;
+ padding-top: 20px;
+ }
+
+ .aws-footer__panel {
+ padding-top: 40px;
+ }
+
+ .aws-footer__panel-inner {
+ padding-left: 24px;
+ padding-right: 24px;
+ }
+
+ .aws-footer__columns {
+ grid-template-columns: 1fr;
+ }
+}
+
+[data-md-color-scheme="slate"] .aws-footer.md-footer,
+[data-md-color-scheme="slate"] .aws-footer__pager {
+ background: #0f141a;
+ color: rgba(255, 255, 255, 0.88);
+}
+
+[data-md-color-scheme="slate"] .aws-footer__pager {
+ border-top-color: #424650;
+}
+
+[data-md-color-scheme="slate"] .aws-footer__pager-line,
+[data-md-color-scheme="slate"] .aws-footer__pager-line strong {
+ color: rgba(255, 255, 255, 0.88);
+}
+
+[data-md-color-scheme="slate"] .aws-footer__pager-line a,
+[data-md-color-scheme="slate"] .aws-footer__pager-line a:hover,
+[data-md-color-scheme="slate"] .aws-footer__pager-line a:focus-visible {
+ color: #42b4ff;
+}
diff --git a/docs/stylesheets/aws-header.css b/docs/stylesheets/aws-header.css
new file mode 100644
index 0000000000..996ba51d7f
--- /dev/null
+++ b/docs/stylesheets/aws-header.css
@@ -0,0 +1,563 @@
+/* AWS docs restyle: portal header (owned by Minion A) */
+
+:root {
+ --aws-header-text: #0f141a;
+ --aws-header-muted: #424650;
+ --aws-header-border: #dedee3;
+ --aws-header-link-blue: #006ce0;
+ --aws-header-utility-bg: #0f141a;
+ --aws-header-orange: #ff9900;
+ --aws-header-orange-hover: #ec7211;
+}
+
+[data-md-color-scheme="default"] {
+ --md-primary-fg-color: #ffffff;
+ --md-primary-fg-color--light: #ffffff;
+ --md-primary-fg-color--dark: #f9f9fb;
+ --md-primary-bg-color: var(--aws-header-text);
+ --md-primary-bg-color--light: var(--aws-header-muted);
+}
+
+.aws-header.md-header {
+ background: transparent;
+ box-shadow: none;
+ color: var(--aws-header-text);
+}
+
+.aws-header.md-header--shadow,
+.aws-header.md-header[data-md-state="shadow"],
+.aws-header.md-header--shadow[data-md-state="shadow"] {
+ box-shadow: none;
+}
+
+.aws-utility-bar {
+ background: var(--aws-header-utility-bg);
+ color: #ffffff;
+ min-height: 36px;
+}
+
+.aws-utility-bar__inner {
+ align-items: center;
+ box-sizing: border-box;
+ display: flex;
+ gap: 24px;
+ justify-content: flex-end;
+ max-width: none;
+ min-height: 36px;
+ padding-left: 24px;
+ padding-right: 24px;
+ width: 100%;
+}
+
+.aws-utility-bar__preferences {
+ display: flex;
+ margin: 0;
+ position: relative;
+}
+
+.aws-prefs__palette-sentinel {
+ display: none;
+}
+
+.aws-utility-bar__link {
+ align-items: center;
+ background: none;
+ border: 0;
+ color: #ffffff;
+ cursor: pointer;
+ display: inline-flex;
+ font-size: 13px;
+ font-weight: 700;
+ line-height: 1.3;
+ margin: 0;
+ padding: 0;
+ text-decoration: none;
+}
+
+.aws-prefs {
+ position: relative;
+}
+
+.aws-prefs__summary {
+ align-items: center;
+ gap: 0.25rem;
+ list-style: none;
+}
+
+.aws-prefs__summary::-webkit-details-marker {
+ display: none;
+}
+
+.aws-prefs[open] .aws-prefs__summary {
+ color: #42b4ff;
+ text-decoration: none;
+}
+
+.aws-prefs__caret {
+ border-left: 4px solid transparent;
+ border-right: 4px solid transparent;
+ border-top: 4px solid currentcolor;
+ height: 0;
+ margin-top: 2px;
+ width: 0;
+}
+
+.aws-prefs[open] .aws-prefs__caret {
+ border-bottom: 4px solid currentcolor;
+ border-top: 0;
+}
+
+.aws-prefs__panel {
+ background: #161d26;
+ box-shadow: 0 8px 20px rgba(0, 0, 0, 0.45);
+ color: #ffffff;
+ min-width: 200px;
+ padding: 16px;
+ position: absolute;
+ right: 0;
+ top: calc(100% + 10px);
+ z-index: 10;
+}
+
+.aws-prefs__heading {
+ border-bottom: 1px solid rgba(255, 255, 255, 0.2);
+ color: #ffffff;
+ font-size: 16px;
+ font-weight: 700;
+ line-height: 1.4;
+ padding-bottom: 12px;
+}
+
+.aws-prefs__section-label {
+ color: #ffffff;
+ font-size: 14px;
+ line-height: 1.4;
+ margin-top: 14px;
+}
+
+.aws-prefs__options {
+ display: grid;
+ gap: 10px;
+ margin-top: 10px;
+}
+
+.aws-prefs__option {
+ align-items: center;
+ color: #ffffff;
+ cursor: pointer;
+ display: inline-flex;
+ font-size: 14px;
+ gap: 8px;
+ line-height: 1.4;
+}
+
+.aws-radio {
+ border: 2px solid rgba(255, 255, 255, 0.7);
+ border-radius: 50%;
+ box-sizing: border-box;
+ display: inline-flex;
+ flex: 0 0 auto;
+ height: 14px;
+ position: relative;
+ width: 14px;
+}
+
+.aws-radio::after {
+ background: #42b4ff;
+ border-radius: 50%;
+ content: "";
+ height: 6px;
+ left: 50%;
+ opacity: 0;
+ position: absolute;
+ top: 50%;
+ transform: translate(-50%, -50%);
+ width: 6px;
+}
+
+body[data-md-color-media="(prefers-color-scheme: light)"] .aws-prefs__option[for="__palette_1"] .aws-radio,
+body[data-md-color-media="(prefers-color-scheme: dark)"] .aws-prefs__option[for="__palette_2"] .aws-radio,
+body[data-md-color-media="(prefers-color-scheme)"] .aws-prefs__option[for="__palette_0"] .aws-radio,
+#__palette_1:checked ~ .aws-prefs .aws-prefs__option[for="__palette_1"] .aws-radio,
+#__palette_2:checked ~ .aws-prefs .aws-prefs__option[for="__palette_2"] .aws-radio,
+#__palette_0:checked ~ .aws-prefs .aws-prefs__option[for="__palette_0"] .aws-radio {
+ border-color: #42b4ff;
+}
+
+body[data-md-color-media="(prefers-color-scheme: light)"] .aws-prefs__option[for="__palette_1"] .aws-radio::after,
+body[data-md-color-media="(prefers-color-scheme: dark)"] .aws-prefs__option[for="__palette_2"] .aws-radio::after,
+body[data-md-color-media="(prefers-color-scheme)"] .aws-prefs__option[for="__palette_0"] .aws-radio::after,
+#__palette_1:checked ~ .aws-prefs .aws-prefs__option[for="__palette_1"] .aws-radio::after,
+#__palette_2:checked ~ .aws-prefs .aws-prefs__option[for="__palette_2"] .aws-radio::after,
+#__palette_0:checked ~ .aws-prefs .aws-prefs__option[for="__palette_0"] .aws-radio::after {
+ opacity: 1;
+}
+
+.aws-utility-bar__link:hover,
+.aws-utility-bar__link:focus,
+.aws-prefs__summary:hover,
+.aws-prefs__summary:focus {
+ color: #ffffff;
+ text-decoration: underline;
+ text-decoration-thickness: 1px;
+ text-underline-offset: 0.25em;
+}
+
+.aws-main-header {
+ background: #ffffff;
+ border-bottom: 1px solid var(--aws-header-border);
+ color: var(--aws-header-text);
+}
+
+.aws-main-header__inner.md-header__inner {
+ align-items: center;
+ box-sizing: border-box;
+ display: flex;
+ gap: 0;
+ max-width: none;
+ min-height: 72px;
+ padding-bottom: 0;
+ padding-left: 24px;
+ padding-right: 24px;
+ padding-top: 0;
+ width: 100%;
+}
+
+.aws-header__drawer.md-header__button {
+ color: var(--aws-header-text);
+ flex: 0 0 auto;
+ margin: 0;
+}
+
+.aws-header__logo.md-logo {
+ align-items: center;
+ display: inline-flex;
+ flex: 0 0 auto;
+ height: 72px;
+ margin: 0;
+ padding: 0;
+}
+
+.aws-header__logo img,
+[data-md-color-scheme="default"] .aws-header__logo img,
+[data-md-color-scheme="slate"] .aws-header__logo img {
+ content: url("../media/aws-logo-dark.svg");
+ height: 32px;
+ width: auto;
+}
+
+.aws-header__nav {
+ align-items: center;
+ display: flex;
+ flex: 0 1 auto;
+ gap: 0;
+ margin-left: 60px;
+ min-width: 0;
+}
+
+.aws-header__menu {
+ display: block;
+ flex: 0 0 auto;
+ position: relative;
+}
+
+.aws-header__nav-link {
+ background: transparent;
+ border: 0;
+ color: var(--aws-header-text);
+ cursor: pointer;
+ display: inline-flex;
+ flex: 0 0 auto;
+ font-size: 14px;
+ font-weight: 700;
+ line-height: 1.4;
+ list-style: none;
+ margin: 0;
+ padding: 26px 20px;
+ text-decoration: none;
+}
+
+.aws-header__menu-summary::-webkit-details-marker {
+ display: none;
+}
+
+.aws-header__menu-summary::marker {
+ content: "";
+}
+
+.aws-header__nav-link:hover,
+.aws-header__nav-link:focus {
+ color: var(--aws-header-text);
+ text-decoration: underline;
+ text-decoration-thickness: 1px;
+ text-underline-offset: 0.25em;
+}
+
+.aws-header__menu[open] > .aws-header__menu-summary {
+ color: var(--aws-header-link-blue);
+ text-decoration: underline;
+ text-decoration-thickness: 2px;
+ text-underline-offset: 0.55em;
+}
+
+.aws-header__menu-panel {
+ background: #ffffff;
+ border: 1px solid #ebebf0;
+ box-shadow: 0 4px 20px rgba(0, 0, 0, 0.1);
+ box-sizing: border-box;
+ color: var(--aws-header-text);
+ display: grid;
+ gap: 22px;
+ left: 20px;
+ min-width: 380px;
+ padding: 24px 32px;
+ position: absolute;
+ top: calc(100% + 1px);
+ width: 380px;
+ z-index: 1000;
+}
+
+.aws-header__menu-section {
+ display: grid;
+ gap: 8px;
+}
+
+.aws-header__menu-heading {
+ color: var(--aws-header-text);
+ font-size: 16px;
+ font-weight: 700;
+ line-height: 1.35;
+}
+
+.aws-header__menu-link {
+ align-items: baseline;
+ color: var(--aws-header-text);
+ display: inline-flex;
+ font-size: 14px;
+ font-weight: 400;
+ gap: 0.3rem;
+ line-height: 1.45;
+ text-decoration: none;
+ width: fit-content;
+}
+
+.aws-header__menu-link:hover,
+.aws-header__menu-link:focus {
+ color: var(--aws-header-link-blue);
+ text-decoration: underline;
+ text-decoration-thickness: 1px;
+ text-underline-offset: 0.25em;
+}
+
+.aws-header__menu-link--external::after {
+ background-color: currentcolor;
+ content: "";
+ display: inline-block;
+ flex: 0 0 auto;
+ height: 12px;
+ margin-left: 2px;
+ -webkit-mask: url("data:image/svg+xml,%3Csvg viewBox='0 0 16 16' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M3 3h4v1.5H4.5v7h7V9H13v4H3V3zm6 0h4v4h-1.5V5.56L7.53 9.53 6.47 8.47l3.97-3.97H9V3z'/%3E%3C/svg%3E") center / contain no-repeat;
+ mask: url("data:image/svg+xml,%3Csvg viewBox='0 0 16 16' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M3 3h4v1.5H4.5v7h7V9H13v4H3V3zm6 0h4v4h-1.5V5.56L7.53 9.53 6.47 8.47l3.97-3.97H9V3z'/%3E%3C/svg%3E") center / contain no-repeat;
+ width: 12px;
+}
+
+.aws-header__actions {
+ align-items: center;
+ display: flex;
+ flex: 0 1 auto;
+ gap: 16px;
+ margin-left: auto;
+ min-width: 0;
+}
+
+.aws-header__search-toggle.md-header__button {
+ color: var(--aws-header-text);
+ flex: 0 0 auto;
+ margin: 0;
+}
+
+.aws-header__console {
+ align-items: center;
+ background: var(--aws-header-orange);
+ border-radius: 9999px;
+ color: var(--aws-header-text);
+ display: inline-flex;
+ flex: 0 0 auto;
+ font-size: 14px;
+ font-weight: 700;
+ justify-content: center;
+ line-height: 1.2;
+ padding: 0.45rem 1.25rem;
+ text-decoration: none;
+ white-space: nowrap;
+}
+
+.aws-header__console:hover,
+.aws-header__console:focus {
+ background: var(--aws-header-orange-hover);
+ color: var(--aws-header-text);
+ text-decoration: none;
+}
+
+.aws-header .md-search__form {
+ border-radius: 8px;
+ overflow: hidden;
+}
+
+.aws-header .md-search__input {
+ border-radius: 8px;
+ box-shadow: none;
+}
+
+[data-md-color-scheme="default"] .aws-header .md-search__form {
+ background-color: #ffffff;
+ border: 1px solid #c6c6cd;
+ box-shadow: none;
+}
+
+[data-md-color-scheme="default"] .aws-header .md-search__form:hover,
+[data-md-color-scheme="default"] .aws-header .md-search__form:focus-within {
+ border-color: var(--aws-header-link-blue);
+ box-shadow: 0 0 0 1px var(--aws-header-link-blue);
+}
+
+[data-md-color-scheme="default"] .aws-header .md-search__input {
+ background-color: #ffffff;
+ box-shadow: none;
+ color: var(--aws-header-text);
+}
+
+[data-md-color-scheme="default"] .aws-header .md-search__input::placeholder,
+[data-md-color-scheme="default"] .aws-header .md-search__icon,
+[data-md-color-scheme="default"] .aws-header .md-search__options,
+[data-md-color-scheme="default"] .aws-header .md-search__options .md-icon {
+ color: var(--aws-header-muted);
+}
+
+[data-md-color-scheme="default"] .aws-header .md-search__input + .md-search__icon:hover,
+[data-md-color-scheme="default"] .aws-header .md-search__options .md-icon:hover {
+ color: var(--aws-header-link-blue);
+}
+
+[data-md-color-scheme="slate"] .aws-utility-bar,
+[data-md-color-scheme="slate"] .aws-main-header {
+ background-color: #161d26;
+ color: #ffffff;
+}
+
+[data-md-color-scheme="slate"] .aws-main-header {
+ border-bottom-color: #2a3541;
+}
+
+[data-md-color-scheme="slate"] .aws-header__drawer.md-header__button,
+[data-md-color-scheme="slate"] .aws-header__search-toggle.md-header__button,
+[data-md-color-scheme="slate"] .aws-header__nav-link {
+ color: rgba(255, 255, 255, 0.9);
+}
+
+[data-md-color-scheme="slate"] .aws-header__nav-link:hover,
+[data-md-color-scheme="slate"] .aws-header__nav-link:focus {
+ color: #ffffff;
+}
+
+[data-md-color-scheme="slate"] .aws-header__menu[open] > .aws-header__menu-summary {
+ color: #42b4ff;
+}
+
+[data-md-color-scheme="slate"] .aws-header__menu-panel {
+ background: #ffffff;
+ color: var(--aws-header-text);
+}
+
+[data-md-color-scheme="slate"] .aws-header__logo img {
+ filter: invert(1) grayscale(1) brightness(1.8);
+}
+
+[data-md-color-scheme="slate"] .aws-header .md-search__form {
+ background-color: #0f141a;
+ border: 1px solid #424650;
+ box-shadow: none;
+}
+
+[data-md-color-scheme="slate"] .aws-header .md-search__form:hover,
+[data-md-color-scheme="slate"] .aws-header .md-search__form:focus-within {
+ border-color: #42b4ff;
+ box-shadow: 0 0 0 1px #42b4ff;
+}
+
+[data-md-color-scheme="slate"] .aws-header .md-search__input {
+ background-color: #0f141a;
+ box-shadow: none;
+ color: #ffffff;
+}
+
+[data-md-color-scheme="slate"] .aws-header .md-search__input::placeholder,
+[data-md-color-scheme="slate"] .aws-header .md-search__icon,
+[data-md-color-scheme="slate"] .aws-header .md-search__options,
+[data-md-color-scheme="slate"] .aws-header .md-search__options .md-icon {
+ color: rgba(255, 255, 255, 0.72);
+}
+
+@media screen and (min-width: 60em) {
+ .aws-header__search-toggle {
+ display: none;
+ }
+
+ .aws-header .md-search {
+ flex: 0 0 300px;
+ margin: 0;
+ padding: 0;
+ width: 300px;
+ }
+
+ .aws-header .md-search__inner {
+ width: 100%;
+ }
+
+ .aws-header .md-search__form {
+ height: 38px;
+ }
+
+ .aws-header .md-search__input {
+ font-size: 14px;
+ height: 100%;
+ }
+}
+
+@media screen and (min-width: 76.25em) {
+ .aws-header__drawer {
+ display: none;
+ }
+}
+
+@media screen and (max-width: 76.234375em) {
+ .aws-main-header__inner.md-header__inner {
+ gap: 16px;
+ }
+
+ .aws-header__nav {
+ display: none;
+ }
+}
+
+@media screen and (max-width: 59.984375em) {
+ .aws-utility-bar__inner {
+ gap: 24px;
+ }
+
+ .aws-main-header__inner.md-header__inner {
+ min-height: 56px;
+ }
+
+ .aws-header__logo.md-logo {
+ height: 56px;
+ }
+
+ .aws-header__actions {
+ gap: 0.25rem;
+ }
+
+ .aws-header__console {
+ display: none;
+ }
+}
diff --git a/docs/stylesheets/aws-nav.css b/docs/stylesheets/aws-nav.css
new file mode 100644
index 0000000000..22e6bd161a
--- /dev/null
+++ b/docs/stylesheets/aws-nav.css
@@ -0,0 +1,501 @@
+/* AWS docs restyle: left sidebar + right rail (owned by Minion B) */
+
+[data-md-color-scheme="default"] {
+ --aws-nav-text: #0f141a;
+ --aws-nav-secondary-text: #424650;
+ --aws-nav-muted-text: #656871;
+ --aws-nav-link: #006ce0;
+ --aws-nav-divider: #ebebf0;
+}
+
+[data-md-color-scheme="slate"] {
+ --aws-nav-text: #f2f3f3;
+ --aws-nav-secondary-text: #d5dbdb;
+ --aws-nav-muted-text: #aab7b8;
+ --aws-nav-link: #42b4ff;
+ --aws-nav-divider: #424650;
+}
+
+/* --------------------------------------------------------------------------
+ * Left sidebar: AWS Developer Guide style navigation
+ * ------------------------------------------------------------------------ */
+
+.md-sidebar--primary .md-sidebar__scrollwrap,
+.md-sidebar--secondary .md-sidebar__scrollwrap {
+ -ms-overflow-style: none;
+ scrollbar-width: none;
+}
+
+.md-sidebar {
+ padding-top: 0;
+}
+
+.md-sidebar--primary .md-sidebar__scrollwrap::-webkit-scrollbar,
+.md-sidebar--secondary .md-sidebar__scrollwrap::-webkit-scrollbar {
+ display: none;
+}
+
+.aws-nav-collapse,
+.aws-nav-reopen {
+ display: none;
+}
+
+@media screen and (min-width: 76.25em) {
+ .md-sidebar--primary {
+ min-height: calc(100vh - var(--md-header-height, 2.4rem));
+ position: sticky;
+ }
+
+ .md-sidebar--primary::after {
+ background-color: #c6c6cd;
+ bottom: 0;
+ content: "";
+ pointer-events: none;
+ position: absolute;
+ right: 0;
+ top: 0;
+ width: 1px;
+ z-index: 1;
+ }
+
+ [data-md-color-scheme="slate"] .md-sidebar--primary::after {
+ background-color: var(--aws-nav-divider);
+ }
+
+ .md-sidebar--primary .md-sidebar__scrollwrap {
+ position: relative;
+ }
+
+ .md-sidebar--primary .md-sidebar__scrollwrap::before {
+ color: var(--aws-nav-text);
+ content: "Powertools for AWS Lambda (TypeScript)";
+ display: block;
+ font-size: 16px;
+ font-weight: 700;
+ line-height: 1.25;
+ margin: 0 0.6rem 0 0;
+ padding: 0.2rem 2.1rem 0.15rem 36px;
+ }
+
+ .md-sidebar--primary .md-sidebar__inner::before {
+ border-bottom: 1px solid var(--aws-nav-divider);
+ color: var(--aws-nav-muted-text);
+ content: "Developer Guide";
+ display: block;
+ font-size: 12px;
+ font-weight: 400;
+ line-height: 1.35;
+ margin: 0 0.6rem 0.55rem 0;
+ padding: 0 0 0.75rem 36px;
+ }
+
+ .md-sidebar--primary .md-nav--primary > .md-nav__title {
+ display: none;
+ }
+
+ .aws-nav-collapse {
+ align-items: center;
+ background: transparent;
+ border: 0;
+ border-radius: 4px;
+ color: #424650;
+ cursor: pointer;
+ display: inline-flex;
+ height: 28px;
+ justify-content: center;
+ padding: 0;
+ width: 28px;
+ z-index: 5;
+ }
+
+ .aws-nav-collapse:hover,
+ .aws-nav-collapse:focus {
+ color: #006ce0;
+ }
+
+ .aws-nav-collapse:focus-visible {
+ outline: 2px solid #006ce0;
+ outline-offset: 2px;
+ }
+
+ .aws-nav-collapse svg {
+ display: block;
+ height: 16px;
+ width: 16px;
+ }
+
+ .aws-nav-collapse {
+ position: absolute;
+ right: 0.2rem;
+ top: 0.05rem;
+ }
+
+ .aws-nav-reopen {
+ align-items: center;
+ background: #161d26;
+ border: 0;
+ border-radius: 50%;
+ color: #fff;
+ cursor: pointer;
+ display: none;
+ height: 40px;
+ justify-content: center;
+ left: var(
+ --aws-nav-reopen-left,
+ calc((100vw - min(100vw, 72rem)) / 2 + 0.6rem)
+ );
+ padding: 0;
+ position: fixed;
+ top: var(--aws-nav-reopen-top, calc(var(--md-header-height, 2.4rem) + 0.6rem));
+ width: 40px;
+ z-index: 8;
+ }
+
+ .aws-nav-reopen:hover,
+ .aws-nav-reopen:focus {
+ background: #253142;
+ }
+
+ .aws-nav-reopen:focus-visible {
+ outline: 3px solid #0972d3;
+ outline-offset: 3px;
+ }
+
+ .aws-nav-reopen svg {
+ display: block;
+ height: 20px;
+ width: 20px;
+ }
+
+ .aws-nav-collapsed .md-sidebar--primary {
+ display: none;
+ }
+
+ .aws-nav-collapsed .md-main__inner {
+ padding-left: 2.4rem;
+ position: relative;
+ }
+
+ .aws-nav-collapsed .aws-nav-reopen {
+ display: inline-flex;
+ }
+}
+
+.md-sidebar--primary .md-nav--primary,
+.md-sidebar--primary .md-nav--primary .md-nav {
+ --aws-nav-caret-gap: 6px;
+ --aws-nav-caret-size: 14px;
+ --aws-nav-indent-step: 16px;
+ --aws-nav-label-indent: 24px;
+ --aws-nav-structural-indent: 12px;
+ font-size: 14px;
+}
+
+.md-sidebar--primary .md-nav--primary .md-nav[data-md-level="1"] {
+ --aws-nav-label-indent: calc(
+ 24px + var(--aws-nav-indent-step) - var(--aws-nav-structural-indent)
+ );
+}
+
+.md-sidebar--primary .md-nav--primary .md-nav[data-md-level="2"] {
+ --aws-nav-label-indent: calc(
+ 24px + var(--aws-nav-indent-step) - var(--aws-nav-structural-indent) +
+ var(--aws-nav-indent-step) - var(--aws-nav-structural-indent)
+ );
+}
+
+.md-sidebar--primary .md-nav--primary .md-nav[data-md-level="3"] {
+ --aws-nav-label-indent: calc(
+ 24px + var(--aws-nav-indent-step) - var(--aws-nav-structural-indent) +
+ var(--aws-nav-indent-step) - var(--aws-nav-structural-indent) +
+ var(--aws-nav-indent-step) - var(--aws-nav-structural-indent)
+ );
+}
+
+.md-sidebar--primary .md-nav--primary .md-nav__link {
+ color: var(--aws-nav-text);
+ font-size: 14px;
+ line-height: 1.4;
+ margin-top: 0;
+ min-height: 0;
+ padding-bottom: 0.35rem;
+ padding-left: var(--aws-nav-label-indent);
+ padding-top: 0.35rem;
+ position: relative;
+ text-decoration: none;
+ text-transform: none;
+}
+
+.md-sidebar--primary .md-nav--primary .md-nav__item {
+ margin: 0;
+}
+
+.md-sidebar--primary
+ .md-nav--primary
+ .md-nav__item--nested
+ > .md-nav__link,
+.md-sidebar--primary
+ .md-nav--primary
+ .md-nav__item--nested
+ > .md-nav__container
+ > .md-nav__link {
+ align-items: center;
+ display: flex;
+ font-weight: 400;
+}
+
+.md-sidebar--primary
+ .md-nav--primary
+ .md-nav__item--nested
+ > .md-nav__container {
+ align-items: center;
+ display: flex;
+ padding-left: var(--aws-nav-label-indent);
+ position: relative;
+}
+
+.md-sidebar--primary
+ .md-nav--primary
+ .md-nav__item--nested
+ > .md-nav__container
+ > a.md-nav__link {
+ flex: 1 1 auto;
+ padding-left: 0;
+}
+
+.md-sidebar--primary
+ .md-nav--primary
+ .md-nav__item--nested
+ > .md-nav__container
+ > label.md-nav__link {
+ bottom: 0;
+ flex: 0 0 auto;
+ left: calc(
+ var(--aws-nav-label-indent) - var(--aws-nav-caret-size) -
+ var(--aws-nav-caret-gap)
+ );
+ order: -1;
+ padding-left: 0;
+ padding-right: 0;
+ position: absolute;
+ top: 0;
+ width: var(--aws-nav-caret-size);
+}
+
+.md-sidebar--primary
+ .md-nav--primary
+ .md-nav__item--nested
+ > .md-nav__container
+ > label.md-nav__link
+ .md-nav__icon {
+ left: 0;
+}
+
+.md-sidebar--primary .md-nav--primary .md-nav__container {
+ padding-bottom: 0;
+ padding-top: 0;
+}
+
+.md-sidebar--primary .md-nav--primary .md-nav__link:hover,
+.md-sidebar--primary .md-nav--primary .md-nav__link:focus {
+ color: var(--aws-nav-link);
+ text-decoration: underline;
+ text-decoration-thickness: 1px;
+ text-underline-offset: 0.25em;
+}
+
+.md-sidebar--primary .md-nav--primary .md-nav__link--active,
+.md-sidebar--primary .md-nav--primary .md-nav__link--active code {
+ color: var(--aws-nav-link);
+ font-weight: 700;
+}
+
+.md-sidebar--primary
+ .md-nav--primary
+ .md-nav__link:not([for="__toc"])
+ .md-nav__icon {
+ align-self: center;
+ background-color: transparent;
+ border-radius: 0;
+ flex: 0 0 var(--aws-nav-caret-size);
+ height: var(--aws-nav-caret-size);
+ left: calc(
+ var(--aws-nav-label-indent) - var(--aws-nav-caret-size) -
+ var(--aws-nav-caret-gap)
+ );
+ margin-left: 0;
+ margin-right: 0;
+ order: -1;
+ position: absolute;
+ width: var(--aws-nav-caret-size);
+}
+
+.md-sidebar--primary
+ .md-nav--primary
+ .md-nav__link:not([for="__toc"])
+ .md-nav__icon:hover {
+ background-color: transparent;
+}
+
+.md-sidebar--primary
+ .md-nav--primary
+ .md-nav__link:not([for="__toc"])
+ .md-nav__icon::after {
+ background-color: #424650;
+ border-radius: 0;
+ display: block;
+ height: var(--aws-nav-caret-size);
+ -webkit-mask-image: url('data:image/svg+xml;charset=utf-8,