feat(widget): add restriction callback to restrict visibility and modification of widget kinds

[Meierschlumpf]

Homarr

Thank you for your contribution. Please ensure that your pull request meets the following pull request:

• Builds without warnings or errors (pnpm build, autofix with pnpm format:fix)
• Pull request targets dev branch
• Commits follow the conventional commits guideline
• No shorthand variable names are used (eg. x, y, i or any abbrevation)

Example usage:

export const { definition, componentLoader } = createWidgetDefinition("dockerContainers", {
	...otherProps,
	restrict({ user }) {
    	return user?.permissions.includes("admin") ? "none" : "all";
  	},
}).withDynamicImport(() => import("./component"));

Available restriction levels:

• none: The widget is fully available to the user.
• select: The widget is available to the user but not in the widget picker.
• all: The widget is not available to the user. As replacement a message will be shown at the widgets position.

Widgets when restricted:

Part of #2288

[deepsource-io]

Here's the code health analysis summary for commits 7aa5d2f..ff0846d. View details on DeepSource ↗.

Analysis Summary

Analyzer	Status	Summary	Link
JavaScript	✅ Success		View Check ↗

---

💡 If you’re a repository administrator, you can configure the quality gates from the settings.

[github-actions]

Coverage Report

Status	Category	Percentage	Covered / Total
🔵	Lines	22.79%	10298 / 45178
🔵	Statements	22.79%	10298 / 45178
🔵	Functions	30.02%	432 / 1439
🔵	Branches	64.82%	1244 / 1919

File Coverage

File	Stmts	Branches	Functions	Lines	Uncovered Lines
Changed Files
apps/nextjs/src/components/board/items/item-content.tsx	0%	0%	0%	0%	1-134
apps/nextjs/src/components/board/items/item-menu.tsx	0%	0%	0%	0%	1-139
apps/nextjs/src/components/board/items/item-select-modal.tsx	0%	0%	0%	0%	1-117
apps/nextjs/src/components/board/items/restricted.tsx	0%	0%	0%	0%	1-28
packages/api/src/router/board.ts	64.13%	81.25%	70%	64.13%	53-61, 64-71, 77-102, 178-247, 297-515, 534-538, 551-553, 556-558, 566, 770-780, 869-970, 978-979, 1034-1049, 1123, 1142, 1153-1168, 1173-1174, 1196-1211, 1216-1217, 1236-1238, 1263-1265, 1356-1357, 1381-1382, 1486-1490, 1547-1548, 1556-1557
packages/api/src/router/import/import-router.ts	71.87%	100%	100%	71.87%	18, 29-34, 40-41
packages/auth/permissions/index.ts	100%	100%	100%	100%
packages/auth/permissions/widget-restriction.ts	83.33%	50%	100%	83.33%	12
packages/old-import/src/index.ts	22.22%	100%	0%	22.22%	9-15
packages/old-import/src/import/import-initial-oldmarr.ts	5.4%	100%	0%	5.4%	18-58
packages/old-import/src/import/import-single-oldmarr.ts	6.45%	100%	0%	6.45%	13-44
packages/old-import/src/import/collections/board-collection.ts	2.04%	100%	0%	2.04%	21-132
packages/widgets/src/definition.ts	100%	100%	100%	100%

Generated in workflow #5692 for commit ff0846d by the Vitest Coverage Report Action