diff --git a/Dockerfile b/Dockerfile index 6dd4e020..832f6bc1 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,10 +1,36 @@ -# Basic docker based environment -# Necessary to trick dokku into building the documentation -# using dockerfile instead of herokuish -FROM php:8.1 +# ---------------------- +# 1. Build stage +# ---------------------- +FROM node:22-alpine AS builder -WORKDIR /code +# Git is required because docs/package.json pulls a dependency from GitHub. +RUN apk add --no-cache git openssh-client -VOLUME ["/code"] +WORKDIR /app/docs -CMD [ '/bin/bash' ] +# Copy dependency manifests first to preserve Docker layer caching. +COPY docs/ ./ +RUN npm ci + +# Increase max-old-space-size to avoid memory issues during build +ENV NODE_OPTIONS="--max-old-space-size=8192" + +# Build the site. +RUN npm run docs:build + +# ---------------------- +# 2. Runtime stage (nginx) +# ---------------------- +FROM nginx:1.27-alpine AS runner + +# Copy built files +COPY --from=builder /app/docs/.vitepress/dist /usr/share/nginx/html + +# Expose port +EXPOSE 80 + +# Health check (optional) +HEALTHCHECK CMD wget --quiet --tries=1 --spider http://localhost:80/ || exit 1 + +# Start nginx +CMD ["nginx", "-g", "daemon off;"] diff --git a/docs.Dockerfile b/docs.Dockerfile deleted file mode 100644 index 8c1ee52e..00000000 --- a/docs.Dockerfile +++ /dev/null @@ -1,24 +0,0 @@ -# Generate the HTML output. -FROM ghcr.io/cakephp/docs-builder as builder - -COPY docs /data/docs -ENV LANGS="en fr ja pt" - -# build docs with sphinx -RUN cd /data/docs-builder && \ - make website LANGS="$LANGS" SOURCE=/data/docs DEST=/data/website - -# Build a small nginx container with just the static site in it. -FROM ghcr.io/cakephp/docs-builder:runtime as runtime - -ENV LANGS="en fr ja pt" -ENV SEARCH_SOURCE="/usr/share/nginx/html" -ENV SEARCH_URL_PREFIX="/chronos/3" - -COPY --from=builder /data/docs /data/docs -COPY --from=builder /data/website /data/website -COPY --from=builder /data/docs-builder/nginx.conf /etc/nginx/conf.d/default.conf - -# Move docs into place. -RUN cp -R /data/website/html/* /usr/share/nginx/html \ - && rm -rf /data/website diff --git a/docs/.gitignore b/docs/.gitignore new file mode 100644 index 00000000..974d64e4 --- /dev/null +++ b/docs/.gitignore @@ -0,0 +1,4 @@ +node_modules +*/public/ +.vitepress/cache +.vitepress/dist diff --git a/docs/.vitepress/config.js b/docs/.vitepress/config.js new file mode 100644 index 00000000..181574bb --- /dev/null +++ b/docs/.vitepress/config.js @@ -0,0 +1,76 @@ +import baseConfig from '@cakephp/docs-skeleton/config' + +import { createRequire } from "module"; +const require = createRequire(import.meta.url); +const toc_en = require("./toc_en.json"); +const toc_fr = require("./toc_fr.json"); +const toc_ja = require("./toc_ja.json"); +const toc_pt = require("./toc_pt.json"); + +const versions = { + text: "3.x", + items: [ + { text: "3.x (current)", link: "https://book.cakephp.org/chronos/3/en/", target: '_self' }, + { text: "2.x", link: "https://book.cakephp.org/chronos/2/en/", target: '_self' }, + ], +}; + +// This file contains overrides for .vitepress/config.js +export default { + extends: baseConfig, + srcDir: '.', + title: 'Chronos', + description: 'CakePHP Chronos Documentation', + base: "/3/", + rewrites: { + "en/:slug*": ":slug*", + }, + sitemap: { + hostname: "https://book.cakephp.org/chronos/3/", + }, + themeConfig: { + socialLinks: [ + { icon: "github", link: "https://github.com/cakephp/chronos" }, + ], + editLink: { + pattern: "https://github.com/cakephp/chronos/edit/3.x/docs/:path", + text: "Edit this page on GitHub", + }, + sidebar: toc_en, + nav: [ + { text: "CakePHP", link: "https://cakephp.org" }, + { text: "API", link: "https://api.cakephp.org/chronos" }, + { ...versions }, + ], + }, + locales: { + root: { + label: "English", + lang: "en", + themeConfig: { + sidebar: toc_en, + }, + }, + '/fr/': { + label: "Français", + lang: "fr", + themeConfig: { + sidebar: toc_fr, + }, + }, + '/ja/': { + label: "日本語", + lang: "ja", + themeConfig: { + sidebar: toc_ja, + }, + }, + '/pt/': { + label: "Português", + lang: "pt", + themeConfig: { + sidebar: toc_pt, + }, + }, + }, +}; diff --git a/docs/.vitepress/theme/index.js b/docs/.vitepress/theme/index.js new file mode 100644 index 00000000..e33e19ec --- /dev/null +++ b/docs/.vitepress/theme/index.js @@ -0,0 +1 @@ +export { default } from '@cakephp/docs-skeleton' diff --git a/docs/.vitepress/toc_en.json b/docs/.vitepress/toc_en.json new file mode 100644 index 00000000..a38ed6a6 --- /dev/null +++ b/docs/.vitepress/toc_en.json @@ -0,0 +1,13 @@ +{ + "/": [ + { + "text": "CakePHP Chronos", + "collapsed": false, + "items": [ + { "text": "Introduction", "link": "/index" }, + { "text": "3.x Migration Guide", "link": "/3-x-migration-guide" }, + { "text": "API", "link": "https://api.cakephp.org/chronos" } + ] + } + ] +} diff --git a/docs/.vitepress/toc_fr.json b/docs/.vitepress/toc_fr.json new file mode 100644 index 00000000..593b6cf5 --- /dev/null +++ b/docs/.vitepress/toc_fr.json @@ -0,0 +1,12 @@ +{ + "/fr/": [ + { + "text": "CakePHP Chronos", + "collapsed": false, + "items": [ + { "text": "Introduction", "link": "/fr/index" }, + { "text": "API", "link": "https://api.cakephp.org/chronos" } + ] + } + ] +} diff --git a/docs/.vitepress/toc_ja.json b/docs/.vitepress/toc_ja.json new file mode 100644 index 00000000..6e732139 --- /dev/null +++ b/docs/.vitepress/toc_ja.json @@ -0,0 +1,12 @@ +{ + "/ja/": [ + { + "text": "CakePHP Chronos", + "collapsed": false, + "items": [ + { "text": "概要", "link": "/ja/index" }, + { "text": "API", "link": "https://api.cakephp.org/chronos" } + ] + } + ] +} diff --git a/docs/.vitepress/toc_pt.json b/docs/.vitepress/toc_pt.json new file mode 100644 index 00000000..583aaa05 --- /dev/null +++ b/docs/.vitepress/toc_pt.json @@ -0,0 +1,12 @@ +{ + "/pt/": [ + { + "text": "CakePHP Chronos", + "collapsed": false, + "items": [ + { "text": "Introdução", "link": "/pt/index" }, + { "text": "API", "link": "https://api.cakephp.org/chronos" } + ] + } + ] +} diff --git a/docs/config/__init__.py b/docs/config/__init__.py deleted file mode 100644 index e69de29b..00000000 diff --git a/docs/config/all.py b/docs/config/all.py deleted file mode 100644 index 298940f1..00000000 --- a/docs/config/all.py +++ /dev/null @@ -1,50 +0,0 @@ -# Global configuration information used across all the -# translations of documentation. -# -# Import the base theme configuration -from cakephpsphinx.config.all import * - -# The version info for the project you're documenting, acts as replacement for -# |version| and |release|, also used in various other places throughout the -# built documents. -# - -# The full version, including alpha/beta/rc tags. -release = '3.x' - -# The search index version. -search_version = 'chronos-3' - -# The marketing display name for the book. -version_name = '' - -# Project name shown in the black header bar -project = 'Chronos' - -# Other versions that display in the version picker menu. -version_list = [ - {'name': '1.x', 'number': '/chronos/1', 'title': '1.x'}, - {'name': '2.x', 'number': '/chronos/2', 'title': '2.x'}, - {'name': '3.x', 'number': '/chronos/3', 'title': '3.x', 'current': True}, -] - -# Languages available. -languages = ['en', 'fr', 'ja', 'pt'] - -# The GitHub branch name for this version of the docs -# for edit links to point at. -branch = '3.x' - -# Current version being built -version = '3.x' - -# Language in use for this directory. -language = 'en' - -show_root_link = True - -repository = 'cakephp/chronos' - -source_path = 'docs/' - -hide_page_contents = ('search', '404', 'contents') diff --git a/docs/en/3-x-migration-guide.rst b/docs/en/3-x-migration-guide.md similarity index 70% rename from docs/en/3-x-migration-guide.rst rename to docs/en/3-x-migration-guide.md index d27e9b33..0891fec1 100644 --- a/docs/en/3-x-migration-guide.rst +++ b/docs/en/3-x-migration-guide.md @@ -1,20 +1,17 @@ -3.x Migration Guide -################### +# 3.x Migration Guide Chronos 3.x contains breaking changes that could impact your application. This guide provides an overview of the breaking changes made in 3.x -Minimum of PHP 8.1 -================== +## Minimum of PHP 8.1 Chronos 3.x requires at least PHP 8.1. This allows chronos to provide more comprehensive typehinting and better performance by leveraging features found in newer PHP versions. -MutableDateTime and MutableDate removed -======================================= +## MutableDateTime and MutableDate removed -The ``MutableDateTime`` and ``MutableDate`` classes have been removed. Long term +The `MutableDateTime` and `MutableDate` classes have been removed. Long term PHP will be deprecating and removing mutable datetime classes in favour of immutable ones. Chronos has long favoured immutable objects and removing the mutable variants helps simplify the internals of Chronos and encourages safer diff --git a/docs/en/conf.py b/docs/en/conf.py deleted file mode 100644 index f638bda2..00000000 --- a/docs/en/conf.py +++ /dev/null @@ -1,9 +0,0 @@ -import sys, os - -# Append the top level directory of the docs, so we can import from the config dir. -sys.path.insert(0, os.path.abspath('..')) - -# Pull in all the configuration options defined in the global config file.. -from config.all import * - -language = 'en' diff --git a/docs/en/contents.rst b/docs/en/contents.rst deleted file mode 100644 index 10625a2c..00000000 --- a/docs/en/contents.rst +++ /dev/null @@ -1,7 +0,0 @@ -.. toctree:: - :maxdepth: 2 - :caption: CakePHP Chronos - - /index - - API \ No newline at end of file diff --git a/docs/en/index.md b/docs/en/index.md new file mode 100644 index 00000000..d01afc51 --- /dev/null +++ b/docs/en/index.md @@ -0,0 +1,316 @@ +# Chronos + +Chronos provides a zero-dependency `DateTimeImmutable` extension, Date-only and Time-only classes: + +* `Cake\Chronos\Chronos` extends `DateTimeImmutable` and provides many helpers. +* `Cake\Chronos\ChronosDate` represents calendar dates unaffected by time or time zones. +* `Cake\Chronos\ChronosTime` represents clock times independent of date or time zones. +* Only safe, immutable objects. +* A pluggable translation system. Only English translations are included in the + library. However, `cakephp/i18n` can be used for full language support. + +The `Chronos` class extends `DateTimeImmutable` and implements `DateTimeInterface` +which allows users to use type declarations that support either. + +`ChronosDate` and `ChronosTime` do not extend `DateTimeImmutable` and do not +share an interface. However, they can be converted to a `DateTimeImmutable` instance +using `toDateTimeImmutable()`. + +## Installation + +To install Chronos, you should use `composer`. From your +application's ROOT directory (where composer.json file is located) run the +following: +```php +php composer.phar require "cakephp/chronos:^3.0" +``` + +## Creating Instances + +There are many ways to get an instance of Chronos or Date. There are a number of +factory methods that work with different argument sets: +```php +use Cake\Chronos\Chronos; + +$now = Chronos::now(); +$today = Chronos::today(); +$yesterday = Chronos::yesterday(); +$tomorrow = Chronos::tomorrow(); + +// Parse relative expressions +$date = Chronos::parse('+2 days, +3 hours'); + +// Date and time integer values. +$date = Chronos::create(2015, 12, 25, 4, 32, 58); + +// Date or time integer values. +$date = Chronos::createFromDate(2015, 12, 25); +$date = Chronos::createFromTime(11, 45, 10); + +// Parse formatted values. +$date = Chronos::createFromFormat('m/d/Y', '06/15/2015'); +``` + +## Working with Immutable Objects + +Chronos provides only *immutable* objects. + +If you've used PHP `DateTimeImmutable` and `DateTime` classes, then you understand +the difference between *mutable* and *immutable* objects. + +Immutable objects create copies of an object each time a change is made. Because modifier methods +around datetimes are not always easy to identify, data can be modified accidentally +or without the developer knowing. Immutable objects prevent accidental changes +to data, and make code free of order-based dependency issues. Immutability does +mean that you will need to remember to replace variables when using modifiers: +```php +// This code doesn't work with immutable objects +$chronos->addDay(1); +doSomething($chronos); +return $chronos; + +// This works like you'd expect +$chronos = $chronos->addDay(1); +$chronos = doSomething($chronos); +return $chronos; + +``` +By capturing the return value of each modification your code will work as +expected. + +## Date Objects + +PHP provides only date-time classes that combines both dates and time parts. +Representing calendar dates can be a bit awkward with `DateTimeImmutable` as it includes +time and timezones, which aren't part of a 'date'. Chronos provides +`ChronosDate` that allows you to represent dates. The time these objects +these objects is always fixed to `00:00:00` and not affeced by the server time zone +or modify helpers: +```php +use Cake\Chronos\ChronosDate; + +$today = ChronosDate::today(); + +// Changes to the time/timezone are ignored. +$today->modify('+1 hours'); + +// Outputs '2015-12-20' +echo $today; + +``` +Although `ChronosDate` uses a fixed time zone internally, you can specify which +time zone to use for current time such as `now()` or `today()`: +```php +use Cake\Chronos\ChronosDate; + +// Takes the current date from Asia/Tokyo time zone +$today = ChronosDate::today('Asia/Tokyo'); +``` + +## Modifier Methods + +Chronos objects provide modifier methods that let you modify the value in +a granular way: +```php +// Set components of the datetime value. +$halloween = Chronos::create() + ->year(2015) + ->month(10) + ->day(31) + ->hour(20) + ->minute(30); + +``` +You can also modify parts of the datetime relatively: +```php +$future = Chronos::create() + ->addYears(1) + ->subMonths(2) + ->addDays(15) + ->addHours(20) + ->subMinutes(2); + +``` +It is also possible to make big jumps to defined points in time: +```php +$time = Chronos::create(); +$time->startOfDay(); +$time->endOfDay(); +$time->startOfMonth(); +$time->endOfMonth(); +$time->startOfYear(); +$time->endOfYear(); +$time->startOfWeek(); +$time->endOfWeek(); + +``` +Or jump to specific days of the week: +```php +$time->next(Chronos::TUESDAY); +$time->previous(Chronos::MONDAY); + +``` +When modifying dates/times across DST (Daylight Savings Time) transitions +your operations may gain/lose an additional hours resulting in hour values that +don't add up. You can avoid these issues by first changing your timezone to +`UTC`, modifying the time: +```php +// Additional hour gained. +$time = new Chronos('2014-03-30 00:00:00', 'Europe/London'); +debug($time->modify('+24 hours')); // 2014-03-31 01:00:00 + +// First switch to UTC, and modify +$time = $time->setTimezone('UTC') + ->modify('+24 hours'); + +``` +Once you are done modifying the time you can add the original timezone to get +the localized time. + +## Comparison Methods + +Once you have 2 instances of Chronos date/time objects you can compare them in +a variety of ways: +```php +// Full suite of comparators exist +// equals, notEquals, greaterThan, greaterThanOrEquals, lessThan, lessThanOrEquals +$first->equals($second); +$first->greaterThanOrEquals($second); + +// See if the current object is between two others. +$now->between($start, $end); + +// Find which argument is closest or farthest. +$now->closest($june, $november); +$now->farthest($june, $november); + +``` +You can also inquire about where a given value falls on the calendar: +```php +$now->isToday(); +$now->isYesterday(); +$now->isFuture(); +$now->isPast(); + +// Check the day of the week +$now->isWeekend(); + +// All other weekday methods exist too. +$now->isMonday(); + +``` +You can also find out if a value was within a relative time period: +```php +$time->wasWithinLast('3 days'); +$time->isWithinNext('3 hours'); +``` + +## Generating Differences + +In addition to comparing datetimes, calculating differences or deltas between +two values is a common task: +```php +// Get a DateInterval representing the difference +$first->diff($second); + +// Get difference as a count of specific units. +$first->diffInHours($second); +$first->diffInDays($second); +$first->diffInWeeks($second); +$first->diffInYears($second); + +``` +You can generate human readable differences suitable for use in a feed or +timeline: +```php +// Difference from now. +echo $date->diffForHumans(); + +// Difference from another point in time. +echo $date->diffForHumans($other); // 1 hour ago; +``` + +## Formatting Strings + +Chronos provides a number of methods for displaying our outputting datetime +objects: +```php +// Uses the format controlled by setToStringFormat() +echo $date; + +// Different standard formats +echo $time->toAtomString(); // 1975-12-25T14:15:16-05:00 +echo $time->toCookieString(); // Thursday, 25-Dec-1975 14:15:16 EST +echo $time->toIso8601String(); // 1975-12-25T14:15:16-05:00 +echo $time->toRfc822String(); // Thu, 25 Dec 75 14:15:16 -0500 +echo $time->toRfc850String(); // Thursday, 25-Dec-75 14:15:16 EST +echo $time->toRfc1036String(); // Thu, 25 Dec 75 14:15:16 -0500 +echo $time->toRfc1123String(); // Thu, 25 Dec 1975 14:15:16 -0500 +echo $time->toRfc2822String(); // Thu, 25 Dec 1975 14:15:16 -0500 +echo $time->toRfc3339String(); // 1975-12-25T14:15:16-05:00 +echo $time->toRssString(); // Thu, 25 Dec 1975 14:15:16 -0500 +echo $time->toW3cString(); // 1975-12-25T14:15:16-05:00 + +// Get the quarter/week +echo $time->toQuarter(); // 4 +echo $time->toWeek(); // 52 + +// Generic formatting +echo $time->toTimeString(); // 14:15:16 +echo $time->toDateString(); // 1975-12-25 +echo $time->toDateTimeString(); // 1975-12-25 14:15:16 +echo $time->toFormattedDateString(); // Dec 25, 1975 +echo $time->toDayDateTimeString(); // Thu, Dec 25, 1975 2:15 PM +``` + +## Extracting Date Components + +Getting parts of a date object can be done by directly accessing properties: +```php +$time = new Chronos('2015-12-31 23:59:58.123'); +$time->year; // 2015 +$time->month; // 12 +$time->day; // 31 +$time->hour // 23 +$time->minute // 59 +$time->second // 58 +$time->micro // 123 + +``` +Other properties that can be accessed are: + +- timezone +- timezoneName +- dayOfWeek +- dayOfMonth +- dayOfYear +- daysInMonth +- timestamp +- quarter +- half + +## Testing Aids + +When writing unit tests, it is helpful to fixate the current time. Chronos lets +you fix the current time for each class. As part of your test suite's bootstrap +process you can include the following: +```php +Chronos::setTestNow(Chronos::now()); +ChronosDate::setTestNow(ChronosDate::parse(Chronos::now())); + +``` +This will fix the current time of all objects to be the point at which the test +suite started. + +For example, if you fixate the `Chronos` to some moment in the past, any new +instance of `Chronos` created with `now` or a relative time string, will be +returned relative to the fixated time: +```php +Chronos::setTestNow(new Chronos('1975-12-25 00:00:00')); + +$time = new Chronos(); // 1975-12-25 00:00:00 +$time = new Chronos('1 hour ago'); // 1975-12-24 23:00:00 + +``` +To reset the fixation, simply call `setTestNow()` again with no parameter or +with `null` as a parameter. diff --git a/docs/en/index.rst b/docs/en/index.rst deleted file mode 100644 index 76a1e953..00000000 --- a/docs/en/index.rst +++ /dev/null @@ -1,308 +0,0 @@ -Chronos -####### - -Chronos provides a zero-dependency ``DateTimeImmutable`` extension, Date-only and Time-only classes: - -* ``Cake\Chronos\Chronos`` extends ``DateTimeImmutable`` and provides many helpers. -* ``Cake\Chronos\ChronosDate`` represents calendar dates unaffected by time or time zones. -* ``Cake\Chronos\ChronosTime`` represents clock times independent of date or time zones. -* Only safe, immutable objects. -* A pluggable translation system. Only English translations are included in the - library. However, ``cakephp/i18n`` can be used for full language support. - -The ``Chronos`` class extends ``DateTimeImmutable`` and implements ``DateTimeInterface`` -which allows users to use type declarations that support either. - - ``ChronosDate`` and ``ChronosTime`` do not extend ``DateTimeImmutable`` and do not - share an interface. However, they can be converted to a ``DateTimeImmutable`` instance - using ``toDateTimeImmutable()``. - -Installation ------------- - -To install Chronos, you should use ``composer``. From your -application's ROOT directory (where composer.json file is located) run the -following:: - - php composer.phar require "cakephp/chronos:^3.0" - -Creating Instances ------------------- - -There are many ways to get an instance of Chronos or Date. There are a number of -factory methods that work with different argument sets:: - - use Cake\Chronos\Chronos; - - $now = Chronos::now(); - $today = Chronos::today(); - $yesterday = Chronos::yesterday(); - $tomorrow = Chronos::tomorrow(); - - // Parse relative expressions - $date = Chronos::parse('+2 days, +3 hours'); - - // Date and time integer values. - $date = Chronos::create(2015, 12, 25, 4, 32, 58); - - // Date or time integer values. - $date = Chronos::createFromDate(2015, 12, 25); - $date = Chronos::createFromTime(11, 45, 10); - - // Parse formatted values. - $date = Chronos::createFromFormat('m/d/Y', '06/15/2015'); - -Working with Immutable Objects ------------------------------- - -Chronos provides only *immutable* objects. - -If you've used PHP ``DateTimeImmutable`` and ``DateTime`` classes, then you understand -the difference between *mutable* and *immutable* objects. - -Immutable objects create copies of an object each time a change is made. Because modifier methods -around datetimes are not always easy to identify, data can be modified accidentally -or without the developer knowing. Immutable objects prevent accidental changes -to data, and make code free of order-based dependency issues. Immutability does -mean that you will need to remember to replace variables when using modifiers:: - - // This code doesn't work with immutable objects - $chronos->addDay(1); - doSomething($chronos); - return $chronos; - - // This works like you'd expect - $chronos = $chronos->addDay(1); - $chronos = doSomething($chronos); - return $chronos; - -By capturing the return value of each modification your code will work as -expected. - -Date Objects ------------- - -PHP provides only date-time classes that combines both dates and time parts. -Representing calendar dates can be a bit awkward with ``DateTimeImmutable`` as it includes -time and timezones, which aren't part of a 'date'. Chronos provides -``ChronosDate`` that allows you to represent dates. The time these objects -these objects is always fixed to ``00:00:00`` and not affeced by the server time zone -or modify helpers:: - - use Cake\Chronos\ChronosDate; - - $today = ChronosDate::today(); - - // Changes to the time/timezone are ignored. - $today->modify('+1 hours'); - - // Outputs '2015-12-20' - echo $today; - -Although ``ChronosDate`` uses a fixed time zone internally, you can specify which -time zone to use for current time such as ``now()`` or ``today()``:: - - use Cake\Chronos\ChronosDate: - - // Takes the current date from Asia/Tokyo time zone - $today = ChronosDate::today('Asia/Tokyo'); - -Modifier Methods ----------------- - -Chronos objects provide modifier methods that let you modify the value in -a granular way:: - - // Set components of the datetime value. - $halloween = Chronos::create() - ->year(2015) - ->month(10) - ->day(31) - ->hour(20) - ->minute(30); - -You can also modify parts of the datetime relatively:: - - $future = Chronos::create() - ->addYears(1) - ->subMonths(2) - ->addDays(15) - ->addHours(20) - ->subMinutes(2); - -It is also possible to make big jumps to defined points in time:: - - $time = Chronos::create(); - $time->startOfDay(); - $time->endOfDay(); - $time->startOfMonth(); - $time->endOfMonth(); - $time->startOfYear(); - $time->endOfYear(); - $time->startOfWeek(); - $time->endOfWeek(); - -Or jump to specific days of the week:: - - $time->next(Chronos::TUESDAY); - $time->previous(Chronos::MONDAY); - -When modifying dates/times across :abbr:`DST (Daylight Savings Time)` transitions -your operations may gain/lose an additional hours resulting in hour values that -don't add up. You can avoid these issues by first changing your timezone to -``UTC``, modifying the time:: - - // Additional hour gained. - $time = new Chronos('2014-03-30 00:00:00', 'Europe/London'); - debug($time->modify('+24 hours')); // 2014-03-31 01:00:00 - - // First switch to UTC, and modify - $time = $time->setTimezone('UTC') - ->modify('+24 hours'); - -Once you are done modifying the time you can add the original timezone to get -the localized time. - -Comparison Methods ------------------- - -Once you have 2 instances of Chronos date/time objects you can compare them in -a variety of ways:: - - // Full suite of comparators exist - // equals, notEquals, greaterThan, greaterThanOrEquals, lessThan, lessThanOrEquals - $first->equals($second); - $first->greaterThanOrEquals($second); - - // See if the current object is between two others. - $now->between($start, $end); - - // Find which argument is closest or farthest. - $now->closest($june, $november); - $now->farthest($june, $november); - -You can also inquire about where a given value falls on the calendar:: - - $now->isToday(); - $now->isYesterday(); - $now->isFuture(); - $now->isPast(); - - // Check the day of the week - $now->isWeekend(); - - // All other weekday methods exist too. - $now->isMonday(); - -You can also find out if a value was within a relative time period:: - - $time->wasWithinLast('3 days'); - $time->isWithinNext('3 hours'); - -Generating Differences ----------------------- - -In addition to comparing datetimes, calculating differences or deltas between -two values is a common task:: - - // Get a DateInterval representing the difference - $first->diff($second); - - // Get difference as a count of specific units. - $first->diffInHours($second); - $first->diffInDays($second); - $first->diffInWeeks($second); - $first->diffInYears($second); - -You can generate human readable differences suitable for use in a feed or -timeline:: - - // Difference from now. - echo $date->diffForHumans(); - - // Difference from another point in time. - echo $date->diffForHumans($other); // 1 hour ago; - -Formatting Strings ------------------- - -Chronos provides a number of methods for displaying our outputting datetime -objects:: - - // Uses the format controlled by setToStringFormat() - echo $date; - - // Different standard formats - echo $time->toAtomString(); // 1975-12-25T14:15:16-05:00 - echo $time->toCookieString(); // Thursday, 25-Dec-1975 14:15:16 EST - echo $time->toIso8601String(); // 1975-12-25T14:15:16-05:00 - echo $time->toRfc822String(); // Thu, 25 Dec 75 14:15:16 -0500 - echo $time->toRfc850String(); // Thursday, 25-Dec-75 14:15:16 EST - echo $time->toRfc1036String(); // Thu, 25 Dec 75 14:15:16 -0500 - echo $time->toRfc1123String(); // Thu, 25 Dec 1975 14:15:16 -0500 - echo $time->toRfc2822String(); // Thu, 25 Dec 1975 14:15:16 -0500 - echo $time->toRfc3339String(); // 1975-12-25T14:15:16-05:00 - echo $time->toRssString(); // Thu, 25 Dec 1975 14:15:16 -0500 - echo $time->toW3cString(); // 1975-12-25T14:15:16-05:00 - - // Get the quarter/week - echo $time->toQuarter(); // 4 - echo $time->toWeek(); // 52 - - // Generic formatting - echo $time->toTimeString(); // 14:15:16 - echo $time->toDateString(); // 1975-12-25 - echo $time->toDateTimeString(); // 1975-12-25 14:15:16 - echo $time->toFormattedDateString(); // Dec 25, 1975 - echo $time->toDayDateTimeString(); // Thu, Dec 25, 1975 2:15 PM - -Extracting Date Components --------------------------- - -Getting parts of a date object can be done by directly accessing properties:: - - $time = new Chronos('2015-12-31 23:59:58.123'); - $time->year; // 2015 - $time->month; // 12 - $time->day; // 31 - $time->hour // 23 - $time->minute // 59 - $time->second // 58 - $time->micro // 123 - -Other properties that can be accessed are: - -- timezone -- timezoneName -- dayOfWeek -- dayOfMonth -- dayOfYear -- daysInMonth -- timestamp -- quarter -- half - -Testing Aids ------------- - -When writing unit tests, it is helpful to fixate the current time. Chronos lets -you fix the current time for each class. As part of your test suite's bootstrap -process you can include the following:: - - Chronos::setTestNow(Chronos::now()); - ChronosDate::setTestNow(ChronosDate::parse(Chronos::now())); - -This will fix the current time of all objects to be the point at which the test -suite started. - -For example, if you fixate the ``Chronos`` to some moment in the past, any new -instance of ``Chronos`` created with ``now`` or a relative time string, will be -returned relative to the fixated time:: - - Chronos::setTestNow(new Chronos('1975-12-25 00:00:00')); - - $time = new Chronos(); // 1975-12-25 00:00:00 - $time = new Chronos('1 hour ago'); // 1975-12-24 23:00:00 - -To reset the fixation, simply call ``setTestNow()`` again with no parameter or -with ``null`` as a parameter. diff --git a/docs/fr/conf.py b/docs/fr/conf.py deleted file mode 100644 index b02032ef..00000000 --- a/docs/fr/conf.py +++ /dev/null @@ -1,9 +0,0 @@ -import sys, os - -# Append the top level directory of the docs, so we can import from the config dir. -sys.path.insert(0, os.path.abspath('..')) - -# Pull in all the configuration options defined in the global config file.. -from config.all import * - -language = 'fr' diff --git a/docs/fr/contents.rst b/docs/fr/contents.rst deleted file mode 100644 index 10625a2c..00000000 --- a/docs/fr/contents.rst +++ /dev/null @@ -1,7 +0,0 @@ -.. toctree:: - :maxdepth: 2 - :caption: CakePHP Chronos - - /index - - API \ No newline at end of file diff --git a/docs/fr/index.md b/docs/fr/index.md new file mode 100644 index 00000000..7c93e856 --- /dev/null +++ b/docs/fr/index.md @@ -0,0 +1,336 @@ +# Chronos + +Chronos fournit une collection d'extensions sans aucune dépendance pour l'objet +`DateTime`. En plus de méthodes pratiques, Chronos fournit: + +* Des objets `Date` pour représenter les dates du calendrier. +* Des objets immutables pour les dates et les datetimes. +* Un système de traduction intégrable. Seules les traductions anglaises sont + incluses dans la librairie. Cependant, `cakephp/i18n` peut être utilisé + pour un support complet d'autres langues. + +## Installation + +Pour installer Chronos, vous devez utiliser `composer`. À partir du répertoire +ROOT de votre application (celui où se trouve le fichier composer.json), +exécutez ce qui suit: +```php +php composer.phar require "cakephp/chronos:^2.0" +``` + +## Vue d'Ensemble + +Chronos fournit un certain nombre d'extensions pour les objets DateTime fournis +par PHP. Chronos fournit 5 classes qui gèrent les variantes mutables et +immutables de date/time et les extensions de `DateInterval`. + +* `Cake\Chronos\Chronos` est un objet de *date et heure* immutable. +* `Cake\Chronos\ChronosDate` est un objet de *date* immutable. +* `Cake\Chronos\MutableDateTime` est un objet de *date et heure* mutable. +* `Cake\Chronos\MutableDate` est un objet de *date* mutable. +* `Cake\Chronos\ChronosInterval` est une extension pour l'objet + `DateInterval`. + +## Créer des Instances + +Il y a plusieurs façons d'obtenir une instance de Chronos ou de Date. Il y a +un certain nombre de méthodes factory qui fonctionnent avec différents ensembles +d'arguments: +```php +use Cake\Chronos\Chronos; + +$now = Chronos::now(); +$today = Chronos::today(); +$yesterday = Chronos::yesterday(); +$tomorrow = Chronos::tomorrow(); + +// Parse les expressions relatives +$date = Chronos::parse('+2 days, +3 hours'); + +// Des entiers indiquant la date et l'heure. +$date = Chronos::create(2015, 12, 25, 4, 32, 58); + +// Des entiers indiquant la date ou l'heure. +$date = Chronos::createFromDate(2015, 12, 25); +$date = Chronos::createFromTime(11, 45, 10); + +// Parse les valeurs formatées. +$date = Chronos::createFromFormat('m/d/Y', '06/15/2015'); +``` + +## Travailler avec les Objets Immutables + +Si vous avez utilisé les objets `DateTime` de PHP, vous êtes à l'aise avec +les objets *mutable*. Chronos offre des objets mutables, mais elle fournit +également des objets *immutables*. Les objets Immutables créent des copies des +objets à chaque fois qu'un objet est modifié. Puisque les méthodes de +modification autour des datetimes ne sont pas toujours transparentes, les +données peuvent être modifiées accidentellement ou sans que le développeur ne +le sache. Les objets immutables évitent les changements accidentels des +données et permettent de s'affranchir de tout problème lié à l'ordre d'appel +des fonctions ou des dépendances. L'immutabilité signifie que vous devez vous +souvenir de remplacer les variables quand vous utilisez les modificateurs: +```php +// Ce code ne fonctionne pas avec les objets immutables +$time->addDay(1); +doSomething($time); +return $time; + +// Ceci fonctionne comme vous le souhaitez +$time = $time->addDay(1); +$time = doSomething($time); +return $time; + +``` +En capturant la valeur de retour pour chaque modification, votre code +fonctionnera comme souhaité. Si vous avez déjà créé un objet immutable, et que +vous souhaitez un objet mutable, vous pouvez utiliser `toMutable()`: +```php +$inplace = $time->toMutable(); +``` + +## Objets Date + +PHP fournit seulement un unique objet DateTime. Représenter les dates de +calendrier peut être un peu gênant avec cette classe puisqu'elle inclut les +timezones, et les composants de time qui n'appartiennent pas vraiment +au concept d'un 'jour'. Chronos fournit un objet `Date` qui vous permet +de représenter les dates. Les time et timezone pour ces objets sont toujours +fixés à `00:00:00 UTC` et toutes les méthodes de formatage/différence +fonctionnent au niveau du jour: +```php +use Cake\Chronos\ChronosDate; + +$today = ChronosDate::today(); + +// Les changements selon le time/timezone sont ignorés. +$today->modify('+1 hours'); + +// Affiche '2015-12-20' +echo $today; + +``` +Bien que `Date` utilise en interne un fuseau horaire fixe, vous pouvez +spécifier le fuseau à utiliser pour l'heure courante telle que `now()` ou +`today()`: +```php +use Cake\Chronos\ChronosDate; + +// Prend l'heure courante pour le fuseau horaire de Tokyo +$today = ChronosDate::today('Asia/Tokyo'); +``` + +## Méthodes de Modification + +Les objets Chronos fournissent des méthodes de modification qui vous laissent +modifier la valeur d'une façon assez précise: +```php +// Définit les composants de la valeur du datetime. +$halloween = Chronos::create() + ->year(2015) + ->month(10) + ->day(31) + ->hour(20) + ->minute(30); + +``` +Vous pouvez aussi modifier les parties de la date de façon relative: +```php +$future = Chronos::create() + ->addYear(1) + ->subMonth(2) + ->addDays(15) + ->addHours(20) + ->subMinutes(2); + +``` +Il est également possible de faire des sauts vers des points définis dans le +temps: +```php +$time = Chronos::create(); +$time->startOfDay(); +$time->endOfDay(); +$time->startOfMonth(); +$time->endOfMonth(); +$time->startOfYear(); +$time->endOfYear(); +$time->startOfWeek(); +$time->endOfWeek(); + +``` +Ou de sauter à un jour spécifique de la semaine: +```php +$time->next(Chronos::TUESDAY); +$time->previous(Chronos::MONDAY); + +``` +Quand vous modifiez des dates/heures au-delà d'un passage à l'heure d'été ou à +l'heure d'hiver, vous opérations peuvent gagner/perdre une heure de plus, de +sorte que les heures seront incorrectes. Vous pouvez éviter ce problème en +définissant d'abord le timezone à `UTC`, ce qui change l'heure: +```php +// Une heure de plus de gagnée. +$time = new Chronos('2014-03-30 00:00:00', 'Europe/London'); +debug($time->modify('+24 hours')); // 2014-03-31 01:00:00 + +// Passez d'abord à UTC, et modifiez ensuite +$time = $time->setTimezone('UTC') + ->modify('+24 hours'); + +``` +Une fois que vous avez modifié l'heure, vous pouvez repasser au timezone +d'origine pour obtenir l'heure locale. + +## Méthodes de Comparaison + +Une fois que vous avez 2 instances d'objets date/time de Chronos, vous pouvez +les comparer de plusieurs façons: +```php +// Il existe une suite complète de comparateurs +// equals, notEquals, greaterThan, greaterThanOrEquals, lessThan, lessThanOrEquals +$first->equals($second); +$first->greaterThanOrEquals($second); + +// Regarder si l'objet courant est entre deux autres. +$now->between($start, $end); + +// Trouver l'argument le plus proche ou le plus éloigné. +$now->closest($june, $november); +$now->farthest($june, $november); + +``` +Vous pouvez aussi vous renseigner sur le moment où une valeur donnée tombe dans +le calendrier: +```php +$now->isToday(); +$now->isYesterday(); +$now->isFuture(); +$now->isPast(); + +// Vérifie le jour de la semaine +$now->isWeekend(); + +// Toutes les autres méthodes des jours de la semaine existent aussi. +$now->isMonday(); + +``` +Vous pouvez aussi trouver si une valeur était dans une période de temps relative: +```php +$time->wasWithinLast('3 days'); +$time->isWithinNext('3 hours'); +``` + +## Générer des Différences + +En plus de comparer les datetimes, calculer les différences ou les deltas entre +des valeurs est une tâche courante: +```php +// Récupère un DateInterval représentant la différence +$first->diff($second); + +// Récupère la différence en tant que nombre d'unités spécifiques. +$first->diffInHours($second); +$first->diffInDays($second); +$first->diffInWeeks($second); +$first->diffInYears($second); + +``` +Vous pouvez générer des différences lisibles qui peuvent vous servir pour +l'utilisation d'un feed ou d'une timeline: +```php +// Différence à partir de maintenant. +echo $date->diffForHumans(); + +// Différence à partir d'un autre point du temps. +echo $date->diffForHumans($other); // 1 hour ago; +``` + +## Formater les Chaînes + +Chronos fournit un certain nombre de méthodes pour afficher nos sorties d'objets +datetime: +```php +// Utilise le format contrôlé par setToStringFormat() +echo $date; + +// Différents formats standards +echo $time->toAtomString(); // 1975-12-25T14:15:16-05:00 +echo $time->toCookieString(); // Thursday, 25-Dec-1975 14:15:16 EST +echo $time->toIso8601String(); // 1975-12-25T14:15:16-05:00 +echo $time->toRfc822String(); // Thu, 25 Dec 75 14:15:16 -0500 +echo $time->toRfc850String(); // Thursday, 25-Dec-75 14:15:16 EST +echo $time->toRfc1036String(); // Thu, 25 Dec 75 14:15:16 -0500 +echo $time->toRfc1123String(); // Thu, 25 Dec 1975 14:15:16 -0500 +echo $time->toRfc2822String(); // Thu, 25 Dec 1975 14:15:16 -0500 +echo $time->toRfc3339String(); // 1975-12-25T14:15:16-05:00 +echo $time->toRssString(); // Thu, 25 Dec 1975 14:15:16 -0500 +echo $time->toW3cString(); // 1975-12-25T14:15:16-05:00 + +// Récupère le trimestre +echo $time->toQuarter(); // 4; +// Récupère la semaine +echo $time->toWeek(); // 52; + +// Formatage générique +echo $time->toTimeString(); // 14:15:16 +echo $time->toDateString(); // 1975-12-25 +echo $time->toDateTimeString(); // 1975-12-25 14:15:16 +echo $time->toFormattedDateString(); // Dec 25, 1975 +echo $time->toDayDateTimeString(); // Thu, Dec 25, 1975 2:15 PM +``` + +## Extraire des Fragments de Date + +Il est possible de récupérer des parties d'un objet date en accédant directement +à ses propriétés: +```php +$time = new Chronos('2015-12-31 23:59:58.123'); +$time->year; // 2015 +$time->month; // 12 +$time->day; // 31 +$time->hour // 23 +$time->minute // 59 +$time->second // 58 +$time->micro // 123 + +``` +Les autres propriétés accessibles sont: + +- timezone +- timezoneName +- dayOfWeek +- dayOfMonth +- dayOfYear +- daysInMonth +- timestamp +- quarter +- half + +## Aides aux Tests + +Quand vous écrivez des tests unitaires, il peut être utile de fixer le *time* +courant. Chronos vous permet de fixer le time courant pour chaque classe. +Pour l'intégrer dans votre processus de démarrage (bootstrap) de suite de tests, +vous pouvez inclure ce qui suit: +```php +Chronos::setTestNow(Chronos::now()); +MutableDateTime::setTestNow(MutableDateTime::now()); +ChronosDate::setTestNow(ChronosDate::parse(Chronos::now())); +MutableDate::setTestNow(MutableDate::now()); + +``` +Ceci va fixer le time courant de tous les objets selon le moment où la suite de +tests a démarré. + +Par exemple, si vous fixez le `Chronos` à un moment du passé, chaque nouvelle +instance de `Chronos` créée avec `now` ou une chaine de temps relative, sera +retournée relativement à la date fixée: +```php +Chronos::setTestNow(new Chronos('1975-12-25 00:00:00')); + +$time = new Chronos(); // 1975-12-25 00:00:00 +$time = new Chronos('1 hour ago'); // 1975-12-24 23:00:00 + +``` +Pour réinitialiser la "fixation" du temps, appelez simplement `setTestNow()` +sans paramètre ou avec `null` comme paramètre. diff --git a/docs/fr/index.rst b/docs/fr/index.rst deleted file mode 100644 index 2ff0be2c..00000000 --- a/docs/fr/index.rst +++ /dev/null @@ -1,329 +0,0 @@ -Chronos -####### - -Chronos fournit une collection d'extensions sans aucune dépendance pour l'objet -``DateTime``. En plus de méthodes pratiques, Chronos fournit: - -* Des objets ``Date`` pour représenter les dates du calendrier. -* Des objets immutables pour les dates et les datetimes. -* Un système de traduction intégrable. Seules les traductions anglaises sont - incluses dans la librairie. Cependant, ``cakephp/i18n`` peut être utilisé - pour un support complet d'autres langues. - -Installation ------------- - -Pour installer Chronos, vous devez utiliser ``composer``. À partir du répertoire -ROOT de votre application (celui où se trouve le fichier composer.json), -exécutez ce qui suit:: - - php composer.phar require "cakephp/chronos:^2.0" - -Vue d'Ensemble --------------- - -Chronos fournit un certain nombre d'extensions pour les objets DateTime fournis -par PHP. Chronos fournit 5 classes qui gèrent les variantes mutables et -immutables de date/time et les extensions de ``DateInterval``. - -* ``Cake\Chronos\Chronos`` est un objet de *date et heure* immutable. -* ``Cake\Chronos\ChronosDate`` est un objet de *date* immutable. -* ``Cake\Chronos\MutableDateTime`` est un objet de *date et heure* mutable. -* ``Cake\Chronos\MutableDate`` est un objet de *date* mutable. -* ``Cake\Chronos\ChronosInterval`` est une extension pour l'objet - ``DateInterval``. - -Créer des Instances -------------------- - -Il y a plusieurs façons d'obtenir une instance de Chronos ou de Date. Il y a -un certain nombre de méthodes factory qui fonctionnent avec différents ensembles -d'arguments:: - - use Cake\Chronos\Chronos; - - $now = Chronos::now(); - $today = Chronos::today(); - $yesterday = Chronos::yesterday(); - $tomorrow = Chronos::tomorrow(); - - // Parse les expressions relatives - $date = Chronos::parse('+2 days, +3 hours'); - - // Des entiers indiquant la date et l'heure. - $date = Chronos::create(2015, 12, 25, 4, 32, 58); - - // Des entiers indiquant la date ou l'heure. - $date = Chronos::createFromDate(2015, 12, 25); - $date = Chronos::createFromTime(11, 45, 10); - - // Parse les valeurs formatées. - $date = Chronos::createFromFormat('m/d/Y', '06/15/2015'); - -Travailler avec les Objets Immutables -------------------------------------- - -Si vous avez utilisé les objets ``DateTime`` de PHP, vous êtes à l'aise avec -les objets *mutable*. Chronos offre des objets mutables, mais elle fournit -également des objets *immutables*. Les objets Immutables créent des copies des -objets à chaque fois qu'un objet est modifié. Puisque les méthodes de -modification autour des datetimes ne sont pas toujours transparentes, les -données peuvent être modifiées accidentellement ou sans que le développeur ne -le sache. Les objets immutables évitent les changements accidentels des -données et permettent de s'affranchir de tout problème lié à l'ordre d'appel -des fonctions ou des dépendances. L'immutabilité signifie que vous devez vous -souvenir de remplacer les variables quand vous utilisez les modificateurs:: - - // Ce code ne fonctionne pas avec les objets immutables - $time->addDay(1); - doSomething($time); - return $time; - - // Ceci fonctionne comme vous le souhaitez - $time = $time->addDay(1); - $time = doSomething($time); - return $time; - -En capturant la valeur de retour pour chaque modification, votre code -fonctionnera comme souhaité. Si vous avez déjà créé un objet immutable, et que -vous souhaitez un objet mutable, vous pouvez utiliser ``toMutable()``:: - - $inplace = $time->toMutable(); - -Objets Date ------------ - -PHP fournit seulement un unique objet DateTime. Représenter les dates de -calendrier peut être un peu gênant avec cette classe puisqu'elle inclut les -timezones, et les composants de time qui n'appartiennent pas vraiment -au concept d'un 'jour'. Chronos fournit un objet ``Date`` qui vous permet -de représenter les dates. Les time et timezone pour ces objets sont toujours -fixés à ``00:00:00 UTC`` et toutes les méthodes de formatage/différence -fonctionnent au niveau du jour:: - - use Cake\Chronos\ChronosDate; - - $today = ChronosDate::today(); - - // Les changements selon le time/timezone sont ignorés. - $today->modify('+1 hours'); - - // Affiche '2015-12-20' - echo $today; - -Bien que ``Date`` utilise en interne un fuseau horaire fixe, vous pouvez -spécifier le fuseau à utiliser pour l'heure courante telle que ``now()`` ou -``today()``:: - - use Cake\Chronos\ChronosDate: - - // Prend l'heure courante pour le fuseau horaire de Tokyo - $today = ChronosDate::today('Asia/Tokyo'); - - -Méthodes de Modification ------------------------- - -Les objets Chronos fournissent des méthodes de modification qui vous laissent -modifier la valeur d'une façon assez précise:: - - // Définit les composants de la valeur du datetime. - $halloween = Chronos::create() - ->year(2015) - ->month(10) - ->day(31) - ->hour(20) - ->minute(30); - -Vous pouvez aussi modifier les parties de la date de façon relative:: - - $future = Chronos::create() - ->addYear(1) - ->subMonth(2) - ->addDays(15) - ->addHours(20) - ->subMinutes(2); - -Il est également possible de faire des sauts vers des points définis dans le -temps:: - - $time = Chronos::create(); - $time->startOfDay(); - $time->endOfDay(); - $time->startOfMonth(); - $time->endOfMonth(); - $time->startOfYear(); - $time->endOfYear(); - $time->startOfWeek(); - $time->endOfWeek(); - -Ou de sauter à un jour spécifique de la semaine:: - - $time->next(Chronos::TUESDAY); - $time->previous(Chronos::MONDAY); - -Quand vous modifiez des dates/heures au-delà d'un passage à l'heure d'été ou à -l'heure d'hiver, vous opérations peuvent gagner/perdre une heure de plus, de -sorte que les heures seront incorrectes. Vous pouvez éviter ce problème en -définissant d'abord le timezone à ``UTC``, ce qui change l'heure:: - - // Une heure de plus de gagnée. - $time = new Chronos('2014-03-30 00:00:00', 'Europe/London'); - debug($time->modify('+24 hours')); // 2014-03-31 01:00:00 - - // Passez d'abord à UTC, et modifiez ensuite - $time = $time->setTimezone('UTC') - ->modify('+24 hours'); - -Une fois que vous avez modifié l'heure, vous pouvez repasser au timezone -d'origine pour obtenir l'heure locale. - -Méthodes de Comparaison ------------------------ - -Une fois que vous avez 2 instances d'objets date/time de Chronos, vous pouvez -les comparer de plusieurs façons:: - - // Il existe une suite complète de comparateurs - // equals, notEquals, greaterThan, greaterThanOrEquals, lessThan, lessThanOrEquals - $first->equals($second); - $first->greaterThanOrEquals($second); - - // Regarder si l'objet courant est entre deux autres. - $now->between($start, $end); - - // Trouver l'argument le plus proche ou le plus éloigné. - $now->closest($june, $november); - $now->farthest($june, $november); - -Vous pouvez aussi vous renseigner sur le moment où une valeur donnée tombe dans -le calendrier:: - - $now->isToday(); - $now->isYesterday(); - $now->isFuture(); - $now->isPast(); - - // Vérifie le jour de la semaine - $now->isWeekend(); - - // Toutes les autres méthodes des jours de la semaine existent aussi. - $now->isMonday(); - -Vous pouvez aussi trouver si une valeur était dans une période de temps relative:: - - $time->wasWithinLast('3 days'); - $time->isWithinNext('3 hours'); - -Générer des Différences ------------------------ - -En plus de comparer les datetimes, calculer les différences ou les deltas entre -des valeurs est une tâche courante:: - - // Récupère un DateInterval représentant la différence - $first->diff($second); - - // Récupère la différence en tant que nombre d'unités spécifiques. - $first->diffInHours($second); - $first->diffInDays($second); - $first->diffInWeeks($second); - $first->diffInYears($second); - -Vous pouvez générer des différences lisibles qui peuvent vous servir pour -l'utilisation d'un feed ou d'une timeline:: - - // Différence à partir de maintenant. - echo $date->diffForHumans(); - - // Différence à partir d'un autre point du temps. - echo $date->diffForHumans($other); // 1 hour ago; - -Formater les Chaînes --------------------- - -Chronos fournit un certain nombre de méthodes pour afficher nos sorties d'objets -datetime:: - - // Utilise le format contrôlé par setToStringFormat() - echo $date; - - // Différents formats standards - echo $time->toAtomString(); // 1975-12-25T14:15:16-05:00 - echo $time->toCookieString(); // Thursday, 25-Dec-1975 14:15:16 EST - echo $time->toIso8601String(); // 1975-12-25T14:15:16-05:00 - echo $time->toRfc822String(); // Thu, 25 Dec 75 14:15:16 -0500 - echo $time->toRfc850String(); // Thursday, 25-Dec-75 14:15:16 EST - echo $time->toRfc1036String(); // Thu, 25 Dec 75 14:15:16 -0500 - echo $time->toRfc1123String(); // Thu, 25 Dec 1975 14:15:16 -0500 - echo $time->toRfc2822String(); // Thu, 25 Dec 1975 14:15:16 -0500 - echo $time->toRfc3339String(); // 1975-12-25T14:15:16-05:00 - echo $time->toRssString(); // Thu, 25 Dec 1975 14:15:16 -0500 - echo $time->toW3cString(); // 1975-12-25T14:15:16-05:00 - - // Récupère le trimestre - echo $time->toQuarter(); // 4; - // Récupère la semaine - echo $time->toWeek(); // 52; - - // Formatage générique - echo $time->toTimeString(); // 14:15:16 - echo $time->toDateString(); // 1975-12-25 - echo $time->toDateTimeString(); // 1975-12-25 14:15:16 - echo $time->toFormattedDateString(); // Dec 25, 1975 - echo $time->toDayDateTimeString(); // Thu, Dec 25, 1975 2:15 PM - -Extraire des Fragments de Date ------------------------------- - -Il est possible de récupérer des parties d'un objet date en accédant directement -à ses propriétés:: - - $time = new Chronos('2015-12-31 23:59:58.123'); - $time->year; // 2015 - $time->month; // 12 - $time->day; // 31 - $time->hour // 23 - $time->minute // 59 - $time->second // 58 - $time->micro // 123 - -Les autres propriétés accessibles sont: - -- timezone -- timezoneName -- dayOfWeek -- dayOfMonth -- dayOfYear -- daysInMonth -- timestamp -- quarter -- half - -Aides aux Tests ---------------- - -Quand vous écrivez des tests unitaires, il peut être utile de fixer le *time* -courant. Chronos vous permet de fixer le time courant pour chaque classe. -Pour l'intégrer dans votre processus de démarrage (bootstrap) de suite de tests, -vous pouvez inclure ce qui suit:: - - Chronos::setTestNow(Chronos::now()); - MutableDateTime::setTestNow(MutableDateTime::now()); - ChronosDate::setTestNow(ChronosDate::parse(Chronos::now())); - MutableDate::setTestNow(MutableDate::now()); - -Ceci va fixer le time courant de tous les objets selon le moment où la suite de -tests a démarré. - -Par exemple, si vous fixez le ``Chronos`` à un moment du passé, chaque nouvelle -instance de ``Chronos`` créée avec ``now`` ou une chaine de temps relative, sera -retournée relativement à la date fixée:: - - Chronos::setTestNow(new Chronos('1975-12-25 00:00:00')); - - $time = new Chronos(); // 1975-12-25 00:00:00 - $time = new Chronos('1 hour ago'); // 1975-12-24 23:00:00 - -Pour réinitialiser la "fixation" du temps, appelez simplement ``setTestNow()`` -sans paramètre ou avec ``null`` comme paramètre. diff --git a/docs/ja/conf.py b/docs/ja/conf.py deleted file mode 100644 index 5871da64..00000000 --- a/docs/ja/conf.py +++ /dev/null @@ -1,9 +0,0 @@ -import sys, os - -# Append the top level directory of the docs, so we can import from the config dir. -sys.path.insert(0, os.path.abspath('..')) - -# Pull in all the configuration options defined in the global config file.. -from config.all import * - -language = 'ja' diff --git a/docs/ja/contents.rst b/docs/ja/contents.rst deleted file mode 100644 index 10625a2c..00000000 --- a/docs/ja/contents.rst +++ /dev/null @@ -1,7 +0,0 @@ -.. toctree:: - :maxdepth: 2 - :caption: CakePHP Chronos - - /index - - API \ No newline at end of file diff --git a/docs/ja/index.md b/docs/ja/index.md new file mode 100644 index 00000000..87becbb9 --- /dev/null +++ b/docs/ja/index.md @@ -0,0 +1,308 @@ +# Chronos + +Chronos (クロノス) は、 `DateTime` オブジェクトへの拡張の依存関係の無いコレクションを提供します。 +便利なメソッドに加えて、Chronos は以下を提供します。 + +* カレンダー日付のための `Date` オブジェクト +* イミュータブルな日付と日時オブジェクト +* プラグインのような翻訳システム。ライブラリーは英語のみの翻訳を含んでいます。 + しかし、全ての言語サポートのために、 `cakephp/i18n` を使うことができます。 + +## インストール + +Chronos をインストールするためには、 `composer` を利用することができます。 +アプリケーションの ROOT ディレクトリー（composer.json ファイルのある場所） +で以下のように実行します。 : +```php +php composer.phar require cakephp/chronos "@stable" +``` + +## 概要 + +Chronos は PHP が提供する DateTime オブジェクトのいくつかの拡張を提供します。 +Chronos は `DateInterval` の拡張機能および、ミュータブル（変更可能）と +イミュータブル（変更不可）な 日付/時刻 の派生系をカバーする5つのクラスを提供します。 + +* `Cake\Chronos\Chronos` はイミュータブルな *日付と時刻* オブジェクト。 +* `Cake\Chronos\ChronosDate` はイミュータブルな *日付* オブジェクト。 +* `Cake\Chronos\MutableDateTime` はミュータブルな *日付と時刻* オブジェクト。 +* `Cake\Chronos\MutableDate` はミュータブルな *日付* オブジェクト。 +* `Cake\Chronos\ChronosInterval` は `DateInterval` の拡張機能。 + +## インスタンスの作成 + +Chronos または Date のインスタンスを取得するためには、多くの方法があります。 +異なる引数セットで動作する多くのファクトリーメソッドがあります。 : +```php +use Cake\Chronos\Chronos; + +$now = Chronos::now(); +$today = Chronos::today(); +$yesterday = Chronos::yesterday(); +$tomorrow = Chronos::tomorrow(); + +// 相対式のパース +$date = Chronos::parse('+2 days, +3 hours'); + +// 日付と時間の整数値 +$date = Chronos::create(2015, 12, 25, 4, 32, 58); + +// 日付または時間の整数値 +$date = Chronos::createFromDate(2015, 12, 25); +$date = Chronos::createFromTime(11, 45, 10); + +// 整形した値にパース +$date = Chronos::createFromFormat('m/d/Y', '06/15/2015'); +``` + +## イミュータブルオブジェクトの動作 + +もしあなたが、PHP の `DateTime` オブジェクトを使用したことがあるなら、 +*ミュータブル* オブジェクトは簡単に使用できます。 +Chronos はミュータブルオブジェクトを提供しますが、これは *イミュータブル* オブジェクトにもなります。 +イミュータブルオブジェクトはオブジェクトが変更されるたびにオブジェクトのコピーを作ります。 +なぜなら、日時周りの変更メソッドは必ずしも透明でないため、データが誤って、 +または開発者が知らない内に変更してしまうからです。 +イミュータブルオブジェクトはデータが誤って変更されることを防止し、 +順序ベースの依存関係の問題の無いコードを作ります。 +不変性は、変更時に忘れずに変数を置き換える必要があることを意味しています。 : +```php +// このコードはイミュータブルオブジェクトでは動作しません +$time->addDay(1); +doSomething($time); +return $time + +// このコードは期待通りに動作します +$time = $time->addDay(1); +$time = doSomething($time); +return $time + +``` +各修正の戻り値をキャプチャーすることによって、コードは期待通りに動作します。 +イミュータブルオブジェクトを持っていて、ミュータブルオブジェクトを作りたい場合、 +`toMutable()` が使用できます。 : +```php +$inplace = $time->toMutable(); +``` + +## 日付オブジェクト + +PHP は単純な DateTime オブジェクトだけを提供します。このクラスのカレンダー日付の表現で、 +タイムゾーンおよび、本当に「日」の概念に属していないタイムコンポーネントを含むと、 +少し厄介な可能性があります。 +Chronos は日時表現のための `Date` オブジェクトを提供します。 +これらのオブジェクトの時間とタイムゾーンは常に `00:00:00 UTC` に固定されており、 +全ての書式/差分のメソッドは一日単位で動作します。 : +```php +use Cake\Chronos\ChronosDate; + +$today = ChronosDate::today(); + +// 時間/タイムゾーンの変更は無視されます +$today->modify('+1 hours'); + +// 出力 '2015-12-20' +echo $today; +``` + +## 変更メソッド + +Chronos オブジェクトは細やかに値を変更できるメソッドを提供します。 : +```php +// 日時の値のコンポーネントを設定 +$halloween = Chronos::create() + ->year(2015) + ->month(10) + ->day(31) + ->hour(20) + ->minute(30); + +``` +また、日時の部分を相対的に変更することもできます。 : +```php +$future = Chronos::create() + ->addYear(1) + ->subMonth(2) + ->addDays(15) + ->addHours(20) + ->subMinutes(2); + +``` +また、ある時間の中で、定義された時点に飛ぶことも可能です。 : +```php +$time = Chronos::create(); +$time->startOfDay(); +$time->endOfDay(); +$time->startOfMonth(); +$time->endOfMonth(); +$time->startOfYear(); +$time->endOfYear(); +$time->startOfWeek(); +$time->endOfWeek(); + +``` +また、1週間中の特定の日にも飛べます。 : +```php +$time->next(Chronos::TUESDAY); +$time->previous(Chronos::MONDAY); + +``` +DST (夏時間) の遷移の前後で日付/時間を変更すると、 +あなたの操作で時間が増減するかもしれませんが、その結果、意図しない時間の値になります。 +これらの問題を回避するには、最初にタイムゾーンを `UTC` に変更し、時間を変更します。 : +```php +// 余分な時間が追加されました +$time = new Chronos('2014-03-30 00:00:00', 'Europe/London'); +debug($time->modify('+24 hours')); // 2014-03-31 01:00:00 + +// 最初に UTC に切り替え、そして更新 +$time = $time->setTimezone('UTC') + ->modify('+24 hours'); + +``` +時間を変更すると、元のタイムゾーンを追加してローカライズされた時間を取得することができます。 + +## 比較メソッド + +Chronos の日付/時間オブジェクトの2つのインスタンスを様々な方法で比較することができます。 : +```php +// 比較のフルセットが存在します +// equals, notEquals, greaterThan, greaterThanOrEquals, lessThan, lessThanOrEquals +$first->equals($second); +$first->greaterThanOrEquals($second); + +// カレントオブジェクトが2つのオブジェクトの間にあるかどうかを確認します。 +$now->between($start, $end); + +// どちらの引数が最も近い (closest) か、または最も遠い (farthest) かを見つけます。 +$now->closest($june, $november); +$now->farthest($june, $november); + +``` +また、与えられた値のカレンダーに当たる場所について問い合わせできます。 : +```php +$now->isToday(); +$now->isYesterday(); +$now->isFuture(); +$now->isPast(); + +// 曜日をチェック +$now->isWeekend(); + +// 他の曜日のメソッドも全て存在します。 +$now->isMonday(); + +``` +また、値が相対的な期間内にあったかどうかを見つけることができます。 : +```php +$time->wasWithinLast('3 days'); +$time->isWithinNext('3 hours'); +``` + +## 差の生成 + +日時比較に加えて、2つの値の差や変化の計算は一般的なタスクです。 : +```php +// 差をあらわす DateInterval を取得 +$first->diff($second); + +// 特定の単位での差を取得 +$first->diffInHours($second); +$first->diffInDays($second); +$first->diffInWeeks($second); +$first->diffInYears($second); + +``` +フィードやタイムラインで使用するのに適した、人が読める形式の差を生成することができます。 : +```php +// 現在からの差 +echo $date->diffForHumans(); + +// 別の時点からの差 +echo $date->diffForHumans($other); // 1時間前; +``` + +## フォーマットの設定 + +Chronos は、出力した日時オブジェクトを表示するための多くのメソッドを提供します。 : +```php +// setToStringFormat() が制御するフォーマットを使用します +echo $date; + +// 別の標準フォーマット +echo $time->toAtomString(); // 1975-12-25T14:15:16-05:00 +echo $time->toCookieString(); // Thursday, 25-Dec-1975 14:15:16 EST +echo $time->toIso8601String(); // 1975-12-25T14:15:16-05:00 +echo $time->toRfc822String(); // Thu, 25 Dec 75 14:15:16 -0500 +echo $time->toRfc850String(); // Thursday, 25-Dec-75 14:15:16 EST +echo $time->toRfc1036String(); // Thu, 25 Dec 75 14:15:16 -0500 +echo $time->toRfc1123String(); // Thu, 25 Dec 1975 14:15:16 -0500 +echo $time->toRfc2822String(); // Thu, 25 Dec 1975 14:15:16 -0500 +echo $time->toRfc3339String(); // 1975-12-25T14:15:16-05:00 +echo $time->toRssString(); // Thu, 25 Dec 1975 14:15:16 -0500 +echo $time->toW3cString(); // 1975-12-25T14:15:16-05:00 + +// クォーター/週数を取得 +echo $time->toQuarter(); // 4; +echo $time->toWeek(); // 52 + +// 一般的なフォーマット +echo $time->toTimeString(); // 14:15:16 +echo $time->toDateString(); // 1975-12-25 +echo $time->toDateTimeString(); // 1975-12-25 14:15:16 +echo $time->toFormattedDateString(); // Dec 25, 1975 +echo $time->toDayDateTimeString(); // Thu, Dec 25, 1975 2:15 PM +``` + +## 日付要素の抽出 + +日付オブジェクトのプロパティーに直接アクセスして要素を取得することができます。 : +```php +$time = new Chronos('2015-12-31 23:59:58'); +$time->year; // 2015 +$time->month; // 12 +$time->day; // 31 +$time->hour // 23 +$time->minute // 59 +$time->second // 58 + +``` +以下のプロパティーにもアクセスできます。 : + +- timezone +- timezoneName +- micro +- dayOfWeek +- dayOfMonth +- dayOfYear +- daysInMonth +- timestamp +- quarter +- half + +## テストの支援 + +単体テストを書いている時、現在時刻を固定すると便利です。Chronos は、 +各クラスの現在時刻を修正することができます。 +テストスイートの bootstrap 処理に以下を含めることができます。 : +```php +Chronos::setTestNow(Chronos::now()); +MutableDateTime::setTestNow(MutableDateTime::now()); +ChronosDate::setTestNow(ChronosDate::parse(Chronos::now())); +MutableDate::setTestNow(MutableDate::now()); + +``` +これでテストスイートが開始された時点で全てのオブジェクトの現在時刻を修正します。 + +例えば、 `Chronos` を過去のある瞬間に固定した場合、新たな `Chronos` +のインスタンスが生成する `now` または相対時刻の文字列は、 +固定された時刻の相対を返却します。 : +```php +Chronos::setTestNow(new Chronos('1975-12-25 00:00:00')); + +$time = new Chronos(); // 1975-12-25 00:00:00 +$time = new Chronos('1 hour ago'); // 1975-12-24 23:00:00 + +``` +固定をリセットするには、 `setTestNow()` をパラメーター無し、または `null` を設定して +再び呼び出してください。 diff --git a/docs/ja/index.rst b/docs/ja/index.rst deleted file mode 100644 index 99aafac4..00000000 --- a/docs/ja/index.rst +++ /dev/null @@ -1,301 +0,0 @@ -Chronos -####### - -Chronos (クロノス) は、 ``DateTime`` オブジェクトへの拡張の依存関係の無いコレクションを提供します。 -便利なメソッドに加えて、Chronos は以下を提供します。 - -* カレンダー日付のための ``Date`` オブジェクト -* イミュータブルな日付と日時オブジェクト -* プラグインのような翻訳システム。ライブラリーは英語のみの翻訳を含んでいます。 - しかし、全ての言語サポートのために、 ``cakephp/i18n`` を使うことができます。 - -インストール ------------- - -Chronos をインストールするためには、 ``composer`` を利用することができます。 -アプリケーションの ROOT ディレクトリー（composer.json ファイルのある場所） -で以下のように実行します。 :: - - php composer.phar require cakephp/chronos "@stable" - -概要 ----- - -Chronos は PHP が提供する DateTime オブジェクトのいくつかの拡張を提供します。 -Chronos は ``DateInterval`` の拡張機能および、ミュータブル（変更可能）と -イミュータブル（変更不可）な 日付/時刻 の派生系をカバーする5つのクラスを提供します。 - -* ``Cake\Chronos\Chronos`` はイミュータブルな *日付と時刻* オブジェクト。 -* ``Cake\Chronos\ChronosDate`` はイミュータブルな *日付* オブジェクト。 -* ``Cake\Chronos\MutableDateTime`` はミュータブルな *日付と時刻* オブジェクト。 -* ``Cake\Chronos\MutableDate`` はミュータブルな *日付* オブジェクト。 -* ``Cake\Chronos\ChronosInterval`` は ``DateInterval`` の拡張機能。 - -インスタンスの作成 ------------------- - -Chronos または Date のインスタンスを取得するためには、多くの方法があります。 -異なる引数セットで動作する多くのファクトリーメソッドがあります。 :: - - use Cake\Chronos\Chronos; - - $now = Chronos::now(); - $today = Chronos::today(); - $yesterday = Chronos::yesterday(); - $tomorrow = Chronos::tomorrow(); - - // 相対式のパース - $date = Chronos::parse('+2 days, +3 hours'); - - // 日付と時間の整数値 - $date = Chronos::create(2015, 12, 25, 4, 32, 58); - - // 日付または時間の整数値 - $date = Chronos::createFromDate(2015, 12, 25); - $date = Chronos::createFromTime(11, 45, 10); - - // 整形した値にパース - $date = Chronos::createFromFormat('m/d/Y', '06/15/2015'); - -イミュータブルオブジェクトの動作 --------------------------------- - -もしあなたが、PHP の ``DateTime`` オブジェクトを使用したことがあるなら、 -*ミュータブル* オブジェクトは簡単に使用できます。 -Chronos はミュータブルオブジェクトを提供しますが、これは *イミュータブル* オブジェクトにもなります。 -イミュータブルオブジェクトはオブジェクトが変更されるたびにオブジェクトのコピーを作ります。 -なぜなら、日時周りの変更メソッドは必ずしも透明でないため、データが誤って、 -または開発者が知らない内に変更してしまうからです。 -イミュータブルオブジェクトはデータが誤って変更されることを防止し、 -順序ベースの依存関係の問題の無いコードを作ります。 -不変性は、変更時に忘れずに変数を置き換える必要があることを意味しています。 :: - - // このコードはイミュータブルオブジェクトでは動作しません - $time->addDay(1); - doSomething($time); - return $time - - // このコードは期待通りに動作します - $time = $time->addDay(1); - $time = doSomething($time); - return $time - -各修正の戻り値をキャプチャーすることによって、コードは期待通りに動作します。 -イミュータブルオブジェクトを持っていて、ミュータブルオブジェクトを作りたい場合、 -``toMutable()`` が使用できます。 :: - - $inplace = $time->toMutable(); - -日付オブジェクト ------------------- - -PHP は単純な DateTime オブジェクトだけを提供します。このクラスのカレンダー日付の表現で、 -タイムゾーンおよび、本当に「日」の概念に属していないタイムコンポーネントを含むと、 -少し厄介な可能性があります。 -Chronos は日時表現のための ``Date`` オブジェクトを提供します。 -これらのオブジェクトの時間とタイムゾーンは常に ``00:00:00 UTC`` に固定されており、 -全ての書式/差分のメソッドは一日単位で動作します。 :: - - use Cake\Chronos\ChronosDate; - - $today = ChronosDate::today(); - - // 時間/タイムゾーンの変更は無視されます - $today->modify('+1 hours'); - - // 出力 '2015-12-20' - echo $today; - -変更メソッド ------------- - -Chronos オブジェクトは細やかに値を変更できるメソッドを提供します。 :: - - // 日時の値のコンポーネントを設定 - $halloween = Chronos::create() - ->year(2015) - ->month(10) - ->day(31) - ->hour(20) - ->minute(30); - -また、日時の部分を相対的に変更することもできます。 :: - - $future = Chronos::create() - ->addYear(1) - ->subMonth(2) - ->addDays(15) - ->addHours(20) - ->subMinutes(2); - -また、ある時間の中で、定義された時点に飛ぶことも可能です。 :: - - $time = Chronos::create(); - $time->startOfDay(); - $time->endOfDay(); - $time->startOfMonth(); - $time->endOfMonth(); - $time->startOfYear(); - $time->endOfYear(); - $time->startOfWeek(); - $time->endOfWeek(); - -また、1週間中の特定の日にも飛べます。 :: - - $time->next(Chronos::TUESDAY); - $time->previous(Chronos::MONDAY); - -:abbr:`DST (夏時間)` の遷移の前後で日付/時間を変更すると、 -あなたの操作で時間が増減するかもしれませんが、その結果、意図しない時間の値になります。 -これらの問題を回避するには、最初にタイムゾーンを ``UTC`` に変更し、時間を変更します。 :: - - // 余分な時間が追加されました - $time = new Chronos('2014-03-30 00:00:00', 'Europe/London'); - debug($time->modify('+24 hours')); // 2014-03-31 01:00:00 - - // 最初に UTC に切り替え、そして更新 - $time = $time->setTimezone('UTC') - ->modify('+24 hours'); - -時間を変更すると、元のタイムゾーンを追加してローカライズされた時間を取得することができます。 - -比較メソッド ------------- - -Chronos の日付/時間オブジェクトの2つのインスタンスを様々な方法で比較することができます。 :: - - // 比較のフルセットが存在します - // equals, notEquals, greaterThan, greaterThanOrEquals, lessThan, lessThanOrEquals - $first->equals($second); - $first->greaterThanOrEquals($second); - - // カレントオブジェクトが2つのオブジェクトの間にあるかどうかを確認します。 - $now->between($start, $end); - - // どちらの引数が最も近い (closest) か、または最も遠い (farthest) かを見つけます。 - $now->closest($june, $november); - $now->farthest($june, $november); - -また、与えられた値のカレンダーに当たる場所について問い合わせできます。 :: - - $now->isToday(); - $now->isYesterday(); - $now->isFuture(); - $now->isPast(); - - // 曜日をチェック - $now->isWeekend(); - - // 他の曜日のメソッドも全て存在します。 - $now->isMonday(); - -また、値が相対的な期間内にあったかどうかを見つけることができます。 :: - - $time->wasWithinLast('3 days'); - $time->isWithinNext('3 hours'); - -差の生成 --------- - -日時比較に加えて、2つの値の差や変化の計算は一般的なタスクです。 :: - - // 差をあらわす DateInterval を取得 - $first->diff($second); - - // 特定の単位での差を取得 - $first->diffInHours($second); - $first->diffInDays($second); - $first->diffInWeeks($second); - $first->diffInYears($second); - -フィードやタイムラインで使用するのに適した、人が読める形式の差を生成することができます。 :: - - // 現在からの差 - echo $date->diffForHumans(); - - // 別の時点からの差 - echo $date->diffForHumans($other); // 1時間前; - -フォーマットの設定 ------------------- - -Chronos は、出力した日時オブジェクトを表示するための多くのメソッドを提供します。 :: - - // setToStringFormat() が制御するフォーマットを使用します - echo $date; - - // 別の標準フォーマット - echo $time->toAtomString(); // 1975-12-25T14:15:16-05:00 - echo $time->toCookieString(); // Thursday, 25-Dec-1975 14:15:16 EST - echo $time->toIso8601String(); // 1975-12-25T14:15:16-05:00 - echo $time->toRfc822String(); // Thu, 25 Dec 75 14:15:16 -0500 - echo $time->toRfc850String(); // Thursday, 25-Dec-75 14:15:16 EST - echo $time->toRfc1036String(); // Thu, 25 Dec 75 14:15:16 -0500 - echo $time->toRfc1123String(); // Thu, 25 Dec 1975 14:15:16 -0500 - echo $time->toRfc2822String(); // Thu, 25 Dec 1975 14:15:16 -0500 - echo $time->toRfc3339String(); // 1975-12-25T14:15:16-05:00 - echo $time->toRssString(); // Thu, 25 Dec 1975 14:15:16 -0500 - echo $time->toW3cString(); // 1975-12-25T14:15:16-05:00 - - // クォーター/週数を取得 - echo $time->toQuarter(); // 4; - echo $time->toWeek(); // 52 - - // 一般的なフォーマット - echo $time->toTimeString(); // 14:15:16 - echo $time->toDateString(); // 1975-12-25 - echo $time->toDateTimeString(); // 1975-12-25 14:15:16 - echo $time->toFormattedDateString(); // Dec 25, 1975 - echo $time->toDayDateTimeString(); // Thu, Dec 25, 1975 2:15 PM - -日付要素の抽出 --------------- - -日付オブジェクトのプロパティーに直接アクセスして要素を取得することができます。 :: - - $time = new Chronos('2015-12-31 23:59:58'); - $time->year; // 2015 - $time->month; // 12 - $time->day; // 31 - $time->hour // 23 - $time->minute // 59 - $time->second // 58 - -以下のプロパティーにもアクセスできます。 : - -- timezone -- timezoneName -- micro -- dayOfWeek -- dayOfMonth -- dayOfYear -- daysInMonth -- timestamp -- quarter -- half - -テストの支援 ------------- - -単体テストを書いている時、現在時刻を固定すると便利です。Chronos は、 -各クラスの現在時刻を修正することができます。 -テストスイートの bootstrap 処理に以下を含めることができます。 :: - - Chronos::setTestNow(Chronos::now()); - MutableDateTime::setTestNow(MutableDateTime::now()); - ChronosDate::setTestNow(ChronosDate::parse(Chronos::now())); - MutableDate::setTestNow(MutableDate::now()); - -これでテストスイートが開始された時点で全てのオブジェクトの現在時刻を修正します。 - -例えば、 ``Chronos`` を過去のある瞬間に固定した場合、新たな ``Chronos`` -のインスタンスが生成する ``now`` または相対時刻の文字列は、 -固定された時刻の相対を返却します。 :: - - Chronos::setTestNow(new Chronos('1975-12-25 00:00:00')); - - $time = new Chronos(); // 1975-12-25 00:00:00 - $time = new Chronos('1 hour ago'); // 1975-12-24 23:00:00 - -固定をリセットするには、 ``setTestNow()`` をパラメーター無し、または ``null`` を設定して -再び呼び出してください。 diff --git a/docs/package-lock.json b/docs/package-lock.json new file mode 100644 index 00000000..e48bd099 --- /dev/null +++ b/docs/package-lock.json @@ -0,0 +1,2104 @@ +{ + "name": "docs", + "version": "1.0.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "docs", + "version": "1.0.0", + "license": "ISC", + "dependencies": { + "@cakephp/docs-skeleton": "git+ssh://git@github.com:cakephp/docs-skeleton.git#node-package", + "vitepress": "^2.0.0-alpha.16" + } + }, + "node_modules/@babel/helper-string-parser": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz", + "integrity": "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-identifier": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.28.5.tgz", + "integrity": "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/parser": { + "version": "7.29.0", + "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.0.tgz", + "integrity": "sha512-IyDgFV5GeDUVX4YdF/3CPULtVGSXXMLh1xVIgdCgxApktqnQV0r7/8Nqthg+8YLGaAtdyIlo2qIdZrbCv4+7ww==", + "license": "MIT", + "dependencies": { + "@babel/types": "^7.29.0" + }, + "bin": { + "parser": "bin/babel-parser.js" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@babel/types": { + "version": "7.29.0", + "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.0.tgz", + "integrity": "sha512-LwdZHpScM4Qz8Xw2iKSzS+cfglZzJGvofQICy7W7v4caru4EaAmyUuO6BGrbyQ2mYV11W0U8j5mBhd14dd3B0A==", + "license": "MIT", + "dependencies": { + "@babel/helper-string-parser": "^7.27.1", + "@babel/helper-validator-identifier": "^7.28.5" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@cakephp/docs-skeleton": { + "version": "1.0.0", + "resolved": "git+ssh://git@github.com/cakephp/docs-skeleton.git#beb4b50177ce8fd81d5113d2e3fc49b107ddf2f2", + "bin": { + "cakedocs": "bin/cakedocs.js" + }, + "peerDependencies": { + "vitepress": "^2.0.0-alpha.15" + } + }, + "node_modules/@docsearch/css": { + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/@docsearch/css/-/css-4.6.0.tgz", + "integrity": "sha512-YlcAimkXclvqta47g47efzCM5CFxDwv2ClkDfEs/fC/Ak0OxPH2b3czwa4o8O1TRBf+ujFF2RiUwszz2fPVNJQ==", + "license": "MIT" + }, + "node_modules/@docsearch/js": { + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/@docsearch/js/-/js-4.6.0.tgz", + "integrity": "sha512-9/rbgkm/BgTq46cwxIohvSAz3koOFjnPpg0mwkJItAfzKbQIj+310PvwtgUY1YITDuGCag6yOL50GW2DBkaaBw==", + "license": "MIT" + }, + "node_modules/@docsearch/sidepanel-js": { + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/@docsearch/sidepanel-js/-/sidepanel-js-4.6.0.tgz", + "integrity": "sha512-lFT5KLwlzUmpoGArCScNoK41l9a22JYsEPwBzMrz+/ILVR5Ax87UphCuiyDFQWEvEmbwzn/kJx5W/O5BUlN1Rw==", + "license": "MIT" + }, + "node_modules/@esbuild/aix-ppc64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.27.4.tgz", + "integrity": "sha512-cQPwL2mp2nSmHHJlCyoXgHGhbEPMrEEU5xhkcy3Hs/O7nGZqEpZ2sUtLaL9MORLtDfRvVl2/3PAuEkYZH0Ty8Q==", + "cpu": [ + "ppc64" + ], + "license": "MIT", + "optional": true, + "os": [ + "aix" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.27.4.tgz", + "integrity": "sha512-X9bUgvxiC8CHAGKYufLIHGXPJWnr0OCdR0anD2e21vdvgCI8lIfqFbnoeOz7lBjdrAGUhqLZLcQo6MLhTO2DKQ==", + "cpu": [ + "arm" + ], + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.27.4.tgz", + "integrity": "sha512-gdLscB7v75wRfu7QSm/zg6Rx29VLdy9eTr2t44sfTW7CxwAtQghZ4ZnqHk3/ogz7xao0QAgrkradbBzcqFPasw==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-x64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.27.4.tgz", + "integrity": "sha512-PzPFnBNVF292sfpfhiyiXCGSn9HZg5BcAz+ivBuSsl6Rk4ga1oEXAamhOXRFyMcjwr2DVtm40G65N3GLeH1Lvw==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-arm64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.27.4.tgz", + "integrity": "sha512-b7xaGIwdJlht8ZFCvMkpDN6uiSmnxxK56N2GDTMYPr2/gzvfdQN8rTfBsvVKmIVY/X7EM+/hJKEIbbHs9oA4tQ==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-x64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.27.4.tgz", + "integrity": "sha512-sR+OiKLwd15nmCdqpXMnuJ9W2kpy0KigzqScqHI3Hqwr7IXxBp3Yva+yJwoqh7rE8V77tdoheRYataNKL4QrPw==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-arm64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.27.4.tgz", + "integrity": "sha512-jnfpKe+p79tCnm4GVav68A7tUFeKQwQyLgESwEAUzyxk/TJr4QdGog9sqWNcUbr/bZt/O/HXouspuQDd9JxFSw==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-x64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.27.4.tgz", + "integrity": "sha512-2kb4ceA/CpfUrIcTUl1wrP/9ad9Atrp5J94Lq69w7UwOMolPIGrfLSvAKJp0RTvkPPyn6CIWrNy13kyLikZRZQ==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.27.4.tgz", + "integrity": "sha512-aBYgcIxX/wd5n2ys0yESGeYMGF+pv6g0DhZr3G1ZG4jMfruU9Tl1i2Z+Wnj9/KjGz1lTLCcorqE2viePZqj4Eg==", + "cpu": [ + "arm" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.27.4.tgz", + "integrity": "sha512-7nQOttdzVGth1iz57kxg9uCz57dxQLHWxopL6mYuYthohPKEK0vU0C3O21CcBK6KDlkYVcnDXY099HcCDXd9dA==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ia32": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.27.4.tgz", + "integrity": "sha512-oPtixtAIzgvzYcKBQM/qZ3R+9TEUd1aNJQu0HhGyqtx6oS7qTpvjheIWBbes4+qu1bNlo2V4cbkISr8q6gRBFA==", + "cpu": [ + "ia32" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-loong64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.27.4.tgz", + "integrity": "sha512-8mL/vh8qeCoRcFH2nM8wm5uJP+ZcVYGGayMavi8GmRJjuI3g1v6Z7Ni0JJKAJW+m0EtUuARb6Lmp4hMjzCBWzA==", + "cpu": [ + "loong64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-mips64el": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.27.4.tgz", + "integrity": "sha512-1RdrWFFiiLIW7LQq9Q2NES+HiD4NyT8Itj9AUeCl0IVCA459WnPhREKgwrpaIfTOe+/2rdntisegiPWn/r/aAw==", + "cpu": [ + "mips64el" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ppc64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.27.4.tgz", + "integrity": "sha512-tLCwNG47l3sd9lpfyx9LAGEGItCUeRCWeAx6x2Jmbav65nAwoPXfewtAdtbtit/pJFLUWOhpv0FpS6GQAmPrHA==", + "cpu": [ + "ppc64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-riscv64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.27.4.tgz", + "integrity": "sha512-BnASypppbUWyqjd1KIpU4AUBiIhVr6YlHx/cnPgqEkNoVOhHg+YiSVxM1RLfiy4t9cAulbRGTNCKOcqHrEQLIw==", + "cpu": [ + "riscv64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-s390x": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.27.4.tgz", + "integrity": "sha512-+eUqgb/Z7vxVLezG8bVB9SfBie89gMueS+I0xYh2tJdw3vqA/0ImZJ2ROeWwVJN59ihBeZ7Tu92dF/5dy5FttA==", + "cpu": [ + "s390x" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-x64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.27.4.tgz", + "integrity": "sha512-S5qOXrKV8BQEzJPVxAwnryi2+Iq5pB40gTEIT69BQONqR7JH1EPIcQ/Uiv9mCnn05jff9umq/5nqzxlqTOg9NA==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-arm64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.27.4.tgz", + "integrity": "sha512-xHT8X4sb0GS8qTqiwzHqpY00C95DPAq7nAwX35Ie/s+LO9830hrMd3oX0ZMKLvy7vsonee73x0lmcdOVXFzd6Q==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-x64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.27.4.tgz", + "integrity": "sha512-RugOvOdXfdyi5Tyv40kgQnI0byv66BFgAqjdgtAKqHoZTbTF2QqfQrFwa7cHEORJf6X2ht+l9ABLMP0dnKYsgg==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-arm64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.27.4.tgz", + "integrity": "sha512-2MyL3IAaTX+1/qP0O1SwskwcwCoOI4kV2IBX1xYnDDqthmq5ArrW94qSIKCAuRraMgPOmG0RDTA74mzYNQA9ow==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-x64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.27.4.tgz", + "integrity": "sha512-u8fg/jQ5aQDfsnIV6+KwLOf1CmJnfu1ShpwqdwC0uA7ZPwFws55Ngc12vBdeUdnuWoQYx/SOQLGDcdlfXhYmXQ==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openharmony-arm64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.27.4.tgz", + "integrity": "sha512-JkTZrl6VbyO8lDQO3yv26nNr2RM2yZzNrNHEsj9bm6dOwwu9OYN28CjzZkH57bh4w0I2F7IodpQvUAEd1mbWXg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/sunos-x64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.27.4.tgz", + "integrity": "sha512-/gOzgaewZJfeJTlsWhvUEmUG4tWEY2Spp5M20INYRg2ZKl9QPO3QEEgPeRtLjEWSW8FilRNacPOg8R1uaYkA6g==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "sunos" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-arm64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.27.4.tgz", + "integrity": "sha512-Z9SExBg2y32smoDQdf1HRwHRt6vAHLXcxD2uGgO/v2jK7Y718Ix4ndsbNMU/+1Qiem9OiOdaqitioZwxivhXYg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-ia32": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.27.4.tgz", + "integrity": "sha512-DAyGLS0Jz5G5iixEbMHi5KdiApqHBWMGzTtMiJ72ZOLhbu/bzxgAe8Ue8CTS3n3HbIUHQz/L51yMdGMeoxXNJw==", + "cpu": [ + "ia32" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-x64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.27.4.tgz", + "integrity": "sha512-+knoa0BDoeXgkNvvV1vvbZX4+hizelrkwmGJBdT17t8FNPwG2lKemmuMZlmaNQ3ws3DKKCxpb4zRZEIp3UxFCg==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@iconify-json/simple-icons": { + "version": "1.2.74", + "resolved": "https://registry.npmjs.org/@iconify-json/simple-icons/-/simple-icons-1.2.74.tgz", + "integrity": "sha512-yqaohfY6jnYjTVpuTkaBQHrWbdUrQyWXhau0r/0EZiNWYXPX/P8WWwl1DoLH5CbvDjjcWQw5J0zADhgCUklOqA==", + "license": "CC0-1.0", + "dependencies": { + "@iconify/types": "*" + } + }, + "node_modules/@iconify/types": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/@iconify/types/-/types-2.0.0.tgz", + "integrity": "sha512-+wluvCrRhXrhyOmRDJ3q8mux9JkKy5SJ/v8ol2tu4FVjyYvtEzkc/3pK15ET6RKg4b4w4BmTk1+gsCUhf21Ykg==", + "license": "MIT" + }, + "node_modules/@jridgewell/sourcemap-codec": { + "version": "1.5.5", + "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz", + "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==", + "license": "MIT" + }, + "node_modules/@rolldown/pluginutils": { + "version": "1.0.0-rc.2", + "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.0-rc.2.tgz", + "integrity": "sha512-izyXV/v+cHiRfozX62W9htOAvwMo4/bXKDrQ+vom1L1qRuexPock/7VZDAhnpHCLNejd3NJ6hiab+tO0D44Rgw==", + "license": "MIT" + }, + "node_modules/@rollup/rollup-android-arm-eabi": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.59.0.tgz", + "integrity": "sha512-upnNBkA6ZH2VKGcBj9Fyl9IGNPULcjXRlg0LLeaioQWueH30p6IXtJEbKAgvyv+mJaMxSm1l6xwDXYjpEMiLMg==", + "cpu": [ + "arm" + ], + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-android-arm64": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.59.0.tgz", + "integrity": "sha512-hZ+Zxj3SySm4A/DylsDKZAeVg0mvi++0PYVceVyX7hemkw7OreKdCvW2oQ3T1FMZvCaQXqOTHb8qmBShoqk69Q==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-darwin-arm64": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.59.0.tgz", + "integrity": "sha512-W2Psnbh1J8ZJw0xKAd8zdNgF9HRLkdWwwdWqubSVk0pUuQkoHnv7rx4GiF9rT4t5DIZGAsConRE3AxCdJ4m8rg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-darwin-x64": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.59.0.tgz", + "integrity": "sha512-ZW2KkwlS4lwTv7ZVsYDiARfFCnSGhzYPdiOU4IM2fDbL+QGlyAbjgSFuqNRbSthybLbIJ915UtZBtmuLrQAT/w==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-freebsd-arm64": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.59.0.tgz", + "integrity": "sha512-EsKaJ5ytAu9jI3lonzn3BgG8iRBjV4LxZexygcQbpiU0wU0ATxhNVEpXKfUa0pS05gTcSDMKpn3Sx+QB9RlTTA==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-freebsd-x64": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.59.0.tgz", + "integrity": "sha512-d3DuZi2KzTMjImrxoHIAODUZYoUUMsuUiY4SRRcJy6NJoZ6iIqWnJu9IScV9jXysyGMVuW+KNzZvBLOcpdl3Vg==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-linux-arm-gnueabihf": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.59.0.tgz", + "integrity": "sha512-t4ONHboXi/3E0rT6OZl1pKbl2Vgxf9vJfWgmUoCEVQVxhW6Cw/c8I6hbbu7DAvgp82RKiH7TpLwxnJeKv2pbsw==", + "cpu": [ + "arm" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm-musleabihf": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.59.0.tgz", + "integrity": "sha512-CikFT7aYPA2ufMD086cVORBYGHffBo4K8MQ4uPS/ZnY54GKj36i196u8U+aDVT2LX4eSMbyHtyOh7D7Zvk2VvA==", + "cpu": [ + "arm" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-gnu": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.59.0.tgz", + "integrity": "sha512-jYgUGk5aLd1nUb1CtQ8E+t5JhLc9x5WdBKew9ZgAXg7DBk0ZHErLHdXM24rfX+bKrFe+Xp5YuJo54I5HFjGDAA==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-musl": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.59.0.tgz", + "integrity": "sha512-peZRVEdnFWZ5Bh2KeumKG9ty7aCXzzEsHShOZEFiCQlDEepP1dpUl/SrUNXNg13UmZl+gzVDPsiCwnV1uI0RUA==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-gnu": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.59.0.tgz", + "integrity": "sha512-gbUSW/97f7+r4gHy3Jlup8zDG190AuodsWnNiXErp9mT90iCy9NKKU0Xwx5k8VlRAIV2uU9CsMnEFg/xXaOfXg==", + "cpu": [ + "loong64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-musl": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.59.0.tgz", + "integrity": "sha512-yTRONe79E+o0FWFijasoTjtzG9EBedFXJMl888NBEDCDV9I2wGbFFfJQQe63OijbFCUZqxpHz1GzpbtSFikJ4Q==", + "cpu": [ + "loong64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-gnu": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.59.0.tgz", + "integrity": "sha512-sw1o3tfyk12k3OEpRddF68a1unZ5VCN7zoTNtSn2KndUE+ea3m3ROOKRCZxEpmT9nsGnogpFP9x6mnLTCaoLkA==", + "cpu": [ + "ppc64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-musl": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.59.0.tgz", + "integrity": "sha512-+2kLtQ4xT3AiIxkzFVFXfsmlZiG5FXYW7ZyIIvGA7Bdeuh9Z0aN4hVyXS/G1E9bTP/vqszNIN/pUKCk/BTHsKA==", + "cpu": [ + "ppc64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-gnu": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.59.0.tgz", + "integrity": "sha512-NDYMpsXYJJaj+I7UdwIuHHNxXZ/b/N2hR15NyH3m2qAtb/hHPA4g4SuuvrdxetTdndfj9b1WOmy73kcPRoERUg==", + "cpu": [ + "riscv64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-musl": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.59.0.tgz", + "integrity": "sha512-nLckB8WOqHIf1bhymk+oHxvM9D3tyPndZH8i8+35p/1YiVoVswPid2yLzgX7ZJP0KQvnkhM4H6QZ5m0LzbyIAg==", + "cpu": [ + "riscv64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-s390x-gnu": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.59.0.tgz", + "integrity": "sha512-oF87Ie3uAIvORFBpwnCvUzdeYUqi2wY6jRFWJAy1qus/udHFYIkplYRW+wo+GRUP4sKzYdmE1Y3+rY5Gc4ZO+w==", + "cpu": [ + "s390x" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-gnu": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.59.0.tgz", + "integrity": "sha512-3AHmtQq/ppNuUspKAlvA8HtLybkDflkMuLK4DPo77DfthRb71V84/c4MlWJXixZz4uruIH4uaa07IqoAkG64fg==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-musl": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.59.0.tgz", + "integrity": "sha512-2UdiwS/9cTAx7qIUZB/fWtToJwvt0Vbo0zmnYt7ED35KPg13Q0ym1g442THLC7VyI6JfYTP4PiSOWyoMdV2/xg==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-openbsd-x64": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.59.0.tgz", + "integrity": "sha512-M3bLRAVk6GOwFlPTIxVBSYKUaqfLrn8l0psKinkCFxl4lQvOSz8ZrKDz2gxcBwHFpci0B6rttydI4IpS4IS/jQ==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ] + }, + "node_modules/@rollup/rollup-openharmony-arm64": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.59.0.tgz", + "integrity": "sha512-tt9KBJqaqp5i5HUZzoafHZX8b5Q2Fe7UjYERADll83O4fGqJ49O1FsL6LpdzVFQcpwvnyd0i+K/VSwu/o/nWlA==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ] + }, + "node_modules/@rollup/rollup-win32-arm64-msvc": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.59.0.tgz", + "integrity": "sha512-V5B6mG7OrGTwnxaNUzZTDTjDS7F75PO1ae6MJYdiMu60sq0CqN5CVeVsbhPxalupvTX8gXVSU9gq+Rx1/hvu6A==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-ia32-msvc": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.59.0.tgz", + "integrity": "sha512-UKFMHPuM9R0iBegwzKF4y0C4J9u8C6MEJgFuXTBerMk7EJ92GFVFYBfOZaSGLu6COf7FxpQNqhNS4c4icUPqxA==", + "cpu": [ + "ia32" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-gnu": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.59.0.tgz", + "integrity": "sha512-laBkYlSS1n2L8fSo1thDNGrCTQMmxjYY5G0WFWjFFYZkKPjsMBsgJfGf4TLxXrF6RyhI60L8TMOjBMvXiTcxeA==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-msvc": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.59.0.tgz", + "integrity": "sha512-2HRCml6OztYXyJXAvdDXPKcawukWY2GpR5/nxKp4iBgiO3wcoEGkAaqctIbZcNB6KlUQBIqt8VYkNSj2397EfA==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@shikijs/core": { + "version": "3.23.0", + "resolved": "https://registry.npmjs.org/@shikijs/core/-/core-3.23.0.tgz", + "integrity": "sha512-NSWQz0riNb67xthdm5br6lAkvpDJRTgB36fxlo37ZzM2yq0PQFFzbd8psqC2XMPgCzo1fW6cVi18+ArJ44wqgA==", + "license": "MIT", + "dependencies": { + "@shikijs/types": "3.23.0", + "@shikijs/vscode-textmate": "^10.0.2", + "@types/hast": "^3.0.4", + "hast-util-to-html": "^9.0.5" + } + }, + "node_modules/@shikijs/engine-javascript": { + "version": "3.23.0", + "resolved": "https://registry.npmjs.org/@shikijs/engine-javascript/-/engine-javascript-3.23.0.tgz", + "integrity": "sha512-aHt9eiGFobmWR5uqJUViySI1bHMqrAgamWE1TYSUoftkAeCCAiGawPMwM+VCadylQtF4V3VNOZ5LmfItH5f3yA==", + "license": "MIT", + "dependencies": { + "@shikijs/types": "3.23.0", + "@shikijs/vscode-textmate": "^10.0.2", + "oniguruma-to-es": "^4.3.4" + } + }, + "node_modules/@shikijs/engine-oniguruma": { + "version": "3.23.0", + "resolved": "https://registry.npmjs.org/@shikijs/engine-oniguruma/-/engine-oniguruma-3.23.0.tgz", + "integrity": "sha512-1nWINwKXxKKLqPibT5f4pAFLej9oZzQTsby8942OTlsJzOBZ0MWKiwzMsd+jhzu8YPCHAswGnnN1YtQfirL35g==", + "license": "MIT", + "dependencies": { + "@shikijs/types": "3.23.0", + "@shikijs/vscode-textmate": "^10.0.2" + } + }, + "node_modules/@shikijs/langs": { + "version": "3.23.0", + "resolved": "https://registry.npmjs.org/@shikijs/langs/-/langs-3.23.0.tgz", + "integrity": "sha512-2Ep4W3Re5aB1/62RSYQInK9mM3HsLeB91cHqznAJMuylqjzNVAVCMnNWRHFtcNHXsoNRayP9z1qj4Sq3nMqYXg==", + "license": "MIT", + "dependencies": { + "@shikijs/types": "3.23.0" + } + }, + "node_modules/@shikijs/themes": { + "version": "3.23.0", + "resolved": "https://registry.npmjs.org/@shikijs/themes/-/themes-3.23.0.tgz", + "integrity": "sha512-5qySYa1ZgAT18HR/ypENL9cUSGOeI2x+4IvYJu4JgVJdizn6kG4ia5Q1jDEOi7gTbN4RbuYtmHh0W3eccOrjMA==", + "license": "MIT", + "dependencies": { + "@shikijs/types": "3.23.0" + } + }, + "node_modules/@shikijs/transformers": { + "version": "3.23.0", + "resolved": "https://registry.npmjs.org/@shikijs/transformers/-/transformers-3.23.0.tgz", + "integrity": "sha512-F9msZVxdF+krQNSdQ4V+Ja5QemeAoTQ2jxt7nJCwhDsdF1JWS3KxIQXA3lQbyKwS3J61oHRUSv4jYWv3CkaKTQ==", + "license": "MIT", + "dependencies": { + "@shikijs/core": "3.23.0", + "@shikijs/types": "3.23.0" + } + }, + "node_modules/@shikijs/types": { + "version": "3.23.0", + "resolved": "https://registry.npmjs.org/@shikijs/types/-/types-3.23.0.tgz", + "integrity": "sha512-3JZ5HXOZfYjsYSk0yPwBrkupyYSLpAE26Qc0HLghhZNGTZg/SKxXIIgoxOpmmeQP0RRSDJTk1/vPfw9tbw+jSQ==", + "license": "MIT", + "dependencies": { + "@shikijs/vscode-textmate": "^10.0.2", + "@types/hast": "^3.0.4" + } + }, + "node_modules/@shikijs/vscode-textmate": { + "version": "10.0.2", + "resolved": "https://registry.npmjs.org/@shikijs/vscode-textmate/-/vscode-textmate-10.0.2.tgz", + "integrity": "sha512-83yeghZ2xxin3Nj8z1NMd/NCuca+gsYXswywDy5bHvwlWL8tpTQmzGeUuHd9FC3E/SBEMvzJRwWEOz5gGes9Qg==", + "license": "MIT" + }, + "node_modules/@types/estree": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz", + "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==", + "license": "MIT" + }, + "node_modules/@types/hast": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/@types/hast/-/hast-3.0.4.tgz", + "integrity": "sha512-WPs+bbQw5aCj+x6laNGWLH3wviHtoCv/P3+otBhbOhJgG8qtpdAMlTCxLtsTWA7LH1Oh/bFCHsBn0TPS5m30EQ==", + "license": "MIT", + "dependencies": { + "@types/unist": "*" + } + }, + "node_modules/@types/linkify-it": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/@types/linkify-it/-/linkify-it-5.0.0.tgz", + "integrity": "sha512-sVDA58zAw4eWAffKOaQH5/5j3XeayukzDk+ewSsnv3p4yJEZHCCzMDiZM8e0OUrRvmpGZ85jf4yDHkHsgBNr9Q==", + "license": "MIT" + }, + "node_modules/@types/markdown-it": { + "version": "14.1.2", + "resolved": "https://registry.npmjs.org/@types/markdown-it/-/markdown-it-14.1.2.tgz", + "integrity": "sha512-promo4eFwuiW+TfGxhi+0x3czqTYJkG8qB17ZUJiVF10Xm7NLVRSLUsfRTU/6h1e24VvRnXCx+hG7li58lkzog==", + "license": "MIT", + "dependencies": { + "@types/linkify-it": "^5", + "@types/mdurl": "^2" + } + }, + "node_modules/@types/mdast": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/@types/mdast/-/mdast-4.0.4.tgz", + "integrity": "sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA==", + "license": "MIT", + "dependencies": { + "@types/unist": "*" + } + }, + "node_modules/@types/mdurl": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/@types/mdurl/-/mdurl-2.0.0.tgz", + "integrity": "sha512-RGdgjQUZba5p6QEFAVx2OGb8rQDL/cPRG7GiedRzMcJ1tYnUANBncjbSB1NRGwbvjcPeikRABz2nshyPk1bhWg==", + "license": "MIT" + }, + "node_modules/@types/unist": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/@types/unist/-/unist-3.0.3.tgz", + "integrity": "sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==", + "license": "MIT" + }, + "node_modules/@types/web-bluetooth": { + "version": "0.0.21", + "resolved": "https://registry.npmjs.org/@types/web-bluetooth/-/web-bluetooth-0.0.21.tgz", + "integrity": "sha512-oIQLCGWtcFZy2JW77j9k8nHzAOpqMHLQejDA48XXMWH6tjCQHz5RCFz1bzsmROyL6PUm+LLnUiI4BCn221inxA==", + "license": "MIT" + }, + "node_modules/@ungap/structured-clone": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/@ungap/structured-clone/-/structured-clone-1.3.0.tgz", + "integrity": "sha512-WmoN8qaIAo7WTYWbAZuG8PYEhn5fkz7dZrqTBZ7dtt//lL2Gwms1IcnQ5yHqjDfX8Ft5j4YzDM23f87zBfDe9g==", + "license": "ISC" + }, + "node_modules/@vitejs/plugin-vue": { + "version": "6.0.5", + "resolved": "https://registry.npmjs.org/@vitejs/plugin-vue/-/plugin-vue-6.0.5.tgz", + "integrity": "sha512-bL3AxKuQySfk1iGcBsQnoRVexTPJq0Z/ixFVM8OhVJAP6ZXXXLtM7NFKWhLl30Kg7uTBqIaPXbh+nuQCuBDedg==", + "license": "MIT", + "dependencies": { + "@rolldown/pluginutils": "1.0.0-rc.2" + }, + "engines": { + "node": "^20.19.0 || >=22.12.0" + }, + "peerDependencies": { + "vite": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0", + "vue": "^3.2.25" + } + }, + "node_modules/@vue/compiler-core": { + "version": "3.5.30", + "resolved": "https://registry.npmjs.org/@vue/compiler-core/-/compiler-core-3.5.30.tgz", + "integrity": "sha512-s3DfdZkcu/qExZ+td75015ljzHc6vE+30cFMGRPROYjqkroYI5NV2X1yAMX9UeyBNWB9MxCfPcsjpLS11nzkkw==", + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.29.0", + "@vue/shared": "3.5.30", + "entities": "^7.0.1", + "estree-walker": "^2.0.2", + "source-map-js": "^1.2.1" + } + }, + "node_modules/@vue/compiler-dom": { + "version": "3.5.30", + "resolved": "https://registry.npmjs.org/@vue/compiler-dom/-/compiler-dom-3.5.30.tgz", + "integrity": "sha512-eCFYESUEVYHhiMuK4SQTldO3RYxyMR/UQL4KdGD1Yrkfdx4m/HYuZ9jSfPdA+nWJY34VWndiYdW/wZXyiPEB9g==", + "license": "MIT", + "dependencies": { + "@vue/compiler-core": "3.5.30", + "@vue/shared": "3.5.30" + } + }, + "node_modules/@vue/compiler-sfc": { + "version": "3.5.30", + "resolved": "https://registry.npmjs.org/@vue/compiler-sfc/-/compiler-sfc-3.5.30.tgz", + "integrity": "sha512-LqmFPDn89dtU9vI3wHJnwaV6GfTRD87AjWpTWpyrdVOObVtjIuSeZr181z5C4PmVx/V3j2p+0f7edFKGRMpQ5A==", + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.29.0", + "@vue/compiler-core": "3.5.30", + "@vue/compiler-dom": "3.5.30", + "@vue/compiler-ssr": "3.5.30", + "@vue/shared": "3.5.30", + "estree-walker": "^2.0.2", + "magic-string": "^0.30.21", + "postcss": "^8.5.8", + "source-map-js": "^1.2.1" + } + }, + "node_modules/@vue/compiler-ssr": { + "version": "3.5.30", + "resolved": "https://registry.npmjs.org/@vue/compiler-ssr/-/compiler-ssr-3.5.30.tgz", + "integrity": "sha512-NsYK6OMTnx109PSL2IAyf62JP6EUdk4Dmj6AkWcJGBvN0dQoMYtVekAmdqgTtWQgEJo+Okstbf/1p7qZr5H+bA==", + "license": "MIT", + "dependencies": { + "@vue/compiler-dom": "3.5.30", + "@vue/shared": "3.5.30" + } + }, + "node_modules/@vue/devtools-api": { + "version": "8.1.0", + "resolved": "https://registry.npmjs.org/@vue/devtools-api/-/devtools-api-8.1.0.tgz", + "integrity": "sha512-O44X57jjkLKbLEc4OgL/6fEPOOanRJU8kYpCE8qfKlV96RQZcdzrcLI5mxMuVRUeXhHKIHGhCpHacyCk0HyO4w==", + "license": "MIT", + "dependencies": { + "@vue/devtools-kit": "^8.1.0" + } + }, + "node_modules/@vue/devtools-kit": { + "version": "8.1.0", + "resolved": "https://registry.npmjs.org/@vue/devtools-kit/-/devtools-kit-8.1.0.tgz", + "integrity": "sha512-/NZlS4WtGIB54DA/z10gzk+n/V7zaqSzYZOVlg2CfdnpIKdB61bd7JDIMxf/zrtX41zod8E2/bbEBoW/d7x70Q==", + "license": "MIT", + "dependencies": { + "@vue/devtools-shared": "^8.1.0", + "birpc": "^2.6.1", + "hookable": "^5.5.3", + "perfect-debounce": "^2.0.0" + } + }, + "node_modules/@vue/devtools-shared": { + "version": "8.1.0", + "resolved": "https://registry.npmjs.org/@vue/devtools-shared/-/devtools-shared-8.1.0.tgz", + "integrity": "sha512-h8uCb4Qs8UT8VdTT5yjY6tOJ//qH7EpxToixR0xqejR55t5OdISIg7AJ7eBkhBs8iu1qG5gY3QQNN1DF1EelAA==", + "license": "MIT" + }, + "node_modules/@vue/reactivity": { + "version": "3.5.30", + "resolved": "https://registry.npmjs.org/@vue/reactivity/-/reactivity-3.5.30.tgz", + "integrity": "sha512-179YNgKATuwj9gB+66snskRDOitDiuOZqkYia7mHKJaidOMo/WJxHKF8DuGc4V4XbYTJANlfEKb0yxTQotnx4Q==", + "license": "MIT", + "dependencies": { + "@vue/shared": "3.5.30" + } + }, + "node_modules/@vue/runtime-core": { + "version": "3.5.30", + "resolved": "https://registry.npmjs.org/@vue/runtime-core/-/runtime-core-3.5.30.tgz", + "integrity": "sha512-e0Z+8PQsUTdwV8TtEsLzUM7SzC7lQwYKePydb7K2ZnmS6jjND+WJXkmmfh/swYzRyfP1EY3fpdesyYoymCzYfg==", + "license": "MIT", + "dependencies": { + "@vue/reactivity": "3.5.30", + "@vue/shared": "3.5.30" + } + }, + "node_modules/@vue/runtime-dom": { + "version": "3.5.30", + "resolved": "https://registry.npmjs.org/@vue/runtime-dom/-/runtime-dom-3.5.30.tgz", + "integrity": "sha512-2UIGakjU4WSQ0T4iwDEW0W7vQj6n7AFn7taqZ9Cvm0Q/RA2FFOziLESrDL4GmtI1wV3jXg5nMoJSYO66egDUBw==", + "license": "MIT", + "dependencies": { + "@vue/reactivity": "3.5.30", + "@vue/runtime-core": "3.5.30", + "@vue/shared": "3.5.30", + "csstype": "^3.2.3" + } + }, + "node_modules/@vue/server-renderer": { + "version": "3.5.30", + "resolved": "https://registry.npmjs.org/@vue/server-renderer/-/server-renderer-3.5.30.tgz", + "integrity": "sha512-v+R34icapydRwbZRD0sXwtHqrQJv38JuMB4JxbOxd8NEpGLny7cncMp53W9UH/zo4j8eDHjQ1dEJXwzFQknjtQ==", + "license": "MIT", + "dependencies": { + "@vue/compiler-ssr": "3.5.30", + "@vue/shared": "3.5.30" + }, + "peerDependencies": { + "vue": "3.5.30" + } + }, + "node_modules/@vue/shared": { + "version": "3.5.30", + "resolved": "https://registry.npmjs.org/@vue/shared/-/shared-3.5.30.tgz", + "integrity": "sha512-YXgQ7JjaO18NeK2K9VTbDHaFy62WrObMa6XERNfNOkAhD1F1oDSf3ZJ7K6GqabZ0BvSDHajp8qfS5Sa2I9n8uQ==", + "license": "MIT" + }, + "node_modules/@vueuse/core": { + "version": "14.2.1", + "resolved": "https://registry.npmjs.org/@vueuse/core/-/core-14.2.1.tgz", + "integrity": "sha512-3vwDzV+GDUNpdegRY6kzpLm4Igptq+GA0QkJ3W61Iv27YWwW/ufSlOfgQIpN6FZRMG0mkaz4gglJRtq5SeJyIQ==", + "license": "MIT", + "dependencies": { + "@types/web-bluetooth": "^0.0.21", + "@vueuse/metadata": "14.2.1", + "@vueuse/shared": "14.2.1" + }, + "funding": { + "url": "https://github.com/sponsors/antfu" + }, + "peerDependencies": { + "vue": "^3.5.0" + } + }, + "node_modules/@vueuse/integrations": { + "version": "14.2.1", + "resolved": "https://registry.npmjs.org/@vueuse/integrations/-/integrations-14.2.1.tgz", + "integrity": "sha512-2LIUpBi/67PoXJGqSDQUF0pgQWpNHh7beiA+KG2AbybcNm+pTGWT6oPGlBgUoDWmYwfeQqM/uzOHqcILpKL7nA==", + "license": "MIT", + "dependencies": { + "@vueuse/core": "14.2.1", + "@vueuse/shared": "14.2.1" + }, + "funding": { + "url": "https://github.com/sponsors/antfu" + }, + "peerDependencies": { + "async-validator": "^4", + "axios": "^1", + "change-case": "^5", + "drauu": "^0.4", + "focus-trap": "^7 || ^8", + "fuse.js": "^7", + "idb-keyval": "^6", + "jwt-decode": "^4", + "nprogress": "^0.2", + "qrcode": "^1.5", + "sortablejs": "^1", + "universal-cookie": "^7 || ^8", + "vue": "^3.5.0" + }, + "peerDependenciesMeta": { + "async-validator": { + "optional": true + }, + "axios": { + "optional": true + }, + "change-case": { + "optional": true + }, + "drauu": { + "optional": true + }, + "focus-trap": { + "optional": true + }, + "fuse.js": { + "optional": true + }, + "idb-keyval": { + "optional": true + }, + "jwt-decode": { + "optional": true + }, + "nprogress": { + "optional": true + }, + "qrcode": { + "optional": true + }, + "sortablejs": { + "optional": true + }, + "universal-cookie": { + "optional": true + } + } + }, + "node_modules/@vueuse/metadata": { + "version": "14.2.1", + "resolved": "https://registry.npmjs.org/@vueuse/metadata/-/metadata-14.2.1.tgz", + "integrity": "sha512-1ButlVtj5Sb/HDtIy1HFr1VqCP4G6Ypqt5MAo0lCgjokrk2mvQKsK2uuy0vqu/Ks+sHfuHo0B9Y9jn9xKdjZsw==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/antfu" + } + }, + "node_modules/@vueuse/shared": { + "version": "14.2.1", + "resolved": "https://registry.npmjs.org/@vueuse/shared/-/shared-14.2.1.tgz", + "integrity": "sha512-shTJncjV9JTI4oVNyF1FQonetYAiTBd+Qj7cY89SWbXSkx7gyhrgtEdF2ZAVWS1S3SHlaROO6F2IesJxQEkZBw==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/antfu" + }, + "peerDependencies": { + "vue": "^3.5.0" + } + }, + "node_modules/birpc": { + "version": "2.9.0", + "resolved": "https://registry.npmjs.org/birpc/-/birpc-2.9.0.tgz", + "integrity": "sha512-KrayHS5pBi69Xi9JmvoqrIgYGDkD6mcSe/i6YKi3w5kekCLzrX4+nawcXqrj2tIp50Kw/mT/s3p+GVK0A0sKxw==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/antfu" + } + }, + "node_modules/ccount": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/ccount/-/ccount-2.0.1.tgz", + "integrity": "sha512-eyrF0jiFpY+3drT6383f1qhkbGsLSifNAjA61IUjZjmLCWjItY6LB9ft9YhoDgwfmclB2zhu51Lc7+95b8NRAg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/character-entities-html4": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/character-entities-html4/-/character-entities-html4-2.1.0.tgz", + "integrity": "sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/character-entities-legacy": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/character-entities-legacy/-/character-entities-legacy-3.0.0.tgz", + "integrity": "sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/comma-separated-tokens": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/comma-separated-tokens/-/comma-separated-tokens-2.0.3.tgz", + "integrity": "sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/csstype": { + "version": "3.2.3", + "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz", + "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==", + "license": "MIT" + }, + "node_modules/dequal": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/dequal/-/dequal-2.0.3.tgz", + "integrity": "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/devlop": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/devlop/-/devlop-1.1.0.tgz", + "integrity": "sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA==", + "license": "MIT", + "dependencies": { + "dequal": "^2.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/entities": { + "version": "7.0.1", + "resolved": "https://registry.npmjs.org/entities/-/entities-7.0.1.tgz", + "integrity": "sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=0.12" + }, + "funding": { + "url": "https://github.com/fb55/entities?sponsor=1" + } + }, + "node_modules/esbuild": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.27.4.tgz", + "integrity": "sha512-Rq4vbHnYkK5fws5NF7MYTU68FPRE1ajX7heQ/8QXXWqNgqqJ/GkmmyxIzUnf2Sr/bakf8l54716CcMGHYhMrrQ==", + "hasInstallScript": true, + "license": "MIT", + "bin": { + "esbuild": "bin/esbuild" + }, + "engines": { + "node": ">=18" + }, + "optionalDependencies": { + "@esbuild/aix-ppc64": "0.27.4", + "@esbuild/android-arm": "0.27.4", + "@esbuild/android-arm64": "0.27.4", + "@esbuild/android-x64": "0.27.4", + "@esbuild/darwin-arm64": "0.27.4", + "@esbuild/darwin-x64": "0.27.4", + "@esbuild/freebsd-arm64": "0.27.4", + "@esbuild/freebsd-x64": "0.27.4", + "@esbuild/linux-arm": "0.27.4", + "@esbuild/linux-arm64": "0.27.4", + "@esbuild/linux-ia32": "0.27.4", + "@esbuild/linux-loong64": "0.27.4", + "@esbuild/linux-mips64el": "0.27.4", + "@esbuild/linux-ppc64": "0.27.4", + "@esbuild/linux-riscv64": "0.27.4", + "@esbuild/linux-s390x": "0.27.4", + "@esbuild/linux-x64": "0.27.4", + "@esbuild/netbsd-arm64": "0.27.4", + "@esbuild/netbsd-x64": "0.27.4", + "@esbuild/openbsd-arm64": "0.27.4", + "@esbuild/openbsd-x64": "0.27.4", + "@esbuild/openharmony-arm64": "0.27.4", + "@esbuild/sunos-x64": "0.27.4", + "@esbuild/win32-arm64": "0.27.4", + "@esbuild/win32-ia32": "0.27.4", + "@esbuild/win32-x64": "0.27.4" + } + }, + "node_modules/estree-walker": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-2.0.2.tgz", + "integrity": "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==", + "license": "MIT" + }, + "node_modules/fdir": { + "version": "6.5.0", + "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz", + "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==", + "license": "MIT", + "engines": { + "node": ">=12.0.0" + }, + "peerDependencies": { + "picomatch": "^3 || ^4" + }, + "peerDependenciesMeta": { + "picomatch": { + "optional": true + } + } + }, + "node_modules/focus-trap": { + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/focus-trap/-/focus-trap-7.8.0.tgz", + "integrity": "sha512-/yNdlIkpWbM0ptxno3ONTuf+2g318kh2ez3KSeZN5dZ8YC6AAmgeWz+GasYYiBJPFaYcSAPeu4GfhUaChzIJXA==", + "license": "MIT", + "peer": true, + "dependencies": { + "tabbable": "^6.4.0" + } + }, + "node_modules/fsevents": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", + "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/hast-util-to-html": { + "version": "9.0.5", + "resolved": "https://registry.npmjs.org/hast-util-to-html/-/hast-util-to-html-9.0.5.tgz", + "integrity": "sha512-OguPdidb+fbHQSU4Q4ZiLKnzWo8Wwsf5bZfbvu7//a9oTYoqD/fWpe96NuHkoS9h0ccGOTe0C4NGXdtS0iObOw==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "@types/unist": "^3.0.0", + "ccount": "^2.0.0", + "comma-separated-tokens": "^2.0.0", + "hast-util-whitespace": "^3.0.0", + "html-void-elements": "^3.0.0", + "mdast-util-to-hast": "^13.0.0", + "property-information": "^7.0.0", + "space-separated-tokens": "^2.0.0", + "stringify-entities": "^4.0.0", + "zwitch": "^2.0.4" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-whitespace": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/hast-util-whitespace/-/hast-util-whitespace-3.0.0.tgz", + "integrity": "sha512-88JUN06ipLwsnv+dVn+OIYOvAuvBMy/Qoi6O7mQHxdPXpjy+Cd6xRkWwux7DKO+4sYILtLBRIKgsdpS2gQc7qw==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hookable": { + "version": "5.5.3", + "resolved": "https://registry.npmjs.org/hookable/-/hookable-5.5.3.tgz", + "integrity": "sha512-Yc+BQe8SvoXH1643Qez1zqLRmbA5rCL+sSmk6TVos0LWVfNIB7PGncdlId77WzLGSIB5KaWgTaNTs2lNVEI6VQ==", + "license": "MIT" + }, + "node_modules/html-void-elements": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/html-void-elements/-/html-void-elements-3.0.0.tgz", + "integrity": "sha512-bEqo66MRXsUGxWHV5IP0PUiAWwoEjba4VCzg0LjFJBpchPaTfyfCKTG6bc5F8ucKec3q5y6qOdGyYTSBEvhCrg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/magic-string": { + "version": "0.30.21", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz", + "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==", + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.5" + } + }, + "node_modules/mark.js": { + "version": "8.11.1", + "resolved": "https://registry.npmjs.org/mark.js/-/mark.js-8.11.1.tgz", + "integrity": "sha512-1I+1qpDt4idfgLQG+BNWmrqku+7/2bi5nLf4YwF8y8zXvmfiTBY3PV3ZibfrjBueCByROpuBjLLFCajqkgYoLQ==", + "license": "MIT" + }, + "node_modules/mdast-util-to-hast": { + "version": "13.2.1", + "resolved": "https://registry.npmjs.org/mdast-util-to-hast/-/mdast-util-to-hast-13.2.1.tgz", + "integrity": "sha512-cctsq2wp5vTsLIcaymblUriiTcZd0CwWtCbLvrOzYCDZoWyMNV8sZ7krj09FSnsiJi3WVsHLM4k6Dq/yaPyCXA==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "@types/mdast": "^4.0.0", + "@ungap/structured-clone": "^1.0.0", + "devlop": "^1.0.0", + "micromark-util-sanitize-uri": "^2.0.0", + "trim-lines": "^3.0.0", + "unist-util-position": "^5.0.0", + "unist-util-visit": "^5.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-util-character": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/micromark-util-character/-/micromark-util-character-2.1.1.tgz", + "integrity": "sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-encode": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-encode/-/micromark-util-encode-2.0.1.tgz", + "integrity": "sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT" + }, + "node_modules/micromark-util-sanitize-uri": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-sanitize-uri/-/micromark-util-sanitize-uri-2.0.1.tgz", + "integrity": "sha512-9N9IomZ/YuGGZZmQec1MbgxtlgougxTodVwDzzEouPKo3qFWvymFHWcnDi2vzV1ff6kas9ucW+o3yzJK9YB1AQ==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-character": "^2.0.0", + "micromark-util-encode": "^2.0.0", + "micromark-util-symbol": "^2.0.0" + } + }, + "node_modules/micromark-util-symbol": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-symbol/-/micromark-util-symbol-2.0.1.tgz", + "integrity": "sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT" + }, + "node_modules/micromark-util-types": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/micromark-util-types/-/micromark-util-types-2.0.2.tgz", + "integrity": "sha512-Yw0ECSpJoViF1qTU4DC6NwtC4aWGt1EkzaQB8KPPyCRR8z9TWeV0HbEFGTO+ZY1wB22zmxnJqhPyTpOVCpeHTA==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT" + }, + "node_modules/minisearch": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/minisearch/-/minisearch-7.2.0.tgz", + "integrity": "sha512-dqT2XBYUOZOiC5t2HRnwADjhNS2cecp9u+TJRiJ1Qp/f5qjkeT5APcGPjHw+bz89Ms8Jp+cG4AlE+QZ/QnDglg==", + "license": "MIT" + }, + "node_modules/nanoid": { + "version": "3.3.11", + "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz", + "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "bin": { + "nanoid": "bin/nanoid.cjs" + }, + "engines": { + "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1" + } + }, + "node_modules/oniguruma-parser": { + "version": "0.12.1", + "resolved": "https://registry.npmjs.org/oniguruma-parser/-/oniguruma-parser-0.12.1.tgz", + "integrity": "sha512-8Unqkvk1RYc6yq2WBYRj4hdnsAxVze8i7iPfQr8e4uSP3tRv0rpZcbGUDvxfQQcdwHt/e9PrMvGCsa8OqG9X3w==", + "license": "MIT" + }, + "node_modules/oniguruma-to-es": { + "version": "4.3.5", + "resolved": "https://registry.npmjs.org/oniguruma-to-es/-/oniguruma-to-es-4.3.5.tgz", + "integrity": "sha512-Zjygswjpsewa0NLTsiizVuMQZbp0MDyM6lIt66OxsF21npUDlzpHi1Mgb/qhQdkb+dWFTzJmFbEWdvZgRho8eQ==", + "license": "MIT", + "dependencies": { + "oniguruma-parser": "^0.12.1", + "regex": "^6.1.0", + "regex-recursion": "^6.0.2" + } + }, + "node_modules/perfect-debounce": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/perfect-debounce/-/perfect-debounce-2.1.0.tgz", + "integrity": "sha512-LjgdTytVFXeUgtHZr9WYViYSM/g8MkcTPYDlPa3cDqMirHjKiSZPYd6DoL7pK8AJQr+uWkQvCjHNdiMqsrJs+g==", + "license": "MIT" + }, + "node_modules/picocolors": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "license": "ISC" + }, + "node_modules/picomatch": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz", + "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==", + "license": "MIT", + "peer": true, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/postcss": { + "version": "8.5.8", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.8.tgz", + "integrity": "sha512-OW/rX8O/jXnm82Ey1k44pObPtdblfiuWnrd8X7GJ7emImCOstunGbXUpp7HdBrFQX6rJzn3sPT397Wp5aCwCHg==", + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/postcss" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "nanoid": "^3.3.11", + "picocolors": "^1.1.1", + "source-map-js": "^1.2.1" + }, + "engines": { + "node": "^10 || ^12 || >=14" + } + }, + "node_modules/property-information": { + "version": "7.1.0", + "resolved": "https://registry.npmjs.org/property-information/-/property-information-7.1.0.tgz", + "integrity": "sha512-TwEZ+X+yCJmYfL7TPUOcvBZ4QfoT5YenQiJuX//0th53DE6w0xxLEtfK3iyryQFddXuvkIk51EEgrJQ0WJkOmQ==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/regex": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/regex/-/regex-6.1.0.tgz", + "integrity": "sha512-6VwtthbV4o/7+OaAF9I5L5V3llLEsoPyq9P1JVXkedTP33c7MfCG0/5NOPcSJn0TzXcG9YUrR0gQSWioew3LDg==", + "license": "MIT", + "dependencies": { + "regex-utilities": "^2.3.0" + } + }, + "node_modules/regex-recursion": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/regex-recursion/-/regex-recursion-6.0.2.tgz", + "integrity": "sha512-0YCaSCq2VRIebiaUviZNs0cBz1kg5kVS2UKUfNIx8YVs1cN3AV7NTctO5FOKBA+UT2BPJIWZauYHPqJODG50cg==", + "license": "MIT", + "dependencies": { + "regex-utilities": "^2.3.0" + } + }, + "node_modules/regex-utilities": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/regex-utilities/-/regex-utilities-2.3.0.tgz", + "integrity": "sha512-8VhliFJAWRaUiVvREIiW2NXXTmHs4vMNnSzuJVhscgmGav3g9VDxLrQndI3dZZVVdp0ZO/5v0xmX516/7M9cng==", + "license": "MIT" + }, + "node_modules/rollup": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.59.0.tgz", + "integrity": "sha512-2oMpl67a3zCH9H79LeMcbDhXW/UmWG/y2zuqnF2jQq5uq9TbM9TVyXvA4+t+ne2IIkBdrLpAaRQAvo7YI/Yyeg==", + "license": "MIT", + "dependencies": { + "@types/estree": "1.0.8" + }, + "bin": { + "rollup": "dist/bin/rollup" + }, + "engines": { + "node": ">=18.0.0", + "npm": ">=8.0.0" + }, + "optionalDependencies": { + "@rollup/rollup-android-arm-eabi": "4.59.0", + "@rollup/rollup-android-arm64": "4.59.0", + "@rollup/rollup-darwin-arm64": "4.59.0", + "@rollup/rollup-darwin-x64": "4.59.0", + "@rollup/rollup-freebsd-arm64": "4.59.0", + "@rollup/rollup-freebsd-x64": "4.59.0", + "@rollup/rollup-linux-arm-gnueabihf": "4.59.0", + "@rollup/rollup-linux-arm-musleabihf": "4.59.0", + "@rollup/rollup-linux-arm64-gnu": "4.59.0", + "@rollup/rollup-linux-arm64-musl": "4.59.0", + "@rollup/rollup-linux-loong64-gnu": "4.59.0", + "@rollup/rollup-linux-loong64-musl": "4.59.0", + "@rollup/rollup-linux-ppc64-gnu": "4.59.0", + "@rollup/rollup-linux-ppc64-musl": "4.59.0", + "@rollup/rollup-linux-riscv64-gnu": "4.59.0", + "@rollup/rollup-linux-riscv64-musl": "4.59.0", + "@rollup/rollup-linux-s390x-gnu": "4.59.0", + "@rollup/rollup-linux-x64-gnu": "4.59.0", + "@rollup/rollup-linux-x64-musl": "4.59.0", + "@rollup/rollup-openbsd-x64": "4.59.0", + "@rollup/rollup-openharmony-arm64": "4.59.0", + "@rollup/rollup-win32-arm64-msvc": "4.59.0", + "@rollup/rollup-win32-ia32-msvc": "4.59.0", + "@rollup/rollup-win32-x64-gnu": "4.59.0", + "@rollup/rollup-win32-x64-msvc": "4.59.0", + "fsevents": "~2.3.2" + } + }, + "node_modules/shiki": { + "version": "3.23.0", + "resolved": "https://registry.npmjs.org/shiki/-/shiki-3.23.0.tgz", + "integrity": "sha512-55Dj73uq9ZXL5zyeRPzHQsK7Nbyt6Y10k5s7OjuFZGMhpp4r/rsLBH0o/0fstIzX1Lep9VxefWljK/SKCzygIA==", + "license": "MIT", + "dependencies": { + "@shikijs/core": "3.23.0", + "@shikijs/engine-javascript": "3.23.0", + "@shikijs/engine-oniguruma": "3.23.0", + "@shikijs/langs": "3.23.0", + "@shikijs/themes": "3.23.0", + "@shikijs/types": "3.23.0", + "@shikijs/vscode-textmate": "^10.0.2", + "@types/hast": "^3.0.4" + } + }, + "node_modules/source-map-js": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz", + "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==", + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/space-separated-tokens": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/space-separated-tokens/-/space-separated-tokens-2.0.2.tgz", + "integrity": "sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/stringify-entities": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/stringify-entities/-/stringify-entities-4.0.4.tgz", + "integrity": "sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg==", + "license": "MIT", + "dependencies": { + "character-entities-html4": "^2.0.0", + "character-entities-legacy": "^3.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/tabbable": { + "version": "6.4.0", + "resolved": "https://registry.npmjs.org/tabbable/-/tabbable-6.4.0.tgz", + "integrity": "sha512-05PUHKSNE8ou2dwIxTngl4EzcnsCDZGJ/iCLtDflR/SHB/ny14rXc+qU5P4mG9JkusiV7EivzY9Mhm55AzAvCg==", + "license": "MIT" + }, + "node_modules/tinyglobby": { + "version": "0.2.15", + "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz", + "integrity": "sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==", + "license": "MIT", + "dependencies": { + "fdir": "^6.5.0", + "picomatch": "^4.0.3" + }, + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/SuperchupuDev" + } + }, + "node_modules/trim-lines": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/trim-lines/-/trim-lines-3.0.1.tgz", + "integrity": "sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/unist-util-is": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/unist-util-is/-/unist-util-is-6.0.1.tgz", + "integrity": "sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-position": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/unist-util-position/-/unist-util-position-5.0.0.tgz", + "integrity": "sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-stringify-position": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/unist-util-stringify-position/-/unist-util-stringify-position-4.0.0.tgz", + "integrity": "sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-visit": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/unist-util-visit/-/unist-util-visit-5.1.0.tgz", + "integrity": "sha512-m+vIdyeCOpdr/QeQCu2EzxX/ohgS8KbnPDgFni4dQsfSCtpz8UqDyY5GjRru8PDKuYn7Fq19j1CQ+nJSsGKOzg==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "unist-util-is": "^6.0.0", + "unist-util-visit-parents": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-visit-parents": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/unist-util-visit-parents/-/unist-util-visit-parents-6.0.2.tgz", + "integrity": "sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "unist-util-is": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/vfile": { + "version": "6.0.3", + "resolved": "https://registry.npmjs.org/vfile/-/vfile-6.0.3.tgz", + "integrity": "sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "vfile-message": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/vfile-message": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/vfile-message/-/vfile-message-4.0.3.tgz", + "integrity": "sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "unist-util-stringify-position": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/vite": { + "version": "7.3.1", + "resolved": "https://registry.npmjs.org/vite/-/vite-7.3.1.tgz", + "integrity": "sha512-w+N7Hifpc3gRjZ63vYBXA56dvvRlNWRczTdmCBBa+CotUzAPf5b7YMdMR/8CQoeYE5LX3W4wj6RYTgonm1b9DA==", + "license": "MIT", + "peer": true, + "dependencies": { + "esbuild": "^0.27.0", + "fdir": "^6.5.0", + "picomatch": "^4.0.3", + "postcss": "^8.5.6", + "rollup": "^4.43.0", + "tinyglobby": "^0.2.15" + }, + "bin": { + "vite": "bin/vite.js" + }, + "engines": { + "node": "^20.19.0 || >=22.12.0" + }, + "funding": { + "url": "https://github.com/vitejs/vite?sponsor=1" + }, + "optionalDependencies": { + "fsevents": "~2.3.3" + }, + "peerDependencies": { + "@types/node": "^20.19.0 || >=22.12.0", + "jiti": ">=1.21.0", + "less": "^4.0.0", + "lightningcss": "^1.21.0", + "sass": "^1.70.0", + "sass-embedded": "^1.70.0", + "stylus": ">=0.54.8", + "sugarss": "^5.0.0", + "terser": "^5.16.0", + "tsx": "^4.8.1", + "yaml": "^2.4.2" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + }, + "jiti": { + "optional": true + }, + "less": { + "optional": true + }, + "lightningcss": { + "optional": true + }, + "sass": { + "optional": true + }, + "sass-embedded": { + "optional": true + }, + "stylus": { + "optional": true + }, + "sugarss": { + "optional": true + }, + "terser": { + "optional": true + }, + "tsx": { + "optional": true + }, + "yaml": { + "optional": true + } + } + }, + "node_modules/vitepress": { + "version": "2.0.0-alpha.16", + "resolved": "https://registry.npmjs.org/vitepress/-/vitepress-2.0.0-alpha.16.tgz", + "integrity": "sha512-w1nwsefDVIsje7BZr2tsKxkZutDGjG0YoQ2yxO7+a9tvYVqfljYbwj5LMYkPy8Tb7YbPwa22HtIhk62jbrvuEQ==", + "license": "MIT", + "peer": true, + "dependencies": { + "@docsearch/css": "^4.5.3", + "@docsearch/js": "^4.5.3", + "@docsearch/sidepanel-js": "^4.5.3", + "@iconify-json/simple-icons": "^1.2.68", + "@shikijs/core": "^3.21.0", + "@shikijs/transformers": "^3.21.0", + "@shikijs/types": "^3.21.0", + "@types/markdown-it": "^14.1.2", + "@vitejs/plugin-vue": "^6.0.3", + "@vue/devtools-api": "^8.0.5", + "@vue/shared": "^3.5.27", + "@vueuse/core": "^14.1.0", + "@vueuse/integrations": "^14.1.0", + "focus-trap": "^7.8.0", + "mark.js": "8.11.1", + "minisearch": "^7.2.0", + "shiki": "^3.21.0", + "vite": "^7.3.1", + "vue": "^3.5.27" + }, + "bin": { + "vitepress": "bin/vitepress.js" + }, + "peerDependencies": { + "markdown-it-mathjax3": "^4", + "oxc-minify": "*", + "postcss": "^8" + }, + "peerDependenciesMeta": { + "markdown-it-mathjax3": { + "optional": true + }, + "oxc-minify": { + "optional": true + }, + "postcss": { + "optional": true + } + } + }, + "node_modules/vue": { + "version": "3.5.30", + "resolved": "https://registry.npmjs.org/vue/-/vue-3.5.30.tgz", + "integrity": "sha512-hTHLc6VNZyzzEH/l7PFGjpcTvUgiaPK5mdLkbjrTeWSRcEfxFrv56g/XckIYlE9ckuobsdwqd5mk2g1sBkMewg==", + "license": "MIT", + "peer": true, + "dependencies": { + "@vue/compiler-dom": "3.5.30", + "@vue/compiler-sfc": "3.5.30", + "@vue/runtime-dom": "3.5.30", + "@vue/server-renderer": "3.5.30", + "@vue/shared": "3.5.30" + }, + "peerDependencies": { + "typescript": "*" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/zwitch": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/zwitch/-/zwitch-2.0.4.tgz", + "integrity": "sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + } + } +} diff --git a/docs/package.json b/docs/package.json new file mode 100644 index 00000000..f1529e11 --- /dev/null +++ b/docs/package.json @@ -0,0 +1,19 @@ +{ + "name": "docs", + "version": "1.0.0", + "description": "", + "main": "config.js", + "scripts": { + "docs:dev": "vitepress dev", + "docs:build": "vitepress build", + "docs:preview": "vitepress preview" + }, + "keywords": [], + "author": "", + "license": "ISC", + "type": "commonjs", + "dependencies": { + "@cakephp/docs-skeleton": "git+ssh://git@github.com:cakephp/docs-skeleton.git#node-package", + "vitepress": "^2.0.0-alpha.16" + } +} diff --git a/docs/pt/conf.py b/docs/pt/conf.py deleted file mode 100644 index 9e22cb01..00000000 --- a/docs/pt/conf.py +++ /dev/null @@ -1,9 +0,0 @@ -import sys, os - -# Append the top level directory of the docs, so we can import from the config dir. -sys.path.insert(0, os.path.abspath('..')) - -# Pull in all the configuration options defined in the global config file.. -from config.all import * - -language = 'pt' diff --git a/docs/pt/contents.rst b/docs/pt/contents.rst deleted file mode 100644 index 10625a2c..00000000 --- a/docs/pt/contents.rst +++ /dev/null @@ -1,7 +0,0 @@ -.. toctree:: - :maxdepth: 2 - :caption: CakePHP Chronos - - /index - - API \ No newline at end of file diff --git a/docs/pt/index.md b/docs/pt/index.md new file mode 100644 index 00000000..526a18d4 --- /dev/null +++ b/docs/pt/index.md @@ -0,0 +1,287 @@ +# Chronos + +O Chronos oferece uma coleção independente de extensões para lidar com o objeto +`DateTime`. Além de métodos de conveniência, o Chronos oferece: + +* Objetos `Date` para representar datas de calendário. +* Objetos *date* e *datetime* imutáveis. +* Um sistema de tradução acoplável. Apenas traduções em inglês estão incluídas + na biblioteca. Todavia, `cakephp/i18n` pode ser usado para suporte completo + a idiomas. + +## Instalação + +Para instalar o Chronos, você deve usar o `composer`. A partir do diretório +*ROOT* de sua aplicação (local onde o arquivo composer.json está localizado) +execute o seguinte comando: +```php +php composer.phar require cakephp/chronos "@stable" +``` + +## Visão geral + +Chronos oferece extensões para lidar com objetos *DateTime* do PHP. 5 classes +cobrem variantes de data/hora mutáveis e imutáveis e uma extensão do objeto +`DateInterval`. + +* `Cake\Chronos\Chronos` é um objeto *date & time* imutável. +* `Cake\Chronos\ChronosDate` é um objeto *date* imutável. +* `Cake\Chronos\MutableDateTime` é um objeto *date and time* mutável. +* `Cake\Chronos\MutableDate` é um objeto *date* mutável. +* `Cake\Chronos\ChronosInterval` é uma extensão do objeto `DateInterval`. + +## Criando instâncias + +Existem várias maneiras de criar instâncias do Chronos ou mesmo, do objeto Date. +Um número considerável de métodos padrão que funcionam com conjuntos diferentes +de argumentos: +```php +use Cake\Chronos\Chronos; + +$now = Chronos::now(); +$today = Chronos::today(); +$yesterday = Chronos::yesterday(); +$tomorrow = Chronos::tomorrow(); + +// Interpreta expressões relativas. +$date = Chronos::parse('+2 days, +3 hours'); + +// Valores inteiros de Date e Time. +$date = Chronos::create(2015, 12, 25, 4, 32, 58); + +// Valores inteiros de Date ou Time. +$date = Chronos::createFromDate(2015, 12, 25); +$date = Chronos::createFromTime(11, 45, 10); + +// Interpreta valores formatados. +$date = Chronos::createFromFormat('m/d/Y', '06/15/2015'); +``` + +## Trabalhando com objetos imutáveis + +Se você é familiarizado com os objetos `DateTime` do PHP, você se sentirá +confortável com objetos *mutáveis*. Além de objetos mutáveis o Chronos também +oferece objetos imutáveis que por sua vez criam cópias de objetos toda vez que +um objeto é modificado. Devido ao fato de que metodos modificadores relativos +a data e hora nem sempre serem transparentes, informações podem ser modificadas +acidentalmente ou sem que o desenvolvedor saiba. Objetos imutáveis previnem +essas alterações acidentais nos dados. Imutabilidade significa que você deverá +lembrar de substituir variáveis usando modificadores: +```php +// Esse código não funciona com objetos imutáveis +$time->addDay(1); +doSomething($time); +return $time; + +// Esse funciona como o esperado +$time = $time->addDay(1); +$time = doSomething($time); +return $time; + +``` +Ao capturar o valor de retorno de cada modificação, seu código funcionará como o +esperado. Se você tem um objeto imutável e quer criar um mutável a partir do +mesmo, use `toMutable()`: +```php +$inplace = $time->toMutable(); +``` + +## Objetos Date + +O PHP disponibiliza um único objeto DateTime. Representar datas de calendário +pode ser um pouco desconfortável por essa classe, uma vez que ela inclui +*timezones* e componentes de hora que realmente não se encaixam no conceito de +'dia'. O Chronos oferece um objeto `Date` para representar datas. A hora e a +zona desse objeto é sempre fixado em `00:00:00 UTC` e todos os métodos de +formatação/diferença operam sob a resolução de dia: +```php +use Cake\Chronos\ChronosDate; + +$today = ChronosDate::today(); + +// Mudanças na hora/timezone são ignoradas +$today->modify('+1 hours'); + +// Exibe '2016-08-15' +echo $today; +``` + +## Métodos modificadores + +Objetos Chronos disponibilizam métodos que permitem a modificação de valores de +forma granular: +```php +// Define componentes do valor datetime +$halloween = Chronos::create() + ->year(2015) + ->month(10) + ->day(31) + ->hour(20) + ->minute(30); + +``` +Você também pode modificar partes da data relativamente: +```php +$future = Chronos::create() + ->addYear(1) + ->subMonth(2) + ->addDays(15) + ->addHours(20) + ->subMinutes(2); + +``` +Também é possível realizar grandes saltos para períodos definidos no tempo: +```php +$time = Chronos::create(); +$time->startOfDay(); +$time->startOfMonth(); +$time->endOfMonth(); +$time->endOfYear(); +$time->startOfWeek(); +$time->endOfWeek(); + +``` +Ou ainda para dias específicos da semana: +```php +$time->next(Chronos::TUESDAY); +$time->previous(Chronos::MONDAY); +``` + +## Métodos de comparação + +Uma vez que você possui 2 instâncias de objetos data/hora do Chronos, é possível +compará-los de várias maneiras: +```php +// Coleção completa de comparadores +// equals, notEquals, greaterThan, greaterThanOrEquals, lessThan, lessThanOrEquals +$first->equals($second); +$first->greaterThanOrEquals($second); + +// Veja se o objeto atual está entre outros +$now->between($start, $end); + +// Encontre qual argumento está mais perto ou mais longe +$now->closest($june, $november); +$now->farthest($june, $november); + +``` +Você também pode arguir sobre quando um determinado valor cai no calendário: +```php +$now->isToday(); +$now->isYesterday(); +$now->isFuture(); +$now->isPast(); + +// Verifica se o dia é no final de semana +$now->isWeekend(); + +// Todos os métodos para outros dias da semana existem também +$now->isMonday(); + +``` +Você também pode verificar se um determinado valor está dentro de um período de +tempo relativo: +```php +$time->wasWithinLast('3 days'); +$time->isWithinNext('3 hours'); +``` + +## Gerando diferenças + +Em adição à comparação de *datetimes*, calcular diferenças ou deltas entre +valores é uma tarefa simples: +```php +// Recebe um DateInterval representando a diferença +$first->diff($second); + +// Recebe a diferença como um contador de unidades específicas +$first->diffInHours($second); +$first->diffInDays($second); +$first->diffInWeeks($second); +$first->diffInYears($second); + +``` +Você pode gerar diferenças de fácil leitura para humanos para usar em um *feed* +ou *timeline*: +```php +// Diferença em relação ao momento atual +echo $date->diffForHumans(); + +// Diferença em relação a outro período no tempo +echo $date->diffForHumans($other); // 1 hora atrás; +``` + +## Formatando strings + +O Chronos disponibiliza métodos para exibir nossos objetos *datetime*: +```php +// Usa o formato controlado por setToStringFormat() +echo $date; + +// Diferentes padrões de formato +echo $time->toAtomString(); // 1975-12-25T14:15:16-05:00 +echo $time->toCookieString(); // Thursday, 25-Dec-1975 14:15:16 EST +echo $time->toIso8601String(); // 1975-12-25T14:15:16-05:00 +echo $time->toRfc822String(); // Thu, 25 Dec 75 14:15:16 -0500 +echo $time->toRfc850String(); // Thursday, 25-Dec-75 14:15:16 EST +echo $time->toRfc1036String(); // Thu, 25 Dec 75 14:15:16 -0500 +echo $time->toRfc1123String(); // Thu, 25 Dec 1975 14:15:16 -0500 +echo $time->toRfc2822String(); // Thu, 25 Dec 1975 14:15:16 -0500 +echo $time->toRfc3339String(); // 1975-12-25T14:15:16-05:00 +echo $time->toRssString(); // Thu, 25 Dec 1975 14:15:16 -0500 +echo $time->toW3cString(); // 1975-12-25T14:15:16-05:00 + +// Recebe o trimestre +echo $time->toQuarter(); // 4; +``` + +## Extraindo componentes de data + +Podemos receber partes de um objeto *date* acessando propriedades: +```php +$time = new Chronos('2015-12-31 23:59:58'); +$time->year; // 2015 +$time->month; // 12 +$time->day; // 31 +$time->hour // 23 +$time->minute // 59 +$time->second // 58 + +``` +Outras propriedades que podem ser acessadas são: + +- timezone +- timezoneName +- micro +- dayOfWeek +- dayOfMonth +- dayOfYear +- daysInMonth +- timestamp +- quarter +- half + +## Auxílio para testes + +Ao escrever testes unitários, fixar a hora atual é bastante útil. O Chronos +lhe permite fixar a hora atual para cada classe. Como parte das suas ferramentas +de testes, você pode incluir o seguinte: +```php +Chronos::setTestNow(Chronos::now()); +MutableDateTime::setTestNow(MutableDateTime::now()); +ChronosDate::setTestNow(ChronosDate::parse(Chronos::now())); +MutableDate::setTestNow(MutableDate::now()); + +``` +Isso irá corrigir a hora atual de todos os objetos para o momento em que o +processo de testes foi iniciado. + +Por exemplo, se você fixar o `Chronos` em algum momento no passado, qualquer +nova instância do `Chronos` criada com `now` ou uma *string* de tempo +relativa, teremos um retorno referente ao tempo fixado: +```php +Chronos::setTestNow(new Chronos('1975-12-25 00:00:00')); + +$time = new Chronos(); // 1975-12-25 00:00:00 +$time = new Chronos('1 hour ago'); // 1975-12-24 23:00:00 +``` diff --git a/docs/pt/index.rst b/docs/pt/index.rst deleted file mode 100644 index 75aaaef7..00000000 --- a/docs/pt/index.rst +++ /dev/null @@ -1,282 +0,0 @@ -Chronos -####### - -O Chronos oferece uma coleção independente de extensões para lidar com o objeto -``DateTime``. Além de métodos de conveniência, o Chronos oferece: - -* Objetos ``Date`` para representar datas de calendário. -* Objetos *date* e *datetime* imutáveis. -* Um sistema de tradução acoplável. Apenas traduções em inglês estão incluídas - na biblioteca. Todavia, ``cakephp/i18n`` pode ser usado para suporte completo - a idiomas. - -Instalação ----------- - -Para instalar o Chronos, você deve usar o ``composer``. A partir do diretório -*ROOT* de sua aplicação (local onde o arquivo composer.json está localizado) -execute o seguinte comando:: - - php composer.phar require cakephp/chronos "@stable" - -Visão geral ------------ - -Chronos oferece extensões para lidar com objetos *DateTime* do PHP. 5 classes -cobrem variantes de data/hora mutáveis e imutáveis e uma extensão do objeto -``DateInterval``. - -* ``Cake\Chronos\Chronos`` é um objeto *date & time* imutável. -* ``Cake\Chronos\ChronosDate`` é um objeto *date* imutável. -* ``Cake\Chronos\MutableDateTime`` é um objeto *date and time* mutável. -* ``Cake\Chronos\MutableDate`` é um objeto *date* mutável. -* ``Cake\Chronos\ChronosInterval`` é uma extensão do objeto ``DateInterval``. - -Criando instâncias ------------------- - -Existem várias maneiras de criar instâncias do Chronos ou mesmo, do objeto Date. -Um número considerável de métodos padrão que funcionam com conjuntos diferentes -de argumentos:: - - use Cake\Chronos\Chronos; - - $now = Chronos::now(); - $today = Chronos::today(); - $yesterday = Chronos::yesterday(); - $tomorrow = Chronos::tomorrow(); - - // Interpreta expressões relativas. - $date = Chronos::parse('+2 days, +3 hours'); - - // Valores inteiros de Date e Time. - $date = Chronos::create(2015, 12, 25, 4, 32, 58); - - // Valores inteiros de Date ou Time. - $date = Chronos::createFromDate(2015, 12, 25); - $date = Chronos::createFromTime(11, 45, 10); - - // Interpreta valores formatados. - $date = Chronos::createFromFormat('m/d/Y', '06/15/2015'); - -Trabalhando com objetos imutáveis ---------------------------------- - -Se você é familiarizado com os objetos ``DateTime`` do PHP, você se sentirá -confortável com objetos *mutáveis*. Além de objetos mutáveis o Chronos também -oferece objetos imutáveis que por sua vez criam cópias de objetos toda vez que -um objeto é modificado. Devido ao fato de que metodos modificadores relativos -a data e hora nem sempre serem transparentes, informações podem ser modificadas -acidentalmente ou sem que o desenvolvedor saiba. Objetos imutáveis previnem -essas alterações acidentais nos dados. Imutabilidade significa que você deverá -lembrar de substituir variáveis usando modificadores:: - - // Esse código não funciona com objetos imutáveis - $time->addDay(1); - doSomething($time); - return $time; - - // Esse funciona como o esperado - $time = $time->addDay(1); - $time = doSomething($time); - return $time; - -Ao capturar o valor de retorno de cada modificação, seu código funcionará como o -esperado. Se você tem um objeto imutável e quer criar um mutável a partir do -mesmo, use ``toMutable()``:: - - $inplace = $time->toMutable(); - -Objetos Date ------------- - -O PHP disponibiliza um único objeto DateTime. Representar datas de calendário -pode ser um pouco desconfortável por essa classe, uma vez que ela inclui -*timezones* e componentes de hora que realmente não se encaixam no conceito de -'dia'. O Chronos oferece um objeto ``Date`` para representar datas. A hora e a -zona desse objeto é sempre fixado em ``00:00:00 UTC`` e todos os métodos de -formatação/diferença operam sob a resolução de dia:: - - use Cake\Chronos\ChronosDate; - - $today = ChronosDate::today(); - - // Mudanças na hora/timezone são ignoradas - $today->modify('+1 hours'); - - // Exibe '2016-08-15' - echo $today; - -Métodos modificadores ---------------------- - -Objetos Chronos disponibilizam métodos que permitem a modificação de valores de -forma granular:: - - // Define componentes do valor datetime - $halloween = Chronos::create() - ->year(2015) - ->month(10) - ->day(31) - ->hour(20) - ->minute(30); - -Você também pode modificar partes da data relativamente:: - - $future = Chronos::create() - ->addYear(1) - ->subMonth(2) - ->addDays(15) - ->addHours(20) - ->subMinutes(2); - -Também é possível realizar grandes saltos para períodos definidos no tempo:: - - $time = Chronos::create(); - $time->startOfDay(); - $time->startOfMonth(); - $time->endOfMonth(); - $time->endOfYear(); - $time->startOfWeek(); - $time->endOfWeek(); - -Ou ainda para dias específicos da semana:: - - $time->next(Chronos::TUESDAY); - $time->previous(Chronos::MONDAY); - -Métodos de comparação ---------------------- - -Uma vez que você possui 2 instâncias de objetos data/hora do Chronos, é possível -compará-los de várias maneiras:: - - // Coleção completa de comparadores - // equals, notEquals, greaterThan, greaterThanOrEquals, lessThan, lessThanOrEquals - $first->equals($second); - $first->greaterThanOrEquals($second); - - // Veja se o objeto atual está entre outros - $now->between($start, $end); - - // Encontre qual argumento está mais perto ou mais longe - $now->closest($june, $november); - $now->farthest($june, $november); - -Você também pode arguir sobre quando um determinado valor cai no calendário:: - - $now->isToday(); - $now->isYesterday(); - $now->isFuture(); - $now->isPast(); - - // Verifica se o dia é no final de semana - $now->isWeekend(); - - // Todos os métodos para outros dias da semana existem também - $now->isMonday(); - -Você também pode verificar se um determinado valor está dentro de um período de -tempo relativo:: - - $time->wasWithinLast('3 days'); - $time->isWithinNext('3 hours'); - -Gerando diferenças ------------------- - -Em adição à comparação de *datetimes*, calcular diferenças ou deltas entre -valores é uma tarefa simples:: - - // Recebe um DateInterval representando a diferença - $first->diff($second); - - // Recebe a diferença como um contador de unidades específicas - $first->diffInHours($second); - $first->diffInDays($second); - $first->diffInWeeks($second); - $first->diffInYears($second); - -Você pode gerar diferenças de fácil leitura para humanos para usar em um *feed* -ou *timeline*:: - - // Diferença em relação ao momento atual - echo $date->diffForHumans(); - - // Diferença em relação a outro período no tempo - echo $date->diffForHumans($other); // 1 hora atrás; - -Formatando strings ------------------- - -O Chronos disponibiliza métodos para exibir nossos objetos *datetime*:: - - // Usa o formato controlado por setToStringFormat() - echo $date; - - // Diferentes padrões de formato - echo $time->toAtomString(); // 1975-12-25T14:15:16-05:00 - echo $time->toCookieString(); // Thursday, 25-Dec-1975 14:15:16 EST - echo $time->toIso8601String(); // 1975-12-25T14:15:16-05:00 - echo $time->toRfc822String(); // Thu, 25 Dec 75 14:15:16 -0500 - echo $time->toRfc850String(); // Thursday, 25-Dec-75 14:15:16 EST - echo $time->toRfc1036String(); // Thu, 25 Dec 75 14:15:16 -0500 - echo $time->toRfc1123String(); // Thu, 25 Dec 1975 14:15:16 -0500 - echo $time->toRfc2822String(); // Thu, 25 Dec 1975 14:15:16 -0500 - echo $time->toRfc3339String(); // 1975-12-25T14:15:16-05:00 - echo $time->toRssString(); // Thu, 25 Dec 1975 14:15:16 -0500 - echo $time->toW3cString(); // 1975-12-25T14:15:16-05:00 - - // Recebe o trimestre - echo $time->toQuarter(); // 4; - -Extraindo componentes de data ------------------------------ - -Podemos receber partes de um objeto *date* acessando propriedades:: - - $time = new Chronos('2015-12-31 23:59:58'); - $time->year; // 2015 - $time->month; // 12 - $time->day; // 31 - $time->hour // 23 - $time->minute // 59 - $time->second // 58 - -Outras propriedades que podem ser acessadas são: - -- timezone -- timezoneName -- micro -- dayOfWeek -- dayOfMonth -- dayOfYear -- daysInMonth -- timestamp -- quarter -- half - -Auxílio para testes -------------------- - -Ao escrever testes unitários, fixar a hora atual é bastante útil. O Chronos -lhe permite fixar a hora atual para cada classe. Como parte das suas ferramentas -de testes, você pode incluir o seguinte:: - - Chronos::setTestNow(Chronos::now()); - MutableDateTime::setTestNow(MutableDateTime::now()); - ChronosDate::setTestNow(ChronosDate::parse(Chronos::now())); - MutableDate::setTestNow(MutableDate::now()); - -Isso irá corrigir a hora atual de todos os objetos para o momento em que o -processo de testes foi iniciado. - -Por exemplo, se você fixar o ``Chronos`` em algum momento no passado, qualquer -nova instância do ``Chronos`` criada com ``now`` ou uma *string* de tempo -relativa, teremos um retorno referente ao tempo fixado:: - - Chronos::setTestNow(new Chronos('1975-12-25 00:00:00')); - - $time = new Chronos(); // 1975-12-25 00:00:00 - $time = new Chronos('1 hour ago'); // 1975-12-24 23:00:00 - diff --git a/docs/public/favicon/apple-touch-icon.png b/docs/public/favicon/apple-touch-icon.png new file mode 100644 index 00000000..c6d073d7 Binary files /dev/null and b/docs/public/favicon/apple-touch-icon.png differ diff --git a/docs/public/favicon/favicon-96x96.png b/docs/public/favicon/favicon-96x96.png new file mode 100644 index 00000000..6642e0cd Binary files /dev/null and b/docs/public/favicon/favicon-96x96.png differ diff --git a/docs/public/favicon/favicon.ico b/docs/public/favicon/favicon.ico new file mode 100644 index 00000000..405aa94c Binary files /dev/null and b/docs/public/favicon/favicon.ico differ diff --git a/docs/public/favicon/favicon.svg b/docs/public/favicon/favicon.svg new file mode 100644 index 00000000..805ef4b8 --- /dev/null +++ b/docs/public/favicon/favicon.svg @@ -0,0 +1,3 @@ + \ No newline at end of file diff --git a/docs/public/favicon/site.webmanifest b/docs/public/favicon/site.webmanifest new file mode 100644 index 00000000..4f23fb31 --- /dev/null +++ b/docs/public/favicon/site.webmanifest @@ -0,0 +1,21 @@ +{ + "name": "CakePHP", + "short_name": "CakePHP", + "icons": [ + { + "src": "/favicon/web-app-manifest-192x192.png", + "sizes": "192x192", + "type": "image/png", + "purpose": "maskable" + }, + { + "src": "/favicon/web-app-manifest-512x512.png", + "sizes": "512x512", + "type": "image/png", + "purpose": "maskable" + } + ], + "theme_color": "#ffffff", + "background_color": "#ffffff", + "display": "standalone" +} \ No newline at end of file diff --git a/docs/public/favicon/web-app-manifest-192x192.png b/docs/public/favicon/web-app-manifest-192x192.png new file mode 100644 index 00000000..b5df2990 Binary files /dev/null and b/docs/public/favicon/web-app-manifest-192x192.png differ diff --git a/docs/public/favicon/web-app-manifest-512x512.png b/docs/public/favicon/web-app-manifest-512x512.png new file mode 100644 index 00000000..6a522de3 Binary files /dev/null and b/docs/public/favicon/web-app-manifest-512x512.png differ diff --git a/docs/public/fonts/cakedingbats-webfont.eot b/docs/public/fonts/cakedingbats-webfont.eot new file mode 100644 index 00000000..0800d1e7 Binary files /dev/null and b/docs/public/fonts/cakedingbats-webfont.eot differ diff --git a/docs/public/fonts/cakedingbats-webfont.svg b/docs/public/fonts/cakedingbats-webfont.svg new file mode 100644 index 00000000..d2afda5e --- /dev/null +++ b/docs/public/fonts/cakedingbats-webfont.svg @@ -0,0 +1,56 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/docs/public/fonts/cakedingbats-webfont.ttf b/docs/public/fonts/cakedingbats-webfont.ttf new file mode 100644 index 00000000..78ad6c88 Binary files /dev/null and b/docs/public/fonts/cakedingbats-webfont.ttf differ diff --git a/docs/public/fonts/cakedingbats-webfont.woff b/docs/public/fonts/cakedingbats-webfont.woff new file mode 100644 index 00000000..a95e1b38 Binary files /dev/null and b/docs/public/fonts/cakedingbats-webfont.woff differ diff --git a/docs/public/fonts/cakedingbats-webfont.woff2 b/docs/public/fonts/cakedingbats-webfont.woff2 new file mode 100644 index 00000000..2cd9fdd0 Binary files /dev/null and b/docs/public/fonts/cakedingbats-webfont.woff2 differ diff --git a/docs/public/icons/batteries_included_chiffon.svg b/docs/public/icons/batteries_included_chiffon.svg new file mode 100644 index 00000000..1972a967 --- /dev/null +++ b/docs/public/icons/batteries_included_chiffon.svg @@ -0,0 +1,15 @@ + + + + + + + + + + + + + + + diff --git a/docs/public/icons/build_quickly_chiffon.svg b/docs/public/icons/build_quickly_chiffon.svg new file mode 100644 index 00000000..d834c9c4 --- /dev/null +++ b/docs/public/icons/build_quickly_chiffon.svg @@ -0,0 +1,22 @@ + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/public/icons/license_chiffon.svg b/docs/public/icons/license_chiffon.svg new file mode 100644 index 00000000..4f4d2f36 --- /dev/null +++ b/docs/public/icons/license_chiffon.svg @@ -0,0 +1,22 @@ + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/public/icons/mvc_chiffon.svg b/docs/public/icons/mvc_chiffon.svg new file mode 100644 index 00000000..78b621f0 --- /dev/null +++ b/docs/public/icons/mvc_chiffon.svg @@ -0,0 +1,42 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/public/icons/no_config_chiffon.svg b/docs/public/icons/no_config_chiffon.svg new file mode 100644 index 00000000..80b5c29a --- /dev/null +++ b/docs/public/icons/no_config_chiffon.svg @@ -0,0 +1,24 @@ + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/public/icons/secure_chiffon.svg b/docs/public/icons/secure_chiffon.svg new file mode 100644 index 00000000..b85f6040 --- /dev/null +++ b/docs/public/icons/secure_chiffon.svg @@ -0,0 +1,16 @@ + + + + + + + + + + + + + + + + diff --git a/docs/public/logo.svg b/docs/public/logo.svg new file mode 100644 index 00000000..829c8e98 --- /dev/null +++ b/docs/public/logo.svg @@ -0,0 +1,27 @@ + + + +