niku 2.3.1

niku: ^2.3.1 copied to clipboard

Bug Fix:

• Add .copiedDeep to resolve StyleSheet overwrite in NikuButton

Breaking Change:

• Rename the following property on Image:
  • circleProgress -> useCircleProgress
  • linearProgress -> useLinearProgress
• Rename on to deps, and onGesture to on.
• Add labelText as replacement of label which is now accept Widget
• Move useTextStyle to useNikuTextStyle in NikuButton to add useTextStyle for NikuState
• Remove useNiku, nikuConstraints, nikuPadding, nikuMargin from Niku and Parent Proxy.

Feature:

• Add material 3 shortcut.
• sparkle on NikuButton as shortcut for ..splashFactory = InkSparkle.splashFactory
• Add Material 3 Typography initialzation shortcut, and Text Factory
  • displayLarge
  • displayMedium
  • displaySmall
  • titleLarge
  • titleMedium
  • titleSmall
  • bodyLarge
  • bodyMedium
  • bodySmall
  • labelLarge
  • labelMedium
  • labelSmall
• Internal architecture changed called Tempestissimo.
  • Significant performance improvement, parent builder rewrite
  • Parent Property builder now lazily executed
  • Flatten and parent property
• Add ExplictParentBuilder to quickly handle single use of parent builder
• New hook: useShadow
• Add new property, borderRadius, shadow, highlightColor, focusColor, hoverColor

Change:

• Add .offstage, .show shortcut
• Update .useScrollbar to Flutter 3
• .hidden now based on Offset
• Initial work with Flutter 3 and Material3.
• useThemeSelector now can accept nullable value
• Refactored Proxy, now has 50% less code and much more cleaner
• Parent Builder architecture rewrite, name Tempestissimo.
• rounded now use NikuRounded under the hood to auto inherits borderRadius for next builder, eg. shadows, and border.
• Deprecate UseQueryMacro<T>, merged into NikuBuildMacro<T>

Bug fix:

• Text Theme doesn't update on Brightness change
• _applyConstraints, _applyPadding, _applyPositions cause Stackoverflow
• Gap now doesn't use square ratio, the content cross-dimension is now preserved.

Breaking Change:

• Rename the following property on Image:
  • circleProgress -> useCircleProgress
  • linearProgress -> useLinearProgress
• Rename on to deps, and onGesture to on.
• Extra hook doesn't work with Tempest Engine, eg. useScreen, useThemeSelector
• useScreen break BuildContext on Flutter 3

Change:

• Add .offstage, .show shortcut
• Update .useScrollbar to Flutter 3
• .hidden now based on Offset

Breaking Change:

• Pass context to get widget results in widget(BuildContext context)
• Rename on to deps, and onGesture to on.

Feature:

• Add material 3 shortcut.
  • sparkle on NikuButton as shortcut for ..splashFactory = InkSparkle.splashFactory
  • Add Material 3 Typography initialzation shortcut, and Text Factory
    • displayLarge
    • displayMedium
    • displaySmall
    • titleLarge
    • titleMedium
    • titleSmall
    • bodyLarge
    • bodyMedium
    • bodySmall
    • labelLarge
    • labelMedium
    • labelSmall

Bug fix:

• Text Theme doesn't update on Brightness change

Breaking Change:

• Add labelText as replacement of label which is now accept Widget

Change:

• Initial work with Flutter 3 and Material3.
• useThemeSelector now can accept nullable value

Bugs fix:

• Extra hook doesn't work with Tempest Engine, eg. useScreen, useThemeSelector
• useScreen break BuildContext on Flutter 3

Breaking Change:

• Move useTextStyle to useNikuTextStyle in NikuButton to add useTextStyle for NikuState

Change:

• Refactored Proxy, now has 50% less code and much more cleaner

Bugs fix:

• _applyConstraints, _applyPadding, _applyPositions cause Stackoverflow

Breaking Change:

• Remove useNiku, nikuConstraints, nikuPadding, nikuMargin from Niku and Parent Proxy.

Feature:

• Internal architecture changed called Tempestissimo.
  • Significant performance improvement, parent builder rewrite
  • Parent Property builder now lazily executed
  • Flatten and parent property
• Add ExplictParentBuilder to quickly handle single use of parent builder
• New hook: useShadow
• Add new property, borderRadius, shadow, highlightColor, focusColor, hoverColor

Change:

• Parent Builder architecture rewrite, name Tempestissimo.
• rounded now use NikuRounded under the hood to auto inherits borderRadius for next builder, eg. shadows, and border.
• Deprecate UseQueryMacro<T>, merged into NikuBuildMacro<T>

Bugs fix:

• Gap now doesn't use square ratio, the content cross-dimension is now preserved.

Feature:

• Add sliverToBox, useForm, and formKey to Parent Proxy

Feature:

• Add useTitle, useContent to NikuAlert
• Add sliverToBox, useForm, and formKey to Niku

Bugs fix:

• Set borderColor to transparent on calling noUnderline on TextFormField
• .gap not working with Row

Bugs fix:

• NikuListTile.apply not applying parent property

Feature:

• Add .rounded to NikuImage
• Add FocusNodeMacro, adding useFocusNode, useFocus
• Add useTitle, useSubtitle, useLeading, useTrailing

Improvement:

• Reduce Time Complexity of hooks from UseQueryMacro from O(n(2i + p)) to O(n) where n is property, p is parent total callstack, and i is total invocation. By passing widget self as reference instead of immutable copied then diffing, and apply The following hooks benefits in performance improvement:
  • useQuery
  • useSize
  • useDarkMode
  • useThemeSelector
  • useScreen

Feature:

• New parent proxy available for all widget:
  • expanded
  • flex
  • fullSize
  • fullWidth, wFull, w100
  • fullHeight, hFull, h100
  • fractionSize, sizePercent
  • fractionWidth, fractionW, fw, wFactor, widthPercent, wPercent
  • fractionHeight, fractionH, hw, hFactor, heightPercent, hPercent
  • boxConstraints
  • nikuConstraints
  • maxSize
  • minSize
  • maxWidth, maxW, wMax
  • minWidth, minW, wMin
  • maxHeight, maxH, hMax
  • minHeight, minH, hMin
  • width, w
  • height, h
  • useGesture
• New parent proxy available for AxisLayourProxy
  • alignTopLeft
  • alignTopCenter
  • alignTopRight
  • alignCenterLeft
  • alignCenter
  • alignCenterRight
  • alignBottomLeft
  • alignBottomCenter
  • alignBottomRight
  • New widget: NikuRadio, NikuRadioListTile, NikuDismissible
• New hook: useTransition, useTransitions
• Add property: splash, wFactor, hFactor to Niku
• New utility widget NikuAnimated, NikuAnimateds
• New proxy: ListTile with dismiss for NikuDismissible

Change:

• Move part of AxisProxy to NikuBuildMacro
• Refactor, and organize examples

Bug fixes:

• obscureCharacter not working in NikuTextFormField

Improvement:

• Reduce Time Complexity of hooks from UseQueryMacro from O(n(2i + p)) to O(n) where n is property, p is parent total callstack, and i is total invocation. By passing widget self as reference instead of immutable copied then diffing, and apply The following hooks benefits in performance improvement:
  • useQuery
  • useSize
  • useDarkMode
  • useThemeSelector
  • useScreen

Feature:

• New parent proxy available for all widget:
  • expanded
  • flex
  • fullSize
  • fullWidth, wFull, w100
  • fullHeight, hFull, h100
  • fractionSize, sizePercent
  • fractionWidth, fractionW, fw, wFactor, widthPercent, wPercent
  • fractionHeight, fractionH, hw, hFactor, heightPercent, hPercent
  • boxConstraints
  • nikuConstraints
  • maxSize
  • minSize
  • maxWidth, maxW, wMax
  • minWidth, minW, wMin
  • maxHeight, maxH, hMax
  • minHeight, minH, hMin
  • width, w
  • height, h
  • useGesture
• New parent proxy available for AxisLayourProxy
  • alignTopLeft
  • alignTopCenter
  • alignTopRight
  • alignCenterLeft
  • alignCenter
  • alignCenterRight
  • alignBottomLeft
  • alignBottomCenter
  • alignBottomRight

Change:

• Move part of AxisProxy to NikuBuildMacro
• Refactor, and organize examples

Bug fixes:

• obscureCharacter not working in NikuTextFormField

Feature:

• New widget: NikuRadio, NikuRadioListTile, NikuDismissible
• New hook: useTransition, useTransitions
• Add property: splash, wFactor, hFactor to Niku
• New utility widget NikuAnimated, NikuAnimateds
• New proxy: ListTile with dismiss for NikuDismissible

Bug fix:

• Unmatch filename with capital case
• Remove print from PaddingMacro

Breaking Change:

• flexible is now flex
• Deprecated required value of TextFormField in favor of hint.
  • To migrate, please add factory .hint or add it as named parameter

Feature:

• Add mandatory shortcut to AxisLayoutProxy
• Add useThemeSelector for declarative useDarkMode
• Support all factory method for NikuGridView
• Add NikuListView
• Add AxisLayoutMacro
• Add .center, .w100, safeArea to AxisLayoutMacro
• Add of alias for apply

Change:

• AxisLayoutMacro is now AxisLayoutProxy
• borderWidth is now baseBorderWidth to follow the same convention with border, borderColor, and borderStyle on proxy
• Remove function allocation from _init of MapTextStyleMacro
• Add center to NikuColumn, and NikuRow
• Replace childrenWithGap with $internalComposeGap in GapMacro
• Add gap property to AxisLayout
• gap can now be applied
• childrenWithGap now only composed on build

Bug fix:

• useDarkMode and useThemeSelector not switching context between
• Fix 'owner!._debugCurrentBuildTarget == this': is not true. when using useDarkMode

Breaking Change:

• flexible is now flex

Feature:

• Add mandatory shortcut to AxisLayoutProxy

Change:

• AxisLayoutMacro is now AxisLayoutProxy

Feature:

• Add useThemeSelector for declarative useDarkMode

Bug fix:

• useDarkMode and useThemeSelector not switching context between

Breaking Change:

• Deprecated required value of TextFormField in favor of hint.
  • To migrate, please add factory .hint or add it as named parameter

Change:

• borderWidth is now baseBorderWidth to follow the same convention with border, borderColor, and borderStyle on proxy

Bug fix:

• Fix 'owner!._debugCurrentBuildTarget == this': is not true. when using useDarkMode

Feature:

• Support all factory method for NikuGridView
• Add NikuListView
• Add AxisLayoutMacro
• Add .center, .w100, safeArea to AxisLayoutMacro
• Add of alias for apply

Change:

• Remove function allocation from _init of MapTextStyleMacro
• Add center to NikuColumn, and NikuRow
• Replace childrenWithGap with $internalComposeGap in GapMacro
• Add gap property to AxisLayout
• gap can now be applied
• childrenWithGap now only composed on build

Bug fix:

• Remove print from PaddingMacro

Feature:

• Text Style Proxy, Button Proxy, TextFormField Proxy
• Add ConstraintsMacro to NikuInputDecoration
• Add useTextStyle to DropdownButton
• Add State Utility Hooks to NikuButton
• Add color setter to NikuButtonStyle

Change:

• border is now baseBorder, and allBorder is now border
• margin property now uses Padding instead of Container because that's how native Flutter doing it. Yes, margin is actually padding in Flutter.

Base on 2.0.0-rc.8

Simply an entire rewrite, read more at version 2 introduction

Base on 2.0.0-rc.8

A compatibility version for working with both v1 and v2 for gradually migrating from v1.

To gradually migrate from v1, simply replace all:

// From
import 'package:niku/niku.dart';
// into
import 'package:niku/v1/niku.dart';

You can easily use IDE like VS Code to find and replace all package:niku/ with package:niku/v1/ then it should work just fine, gradually migrate from v1.

Bux Fix:

• Add copied to NikuImage, NikuSlider, NikuRangeSlider.
• Apply parent builder to copied method

Feature:

• New use on NikuWidget to apply multiple styles at once
• Add useBorder, useRoundedBorder
• Add apply to NikuIcon
• Add WidthHeightMacro

Change:

• Add Full Macro conventions
• Use Parent Builder stack instead of direct setter to support apply parent styling

Bux Fix:

• Fix wrong spelling of actionPb
• Use Full Macro on Alert
• n.showDialog now accepts any widget

Change:

• showNikuDialog now accepts any widget

Bug Fix:

• Add default .rounded to NikuButton
• Fix gap inserted to last children
• Fix Column with gap required at least 1 children

Breaking Change:

• Remove NikuImage.file factory to support web platform.

Breaking Change:

• Remove cached network image due to not supporting all platform yet.

Feature:

• Add .quarterTurns, bgBlur, clipRect, clipOval to Niku

Change:

• Remove default styling from NikuText to match default Flutter Text, eg. TextBasis.

Bug fixes:

• AxisMacro not assigning wrong field name

Breaking Change:

• Migrate .useScreen to useSize
• Migrate .useQuery to .useScreen
• Migrate .useEvents to useGesture
• Remove TransformSelectableText

Feature:

• Add .useQuery to handle MediaQueryData
• Add useBorder, useNikuBorder, useBorderColor, useBorderWidth hook
• Add .useDarkMode to handle element styling on Dark Theme
• Add n.Image.cache to use CacheNetworkImage

Bug fixes:

• Correct focusedErrorBorder setter name

Breaking Change:

• Remove asNiku on Widget (still working for object)
• Migrate .useOn to useEvents

Feature:

• Add .focusColor, .splashColor, highlightColor, hoverColor to NikuCheckboxListTile
• Add .adaptive to NikuAlert
• Add .adaptive to Switch
• Add .adaptive to NikuTextFormField
• Add NikuShowDialog to handle adaptive dialog
• New NikuQuery widget

Bug fixes:

• .on property in Niku doesn't passing dependencies to concilation process

Feature:

• Add useQuery and useScreen property, read more about it here

Bug fixes:

• .on property in Niku doesn't passing dependencies to concilation process

Feature:

• Game Changing, NikuOn, .on and .freezed property, read more about it here
• NikuDropdownButton widget for DropdownButton

Bug fixes:

• Change from Nullish cascade equality to nullish check to override useStyle's style

Breaking Change:

• Migrate .useStyle to .useTextStyle() on NikuText.
• Migrate .useStyle to .useButtonStyle() on NikuButton.
• Change .useStyle to .useButtonStyle() on NikuButton.
• Migrate .useBuilder, useParent to useChild on Niku.
• Migrate from .value to .widget on every Niku component.
• Migrate from style to textStyle on every Niku component.

• Namespace
• Selectable Text

Heaven and Earth, batch 1. @see #17

Thanks to y-pakron for fixing the bug! This release fix the expanded method to be flexible on NikuCore where I overlook. Without this PR, we are going to have time confusion of why flexing doesn't work!

Bug fixes:

• Apply flex parameter to expanded on NikuCore

Thanks to dmitrijkiltau for contribution! This release add the nullable onTap on NikuButton, also adding the example for that.

Bug fixes:

• Nullable onTap on NikuButton

Big thanks to y-pakorn for this release! He contribute to Niku for a several PR now, in fact, this entire release is happend because of his contribution which solved bug caused by my clumsiness, tee hee~

Feature:

• Add mainAxisSize to NikuColumn and NikuRow

Bug fixes:

• Fixes .fullWidth() which cause full height.
• Makes error text optional on NikuTextField.

Feature:

• selectable text

Bug fix:

• builder return Widget instead of Niku.

Bug fix:

• log

Bug fix:

• builder return void.

Feature:

• add .scrollbar to base.
• add .style, .theme to text.

Breaking Change:

• Remove .text from NikuText.

Change:

• Adding final to constructor parameter.

Bug fix:

• Fix key not setting for several widget.
• Fix animated and animatedBuilder not working.

Bug fix:

• this. access property.

Feature:

• Add NikuWrap
• Add form to NikuBase.
• Add focusedError to TextField border input.

Bug fix:

• apply using unexpected share property.
• apply on NikuTextField without AlignVertical cause build to failed.

Feature:

• Add cursor to IconButton.
• Add the following property to IconButton:
  • size,
  • minSize, minimumSize
  • maxSize, maximumSize
  • minWidth, minimumWidth
  • minHeight, minimumHeight
  • maxWidth, maximumWidth
  • maxHeight, maximumHeight
• Boolean method on NikuTextField now has default value of true.

Breaking Change:

• Rename border to b and setBorder to border.
• Change obscureTextFormField to obscureText on NikuTextField.
• Add asPassword on NikuTextField.
• Remove disabledSmartDashes and disabledSmartQuotes.
• enableSmartQuotes and enableSmartDashes now accept option boolean default as true.
• Change from inputDecorationEnable to enableInputDecoration.
• Change from ...textFormField to ...text in NikuTextField.

Bug fix:

• Fix Visual Density in NikuButton.
• Setting multiple border variant not working

Breaking Change:

• Swap arguments of animated

Change:

• Remove Nested instance from base property
• Add default value of true to absortPointer and ignorePointer

Bug Fix:

• add Key

Feature:

• Remove .build() and .style()
• Niku Internal is now mutating property instead of stacking
• Add .asNiku on component instead of using Niku Component
• Match NikuButton to idiomatic Dart
• Add TextStyle to TextButton
• Every Niku Component now support margin property

Breaking Change:

• Every Niku Component now extend NikuCore which extends StatelessWidget
• Variant method NikuButton is removed
  • .icon to NikuButton.icon
  • .text to NikuButton.text
  • .elevated to NikuButton.elevated
  • .elevatedIcon to NikuButton.elevatedIcon
  • .outlined to NikuButton.outlined
  • .outlinedIcon to NikuButton.outlinedIcon

Change:

• Remove usage of this. except for constructor
• Every margin property is moved to NikuCore
• Build is now using internalBuild
• Remove container if margin is not presented

Bug fix:

• Foreground on text change background instead
• Fix margin not mistakenly setting on padding instead

Feature:

• Add animatedBuilder, animated for AnimationBuilder
• Add animatedContainer for AnimatedContainer
• Add semantics for Semantics

Changed:

• Move use of Container to DecoratedBox
  • The property which affected this changed including:
    • boxDecoration
    • border
    • shadows
• Move use of Container to SizedBox
  • The property which affected this changed including:
    • fullSize
    • fullWidth
    • fullHeight

Bug fixes:

• Wrong size on widthPercent, heightPercent and sizePercent
• Unable to use NikuRow without specifying crossAxisAlignment
• Add optional onTap to .inkwell

Bug fixes:

• Wrong size on widthPercent, heightPercent and sizePercent

Feature:

• Add builder on Niku for composing custom widget.
• Add widthPercent, heightPercent and sizePercent

Changed:

• bg and backgroundColor of Niku are now using ColoredBox instead of Container
• Niku now don't required any constructor Widget

Bug fixes:

• Fix apply overriding written value

Breaking Change:

• Deprecated:
  • FlatButton
  • RaisedButton
  • ElevatedButton
• Move button.dart to oldButton.dart
• Move NikuButton to button.dart
• Importing package:niku/niku.dart won't import oldButton.dart
• Only support Flutter 2.0.0 or newer

Feature:

• Add NikuButton for new building new universal Button including
  • TextButton
  • TextButton.icon
  • ElevatedButton
  • ElevatedButton.icon
  • OutlinedButton
  • OutlinedButton.icon

Documentation

• Add code highlight to widget example usage

Feature:

• Add support for Sound Null Safety of Flutter 2
• Only support Flutter 2.0.0 or newer

Refactor:

• Constructor to use this as parameter
• Remove overflow from stack as it's deprecated

Documentation:

• Fix Null Coalesce
• Fix borderColor, borderStyle from crashing on outlineButton

Documentation:

• Fix Null Coalesce
• Fix borderColor, borderStyle from crashing on outlineButton

Documentation:

• Fix wrong spelling of disabled on outlineButton
• Fix setBorder of outlineButton from crashing

Feature:

• Add support for:
  • NikuStack
    • Niku extension for IconButton
• Add more property to Base Widget
  • Backdrop filter
  • Positioned
  • singleChildScrollView / scrollable
  • flexible / flex
• Add group import
• Add extension Widget
  • Add .niku() extension for widget

Documentation:

• Add property documentation

• Correcting wrong spelling

• Bug fixes:

  • Fixes border not rendering children
  • Mark children constructor in Row as required

Feature:

• Add support for:
  • NikuIconButton
    • Niku extension for IconButton
• Add new property to Niku (base):
  • on - Event listener
  • material - Add [Material] to Widget
  • inkWell - Add [InkWell] to Widget
  • border - Decorate with border using [Border]
• Add group for flatButton, raisedButton, outlineButton and flatButton as package:niku/widget/button

Documentation:

• Restructure documentation

• Bug fixes:

  • Wrong spelling of documentation in several place
  • Prevent toolbarOptions from crashing if not specified all by adding default value

Bug fixes:

• Fix require padding for NikuFlatButton, NikuOutlineButton and NikuRaisedButton

Bug fixes:

• README.md image not showing banner.

Initialize project

Add support for

• Niku
  • Niku base for styling widget
• NikuText
  • Niku extension for Text
• Column
  • Niku extension for Row
• Row
  • Niku extension for Column
• NikuTextField
  • Niku extension for TextFormField
• NikuFlatButton
  • Niku extension for FlatButton
• NikuRaisedButton
  • Niku extension for RaisedButton
• NikuOutlineButton
  • Niku extension for OutlineButton