Skip to content

Delete the deprecated zero-caller useBranding hook - #5651

Merged
os-sales merged 1 commit into
mainfrom
claude/issue-5368-retire-usebranding
Aug 22, 2026
Merged

Delete the deprecated zero-caller useBranding hook#5651
os-sales merged 1 commit into
mainfrom
claude/issue-5368-retire-usebranding

Conversation

@os-sales

Copy link
Copy Markdown
Collaborator

Fixes#5368

apps/console/src/hooks/useBranding.ts was a @deprecated thin wrapper around
useAppShellBranding with no caller anywhere in the repository. The migration its own
deprecation note asked for had already happened — ConsoleLayout passes branding
straight to AppShell — and nothing was left behind to call the wrapper.

It was not free to keep. PR #5366 had to edit this file twice (the feed line and its
local AppBranding interface) purely to keep a file nobody calls compiling. That is the
recurring tax this removes.

Premise re-measured on the current tip

The card's zero-caller reading was taken on bdf8cf76e. Re-measured on aa3b81062
(this branch's merge-base), the file was still present, still @deprecated, and still
uncalled.

Caller sweep — fixed-string, whole repo, all file types, build outputs excluded:

grep -rnF 'useBranding' . --exclude-dir=node_modules --exclude-dir=.git \
--exclude-dir=dist --exclude-dir=build --exclude-dir=.next \
--exclude-dir=.turbo --exclude-dir=coverage

Two further sweeps for the module coordinate rather than the identifier:
grep -rnF 'hooks/useBranding' and grep -rnF 'useBranding.ts'.

Positive control. A zero count is only evidence when the pattern is proven able to
match, so absence was never concluded from a bare zero: the same command returned the
file's own declaration (useBranding.ts:19) and its doc comment (:2), plus the two
guide hits and three historical CHANGELOG lines. Seven hits, no importer among them —
not a silently-zeroed anchor.

The published-surface check, and a correction

The suggested disposition asked for one check before deleting: is any of this reachable
from outside? The check does not come back the way the framing assumed —
apps/consoleis a published package (@object-ui/console, publishConfig.access: public), not merely an application. The conclusion survives anyway, by a stronger route:

  • Its exports map has exactly one entry, ../plugin.js / ./plugin.d.ts. No
    subpath exports and no wildcard exports exist anywhere in the workspace.
  • plugin.js is compiled from tsconfig.plugin.json, whose include is ["plugin.ts"]
    — one file. plugin.ts imports nothing from src/ and never names the hook.
  • files is ["dist", "plugin.ts", "plugin.js", "plugin.d.ts", "README.md"], so src
    never enters the npm tarball at all.
  • With no importer in the repo, the hook was absent from the built SPA in dist too.

So the file was unreachable from any published entry point — but on the strength of the
exports map and files, not on the premise that the console is unpublished.

The guide edit is required, not cosmetic

useBranding was the only file in the console's hooks directory, so the directory goes
with it. skills/objectui/guides/console-development.md stated both coordinates in
backtick code spans, and scripts/check-skills-paths.mjs resolves exactly those spans
against disk. Leaving either would have turned that gate red — verified by observing the
directory disappear from the working tree the moment the file was removed.

The caveat sentence about the first row's differing prefix is dropped rather than
rewritten: with the row gone, every remaining hook lives in @object-ui/app-shell, so
the exception it existed to explain no longer exists.

Published skills surface — both readings, and both go down:

ReadingBeforeAfterNet
console-development.md (whole file)512510−2
Whole published package (18 .md under skills/)56765674−2

Changeset

Empty frontmatter. apps/console is in the changeset fixed group, so this deletion is
a guarded-source change and check-changeset-presence.mjs demands a declaration — but
nothing published changes, and the gate's empty-frontmatter exemption is the accurate
answer rather than a release.

Verification

Run on the final commit; exit codes captured before any pipe, and each verdict quoted
from the gate's own line.

CheckResult
check-skills-paths✅ OK (93/94 stated path(s) resolve across 18 guide file(s); 1 baselined)
check-changeset-presence✅ 1 source file(s) of 1 released package(s) changed … EMPTY frontmatter
check-changeset-fixed✅ All workspace packages are in the changeset fixed group.
check-changeset-no-major✅ No changeset declares a major bump.
check-control-bytes✅ OK (scanned 4695 tracked text file(s); skipped 85 binary)
check-lint-coverage✅ 46/46 packages linted, 0 with outstanding errors
check-type-check-coverage✅ 45/46 via type-check
check-package-self-import✅ No package names itself inside its own src/.
check-doc-linksexit 0
@object-ui/consoletype-checkexit 0 (dependency closure built first)
@object-ui/consolelintexit 0 — 201 warnings, all pre-existing no-explicit-any in files this diff does not touch
check-skills-paths + check-changeset-presence unit tests2 files, 62 tests passed

The type-check green was measured, not assumed. A green compile after deleting a file
only means something if it could have gone red, so the control got its own mutation leg:
an import { useBranding } from './hooks/useBranding' was appended to
apps/console/src/App.tsx, the injection confirmed on disk by grep count (0 → 1) rather
than by the editor's exit code, and the type-check then failed with
src/App.tsx(381,29): error TS2307: Cannot find module './hooks/useBranding' (exit 2).
The restore leg ran from a trap … EXIT INT TERM, and the tree was confirmed back to a
0 count and a clean git status before the final green was re-read.

The 67-file apps/console suite is not included above: it was started, exceeded the
foreground cap under concurrent load, and was reaped by its own timeout. It is declared
as a narrowing rather than reported as a pass. Nothing in it can reach the deleted module
— the sweep above found no importer in any file type — and CI runs the full farm.


Generated by Claude Code

`apps/console/src/hooks/useBranding.ts` was a `@deprecated` thin wrapper around
`useAppShellBranding`, with no caller anywhere in the repo. The migration its own
deprecation note asked for had already happened: `ConsoleLayout` passes `branding`
straight to `AppShell`, and nothing was left behind to call the wrapper.
It was not free to keep. PR #5366 had to edit this file twice — the feed line and
its local `AppBranding` interface — purely to keep a file nobody calls compiling.
The hook was the only file in the console's hooks directory, so the directory goes
with it. `skills/objectui/guides/console-development.md` stated both coordinates in
backtick code spans, which `scripts/check-skills-paths.mjs` resolves against disk;
both are updated, and the caveat about the first row's differing prefix is dropped
because every remaining hook now lives in `@object-ui/app-shell`.
Fixes#5368
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Eager closure (gzip, 52 chunks)3785.8 KB3867.2 KB
Main entry chunk (gzip)151.6 KB350 KB
Entry fileindex-CftgFQXz.js
StatusPASS

The eager closure is every chunk the entry reaches through static imports — what the browser fetches and parses before the app renders. The entry chunk on its own is a small fraction of it.


📦 Bundle Size Report

PackageSizeGzipped
app-shell (index.js)10.04KB3.72KB
app-shell (runtime-config.js)11.22KB3.78KB
app-shell (types.js)0.01KB0.04KB
app-shell (urlParams.js)10.06KB3.86KB
auth (AuthContext.js)0.31KB0.24KB
auth (AuthGuard.js)1.17KB0.53KB
auth (AuthProvider.js)29.34KB7.05KB
auth (AuthShell.js)3.49KB1.40KB
auth (ForgotPasswordForm.js)12.21KB3.45KB
auth (LoginForm.js)18.15KB5.39KB
auth (PreviewBanner.js)0.90KB0.50KB
auth (RegisterForm.js)6.65KB2.22KB
auth (SocialSignInButtons.js)9.61KB3.89KB
auth (UserMenu.js)3.41KB1.23KB
auth (auth-gate-events.js)1.29KB0.66KB
auth (authStyles.js)5.04KB1.72KB
auth (createAuthClient.js)40.21KB10.80KB
auth (createAuthenticatedFetch.js)6.35KB2.43KB
auth (index.js)2.77KB1.22KB
auth (invitation-status.js)1.22KB0.70KB
auth (org-roles.js)6.66KB2.78KB
auth (phone-identifier.js)1.11KB0.66KB
auth (types.js)0.59KB0.35KB
auth (useAuth.js)5.02KB0.89KB
auth (useIsWorkspaceAdmin.js)3.04KB1.45KB
collaboration (CommentThread.js)26.08KB7.56KB
collaboration (LiveCursors.js)3.17KB1.27KB
collaboration (PresenceAvatars.js)6.49KB2.64KB
collaboration (PresenceProvider.js)2.79KB1.13KB
collaboration (index.js)1.68KB0.73KB
collaboration (useCollaborationTranslation.js)6.05KB2.52KB
collaboration (useCommentSearch.js)1.98KB0.88KB
collaboration (useConflictResolution.js)7.75KB1.86KB
collaboration (useMentionNotifications.js)1.81KB0.68KB
collaboration (usePresence.js)6.33KB1.84KB
collaboration (useRealtimeSubscription.js)7.91KB2.01KB
components (index.js)507.00KB113.72KB
core (index.js)4.51KB1.80KB
create-plugin (index.js)10.08KB3.26KB
data-objectstack (index.js)159.80KB44.33KB
fields (index.js)238.85KB60.13KB
i18n (LocalizationContext.js)1.76KB0.96KB
i18n (currency.js)1.22KB0.64KB
i18n (i18n.js)4.28KB1.75KB
i18n (index.js)3.44KB1.39KB
i18n (pickLocalized.js)7.62KB3.26KB
i18n (provider.js)23.13KB7.63KB
i18n (useDisplayLocale.js)2.85KB1.45KB
i18n (useObjectLabel.js)33.40KB8.71KB
i18n (useSafeTranslation.js)7.77KB3.13KB
layout (index.js)38.95KB10.97KB
mobile (MobileProvider.js)0.92KB0.49KB
mobile (ResponsiveContainer.js)0.94KB0.38KB
mobile (breakpoints.js)1.51KB0.70KB
mobile (createOfflineDataSource.js)5.61KB1.75KB
mobile (index.js)1.55KB0.62KB
mobile (offlineQueue.js)3.91KB1.35KB
mobile (pwa.js)0.97KB0.49KB
mobile (serviceWorker.js)1.48KB0.62KB
mobile (serviceWorkerSource.js)3.41KB1.48KB
mobile (useBreakpoint.js)1.54KB0.65KB
mobile (useGesture.js)6.96KB1.98KB
mobile (useOfflineSync.js)1.99KB0.72KB
mobile (usePullToRefresh.js)2.53KB0.85KB
mobile (useResponsive.js)0.72KB0.42KB
mobile (useResponsiveConfig.js)1.37KB0.63KB
mobile (useSpecGesture.js)4.32KB1.64KB
mobile (useTouchTarget.js)1.01KB0.54KB
permissions (MePermissionsProvider.js)9.35KB3.31KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)4.42KB1.42KB
permissions (evaluator.js)5.12KB1.74KB
permissions (index.js)0.93KB0.41KB
permissions (store.js)0.91KB0.42KB
permissions (useFieldPermissions.js)1.28KB0.53KB
permissions (usePermissions.js)1.81KB0.83KB
plugin-ai (index.js)15.75KB3.80KB
plugin-calendar (index.js)46.62KB12.83KB
plugin-charts (index.js)64.65KB18.32KB
plugin-chatbot (index.js)181.41KB43.22KB
plugin-dashboard (index.js)128.33KB32.93KB
plugin-designer (index.js)212.30KB42.80KB
plugin-detail (index.js)242.16KB60.90KB
plugin-editor (index.js)2.46KB1.10KB
plugin-form (index.js)125.07KB30.43KB
plugin-gantt (index.js)164.10KB39.87KB
plugin-grid (index.js)200.79KB54.26KB
plugin-kanban (index.js)52.93KB14.60KB
plugin-list (index.js)111.70KB27.17KB
plugin-map (index.js)20.06KB6.62KB
plugin-markdown (index.js)13.72KB4.69KB
plugin-report (index.js)43.49KB11.93KB
plugin-timeline (index.js)26.68KB7.66KB
plugin-tree (index.js)8.50KB2.88KB
plugin-view (index.js)84.50KB20.68KB
providers (DataSourceProvider.js)0.75KB0.39KB
providers (MetadataProvider.js)1.37KB0.59KB
providers (ThemeProvider.js)1.90KB0.85KB
providers (UploadProvider.js)11.66KB3.50KB
providers (index.js)0.45KB0.23KB
providers (types.js)0.01KB0.04KB
react-runtime (index.js)5.62KB2.34KB
react (LazyPluginLoader.js)3.77KB1.33KB
react (SchemaRenderer.js)43.66KB14.77KB
react (data-invalidation.js)5.05KB2.08KB
react (index.js)1.33KB0.69KB
react (schema-input.js)2.32KB1.24KB
react (spec-input.js)0.20KB0.18KB
sdui-parser (codegen.js)5.41KB2.34KB
sdui-parser (index.js)4.77KB2.16KB
sdui-parser (input-type.js)2.84KB1.40KB
sdui-parser (parse.js)10.76KB3.17KB
sdui-parser (provenance.js)3.66KB1.82KB
sdui-parser (types.js)0.29KB0.24KB
sdui-parser (validate.js)6.92KB2.40KB
types (ai.js)0.20KB0.17KB
types (api-types.js)0.20KB0.18KB
types (app.js)2.87KB0.99KB
types (base.js)0.20KB0.18KB
types (blocks.js)0.20KB0.18KB
types (complex.js)0.20KB0.18KB
types (crud.js)0.20KB0.18KB
types (dashboard-filter-alias.js)6.23KB2.74KB
types (data-display.js)0.20KB0.18KB
types (data-protocol.js)0.20KB0.19KB
types (data.js)0.20KB0.18KB
types (designer.js)1.87KB0.85KB
types (disclosure.js)0.20KB0.18KB
types (error-code.js)1.54KB0.88KB
types (feedback.js)0.20KB0.18KB
types (field-types.js)0.20KB0.18KB
types (form.js)0.20KB0.18KB
types (http-retry.js)4.32KB2.02KB
types (index.js)3.08KB1.53KB
types (layout.js)0.20KB0.18KB
types (managed-by.js)0.19KB0.18KB
types (mobile.js)2.59KB1.31KB
types (navigation.js)0.20KB0.18KB
types (objectql.js)0.20KB0.18KB
types (overlay.js)0.20KB0.18KB
types (permissions.js)0.20KB0.18KB
types (plugin-scope.js)0.20KB0.18KB
types (record-components.js)0.20KB0.19KB
types (record-semantics.js)1.28KB0.67KB
types (registry.js)0.20KB0.18KB
types (reports.js)0.20KB0.18KB
types (spec-report.js)5.05KB1.93KB
types (system-fields.js)3.33KB1.54KB
types (theme.js)0.20KB0.18KB
types (ui-action.js)3.40KB1.71KB
types (views.js)0.20KB0.18KB
types (widget.js)0.20KB0.18KB

Size Limits

  • ✅ Core packages should be < 50KB gzipped
  • ✅ Component packages should be < 100KB gzipped
  • ⚠️ Plugin packages should be < 150KB gzipped

@os-sales
os-sales marked this pull request as ready for review August 22, 2026 01:09
@os-sales
os-sales added this pull request to the merge queueAug 22, 2026
Merged via the queue into main with commit 86d89d0Aug 22, 2026
23 checks passed
@os-sales
os-sales deleted the claude/issue-5368-retire-usebranding branch August 22, 2026 01:09
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

finding: apps/console/src/hooks/useBranding.ts is a deprecated hook with zero callers — dead file, not just a dead key

2 participants

@os-sales@claude