publish: the public projection begins here

This is a projection, not a development branch. The tree above was constructed
from the internal source named below under a manifest that decides which paths
may leave, then scanned as a whole tree rather than as a series of patches, and
only then published.

Public history starts here because the history before it was not admissible,
and neither was the tree. What used to stand in this repository included a
rescue copy of another machine, a directory of phone handoffs, deployment
wired to one house, and a submodule pointing at a forge no stranger can reach.
None of that was ever the product. It stays in the private forge, which is
allowed to hold the whole working organism, and this is what was deliberately
sent out instead.

Three mechanisms produced this tree, in decreasing order of trust. A top-level
path the manifest does not name never arrives at all, which is the one that
catches directories nobody has thought of yet. Named internal files inside
admitted roots are dropped. A short, reviewed table replaces deployment
defaults that a public build must not carry -- an endpoint aimed at one LAN, a
VPN profile belonging to one phone, packaging built from one checkout path.

Everything after this commit is an ordinary publication with the same three
trailers, so a force push stops being routine and starts meaning that
something deliberate happened. The trailers bind the projection to its source
without pretending the public SHA is the private one: same lineage, different
tree, and the record says so.

Source-Sha: 8f27b1e76a8fef560a336aba18e6990713ff1047
Policy-Sha: 6b261d2f3e6e1fb19874846ba4bb1dfe15565d25b8618c1c1afba0419c101d27
Tree-Digest: 18ec3563c5e5ef9a414993a9f6734b251ff9ed3cd56eebdd6cac01e45c6e3067

surfaces/quickshell/modules/common/widgets/ContentPage.qml

@@ -0,0 +1,43 @@
+import QtQuick
+import QtQuick.Layouts
+import qs.modules.common
+import qs.modules.common.widgets
+
+// Souveraine: responsive variant of ii's ContentPage. Upstream clamps the
+// content column to baseWidth (600) and centers it — fine on a desktop
+// window, but on a narrow/touch surface it clips both edges and stretches a
+// huge gap into every row. Here, when the page is narrower than 650px the
+// column is anchored left+right with fixed margins, so it tracks the live
+// page width (reacts to fullscreen/resize) and nothing clips. Desktop
+// windows (>=650px) keep upstream's clamp-and-center behavior.
+StyledFlickable {
+    id: root
+    property real baseWidth: 600
+    property bool forceWidth: false
+    property real bottomContentPadding: 100
+    readonly property bool narrow: root.width < 650
+    readonly property real sideMargin: 20
+
+    default property alias contentData: contentColumn.data
+
+    clip: true
+    contentHeight: contentColumn.implicitHeight + root.bottomContentPadding
+    implicitWidth: contentColumn.implicitWidth
+
+    ColumnLayout {
+        id: contentColumn
+        spacing: 30
+        // Narrow: anchor to both edges so the column IS the page width minus
+        // symmetric margins — tracks resize, no clipping, no centered-overflow.
+        // Wide: fixed width, centered (upstream behavior).
+        anchors {
+            top: parent.top
+            margins: root.sideMargin
+            horizontalCenter: root.narrow ? undefined : parent.horizontalCenter
+            left: root.narrow ? parent.left : undefined
+            right: root.narrow ? parent.right : undefined
+        }
+        width: root.narrow ? (root.width - root.sideMargin * 2)
+            : (root.forceWidth ? root.baseWidth : Math.max(root.baseWidth, implicitWidth))
+    }
+}

surfaces/quickshell/modules/common/widgets/FloatingActionButton.qml

@@ -0,0 +1,78 @@
+import QtQuick
+import QtQuick.Layouts
+import qs.modules.common
+import qs.modules.common.widgets
+
+/**
+ * Material 3 FAB.
+ *
+ * Souveraine override of ii's widget: the label inside the collapsed Revealer
+ * centers on the button instead of the Revealer (see the comment at
+ * buttonText), breaking the implicitHeight binding loop upstream logs on every
+ * startup. Everything else is verbatim ii — diff against ii-base before
+ * re-applying if ii updates.
+ */
+RippleButton {
+    id: root
+    property string iconText: "add"
+    property bool expanded: false
+    property real baseSize: 56
+    property real elementSpacing: 5
+    implicitWidth: expanded ? (Math.max(contentRowLayout.implicitWidth + 10 * 2, baseSize)) : baseSize
+    implicitHeight: baseSize
+    buttonRadius: baseSize / 14 * 4
+    colBackground: Appearance.colors.colPrimaryContainer
+    colBackgroundHover: Appearance.colors.colPrimaryContainerHover
+    colRipple: Appearance.colors.colPrimaryContainerActive
+    property color colOnBackground: Appearance.colors.colOnPrimaryContainer
+    contentItem: Row {
+        id: contentRowLayout
+        property real horizontalMargins: (root.baseSize - icon.width) / 2
+        anchors {
+            verticalCenter: parent?.verticalCenter
+            left: parent?.left
+            leftMargin: contentRowLayout.horizontalMargins
+        }
+        spacing: 0
+
+        MaterialSymbol {
+            id: icon
+            anchors.verticalCenter: parent.verticalCenter
+            horizontalAlignment: Text.AlignHCenter
+            verticalAlignment: Text.AlignVCenter
+            iconSize: 26
+            color: root.colOnBackground
+            text: root.iconText
+        }
+        Loader {
+            anchors.verticalCenter: parent.verticalCenter
+            visible: root.buttonText?.length > 0
+            active: true
+            sourceComponent: Revealer {
+                visible: root.expanded || implicitWidth > 0
+                reveal: root.expanded
+                implicitWidth: reveal ? (buttonText.implicitWidth + root.elementSpacing + contentRowLayout.horizontalMargins) : 0
+                StyledText {
+                    id: buttonText
+                    anchors {
+                        left: parent.left
+                        leftMargin: root.elementSpacing
+                        // Center on the BUTTON, not the Revealer (2026-08-05).
+                        // Centering on the Revealer bound the text's y to the
+                        // Revealer's height, whose implicitHeight is
+                        // childrenRect.height, which depends on the text's
+                        // y — the implicitHeight binding loop logged on every
+                        // startup (FloatingActionButton.qml[45:30]). The
+                        // Revealer and the button share a center anyway, so
+                        // this is visually identical and acyclic.
+                        verticalCenter: root.verticalCenter
+                    }
+                    text: root.buttonText
+                    color: Appearance.colors.colOnPrimaryContainer
+                    font.pixelSize: 14
+                    font.weight: 450
+                }
+            }
+        }
+    }
+}

surfaces/quickshell/modules/common/widgets/FullscreenPolkitWindow.qml

@@ -0,0 +1,94 @@
+// Souveraine override of ii's FullscreenPolkitWindow.
+//
+// One change: on a phone the prompt takes keyboard focus exclusively.
+//
+// Upstream uses WlrKeyboardFocus.OnDemand, which is right for a desktop —
+// the prompt is one surface among many and focus follows the pointer. On the
+// phone it made the password field untypable in a way that looked like a
+// keyboard bug and wasn't. Verified live 2026-07-26: the on-screen keyboard
+// rose with the prompt and its keys went nowhere.
+//
+// The chain: squeekboard delivers keystrokes through the input-method
+// protocol to whatever surface holds keyboard focus, and Qt only activates a
+// text-input context on a surface that HAS that focus. With OnDemand a
+// layer-shell surface is granted focus by a click — but the field the user
+// needs to click is inside the very surface that has no context yet, and
+// there is no pointer on a phone to hover one into existence. Nothing ever
+// activated, so the keys had no destination.
+//
+// Exclusive is also simply what this surface is: a modal authorization
+// prompt on the Overlay layer, the same posture the lock surface takes. Esc
+// and the cancel button both still dismiss it (see PolkitContent), so the
+// grab is not a trap.
+//
+// Desktop keeps OnDemand — there is a hardware keyboard there and no reason
+// to change a working path.
+pragma ComponentBehavior: Bound
+import qs
+import qs.services
+import qs.modules.common
+import qs.modules.common.widgets
+import qs.modules.common.functions
+import QtQuick
+import Quickshell
+import Quickshell.Wayland
+
+Scope {
+    id: root
+    required property Component contentComponent
+
+    readonly property bool phone: Config.options?.souveraine?.phone ?? false
+
+    Loader {
+        active: PolkitService.active
+        sourceComponent: Variants {
+            model: Quickshell.screens
+            delegate: PanelWindow {
+                id: panelWindow
+                required property var modelData
+                screen: modelData
+
+                // Do not cover the on-screen keyboard. squeekboard is a
+                // layer-shell surface on `top`; this prompt is on `overlay`,
+                // so a full-screen prompt sits above it. The dialog is
+                // transparent, which made that look survivable — the keyboard
+                // was plainly visible through it — but this surface owned the
+                // whole screen's input region, so every tap in the bottom
+                // third landed on the dialog and the keys never saw a touch.
+                // Visible and inert, exactly as reported.
+                //
+                // Measured on device: osk is 0 732 540 348 on a 540x1080
+                // panel, so the keyboard is the bottom ~32%. While it is up,
+                // stop anchoring the bottom edge and end the surface above it.
+                readonly property bool yieldToOsk: root.phone && GlobalStates.oskOpen
+
+                anchors {
+                    top: true
+                    left: true
+                    right: true
+                    bottom: !panelWindow.yieldToOsk
+                }
+                // Only consulted when the bottom anchor is released.
+                implicitHeight: panelWindow.yieldToOsk
+                    ? Math.round((panelWindow.screen?.height ?? 1080) * 0.65)
+                    : 0
+
+                color: "transparent"
+                WlrLayershell.namespace: "quickshell:polkit"
+                // Exclusive was tried on 2026-07-26 and made it worse: with an
+                // exclusive layer grab the on-screen keyboard stopped taking
+                // touch at all — keys did not even highlight. OnDemand is what
+                // the working text fields elsewhere in this shell use, and
+                // squeekboard follows them fine.
+                WlrLayershell.keyboardFocus: WlrKeyboardFocus.OnDemand
+                WlrLayershell.layer: WlrLayer.Overlay
+                exclusionMode: ExclusionMode.Ignore
+
+                Loader {
+                    anchors.fill: parent
+                    sourceComponent: root.contentComponent
+                }
+            }
+        }
+    }
+}

surfaces/quickshell/modules/common/widgets/StyledToolTip.qml

@@ -0,0 +1,41 @@
+import qs.modules.common
+import qs.modules.common.widgets
+import QtQuick
+import QtQuick.Controls
+import QtQuick.Layouts
+
+// Souveraine: tooltip-trigger fix. Upstream treated a parent with no
+// `hovered` property (parent.hovered === undefined) as "always show" — so any
+// StyledToolTip attached to a non-hoverable parent (e.g. ConfigSpinBox, a
+// RowLayout) was permanently visible. That's latent on desktop and broken on
+// touch. Now: a tooltip only shows on a real positive hover (hoverable parent
+// actually hovered) or the explicit alternativeVisibleCondition. Non-hoverable
+// parents default off.
+ToolTip {
+    id: root
+    property bool extraVisibleCondition: true
+    property bool alternativeVisibleCondition: false
+
+    readonly property bool internalVisibleCondition: (extraVisibleCondition && (parent?.hovered ?? false)) || alternativeVisibleCondition
+    verticalPadding: 5
+    horizontalPadding: 10
+    background: null
+    font {
+        family: Appearance.font.family.main
+        variableAxes: Appearance.font.variableAxes.main
+        pixelSize: Appearance?.font.pixelSize.smaller ?? 14
+        hintingPreference: Font.PreferNoHinting // Prevent shaky text
+    }
+
+    delay: 0
+    visible: internalVisibleCondition
+
+    contentItem: StyledToolTipContent {
+        id: contentItem
+        font: root.font
+        text: root.text
+        shown: root.internalVisibleCondition
+        horizontalPadding: root.horizontalPadding
+        verticalPadding: root.verticalPadding
+    }
+}

surfaces/quickshell/modules/common/widgets/qmldir

@@ -0,0 +1,111 @@
+AddressBar 1.0 AddressBar.qml
+AddressBreadcrumb 1.0 AddressBreadcrumb.qml
+ButtonGroup 1.0 ButtonGroup.qml
+CalendarView 1.0 CalendarView.qml
+Circle 1.0 Circle.qml
+CircularProgress 1.0 CircularProgress.qml
+CliphistImage 1.0 CliphistImage.qml
+ClippedFilledCircularProgress 1.0 ClippedFilledCircularProgress.qml
+ClippedProgressBar 1.0 ClippedProgressBar.qml
+ConfigRow 1.0 ConfigRow.qml
+ConfigSelectionArray 1.0 ConfigSelectionArray.qml
+ConfigSlider 1.0 ConfigSlider.qml
+ConfigSpinBox 1.0 ConfigSpinBox.qml
+ConfigSwitch 1.0 ConfigSwitch.qml
+ContentPage 1.0 ContentPage.qml
+ContentSection 1.0 ContentSection.qml
+ContentSubsection 1.0 ContentSubsection.qml
+ContentSubsectionLabel 1.0 ContentSubsectionLabel.qml
+CustomIcon 1.0 CustomIcon.qml
+DashedBorder 1.0 DashedBorder.qml
+DialogButton 1.0 DialogButton.qml
+DialogListItem 1.0 DialogListItem.qml
+DirectoryIcon 1.0 DirectoryIcon.qml
+DragManager 1.0 DragManager.qml
+ErrorShakeAnimation 1.0 ErrorShakeAnimation.qml
+FadeLoader 1.0 FadeLoader.qml
+Favicon 1.0 Favicon.qml
+FloatingActionButton 1.0 FloatingActionButton.qml
+FlowButtonGroup 1.0 FlowButtonGroup.qml
+FocusedScrollMouseArea 1.0 FocusedScrollMouseArea.qml
+FullscreenPolkitWindow 1.0 FullscreenPolkitWindow.qml
+Graph 1.0 Graph.qml
+GroupButton 1.0 GroupButton.qml
+IconAndTextToolbarButton 1.0 IconAndTextToolbarButton.qml
+IconToolbarButton 1.0 IconToolbarButton.qml
+KeyboardKey 1.0 KeyboardKey.qml
+LightDarkPreferenceButton 1.0 LightDarkPreferenceButton.qml
+MaskMultiEffect 1.0 MaskMultiEffect.qml
+MaterialCookie 1.0 MaterialCookie.qml
+MaterialLoadingIndicator 1.0 MaterialLoadingIndicator.qml
+MaterialShape 1.0 MaterialShape.qml
+MaterialShapeWrappedMaterialSymbol 1.0 MaterialShapeWrappedMaterialSymbol.qml
+MaterialSymbol 1.0 MaterialSymbol.qml
+MaterialTextArea 1.0 MaterialTextArea.qml
+MaterialTextField 1.0 MaterialTextField.qml
+MenuButton 1.0 MenuButton.qml
+NavigationRail 1.0 NavigationRail.qml
+NavigationRailButton 1.0 NavigationRailButton.qml
+NavigationRailExpandButton 1.0 NavigationRailExpandButton.qml
+NavigationRailTabArray 1.0 NavigationRailTabArray.qml
+NoticeBox 1.0 NoticeBox.qml
+NotificationActionButton 1.0 NotificationActionButton.qml
+NotificationAppIcon 1.0 NotificationAppIcon.qml
+NotificationGroup 1.0 NotificationGroup.qml
+NotificationGroupExpandButton 1.0 NotificationGroupExpandButton.qml
+NotificationItem 1.0 NotificationItem.qml
+NotificationListView 1.0 NotificationListView.qml
+OptionalMaterialSymbol 1.0 OptionalMaterialSymbol.qml
+PagePlaceholder 1.0 PagePlaceholder.qml
+PointingHandInteraction 1.0 PointingHandInteraction.qml
+PointingHandLinkHover 1.0 PointingHandLinkHover.qml
+PopupToolTip 1.0 PopupToolTip.qml
+Revealer 1.0 Revealer.qml
+RippleButton 1.0 RippleButton.qml
+RippleButtonWithIcon 1.0 RippleButtonWithIcon.qml
+RoundCorner 1.0 RoundCorner.qml
+ScrollEdgeFade 1.0 ScrollEdgeFade.qml
+SecondaryTabBar 1.0 SecondaryTabBar.qml
+SecondaryTabButton 1.0 SecondaryTabButton.qml
+SelectionDialog 1.0 SelectionDialog.qml
+SelectionGroupButton 1.0 SelectionGroupButton.qml
+SineCookie 1.0 SineCookie.qml
+SqueezedAnnotationStyledText 1.0 SqueezedAnnotationStyledText.qml
+StyledBlurEffect 1.0 StyledBlurEffect.qml
+StyledComboBox 1.0 StyledComboBox.qml
+StyledDropShadow 1.0 StyledDropShadow.qml
+StyledFlickable 1.0 StyledFlickable.qml
+StyledImage 1.0 StyledImage.qml
+StyledIndeterminateProgressBar 1.0 StyledIndeterminateProgressBar.qml
+StyledListView 1.0 StyledListView.qml
+StyledProgressBar 1.0 StyledProgressBar.qml
+StyledRadioButton 1.0 StyledRadioButton.qml
+StyledRectangularShadow 1.0 StyledRectangularShadow.qml
+StyledScrollBar 1.0 StyledScrollBar.qml
+StyledSlider 1.0 StyledSlider.qml
+StyledSpinBox 1.0 StyledSpinBox.qml
+StyledSwitch 1.0 StyledSwitch.qml
+StyledText 1.0 StyledText.qml
+StyledTextArea 1.0 StyledTextArea.qml
+StyledTextInput 1.0 StyledTextInput.qml
+StyledToolTip 1.0 StyledToolTip.qml
+StyledToolTipContent 1.0 StyledToolTipContent.qml
+ThumbnailImage 1.0 ThumbnailImage.qml
+Toolbar 1.0 Toolbar.qml
+ToolbarButton 1.0 ToolbarButton.qml
+ToolbarPairedFab 1.0 ToolbarPairedFab.qml
+ToolbarTabBar 1.0 ToolbarTabBar.qml
+ToolbarTabButton 1.0 ToolbarTabButton.qml
+ToolbarTextField 1.0 ToolbarTextField.qml
+VerticalButtonGroup 1.0 VerticalButtonGroup.qml
+VibrantToolbarButton 1.0 VibrantToolbarButton.qml
+WaveVisualizer 1.0 WaveVisualizer.qml
+WavyLine 1.0 WavyLine.qml
+WeekRow 1.0 WeekRow.qml
+WindowDialog 1.0 WindowDialog.qml
+WindowDialogButtonRow 1.0 WindowDialogButtonRow.qml
+WindowDialogParagraph 1.0 WindowDialogParagraph.qml
+WindowDialogSectionHeader 1.0 WindowDialogSectionHeader.qml
+WindowDialogSeparator 1.0 WindowDialogSeparator.qml
+WindowDialogSlider 1.0 WindowDialogSlider.qml
+WindowDialogTitle 1.0 WindowDialogTitle.qml