https://github.com/lazerbeak12345/flow-extras
An experimental collection of widgets for the Minetest Flow formspec replacement
https://github.com/lazerbeak12345/flow-extras
formspec lua minetest-mod widgets
Last synced: about 1 month ago
JSON representation
An experimental collection of widgets for the Minetest Flow formspec replacement
- Host: GitHub
- URL: https://github.com/lazerbeak12345/flow-extras
- Owner: Lazerbeak12345
- License: mit
- Created: 2023-06-24T04:46:02.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2024-08-17T21:10:09.000Z (over 1 year ago)
- Last Synced: 2025-10-31T00:49:26.654Z (5 months ago)
- Topics: formspec, lua, minetest-mod, widgets
- Language: Lua
- Homepage:
- Size: 1.31 MB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Flow Extras
[](https://content.minetest.net/packages/lazerbeak12345/flow_extras/)
[](https://forum.minetest.net/viewtopic.php?t=29766)
[](https://github.com/Lazerbeak12345/flow-extras/actions/workflows/busted.yml)
[](https://github.com/Lazerbeak12345/flow-extras/actions/workflows/luacheck.yml)
[](https://coveralls.io/github/Lazerbeak12345/flow-extras?branch=master)
[](https://semver.org)
An experimental collection of extra widgets for [flow].
> Not officially associated with flow
[flow]: https://github.com/luk3yx/minetest-flow
## Docs
### Widgets & tools
See the LuaCATS documentation in the code, with the busted unit tests for examples.
If your IDE supports LuaCATS (such as if it uses the `lua_ls` language server), then the documentation should show up in your IDE.
### Textures
- `flow_extras_list_bg.png` is the default background for all list slots rendered by `flow_extras.List`
- `flow_extras_list_inactive.png` is availiable for use in situations (like craft recepies) where you need a deactivated "List".
## Rules
I've seen a lot of libraries like Qt and GTK accumulate hundreds of widgets over the years. I'd like to slow that process down here.
> The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL
> NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and
> "OPTIONAL" in this document are to be interpreted as described in
> [RFC 2119](https://datatracker.ietf.org/doc/html/rfc2119).
1. Widgets MUST NOT require any specific game or mod, except for `flow` or `formspec_ast`.
2. Widgets SHOULD NOT be a part of Flow. If a widget is added to Flow after it has been included in Flow-Extras, this widget SHOULD be deprecated.
3. Widgets MUST fulfill an existing need, shown by at least two projects.
4. Widgets MUST be themable wherever reasonably possible using conventional methods.
5. Widgets SHOULD encourage the buisness logic to be seperate, and the form generation logic to be inline.
6. Widgets SHOULD maximise reuse through generalization.
7. Widgets MAY allow for children widgets using the standard convention set in Flow
8. Widgets MAY use widgets not yet supported by flow, provided that
1. it MUST use a "fake" form of the widget by default. However it MAY provide a way to use the unsupported widget
2. MUST document use of unsupported widgets
9. Widgets MAY use widgets not supported by older versions of the Minetest Client, provided this MUST be documented, and that the widget is supported by FS51 or simmilar libraries. If the widget is not supported by such a library, then the widget MUST follow reccomendations in rule 8.1
## TODO
- [ ] `Navabble`
- [ ] Accepts a table of callbacks, each returning window contents
- [ ] requires a name
- [ ] `FakeTabbar`
- [ ] A fake tabbar with identical API
- [ ] `Pagnator`
- [ ] A pagnator widget for use with `Navabble`
- [ ] Custom message text supported (with translation as well, ofc)
- [ ] Reactive Boxes
- [ ] reacts to width of client, if availiable.
- [ ] behave like breakpoints from the CSS library Bootstrap
- [ ] Each type of for loop as a map-like function
- [ ] `{Widget,table}[][] -> WidgetArgs[]`
- [ ] Integrate with `flow_inspector`
## Legal
### Code
See `./LICENSE`
### Media
#### Images
- `flow_extras_list_bg.png`: renamed from `gui_hb_bg.png`, a texture by BlockMen (CC BY-SA 3.0)