See git commit history for further change log entries.
This file is often not updated.
- Make fulcro apps more friendly when printed by accident.
- Fixed bug where
parent
didn't work in hooks
- Dynamic Routing improvements:
- Added ability to dynamically add targets to a router at runtime.
- Added cljs.loader support, so that code can be loaded before adding/routing to a target.
See
dr/add-route-target!
and dr/route-to!
for details. - Added
route-to!
helper for routing to a target by class instead of by path,
with support for resolution of ambiguities with the same target is in the UI
more than once. - Removed the requirement that a router have at least one (static) target, since
it is now possible to add targets dynamically, and you might want a completely
dynamic router. :router-targets is still required (but now allowed to be empty)
to help new users remember (and spellcheck) the option.
- Deprecated client dom/render-to-string, since it just called React directly, and
caused dependency weirdness. Much better to use the React API directly.
- Made registry-key->class ok with being passed a class
- Added workspaces data-view example that shows how to create a materialized
view in a case where the normalized data does not match the UI shape/needs.
- POSSIBLE BREAKING CHANGE: The low-level http remote no longer sends
a
:transaction
key to response middleware. That key was
renamed to :original-transaction
. The :transaction
key is
what middleware still uses to modify the transaction that will
be used in the merge layer. This will only affect you if you're using
custom client response middleware that modified things a the low level.
- Added restart logic to inspect-over-ws
- Cleaned up HTTP remote error reporting
- Minor clean-ups around Inspect.
- Added js annotations on items that were causing warnings.
- Re-release with accidental line deletion that affected Inspect fixed.
- Fixed data fetch to use transaction on merge instead of original query.
- Added metadata encoding for SSR state.
- Made initial mount syncrhonouse to be compatible with React Native.
- Added
:tempid->realid
to mutation env for ok/error actions.
- Fixed bug in dynamic routing due to missed timer cancels
- Improvements to dyn router/uism to work better from CLJ for SSR.
- Fixed indexing bug in dynamic routing. This was leading to missed refreshes.
- Reduced noisy warning
- Fixed bug in lazy expansion of children
- Changed tests to run against production react js
- Added try/catch at critical section of UISM, hoping to avoid user
handler from causing misbehaviors.
- Fixed order of mutation action processing so network results are in
targeted state position before ok/error actions are called.
- Added missing calls to
force-children
that affect bindings in
release builds.
- Added dev warning about bad react keys.
- Got rid of warning generated by form inputs.
- Made component warnings/errors only visible in dev mode.
- Fixed bug in explicit ref/component in transact with component.
- Fixed incorrect spec in tx processing
- Added back SSR initial state routines
- Fixed bug in fs/dirty-fields.
- Expanded dirty fields to not require the use of tempids.
- Fixed mutation-requested UI refresh
- Fixed dynamic router componentDidMount
- Added
app/initialize-state!
to set up state in headless mode. - Added option to
set-root!
to support an initialize-state?
option. - Made
:will-enter
optional on route targets - Added sanity checks in dynamic routing:
** Warn if will-enter returns an invalid ident
** Warn if will-enter fails to wrap ident in route-*
** Warn, on root mount, if any route targets have invalid route-segments
- Fixed deferred routing bug
- Add
app/set-root!
to allow many APIs to work before app/mount!
- Made routing possible before mount
- Added more warnings to routing, to help debug
- Fixed hot-code-reload issue. Component defonce was not being honored as metadata.
- Added ::uism/app to env in state machines
- Re-added function in dr that got dropped
- Dropped spy calls that were accidentally left in
- Minor bug fixes. Dropped accidental inclusions.
- Added React interop helpers for HOC
- Fixed some SSR issues: style elements don't corrupt CSS, fragments now work.
- Fixed a bug when setting recursive dynamic queries.
- Bug fix in dynamic router start code.
- Downgraded ghostwheel. This makes cljs builds bigger, but was necessary because
newer gw is still SNAPSHOT
- Cleaned up a number of functions that needed to not move forward.
- Removed legacy transit overrides in middleware. This means CLJS side will receive
tagged bigdecimals now instead of floats. This can still be done for bw compat
with apps that want it, but should not be the default for the library.
- Working on final naming for APIs.
- NAME UPDATES (BREAKING)
- namespace application-helpers -> lookup
- api-middleware: augment-map -> apply-response-augmentations
- Added support for network aborts
- Fixed pre-merge support in merge-component
- Reworked merge-component! to use merge-component
- Added support for alternate default config edn
- Fixed legacy union router ident signature
- Fixed dynamic routing path interpretation
- Made mark/sweep merge an option of general merge functions
- Added hooks to redefine render/hydrate (for native support)
- Removed :constructor
- Added props as arg to
:initLocalState
- Fixed bug from incubator commit 38659c19cc8caa20167d4649242039d7a35dfae1
- Fixed/updated dynamic router
- Fixed some ident-optimized render oversights
- Made it possible to self-refer in a mutation body
- Various SSR fixes
- Fixed initial state def and use. Was inconsistent in some places.
- Added default mutation result handler update [ref ::m/mutation-error]
- Made default mutation result handler a re-usable composition.
- Made each step of default result handler a reusable functional step.
- BREAKING CHANGE:
default-result-action
renamed to default-result-action!
- Updates/fixes for CCI/cljdoc
- Added active remote status tracking to state atom
- Added compressible transactions with support in Inspect
- Reduced chances of lost db updates for inspect.
- Added hooks to allow global customization of load internals
- Added global query transform override
- Added load marker default support
- Fixed http remote to not force status code to 500 unless it is missing on errors.
- Removed targeting aliases in data-fetch. Use the targeting ns directly for append-to et al.
- Fixed problem with mutations sending as empty-query mutation joins due
to faulty global query transform.
- Changed internal alg names so that they could be safely spec'd
- Added failed load marker support.
- Fixed missed render on
set-query!
. - Added follow-on read support.
- Updated render scheduling to be debounced instead of queued to avoid extra refreshes.
- Fixed tracking of
:refresh
and :only-refresh
to accumulate and clear properly. - Added back support for
refresh
section of mutations. - Added lost-refresh avoidance when both refresh and only-refresh collide.
- Added recovery from failures in ident-optimized refresh with console messaging
- Changed indexes to use class registry keys instead of classes so hot reload works better.
- Fixed load fallbacks
- Fixed issue with new remote-error? override
- Added missing (deprecated) load/load-field
- Added ability to override remote-error?
- Removed busted specs in new remote
- Lots of doc string improvements
- More conversions to ghostwheel
- BREAKING: Changed ns name of union-router to legacy-ui-routers.
- Fixed issues with parallel load option
- Fixed issue with pre-merge and initial app state
- Added additional missing inspect support (dom preview, network, etc.)
- Fixed clj render to work well with css lib
- Switched react back to cljsjs...no need for that break
- Added missing augment-response helper to mware
- Fixed a couple of bugs in optimized render
- Fixed bug in new db->tree
- Added missing link query tsts for db->tree
- Fixed bug in tx processing for remote false
- Added more to html events ns
- Updated specs for form-state
- Improved ident-optimized render, added support for :only-refresh
- Added specs and docs strings
- Fixed some naming where registry key should have been used
- Fixed componentDidMount prev-props (failing to update)
- Fixed tempid rewrites on mutation return from server
- Changed transit stack. Updated dev guide for it.
- Deprecated some names
- Added SSR render-to-string support
- Switched to ghostwheel 0.4 for better spec elision in production builds
- Improved logging helpers
- Some UISM touch-ups
- Minor fixes around mount error checks and debug logging
- Improved hot code reload (app root and dyn router)
- Workaround gw bug
- Made will-leave and route-cancelled optional on dr route targets
- Did some minor renames in UI state machines.
- A number of issues fixed in UI state machines that were caused by some
renames.
- Added official hooks to a number of places, and added a bit to docs
- Finished defining the "default" amount of pluggability for default mutations
- Make global query transform apply closer to the network layer to catch both mutations and queries
- Added confirmation tests to some more elements of merge join and pre-merge
- Fixed Fulcro Inspect db view (was missing deltas)
- Added missing support for returning/with-params/with-target to mutations,
but change remotes to allow
env
in addition to boolean and AST so that
the threading of those functions are cleaner. - Added/modified how custom start-up state is given to an app.
- Fixed rendering bug so that app normalization is optional (useful in small demos)
- Fixed bug in tx processing
- Fixed missing refresh in ident optimized render when using ident joins
- Added missing indexes
- Added various missing functions and namespaces
- Added Inspect preload so F3 can work with Chrome extension
- Updated readme
- Integrated many namespaces from F2: form-state, icons, events, entities...
- Added numerous tests.
- Added a few more missing utility functions
- Major APIs all ported, and somewhat tested
- Websockets is in a separate library (reduced server deps)
- Not API compatible with F2 yet. See todomvc sample source for basics
- Added shared back. Forcing root render and
update-shared!
updates shared-fn values. Slight operational difference from 2.x.
- Added real and mock http remote
- Added server middleware
- Ported (but untested) uism and routing
- Fixed transitive deps. May require you to add deps to your project.
- Added ability to pass options to garden css processing.
- Fixed pre-merge bug (backported from F3) on idents
- Fixed network activity indicators
- Re-release of 2.8.9, which was missing a require.
- Removed DOM from form-state so that is will work with react native.
- Added warning when DOM inputs are sent non-string values about that causing "missed" refreshes.
- Added global component registry.
-- Alleviates problems with circular refs for component use in mutations
-- Allows tracking of classes in app state without compromising Inspect/serialization
- Another tweak to computed factory
- Added reconnect for websockets
- Added children support for computed factory
- Small bug fix around default url in networking
- Added pending requests map to the reconciler so you can see what requests are queued but not yet transmitted on the network.
- Made a number of methods more tolerant to input for getting reconciler
using any->reconciler
- Fixed bugs in fulcro logging that preventing setting the logging level
- Added any->reconciler as a helper for getting a reconciler from
various arbitrary types.
- Fixed a bug in form state dirty fields when a subform is missing.
- Upgraded various dependencies
- Converted project to shadow-cljs
- Fixed bug in CLJ (SSR) side of primitives
- Fixed warning in cljs/garden compile
- Fixed dom server require
- New client constructor with better defaults (make-fulcro-client)
- Updated book to talk about new client constructor
- Removed docs regarding marker "true", since it is for legacy only
- Add pre-merge support.
- Tweak to wrapped for elements to handle nested wrappings.
- Upgraded to clojure 1.10
- Other upgrades to reduce warnings.
- Fixed deprecated websockets to work with new sente.
- BREAKING CHANGE: Sente 14.0-RC1 has a breaking change that
forces us to cause a similar websocket API breaking change.
CSRF in prior sente versions was insecure (we had a
workaround) but the official fix required an API change. The
fulcro.websockets/make-websocket-networking
on the client
now requires a CSRF token. - You MUST upgrade your sente version (if you're using websockets) to
14.0-RC1 or better.
- Fix for SSR encoding/decoding of state (thanks @lennartbuit)
- Added getDerivedStateFromError lifecycle support
- Added a bunch of missing SVG tags to DOM.
- Added a new defsc-router to routing ns that lets you declare routers to be more controllable components
- Fixed a bug where rapid refresh requests could lose an animation frame.
- Fixed custom remote detection bug in pessimistic mutations.
- Fixed bug where targets would not tolerate metadata
- Added console errors when form fields are used but undeclared.
- Added warning to console log about using non-serial remotes with deferred transactions.
- Fixed bug in db->tree that caused infinite loops on invalid app state
- Made ex-info that do not contain response keys into proper errors on network
- Fixed bugs where load markers were not being updated to failed state when
they were not keywords.
- Added low-level network activity tracking, so that loads and mutations can be on even
ground when it comes to detecting network activity.
- Added a function that can be used to defer a call until network is idle, for SSR
via client running in node.
- Fixed oversight in new wrapper
- Added support for custom actions in defmutation: NOTE POSSIBLE CONFLICT
If you named a remote with a name that ends in action, that will no longer
work right as a remote. Rename it.
- Removed ordering requirement in defmutation.
- Added wrap-csrf-token client request middleware.
- Added wrap-protect-origins for protecting GET across origins for API CSRF.
- Added security chapter in Developer's Guide
- Fixed computed-factory. It was shadowing things.
- Improved websocket response encoding error messages.
- Fixed bug introduced by 2.6.5 optimization
- Fixed bug in dynamic query code
- More optimizations. Reduced adv compile output by about 1.5k/defsc thanks to @thheller.
- Advanced compile optimizations. Shaves off about 100k compressed on adv compiles.
- Make
form-state/reset-form!
parameters optional (consistentcy). - Made integrate-ident append/prepend tolerate missing vectors
- Minor improvements to error messages.
- Added
:hydrate?
to reconciler options. Used to inform the client that the content was pre-renderered on the
server and should be hydrated instead of rendererd. (React 16+ feature). - Improved error messages from
defsc
, defmutation
, and defrouter
.
- BREAKING CHANGE:
set-state!
is now tied directly to React's setState, and in 16+ that
is merely an async request to set the state and update. React is allowed to defer it. If you
rely on reading state with get-state
immediately after setting it, then your
code will break. This change was facilitated by internal changes from React 15 to 16. - BREAKING CHANGE: In the unlikely case that you still directly use
defui
AND co-located CSS, then you will need to change protocols. The CSS protocols moved
to fuclro-css.css-protocols
to allow people to opt-out of the garden
library bloat if they don't use it. Users of defsc
should not have a problem. - Added
fulcro-css/css-injection
namespace with new (better) ways of injecting CSS. - You can now more easily access the current state via
primitives/component->state-map
. Not a common need, but comes up now and then. - Load markers now support other types for marker IDs
set-route
mutation now auto-refreshes routers- Added some additional error message cases to websocket support.
- Deprecated prim/integrate-ident and prim/integrate-ident! and moved logic to
muations/integrate-ident*
. - Added
mutations/remove-ident*
helper for removing idents from a list of idents in app state. - Added
form-state/delete-form-state*
for cleaning up data created by form-state. - Added sente-options argument to client side websockets, to mirror server side.
- Sente channel socket type by default is now :auto, so it will fall back to ajax long polling if ws is not available.
- Updated so that using React 16.4 includes all lifecycle methods (UNSAFE, etc.), EXCEPT getDerivedStateFromProps
- Changed how React state works with Fulcro in order to be compliant with new React 16 requirements.
- State changes required a rewrite of rendering optimizations to prevent lifecycle bugs. May be slightly slower until I optimize one algorithm a bit.
- Added wrapper in primitives for React Fragment, and allows returning vectors of children in
defsc
. - Updated default React version to 16.4. Those needing an older version must
exclude react, react-dom, and react-dom-server from Fulcro, and include
the version of React they need.
- Still supports React 15.x
- Fixed bug in merge with link queries
- Fixed a bug related to metadata on dynamic queries which cause normalization problems.
- Added
:classes
support to regular DOM elements.
- Cleanup of some docs/dead code
- Fixed clojure specs in networking that would cause networking to crash if instrument was on
- Improved client networking remote support to include serial? option so remotes can be parallel (default to serial for sanity).
- Fixed resource access in uberjar for not-found page for easy server
- Added support for transit options in str conversion functions and
initial state generation functions for SSR.
- Fixed bug where mutation-declared refresh was ignored by post mutations
- Fixed query de-dupe
- Changed marker to auto-disable when targeting to-many
- Added exception stack trace to mutation errors
- Fixed a bug in transact! that sometimes caused :component to be nil in mutations.
- Fixed a bug in SSR spec that cause sub-components to appear as props
- Fixed websockets to prevent first transmission unless the state of the connection is good.
- Changed websockets back-off to max out at 4s retries
- Fixed bug in some namespaces missing react requires that were breaking optimized builds.
- Fixed bug in v2.5.5 merge improvement
- Fixed bug in tempid migrations on mutation merges
- Fixed shouldComponentUpdate to give Fulcro props instead of low-level React
- Added React 16 error boundary support (requires you use React 16, of course)
- Improved failed route message
- Fixes bug in logging for release compiles
- Added missing helpers for server-side rendering with dynamic routing.
- Fixed a bug in the spec for localized dom on server
- Added support for :focus on loads
- Fixed issue with internal merge on mutation joins getting :not-found in idents
- Fixed a bug in forms that was trimming values incorrectly with new DOM
- Various tweaks and fixes to book
- Namespace fix in book source
- Added svg use tag
- Fixed a bug on wrapped select with ref
- Promoted fulcro.client.alpha.dom to fulcro.client.dom
- Promoted fulcro.client.alpha.localized-dom to fulcro.client.localized-dom
- Dramatic cleanup reduces dependencies WARNING: If you use websockets or server namespaces, you must now explicitly add the dependencies to your project. Dynamic loading errors will report what is missing.
- Released new i18n (alpha promotion). BREAKING CHANGE.
- Behavioral change: The deprecated fulcro.client.logging is now just a facade to fulcro.logging
- Moved tutorial to a separate repo
- Fixed bug in alpha dom. Lazy seqs were sometimes not properly expanded.
- Bug in specter WRT cljs, so changed fulcro-css use clojure.walk for localizing things
- Also eliminated that dependency
- Updated alpha dom to support expressions in props
- Added
sc
macro, a non-def version of defsc
- Fixed bug in alpha dom select input
- Fixed dynamic query ID generation under adv optimization
- Fixed bug in mutation joins (server return values)
- Removed support for bindable parameters in queries. Obscure feature no one was using that was broken.
- Fixed bug in book demo
- Added fulcro.alpha.i18n. A rewrite of i18n support.
- Fixed problem related to a change in CLJS 1.10+
- Fixed
:ref
support on wrapped inputs - Added a
make-root
helper to the fulcro.client.cards ns for helping with devcard creation
- Fixed bug in dirty-fields for form state, where relations were not properly reported.
- The remote plumbing layer had a few intrusive internals change that should have no
external visible effects.
- NOTE: Fulcro Inspect must be upgraded. It required changes to support the new remoting.
- New remoting protocol and implementation: FuclroRemoteI and FulcroHTTPRemote
- Supports aborting any remote request (load/mutation) from queue or active network
- Supports giving progress updates via a general transaction
- Support request and response middleware
- Updated developer's guide to include new remoting
- Requires an update to Fulcro Inspect
- Client still defaults to old networking code. Using abort, progress,
and middleware is opt-in for now.
- Made a set-route mutation in routing (augments the set-route mutation helper)
- Made routing param helper public
- Added support for custom database query interpreter on the client database,
instead of just a read helper. See the
:query-interpreter
parameter on client creation.
This allows for easy integration of things like pathom to more easily customize the entire
client database engine. - Added support for putting params on a join key, instead of in a list outside of the join.
- Removed some dead code in primitives
- Removed dom dependencies in routing and data fetch, to enable easier use with React Native
- BREAKING CHANGE: new Websockets API support refined and improved a bit, but the argument lists for construction changed slightly.
- Fix to SSR on routing changes
- Improved get-ident to work consistently on server and client
- Improved UI routing documentation and API.
- Possible breaking change: Make logging no longer require timbre. fulcro.client.logging is deprecated. If you
were accidentally relying on Fulcro's import of timbre, you may have to manually add it to your dependencies now.
- Added fulcro.logging: allows you to plug in a logger to log messages from internal fulcro functions
- Added new version of websockets. Deprecated old.
- Fixed network history tracking. Was clogging up due to bug in remote activity tracking.
- Corrected counting on active remotes (more than one remote interaction can happen per tx time)
- Made parent-with-context work with SSR
- Added
prim/with-parent-context
for cases where you're using child-as-a-function
react pattern and the Fulcro internal bindings are lost. - Made load work with dynamic queries
- Alpha release of new form state support
- Fixed a bug in load markers: placed incorrectly when using marker table
- Expanded defsc to support new form fields
- Added common non-printable key code detectors in fulcro.events
- Added all common HTML entities (unicode strings) like
into fulcro.ui.html-entities - Some typo fixes
- Some tutorial typos
- Moved bootstrap docs to book
- Thomas Heller helped find a better fix for the compiler hack in defui. Statics and
advanced compilataion are now much cleaner.
- Fixed remote detection in
ptransact!
to use application state so that
it more reliably detects which mutations are remote in a tx. - Fixed bug related to union app state initialization
- See betas below
- Removed reference to missing externs file
- Added param coercion to routing
- Updated
current-route
to work on state or the routing table itself - Updated docs to reflect the above two
- Fixed initial state generation for SSR
- Refactored rendering
- Added support for alternate rendering modes
- Made force update override shouldComponentUpdate
- Eliminates the need for
react-key
on root element
- Fixed bug with dynamic locale loading UI refresh (timing issue)
- Considerable revamping of documentation
- Significant change to the internals of i18n. Should work better when
multiple apps are on the screen.
- Fixed transact! follow on reads. The declared refresh fix had accidentally
dropped processing the explicit follow-on reads.
- Minor bug fixes in
ptransact!
(ref not required) and merge-component!
(UI refresh)
- Added support for ::prim/ref in fallbacks
- Refactored a bit of internal fallback logic
- Tweaks to docs and demos
- DOM inputs (input, textarea, select, option) have a raw mode with
JVM option
-DrawInputs
. This removes the legacy Om next-style wrappers
around the inputs. Opt-in for now. Will become the default in future versions. - Removed the cljs compiler hack for adv optimization. Fixed it in a way that is localized to Fulcro. This
fixes the madness with needing a production profile to build adv builds!
- Added support for
:initialize
option to load (ALPHA. In flux)
- Documentation updates.
- Removed old sanity check for load parameters.
- History bug fixes: network activity completion was corrupting history
- I18N bug fix: missing locale causing missing messages
- Added support for fallbacks in
ptransact!
- Fixed bug in
ptransact!
where non-remote calls would not be called if
the earlier ones were not remote. New behavior is to cluster
non-remote mutations together in front of the "next" remote one, then
defer the rest and repeat. - Added ref to env of mutations that run through
ptransact!
ptransact!
API now identical to transact!
(added ref support)- Better error checking in defsc for improper use of initial-state template mode
- Added support for routers to pass computed through
- A few fixes to bootstrap support
- Added support for targeting return values from mutations
- website updates
- load-field and load-field-action now accept a parameters map. Maintained
named parameter support so it does not break existing code.
- Fixed a bug in SSR lifecycle handling
- Fixed a bug in refresh related to the new multiple-target support in load
- Massive documentation update
- Converted most demos and docs to use
defsc
- Added support to
defsc
for *
to work right in query template form - Removed devguide Glossary
- Renamed a bunch of server dev guide sections
- Expanded defsc
- Now supports lifecylcle methods first-class
- Fixed a bug in defsc query validation
- Documentation improvements
- Bug fixes and doc improvements
- Bug fixes and doc improvements
- Removed dependency on Om Next. See README-fulcro-2.0.adoc for upgrade instructions.
- Imported and refined the useful Om Next abstractions.
- Dropped indexer support for data path, and class path.
- Made post-processing path-meta obsolete (internal change)
- Fixed factory to use
apply
to prevent React warnings when using children. - Revamped all of the documentation. Made many improvements to Dev Guide
- Added code to support React 16 (optional, defaults to 15)
- Rewrote how dynamic queries work. They are now 100% part of state and history.
- Changed DynamicRouter to use new dynamic query support
- Refined how UI refreshes work. Should be a bit faster that Om Next in general.
- Improved load marker implementation. You may now give markers a name and have them normalize instead of overwriting your data
- Improved
:target
support in all variants of load. You can now target multiple locations, including append/prepend to existing
to-many collections (see the doc string). - Improved start-up failure messages for server related to configuration files.
- BREAKING CHANGE: load-action and load-field-action require the env (they used to allow env or just the state atom).
- Added a new history system with the following improvements
- The history sequence is now a unidirectional list of nodes that are annotated with the action
that affected the change, db-before, db-after, and also with live tracking of network activity relating
to state changes. This improves debugging abilities dramatically, and also enables better internal
automated error recovery.
- Added support for compressible history edges. This allows adjacent history entries to auto-compress into the most recent.
- Added a better API for accessing and navigating history
- Added support for client mutations to declare a refresh set so that UI follow-on reads are no longer necessary.
- Added more examples in demos
- Added pessimistic transaction support with ptransact!
- Added compressible transaction support with compressible-transact!
- Both of the above use support functions to rewrite the transaction, so you can still use transact! if you like.
- Mutations can now be interned. This enables docstrings and navigation to work for things like nREPL, and also allows you
to use devcards mkdn-pprint-source with mutations in your devcards. See the docstring of defmutation for more details.
- Demos compressed into fewer source files.
- Websockets demo moved to external project
- Expanded and cleaned up many portions of the developer's guide
- Expanded defsc.
- It can now take a method body for
initial-state
, ident
, and query
in
addition to a simpler template. Using the method forms loosens verification logic. - Options are optional, so you can generate a plain react component
- Parameters to the lambda forms get
this
and props
from main args, so you don't list them.
(e.g. :ident (fn [] ...use this and props from defsc args...)
- BREAKING CHANGE:
- The 4th argument is now children IF you use
:css
. - The 4th argument is now an error if there are no CSS rules.
- Defsc now considers all arguments after props to be optional, so you don't need to list underscores
- Removed deprecated fulcro.client.cards/fulcro-app. Please port to
defcard-fulcro
instead (trivial port). - Moved defsc from fulcro.client.core to fulcro.client.primitives namespace
- Renamed fulcro.client.core to fulcro.client
- Code motion (old names refer to new ones, so no action needed on 1.x apps)
- iinitial-app-state (now has-initial-app-state?), iident (now has-ident?),
integrate-ident, integrate-ident!, merge-component, merge-state!
(now merge-component!), component-merge-query,
merge-alternate-unions, merge-alternate-union-elements!, and
merge-alternate-union-elements moved to primitives.
- Removed log-app-state utility. Will reduce production deploy size. (thanks @thheller)
- Added code for log-app-state to Guide's F_DevEnv documentation, along with a note about fulcro-inspect
- Back-ported improvements to defsc to 1.x dev line. Supports lambdas
for options as well as the original templates. See docstring.
- Expanded tool registry support
- Expanded websocket support a bit
- Fixed elements/ui-iframe in Firefox
- Added support for tools to be notified when a Fulcro app starts so they
can hook in.
- Added a cascading dropdown demo
- Minor fixes
- Added
:set
support to integrate-ident
- Added support for shadow DOM (for browsers that support it)
- Fixed typo in forms on maxLength
- Added support for FormatJS custom formats (trf). No SSR support for now.
- Upgraded IntlMessageFormat to version 2.2.0
- Added support for params and refresh list in on-form-change
- Added explicit elide-asserts false to project because of core-async bug
- Fixed regression in i18n change-locale.
- Fixed routers to allow initial state parameters to pass through to the default screen.
- Fixed a bug in dynamic routers that caused updated route queries to not be properly saved in app state.
- Fixed a bug in logging where the clj and cljs API didn't match
- Added
defsc
macro to core namespace and documented in devguide section M05 - Added a cheat sheet to docs
- Added mutation helper comments to routing section of devguide
- Enhanced the
env
available in post mutations and fallbacks - Added some content to the reference guide
- Added auto-retries on dynamic route loading
- Fixed bugs in gettext defaults for i18n extract/deploy.
- Finished adding i18n dynamic module loading support to generated locales.
- Added demo of dynamic locale loading.
- Fixed a force-refresh bug in i18n on locale change.
- Updated i18n dev guide documentation.
- Added a demo about using defrouter to switch between lists and editors for the items.
- Added colocated CSS demo.
- Increased the extra attrs that
form-field
allows on most built-in types (e.g. text, html5), to include :ref
among others. - Fixed but in dynamic routing that was causing query to not change correctly
- Fixed mark/sweep to not leave not-found idents lying around
- Added demo for new fulcro-sql graph query against SQL
- Bugfix: fixed joins on :ui attrs to work right with mark/sweep on loads
- Changed initialization order around networking to prevent async races
- Moved alternate union initialization to before initial render
- Added dynamic routing with code splitting support (not ready for prime time: waiting for compiler fixes still)
- Added demos for defrouter as a detail viewer and dynamic routing
- Fixed a bug with route params that caused numbers to not be usable as parameters
- Continued expanding reference guide
- Added more info on writing custom form submission to Dev Guide Form Server Interaction section.
- Changed CI to use Circle CI
- Cleaned up forms support a bit, and improved docs strings some
- REQUIRES: Clojurescript 1.9.854+.
- BREAKING CHANGE: Removed passing
app
to networking. This caused a dependency loop that was unsolvable internally and
has always been broken. If you have custom networking you'll have to remove that param to start. - NOTE: You must upgrade fulcro-spec (if you use it) to beta7 as well with this release.
- Added initialize-form mutation to forms with docs in devguide.
- Fixed deprecated ring content-type handling in server.
- Made devcards dynamically load so it isn't a hard dependency.
- Fixed a bug in new initial app state handling.
- Added DynamicRouter to routing. Should work as soon as newest cljs compiler module loader is debugged and fixed.
- Fixed initialize form to work for SSR.
- Quite a number of devguide improvements.
- Got started on a better Reference Guide.
- Removed the wrap-defaults module and ring-defaults dependency. It is trivial to write, and pulls in deps that can cause downstream problems.
- Changed :initial-state option: The explicit parameter will override InitialAppState. The old behavior always takes InitialAppState, which turns out to be backwards (and no one should be supplying both unless they mean to override).
- Dramatically improved devcards support: state persistent, eliminated console errors. Must port to new
functions/macros to use. Legacy
fulcro-app
works better than it did, but it is not recommended and will
cause cards that render the same app to collide. - Worked a lot on the server parts of the devguide. Also fixed some doc strings that still referred to load-data
- Set load markers to be placed when load transacts, instead of waiting for the queue processing. This should help with loading UI flicker.
- Backported to Clojure 1.8. Existing apps should still be able to still use 1.9, but this prevents it from being a requirement.
- Made sure that server-side rendering of i18n worked properly, including trf
- Set up client to honor incoming locale from server (if it sets :ui/locale in initial state)
- Removed experimental defui augments. Copy from old source if you use it.
- Changed the SSR client-side retrieval function to return nil instead of a state marker.
- Made routing.cljc more friendly to SSR
- Added fulcro.core/merge-component to help merging a new instance of a
component to app state in mutations.
- Added fulcro.core/merge-alternate-union-elements (no exclamation) that can work on state maps.
- Improved CSS on devguide a little
- Made util more SSR-friendly
- Added SSR-related initial state helpers to fulcro.server-render
- Added clj encode/decode to transit string to util
- Added tests for remaining functions in util
- Added section M50-Server-Side-Rendering to the Dev Guide
- Fixed support viewer. Porting for defmutation had broken it.
- RENAMED PROJECT: Fulcro. All relevant namespaces and interface names updated to use the new naming. Use bin/rename-untangled.sh to fix your project.
- Added more form field types (html5-input supports all text-like html 5 input types)
- Improved options can be passed when rendering form fields (still needs more)
- Form commit now accepts a fallback
- Improved docstrings on form commit
- Added defvalidator for making form field validators
- Added untangled.client.data-fetch/fallback as the new name for tx/fallback. tx/fallback is still OK, but the new one uses a defmutation, so it pops up in IDEs.
- Added support for user-supplied client read handler
- Fixed uses of clojure.spec to clojure.spec.alpha
- Integrated devguide
- Integrated cookbook (as demos)
- Removed local storage and async service stuff. It was undocumented, and unneeded.
- Removed
load-data
from data-fetch. Port to using load
instead. - Moved internal i18n vars to untangled.i18n namespace
- Removed protocol testing support. Port it from the old library into your project if you need it.
- Removed openid parsing (doesn't belong in this lib)
- Renamed untangled.client.impl.util to untangled.client.util
- Moved force-render and unique-key to untangled.client.util namespace.
- Moved strip-parameters to untangled.client.util (cljc)
- BREAKING CHANGE: Renamed built-in mutations using the defmutation macro.
- untangled/load -> untangled.client.data-fetch/load
- tx/fallback -> untangled.client.data-fetch/fallback
- ui/change-locale -> untangled.client.mutations/change-locale
- ui/set-props -> untangled.client.mutations/set-props
- ui/toggle -> untangled.client.mutations/toggle
Remember that namespace aliasing works within syntax quotes (e.g. `m/change-locale)
- Moved augment-capable defui to augmentation namespace. STILL EXPERIMENTAL.
- Merged server support into this project
- Moved easy untangled server to untangled.easy-server namespace.
- Moved all other server code to untangled.server namespace.
- Added bootstrap3 namespace with helpers that can render passive and active bootstrap 3 elements.
- If
net/UntangledNetwork start
returns something that implements UntangledNetwork
, this value will be used as the actual remote by the app. - Made forms support work (initial render) for SSR
- MOVED pathopt option. It is now just one of the regular reconciler options you can pass. Currently does not default to true due to bugs in Om Next.
- Changed network result handling so that it does not change :ui/react-key (flicker)
- Added support for splitting mutation txes when there are duplicate calls, so that they go over separate network requests to work around Om returning a map.
- Fixed load markers for ident-based loading: They will appear iff the entity is already present (refresh)
- Cleaned up logic around data markers related to markers and data targeting
- Added sequential processing as a configurable option on networking
- Added devcards for integration testing loading cases
- Removed explicit require of devcards.core in devcard untangled-app macro so that devcards is not a hard dependency.
- Updated load to auto-add target or kw of load to the refresh list.
- Added defmutation
- Fixed up namespaces that defined macros to allow for implicit macro usage by adding self-references
- Added support for multiple remotes (networking option now accepts a map)
- NOTE:
clear-pending-remote-requests!
now requires a remote parameter.
- Added support for progressive load updates (nice for file
upload support)
- Removed cache
- Added UI routing helpers
- Added support for nil as subquery class in load
- Fixed preprocess-merge to eliminate litter in app state
- Added support for server-side rendering.
- Removed forced root re-render on post mutations. POTENTIALLY BREAKING CHANGE!
- The intended use is to include :refresh with your loads that indicate what to re-render
- Fixed bug in InitialAppState that was missing the merge of nested unions on startup
- Changed InitialAppState to overwrite any supplied initial app state atom.
This allows you to inspect data (the app state) when embedding an Untangled application in a devcard.
- Added new
load
and load-action
functions with cleaner interface. Deprecated load-data
and load-data-action
.
- Now have the ability to target a top-level query to a spot in app state. Reduces need for post mutations
- Reduced arguments for better clarity
- Added ability to pass untangled app, so that use in started-callback is easier.
- Fixed bug in failed loading markers
- Fixed bug with removal/addition of markers when markers are off
- Added jump to and playback speed features to the support viewer.
- Added support for post-mutation parameters in load API.
- Added support for custom handling of merge of return values from server mutations (see
:mutation-merge
in new-untangled-client
). - Added support for custom transit handlers on the client side. Server side is coming in a release soon.
- Added support for turning on/off Om path optimization
- Fix for latest cljs support (PR 47)
- DEPRECATED: load-data will soon no longer supports the :ident parameter. Use load instead.
- The
:marker
keyword actually works now! - Fix: data fetch with parameters places the load marker in the correct location in app state
- Fix: error callback doesn't attempt to modify data state in app state db when the data state's marker is false
- Fixed bug with global-error-callback not being called with a server error returns no body
- Fixed bug that prevents error processing if the server is completely down
- Added reset-history! function to reset UntangledApplication Om cache history.
- Added to UntangledApplication protocol:
- (reset-app! [this root-component callback] "Replace the entire app state with the initial app state defined on the root component (includes auto-merging of unions). callback can be nil, a function, or :original (to call original started-callback).")
- (clear-pending-remote-requests! [this] "Remove all pending network requests. Useful on failures to eliminate cascading failures.")
- Fixed bug where keywords in a union query were not elided when specified in the
:without
set of data fetches - Fixed bug with query combining that was causing parallel reads to collide
- Corrected initialization order so that alternates on unions are done before startup callback
- Fixed a rendering refresh bug on post mutations
- Fixed compiler warnings about clojure walk
- Added marker option to loads, so that load markers are optional
- OpenID client will now extract tokens from cookies as well as the header.
- Added utility function integrate-ident!
- Refined merge-state!
- Renamed Constructor to InitialAppState
- Automated initialization of to-one unions (to-many was already doable by Om)
- Fixed bug with initial state and new constructors
- Added untangled/Constructor for adding initial state to UI components
- Added merge-state! for easily merging component-centric data (e.g. from server push)
- Significant optimizations to post-query processing.
- BREAKING CHANGE: to load-data. You should now include :refresh to trigger re-rendering of components. This removes the
internal need for a forced root re-render. Proper refresh after load-data now requires this parameter.
- Removed deprecated load-collection and load-singleton. Use load-data instead (name change only)
- Removed old logging code (use untangled.client.logging instead)
- Added support for parallel lazy loading
- Added
(start [this app])
to the UntangledNetwork
protocol. - Log-app-state now requires the atom containing a mounted untangled client, define it in the user namespace like so:
(defonce app (atom (fc/new-untangled-client ... )))
(swap! app fc/mount RootComponent "app-div")
(def log-app-state (partial util/log-app-state app))
global-error-callback
now expectes an arity 2 function. First param is the status and the second is the response.- Fixed bug that closed over tempids in network callbacks
- Fixed bug in path-optimized union query parsing
- Fixed tempid rewrite regression
- Upgraded to Om-alpha32
- untangled.openid-client/setup, parses any openid claims from the webtoken in the url's hash fragments
- Renamed load-collection/singleton to load-data. Old names are deprecated, but not yet removed.
- Renamed :app/loading-data to :ui/loading-data
- Added remote trigger method for doing loading from mutations.
- Renamed everything in the internals that was prefixed app/ to untangled/
- Added global server error handler.
- Added fallback support for load-data, load-field, etc.
- Refactored networking send for better clarity
- Fixed bug on mark/sweep of missing query results. It was being applied to mutations instead of reads. Added tests for this that need a bit more work.
- Fixed local read bug, and turned on path optimization
- Fixed fallback handling of failed remote transactions, and added lots of tests
- Renamed react-key to ui/react-key
- Renamed app/locale to ui/locale
- Renamed mutation app/change-locale to ui/change-locale
- Implemented a number of missing things in i18n
- Removed a number of i18n helpers that were redundant to trf
- Added :request-transform networking hook with spec
- Modified load callback to a mutation symbol
- Changed :params of loaders to allow you to specify which prop on the query gets the stated parameters
- Added history method to application protocol, to make implementing history viewer in an app trivial
Can you improve this documentation? These fine people already did:
Tony Kay, Wilker Lucio, Ethan Gracer, Karanbir Toor, Anthony D'Ambrosio, Mark Hinshaw, currentoor, Anthony, Michael Glaesemann, mahinshaw, Kenneth Bier, Jeff Slavin & Bob KoutskyEdit on GitHub