kotsu - npm Package Versions

1.5.0

Removed

• [package] Dropped support of node < 6.0.0.
• [grunt][data] Removed property localesNames, since with updated locales structure it's easy to extract locale names.
• [grunt] Removed Grunt shell:jspm_config and shell:jspm_install tasks. Those steps will be done automatically during npm postinstall.
• [package][grunt][module] Removed grunt-gray-matter module in favour of published to NPM version.
• [modules][templates] Removed Nunjucks filters |number and |currency. Use new global function numbro instead.
• [modules] Removed need to pass Grunt instance inside gettext and nunjucks-extensions modules.
• [breaking][modules] Dropped locales option in Gettext. Class will determinate available l10n files based on directories structure you have in /source/locales. Note, that Gettext will load all messages, even for not declared in Grunt config locales, but for which you have l10n files.
• [breaking][modules] Dropped src option in Gettext. Expected directories structure hardcoded in Gettext. Path to locales still have to be specified with cwd, but everything beyond will be resolved by Gettext itself.
• [breaking][modules] Dropped support of tricky domains like en-US:nav:bar in dgettext(), which were used before to workaround inability of node-gettext to sustain few locales in single instance. With updated Gettext you can use provided methods to switch locales on the go, and access domains as normal, sane person.
• [breaking][modules] Dropped textdomain() method of Gettext and it's Nunjucks counterpart. Use new setTextdomain() instead to set domains, and setLocale() to change locale.
• [modules] Dropped resolveDomain() method of Gettext.
• [modules] Dropped load() method of Gettext in favour of new methods.
• [templates] Removed <link> referencing sitemap.xml from header, since none of search providers supports this method. See #88. Sitemap referenced in robots.txt instead.

Added

• [package] Moved development-related tasks to npm run scripts.
• [tests] Added Jest for running tests.
• [tests] Added some basic tests for existing Kotsu modules.
• [modules][templates] Added numbro.js as global Nunjucks function numbro.
• [modules] Added nunjucks-task module, which encapsulates l10n-specific logic stored in Grunt Nunjucks task itself before. Module exposes a single method to which should be passed usual Nunjucks options and some new, module-specific, options (mostly related to l10n). Module will return prepared configuration for task target with injected l10n and matter data and configurated Kotsu and l10n Nunjucks environment extensions.
• [modules] Added setLocale() method for Gettext and it's counterpart for Nunjucks. Use it to switch current locale. Don't forget to switch it back, though... Note, that you have to call setLocale with locale of you environment at least once on top level of your project to invoke proper Gettext instance. For Nunjucks it already does updated nunjucksIExtensions() of Gettext.
• [modules] Added setTextdomain() method for Gettext, and same global for Nunjucks. Call it to change default locale to specified one. If you have any, except default.
• [modules] Added bindTextdomain() method for Gettext, similar to GNU one. So far it used externally to load messages for active locales, but you can join the party and spawn more domains based on your delicate preferences. It expects your l10n files to be under {localeName}/LC_MESSAGES/.. or {localeName}/.. paths.
• [modules] Added autobindTextdomain() method for Gettext. It crawls active locale directory and automatically discovers all files, then loads them as domains. For example, en-US/nav/bar.po l10n file will end up as nav/bar domain of en-US locale. Used externally, during Gettext invocation to load all l10n files.
• [modules][grunt][templates] Added missing before regioncode and isoLocale to Nunjucks filters.
• [grunt] Gruntfile now returns grunt instance. This allows to invoke gruntfile in other environments and use Gruntfile config and methods.

Changed

• [package] Updated dependencies.
• [package] Replaced grunt-standard with standard.
• [package] Replaced grunt-stylelint with stylelint.
• [package] jspm modules will be installed automatically during npm postinstall step.
• [misc] Updated Stylelint rules to support ^7.9.0.
• [modules][templates] nunjucks-extensions module will set numbro locale, default formatting and currency formatting to current locale's parameters on initialization.
• [modules][templates] moment now exposed to Nunjucks as pure function and no longer sets locale to current locale internally.
• [modules][templates] nunjucks-extensions module will set moment locale to current locale on initialization.
• [modules] Refactored Gettext, so now it handles locales and domains in similar to GNU gettext way, by creating new instance for each locales. Finally you don't need to use domain to store locale any more.
• [modules] nunjucksExtensions() of Gettext on invocation will now set locale to current locale of task and set domain to default.
• [modules] load method of Gettext has been split into bindTextdomain() and autobindTextdomain() methods, and it's discovery mechanism now works slightly different.
• [breaking][modules] dgettext() and other domain-related gettext functions now expects as domain not :nav:bar for current locale or en-US:nav:bar for specific one, but nav/bar... for both cases. If you want to call domain from other locale, change it with new setLocale() first.
• [modules][grunt] Refactored i18-tools to be completely static and class-less, so it no longer requires invocation with new. Instead of providing locales properties for whole class, now only relevant properties should be provided for invoked methods.
• [modules][grunt] Made i18-tools-related Nunjucks extensions to be declared by newly added method nunjucksExtensions() to i18-tools . This finally removed all manual declarations of extensions from Nunjucks task, leaving clear space for projects-specific filters and globals.
• [modules] Unified behaviour of i18-tools method getLocaleDir() with declared as Nunjucks global localeDir(). Now it will always output '' for base locale and '/' + localeName ('/' + localeUrl) for others.
• [modules] Renamed printf to more appropriate sprintf.
• [grunt][modules] Renamed gettext.installNunjucksGlobals to gettext.nunjucksExtensions to be unified with other similar calls.
• [grunt][modules] gettext.nunjucksExtensions() will now require current locale as second argument, and it will set gettext default textdomain to it during invoking, so there is no need to call gettext.textdomain(currentLocale) in Grunt task.
• [grunt][modules][templates] Changed structure of locales to be normalized database-like, with accessible locale names as keys for each locale object, instead of being just an array. It makes working with locales much easier, both in JavaScript and Nunjucks environments.
• [grunt][data] Moved locales, baseLocale and gettext config properties one level higher, thus removing i18n property. There is no reason to keep those mandatory properties so deep.
• [grunt] grayMatter task no longer uses expand: true option, since it writes to single file, thus doesn't need expanding.
• [grunt] l10n-specific logic of Nunjucks task moved into standalone module nunjucks-task. This allowed to make Nunjucks task file much cleaner and to contain mostly options with minimum of logic.
• [grunt] All options of Nunjucks task has been flatten by moving options.i18n.* and options.humanReadableUrls.* directly to options.
• [grunt] Option options.files.matter of Nunjucks task moved to options.matter and now excepts function, which will return prepared object, or matter object itself instead of path to matter file.
• [templates] Added onlyActiveOnIndex option to Nav and NavItem components, which allows to force item be active only when current route matches link route not partially, but completely. Disabled by default.

Fixed

• [grunt] Fixed wrong default currency format for base locale.
• [modules] Fixed occasionally swallowed by crumble last characters of path with file extension.
• [modules][templates] Fixed numbro deprecation of setLanguage method warning.
• [templates] Fixed wrong urls on Example page.
• [templates] Fixed not retrieved this.orig.cwd when grunt-newer used.

1.4.0

Removed

• [data] Removed example.json. Finally there won't be need to delete it every time new project bootstrapped with Kotsu.

Added

• [grunt] Added .o-show-grid to exceptions in uncss task.
• [templates] Added ability to specify specific for page themeColor via themeColor in Gray Matter.

Changed

• [ci] Switched to alpine linux distribution as base layer for nginx container.

• [package] Updated dependencies.

• [package] Moved linting and testing dependencies to devDependencies.

• [misc] Upated Stylelint scss rules to 1.4.1.

• [styles] Updated Ekzo to 2.4.0

• [styles] Since Ekzo 2.4.0 doesn't provide spacing for icons and sprites any more, added them to Kotsu in form of .Icon--left and .Icon--right.

• [styles] Renamed _Icons.scss to _Icon.scss.

• [styles] Since Ekzo 2.4.0 also doesn't provide .o-btn size variations and default paddings for buttons, added them in form of .Btn* component.

• [styles] .Btn by default extends .o-btn.

• [styles] Followed Ekzo changes:

  • Set settings, which shouldn't generate CSS properties, to null;
  • Converted $ekzo-line-height to $ekzo-line-heights map and using new ekzo-line-height() to retrieve values from it;
  • Added .o-svg-icon to imports.

• [templates] Used new .Btn* instead of .o-btn* and .Icon* instead of .o-icon*.

1.3.1

Added

• [ci] Added support for AppVoyer

Changed

• [package] Removed devDependencies section and all packages moved to dependencies section since it's impossible to use kotsu with npm install --production or --only flag, see

Fixed

• [grunt] Updated uncss rules to ignore not only .is-*, but also .*is-*, .*has-* and .*not-*. This allow to use more specific selectors, like .nav-is-active when needed.
• [templates] Fixed Nav component not passing depth to Items caller.

1.3.0

Added

• [ci] Added env.SITENAME variable to setup site domain name in nginx and templates.
• [grunt][data] Added env.STAGING which returns true if --staging flag provided or environment variable is set (example: grunt build --staging).
• [templates] From now on robots.txt in staging environment will disallow everything.
• [styles] Added .Wrapper--bleed.

Changed

• [ci] Replace environment variables in dockerfile using envsubst (not passing them to docker itself actually).
• [ci] env.DEPLOY_SERVER renamed to env.DEPLOY_IP
• [templates] Moved content of Item component from Nav into standalone NavItem component, which later should be re-used in Nav. This should reduce clutter in Nav component.
• [templates] Completely reworked Example component.
• [static] robots.txt now points to sitemap.xml as per Google guidelines. See https://github.com/LotusTM/Kotsu/issues/88 for details.
• [static] Converted robots.txt into template and moved to source/temaplates. Now it can be formatted based on any data, provided to Nunjucks.
• [styles] Updated Ekzo to 2.3.1.
• [styles] Renamed .Wrapper--contain to .Wrapper--content.
• [styles] pre will no longer show in full width on hover by default.
• [styles] Changed default font size from 14px to 16px.
• [misc] Updated Stylelint rules.

Fixed

• [styles] Fixed duplicate import of animations.
• [templates] Fixed wrongly applied Nav items styles to breadcrumb items.
• [templates] Fixed applied .Wrapper on page.applyWrapper: false instead of true.
• [templates] Fixed some components docs.
• [package] Reverted to Nunjucks 2.5.2 due to yet not fixed bugs (#912, #120) in Nunjucks 3.0.0 by fixing grunt-nunjucks-2-html at 2.0.0.