kotsu - npm Package Versions

published 1.14.1 • 7 years ago

Changelog

1.14.1 - 2018-06-11

Changed

[styles] Added better paddings for <code> tag.

Fixed

[grunt] Local assets' absolute URLs are now cachebusted too thanks to grunt-cache-bust new option urlPrefixes.

Such absolute URLs, leading to local assets, are used in RDFa and Open Graph declarations.

1.14.0

published 1.14.0 • 7 years ago

Changelog

1.14.0 - 2018-06-07

Changed

[package] Updated dependencies.
[package] Updated JSPM to v0.17.0-beta.48.

[styles] $ekzo-font-families now uses unquote() to declare fonts. Helps to avoid issues when merging font family with predefined font familis stacks:

  $ekzo-font-families: (
-   base:           '"Open Sans", #{$ekzo-helvetica-font-stack}',
+   base:           unquote('"Open Sans", #{$ekzo-helvetica-font-stack}'),
    monospace:      $ekzo-consolas-font-stack
  );

[templates] Structured data for social links in <head> will no longer be outputted if services actually doesn't have url property.

This can happen, when site using only image for this service, but doesn't have account in social network.
[ci] Updated configs to work with Node 10.
[ci] Change npm install to npm ci, which is faster and does not change package-lock.json.
[ci] Updated CircleCI config to cache NPM modules and JSPM package separately.

Fixed

[data] Fixed URLs paths joined by path.join instead of more appropriate urljoin.
[grunt] grunt-jspm will no longer fail on NPM warnings.
[grunt] grunt-jspm will no longer exit before all files have been built.
[ci] Due to latest changes in Travis, npm test no longer invoked automatically. Fixed by forcing npm test to run before build.

1.13.0

published 1.13.0 • 7 years ago

Changelog

1.13.0 - 2018-03-30

Added

[grunt] Added grunt-jspm task which allows launch JSPM watch and build within Grunt.

JSPM no longer needs to be launched with npm-run-parallel and JSPM running process is now synchronous and predictable.

Besides, new JSPM task able to handle simultaneous watch of multiple packages.

Note, that task uses child_process.spawn under the hood. Because JSPM does not expose its watch API, for now it is possible to be launched only with CLI.

#230
[grunt] Added grunt-jspm-emitter which is responsible for launching chockidar-socket-emitter, which is watching scripts changes and emits them to SystemJS when Kotsu started in Hot Reloading Module mode, with --hmr flag #230
[package][modules] Added version NPM script and called by it modules/changelog-version.

This is a small experimental unility, which will run everytime version will be bumped with npm version command, so that you'll never forget to update CHANGELOG version before release. Of course, if CHANGELOG exists at all.

Note, that to work CHANGELOG should follow keepchangelog.com specs.
[modules] Added SITE.matter.$raw internal property, which holds not rendered Front Matter.

[modules] Added cache module which provides a central cache storage and additional method for memoizing function results based on it's arguments or specified cache store key.

Cache itself based on lru-cache.

Examples:

const { cache, cacheFunc } = require('./modules/cache')

cacheFunc(renderFunc)('{{ value }}', { value: 'test' })
// -> 'test'
cacheFunc(renderFunc, 'matter')('{{ value }}', { value: 'test2' })
// -> 'test2'

cache.get('123er23')
// -> 'test'
cache.get('matter')
// -> 'test2'

Changed

[grunt] Replaced shell:jspm_watch and shell:jspm_build tasks with jspm:watch and jspm:build.

Besides, jspm:watch is now also part of the serve task.

#230
[modules] Matter data is no longer rendered ad hoc (by calling getPage(), etc), and instead rendered only once during environment configuration.

Raw version of same matter is always available under SITE.matter.$raw.

Beware that due to those changes, in default rendered and cached version page-specific context variables, like PAGE.locale won't be available. Pieces with such variables should be rendered explicitly with render() filter applied to $raw version of data.
[modules][nunjucks] Nunjucks getPage() no longer renders Matter data and instead returns rendered and cached data.

For rare cases, when some additional rendering with specific context required, raw pages data available under $raw property.
```
{% set item = getPage('/item').props.title %}
{# -> 'Якась сторінка' #}
{% set item = getPage('/item').$raw.props.tile %}
{# -> '={{ gettext("Some page") }}' #}
```
[modules] Simplified code related to caching of data.SITE.matter and data.SITE.images.
[modules] It is now possible to import clear-workid module without causing side effects and run it later. Just in case someone want to, let's say, test it... Like we shouldn't test it too...

Running it with node will work the same way as before.
[modules] Improved clear-workid output visuals.

Removed

[grunt] Removed grunt-shell which was used to launch JSPM watch and build. It has been replaced by grunt-jspm which spawns JSPM process #230
[package] Removed js:watch script, since it is handled by grunt-jspm by now #230
[package] Removed npm run start-hmr, npm run serve-hmr and related subtasks.

Just use npm start -- --hmr or npm run serve -- --hmr to launch Hot Module Reloading.
[package] Removed npm-run-all package, since due to newly added grunt-jspm and grunt-jspm-emitter it no longer used #230
[templates] Removed Nunjucks getPage() function forceRender and cached options, because getPage() now always returns rendered and cached pages data, while raw version available with $raw property.

Fixed

[grunt] Fixed async Nunjucks templates not working by updating grunt-nunjucks-2-html to version 2.2.0 vitkarpov/grunt-nunjucks-2-html#56
[modules] Fixed lack of colors in JSPM output #90
[modules] Replaced ES6 imports and exports in some module files with Node require and module.exports.

1.12.0

published 1.12.0 • 7 years ago

Changelog

1.12.0

Added

[styles] Added inputs default styling to textarea and select.
[scripts] Added built-in crucial polyfills for DOM matches, closest and classList methods.
[scripts] Initial console.log will now display current Circle CI build number and commit SHA1, which caused it.
[misc] Added more cleaning directives in robots.txt.
[modules] Added more aggressive caching for SITE.matter, which makes single require of matter files instead of require per each rendered file.
[modules] Added module sass-extensions which now is a home for all Sass functions and other extensions.
[modules][styles] Added Sass function kotsu-data with access to all Kotsu data. It is a replacement for kotsu-path and kotsu-theme-colors functions #35

[templates][modules] Added Nunjucks imageSize() function which takes in image paths and returns image-related data:

{% set image = imageSize('path/image.jpg') %}

{{ image.src }} returns 'path/image.jpg'
{{ image.width }} returns 100
{{ image.height }} returns 200
{{ image.set() }} returns all images in set
{{ image.srcset() }} returns `srcset`

See additional cases in test file.

[grunt] Added grunt-image-size task, which collects data about each image.
[grunt] Added grunt-write-json task, which compiles JS to JSON-file. Used as to prepare data for frontend scripts.
[data] Added ability to pass data from Grunt and source/data to frontend scripts, which are handled by JSPM.

This is done by editing source/data/scripts.js file, which later will be compiled into JSON file with grunt-write-json Grunt task.

Data available to scripts from @data module:
```
import data from '@data'

console.log(data)
```
Yeap, less than ideal, but hopefuly it will be improved in future.

#265
[data] Added ENV.buildNumber build number and ENV.buildSHA1 with commit SHA1 which caused build.
[data] Added new data property SITE.images, which holds images information collected by grunt-image-size.
[data] Added new data property PATH.file which points to Gruntfile file.build values.

[conf] Enabled new SCSS Stylelint rule:

scss/dollar-variable-colon-space-after: at-least-one-space

[package] Update package-lock.json for greenkeeper builds and upload it to github using greenkeeper-lockfile package, closes #350
[package] Added jest.config.js where now stored Jest config from package.json.
[package] Added preversion script, which will run tests and build before npm version command.

Changed

[package] Updated dependencies.
[package][data] twitter proprty is no longer a part of the package.json. It's moved into data SOCIAL.twitter.handle instead.
[package] Removed grunt-contrib-uglify in favor of uglify-js bundled with jspm #294
[package] Moved Jest config from package.json to jest.config.js.
[grunt] Split tinypng:build task into tinypng:sprites and tinypng:images tasks, which are stored now in sprites and images tasks files.

tinypng:images is disabled by default to avoid awkward situations...
[styles] Default .Icon--left and .Icon--right classes now have more reasonable margins.

[styles] Replaced all kotsu-path and kotsu-theme-colors functions instances with kotsu-data function. Queries inside functions have been changed too, to access needed properties:

- $ekzo-images-path:       '/' + kotsu-path(images);
+ $ekzo-images-path:       '/' + kotsu-data('PATH.images');
- $ekzo-ui-path:           '/' + kotsu-path(images) + '/ui';
+ $ekzo-ui-path:           '/' + kotsu-data('PATH.images') + '/ui';
- $ekzo-sprites-path:      '/' + kotsu-data('PATH.sprites');
+ $ekzo-sprites-path:      '/' + kotsu-path(sprites);
- $ekzo-fonts-path:        '/' + kotsu-data('PATH.fonts');
+ $ekzo-fonts-path:        '/' + kotsu-path(fonts);

- secondary: kotsu-theme-color(),
+ secondary: kotsu-data('SITE.themeColor'),

[scripts] ES6 in, CoffeeScript out.

CoffeeScript is no longer a part of the Kotsu. All code rewritten in pure ES6, all .coffee files renamed to .js, all imports no longer referring to .coffee extension, CoffeeScript no longer supported by Jest testing environment out of the box.

Process of transition has been accompanied by VHS Glitch - Blood In Blood Out.
[scripts] main.js content no longer wrapped into jQuery function.

Since the script is placed in the end of the HTML, when the DOM is loaded, and JSPM anyway wraps content of each module into a function and leaking into a global scope variables no longer possessing any threat, there is simply no sense to continue doing this in 2018.
[modules] node-gettext has been updated to the version 2.0.0 and related gettext module completely rewritten. It is no longer a class, but a simple function, which returns same Gettext methods as before.

Closes #156, fixes #272, related to #45.
[modules] gettext will now log to the console errors in case any translation is missing.

Closes #46.
[modules][grunt][data] Matter data is no longer defined in Nunjucks task and instead passed explicitly as a part of SITE.matter data within data index file.
[modules][grunt] styles task file has been cleened up by moving Sass functions into standalone module modules/sass-extensions.
[modules][tests] All testing utilities moved directly into modules.
[modules] modules/nunjucks.js renamed to modules/nunjucks-test-utils.js.
[templates] Changed paths in _base.nj script block:
- PATH.scripts main.js replaced with PATH.file.script.compiled
- PATH.scripts main.min.js replaced with PATH.file.script.minified
[templates] Due to update of numbro to version 2.0.0 numbro.setCulture() method has been changed to numbro.setLanguage().
[styles] Updated Ekzo to HEAD version past 2.6.0.
[styles] Loading order of settings files within settings layer no longer matters.
[data] Reworked the way paths supplied to index data file PATH from Gruntfile.

Now, out of the box, index file will automatically pickup following settings from Gruntfile:
- All path.build will be stripped of the build root and placed in the root of PATH
- file.build will be stripped of the build root and placed in PATH.file
- All path will be placed as it is in the root of PATH, which makes all path values accessible in data consumers by following PATH.source, PATH.build, etc.
No changes to structure was made except newly added PATH.file property. However, with this change it is no longer required to manually map Gruntfile path and file values to data file PATH. Instead, Kotsu will pick up all of them them for you.
[data] Matter data property renamed from SITE._matter to SITE.matter.
[data] Data file now destructuring config() values once to avoid numerous config() calls. This should improve performance in large data files.
[data] Data file now using path.join() method to properly concatenate various paths.
[tests] runGrunt test utility now returns console output in case of resolve.
[ci] Update Travis and CircleCI configuration files to use nove v9 for tests and builds.

Removed

[grunt] Removed file.build.style.tidy setting. Now it's embedded into uncss task directly.

Since this paths shouldn't be used anywhere else, keeping it in main Gruntfile didn't make much sense.
[grunt] Removed file.build.sprite.hash setting. Now it's embedded into tinypng task directly.
[grunt] Removed grunt-responsive-images-extender in favor of newly added imageSize() Nunjucks function.
[package][scripts] jQuery no longer shipped with Kotsu by default. The time has passed. Use native DOM API.
[package] Removed Jest config property from package.json in favor of jest.config.js.
[package] Removed tests/utils/jest.js in favor of jest.config.js.
[temlates] Removed imports block from _base.nj layout. They weren't useful since you wouldn't be able to extend base layout without them anyway.
[modules][styles] Removed kotsu-path and kotsu-theme-colors functions in favor of more generic function kotsu-data which has access to all Kotsu data #35
[styles][templates] Removed pages-related classes like p-index and p-blog.

Such usage is deprecated. Pages are complex components and should be threaded just like any other component. Thus, components classes like Index for the index page or Blog for the blog encouraged instead.

Fixed

[modules] Fixed encoded Cyrillic URLs after going through urljoin().

1.11.0

published 1.11.0 • 7 years ago

Changelog

1.11.0

Added

[styles] Added text-decoration-skip: ink; to default links style.
[modules] Added Date refinament which expects ISO 8601 date.

Changed

[package] Updated dependencies.
[package] Updated Ekzo to version 2.6.0.
[grunt] SEO-related comments  and  will no longer be stripped during HTML minification.
[grunt] Comments starting with ! like  will no longer be stripped during HTML minification.
[templates] Moved global components imports from _base.nj layout into components and layouts where they are actually used. Global imports no longer encouraged.

In such way components will declaratively show their dependencies on each other. It will solve two issues:
1. Eliminate need to maintain specific order of imports to ensure that used by other components macros are imported before them.
2. Will make testing easier, since for complex components it won't be needed any more to import manually all needed pieces in tests files too.
Importing many times same components even in 300-pages projects does not have any performance-wise implications. So, why not?

Note, that for components you need to place imports in the beginning of the file, outside of {% macro %}:
```
{% from '_components/_NavItem.nj' import NavItem with context %}

{% macro Nav() %}
<p>Macro content...</p>
{% endmacro %}
```
However, in case of layouts which extends to import components with context, import should be placed inside {% block %}, otherwise context will end up undefined:
```
{% block main %}
{% from '_components/_Example.nj' import Example with context %}

<p>Content...</p>
{% endblock %}
```
[templates] Moved id of the Example() component, which is generated based on title, from heading to <article>. This will ensure that example's generated link will properly scroll to element itself in cases when heading is changed in some specific ways...
[templates] Improved components doc blocks. Now they should confront JSDoc standards.
[modules] Improved isActive() function performance by exiting early during checks and not using RegExp in exact mode.
[modules] Nunjucks isActive() function is now stricter in non-exact mode. It will match only full segments and not literal parts of URLs.

For example, from now for isActive('/test') those are different URLs even in non-exact mode:
```
/test/page
/test234/page
```
While those are not:
```
/test/page
/test/234/page
```

Fixed

[modules] Fixed isActive() Nunjucks function returning wrong results for URLs with partial match.

Few examples for page with URL /test/page:

{{ isActive('/tes') }} {# has been wrong `true` #}
{{ isActive('/tes/') }} {# has been wrong `true` #}
{{ isActive('/test') }}
{{ isActive('/test/') }}
{{ isActive('/test/pag') }} {# has been wrong `true` #}
{{ isActive('/test/pag/') }} {# has been wrong `true` #}
{{ isActive('/test/page') }}
{{ isActive('/test/page/') }}

1.10.0

published 1.10.0 • 7 years ago

Changelog

1.10.0

Added

[templates] Added default canonical URL to each page, which references page itself.

Predefined canonical URL will avoid search providers being confused in case of duplicate content caused by dynamic parameters in URL like those:
```
https://example.com
https://example.com?search=test
```
Canonical URL will tell search providers to always treat original page without parameters as canonical and the one, which should be displayed in search results.

To disable default canonical URL, specify in Front Matter:
```
---
canonical: false
---
```
Or set your own canonical:
```
---
canonical: /this-is-real-page
---
```
See #326 for details.
[docs] Added documentation from Wiki into docs directory.

Behold, :blue_book: The Documentation! Well, not much. But some day a miracle will happen...

#317

Changed

[package] Updated dependencies.
[grunt] Enabled additional compression options in grunt-contrib-htmlmin task.

Here is full list of added options:
```
minifyJS: true
minifyCSS: true
processConditionalComments: true
quoteCharacter: "'"
sortAttributes: true
sortClassName: true
```
As a result, inlined JS CSS and IE conditional comments will be minified.

Sorting of attributes and class names will allow to gzip pages even better.
[templates] PAGE.canonical no longer accepts array of URLs. Instead only one URL can be provided.

This should prevent stupid situations, when people specifing multiple canonical URLs without understanding how Google and Yandex will treat it.

See #326.
[templates] Removed not needed indentation from Front Matter sections.
[templates] Prettified Google Analytics and Yandex Metric snippets. They will be uglified anyway.
[templates] Prettified Nav components Item. Yeap, now it takes more space, but at least now it is readable.

Fixed

[package] Fixed not locked JSPM version.
[templates] Removed accidentally left type="text/javascript" attribute in <script> tag of Yandex component.

1.9.0

published 1.9.0 • 7 years ago

Changelog

1.9.0

Added

[templates] Added ability to exclude certain pages from Breadcrumb() component with new Front Matter excludeFromBreadcrumb property set to true.

It is useful for for landing or tag parent index-pages, which should never be listed in breadcrumb.

Note, that it will also hide page from breadcrumb in search snippets.
[templates] Added lastItemClass parameter for Breadcrumb() component, which allows to set specific class on last item of the breadcrumb.
[modules] Added better error output for traverse and relied on it nunjucks-render and format.

New error includes input, which failed rendering. For objects it will include currently rendered string of the leaf.
[modules] Added error messages in case wrong values passed to getLocaleProps(), getLocaleDir() and related Nunjucks localeDir().

This should clarify obscurity of vague and hard to debug internal errors when grunt.locales, Matter's SITE.locales or PAGE.locale are undefined or wrong.
[conf] Added caching of node_modules for Travis.
[tests] Added Breadcrumb() Nunjucks component tests.

Changed

[grunt] Generated sitemap.xml will no longer have trailing slashes in URLs, which makes it uniform with trailing slash-less URLs in site navigation.

To revert this change, remove from Grunt config sitemap_xml.options.trailingSlash: false option.
[templates] Breadcrumb() component now will always print last item, regardless of displayLast option. However, when displayLast enabled, last item will be hidden visually and for screen readers with display: none.

It required to confront requirements for BreadcrumbList structured data, dictated by Google. Breadcrumb should be full and include all tail.
[templates] Breadcrumb() last item changed from <span>, which previously indicated inactive element, to fully working <a>.

It's done to confront BreadcrumbList structured data requirements.

If you still wish to keep last item inactive, use newly added lastItemClass option to set a specific class, like g-link--inherit, which will make anchor appear like a regular text, making it inactive for users, while still accessible for bots.
[package][tests] Replaced NPM postbuild script, which checks clean working dir, with more reliable clean-workdir.js test.

It will no longer occasionally pass wrongly test when grep is unavailable (like in Windows environment out of box).
[conf] Both Travis and Circle CI will no use latest version of NPM to avoid issues with discrepancies regarding package-lock.json format.

It is recommended to use for development latest NPM too:
```
npm install -g npm@latest
```
[conf] Enabled again package-lock.json updates on npm install for AppVeyor #289.

Fixed

[grunt] Thanks to update of grunt-gray-matter to version 1.3.0 pages with Front Matter having syntax errors will no longer be silently ignored.

Instead, detailed error message will be thrown.

See #320.
[conf] Fixed Travis ignoring failed tests and exit code 1 in postbuild phase.

It is happened because when script runs in after_success phase exit codes 1 are ignored. See Travis docs.

Thus, .travis.yml after_success changed to script which will properly react to exit code 1.
[tests][package] Fixed Jest testPathIgnorePatterns which resulted in ignoring tests on some CI (like Travis).

For instance, Travis builds into /home/travis/build/LotusTM/Kotsu, and specified /build/ in ignore patterns of Jest effectively ignored any path, which contained build. See jest#1057.

<rootDir> has been added to ignore only contained in root build and temp directories.

1.8.0

published 1.8.0 • 7 years ago

Changelog

1.8.0

Added

[templates] Outdated Browser component now has rel='nofollow' specified in the link.
[templates] Example component now will generate id and anchor for each heading, so it is possible to reference specific section whenever needed
[modules] Added traverse function to walk Objects and Arrays and recursively apply specified function with a predicate. Mostly useful for Kotsu internal dark deeds — rendering Objects and Arrays :sparkles:
[modules] Added format() (sprintf()) tests.
[modules] Added experimental ability for nunjucks-render to specify this of context, which by default points to input itself.

This is useful feature to use in data structures for self-referencing:
```
{% set data = {
  name: 'Mike',
  hello: 'hey {{ this.name }}'
}|render() %}

{{ data.hello }} === hey Mike
```
[conf] Added whitespace trimming disallow to .editorconfig for Jest snapshot files. To avoid very stupid situations with broken snapshots...
[conf] Added new SCSS Stylelint rules:
```
scss/at-else-if-parentheses-space-before: always
scss/at-function-parentheses-space-before: never
scss/at-mixin-parentheses-space-before: never
```
Functions and mixins declarations now require space before (arguments), to follow codestyle enforced by standard in JavaScript.
[utils] Added information about type for tcomb Maxlength refinement.

Changed

[package] Updated dependencies.
[grunt] uncss task will now ignore any remote CSS by default (starting with https, http or //) to avoid pulling into main stylesheets file unexpected external CSS, which can be downloaded by 3rd-party scripts.

Instead, it is recommended to whitelist needed remote files explicitly, to be sure about what gets into main stylesheets and to avoid unexpected duplication.
[modules] Improved nunjucks-render.

Now it renders objects and arrays recursively and no longer relies on JSON.stringify().

As a result, slightly improved performance, less limitations, implied by JSON stringification, and no more tricky code to properly remove escaping of Nunjucks templates.

See #173.
[modules] Improved sprintf, which used as format() filter in Nunjucks.

Now it applies sprintf recursively to input and no longer relies on JSON.stringify() with all its limitations.

As a side effect, it gains minor performance boost and will no longer trigger stupid errors with any string containing normal percentages, like 23%.

See #173.
[modules] Converted sprintf to pure JavaScript #287.
[modules] Converted nunjucks-render to pure JavaScript #287.
[modules] Renamed sprintf to format, just for consistency with filter used in Nunjucks.
[modules][utils] Move tcomb refinements and validate from test utils to modules, since they can be used not only for testing.
[package] Renamed main JSPM package from kotsu to more generic main. which better reflects main file name.
[grunt][templates] During JSPM build and SystemJS.import() now used main package name (main).

Finally full filepath no longer required during JSPM build invocation :guitar:
[styles] In supplied theme-file outer-space color renamed to more generic secondary color.
[styles] Update codestyle — functions and mixins declarations now require space before (arguments).
[styles] Update Ekzo to version 2.5.3.
[styles] Given better comments headers for Btn component file.
[static][templates] Renamed mstile.png and mstile-wide.png icons to mstile-310x310.png and mstile-310x150.png to be more specific sizes and usage.
[ci] Disabled package-lock.json updates on npm install for AppVeyor #289.
[utils] More robust way to get type name for tcomb EqualKeyAndProp refinement.
[utils] Split tcomb util file into refinements and validate files with standalone tests.
[tests] Improved Nunjucks render() filter tests.

Removed

[static] Removed accidentally left and unused mstile-70x70.png icon.

Fixed

[package] Fixed postbuild test for AppVeyor #289.
[package] Fixed tcomb-validation version being not locked.
[styles] Fixed headers of settings files having .DEFAULTS in the end. That was a shadow of far past...
[templates] Fixed Google Analytics snippet using relative // protocol instead of https. Are you still using HTTP? Don't be afraid. That won't hurt you. But I burp'n will.

1.7.0

published 1.7.0 • 8 years ago

Changelog