@stdlib/string-dotcase 0.0.4 → 0.1.0

package/CITATION.cff

@@ -0,0 +1,30 @@
+cff-version: 1.2.0
+title: stdlib
+message: >-
+  If you use this software, please cite it using the
+  metadata from this file.
+
+type: software
+
+authors:
+  - name: The Stdlib Authors
+    url: https://github.com/stdlib-js/stdlib/graphs/contributors
+
+repository-code: https://github.com/stdlib-js/stdlib
+url: https://stdlib.io
+
+abstract: |
+  Standard library for JavaScript and Node.js.
+
+keywords:
+  - JavaScript
+  - Node.js
+  - TypeScript
+  - standard library
+  - scientific computing
+  - numerical computing
+  - statistical computing
+
+license: Apache-2.0 AND BSL-1.0
+
+date-released: 2016

package/NOTICE

@@ -1 +1 @@
-Copyright (c) 2016-2023 The Stdlib Authors.
+Copyright (c) 2016-2023 The Stdlib Authors.

package/README.md

@@ -1,31 +1,42 @@
-<!--
-
-@license Apache-2.0
-
-Copyright (c) 2023 The Stdlib Authors.
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-   http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
-
--->
-
-# dotcase
-
+<!--
+
+@license Apache-2.0
+
+Copyright (c) 2023 The Stdlib Authors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+-->
+
+
+<details>
+  <summary>
+    About stdlib...
+  </summary>
+  <p>We believe in a future in which the web is a preferred environment for numerical computation. To help realize this future, we've built stdlib. stdlib is a standard library, with an emphasis on numerical and scientific computation, written in JavaScript (and C) for execution in browsers and in Node.js.</p>
+  <p>The library is fully decomposable, being architected in such a way that you can swap out and mix and match APIs and functionality to cater to your exact preferences and use cases.</p>
+  <p>When you use stdlib, you can be absolutely certain that you are using the most thorough, rigorous, well-written, studied, documented, tested, measured, and high-quality code out there.</p>
+  <p>To join us in bringing numerical computing to the web, get started by checking us out on <a href="https://github.com/stdlib-js/stdlib">GitHub</a>, and please consider <a href="https://opencollective.com/stdlib">financially supporting stdlib</a>. We greatly appreciate your continued support!</p>
+</details>
+
+# dotcase
+
 [![NPM version][npm-image]][npm-url] [![Build Status][test-image]][test-url] [![Coverage Status][coverage-image]][coverage-url] <!-- [![dependencies][dependencies-image]][dependencies-url] -->
 
-> Convert a string to dot case.
-
-<!-- Package usage documentation. -->
-
+> Convert a string to dot case.
+
+<!-- Package usage documentation. -->
+
 <section class="installation">
 
 ## Installation
@@ -36,81 +47,79 @@ npm install @stdlib/string-dotcase
 
 </section>
 
-<section class="usage">
-
-## Usage
-
-```javascript
-var dotcase = require( '@stdlib/string-dotcase' );
-```
-
-#### dotcase( str )
-
-Converts a string to dot case.
-
-```javascript
-var out = dotcase( 'foo bar' );
-// returns 'foo.bar'
-
-out = dotcase( 'IS_MOBILE' );
-// returns 'is.mobile'
-
-out = dotcase( 'Hello World!' );
-// returns 'hello.world'
-
-out = dotcase( '--foo-bar--' );
-// returns 'foo.bar'
-```
-
-</section>
-
-<!-- /.usage -->
-
-<!-- Package usage examples. -->
-
-<section class="examples">
-
-## Examples
-
-```javascript
-var dotcase = require( '@stdlib/string-dotcase' );
-
-var str = 'Hello World!';
-var out = dotcase( str );
-// returns 'hello.world'
-
-str = 'HELLO WORLD!';
-out = dotcase( str );
-// returns 'hello.world'
-
-str = 'To be, or not to be: that is the question.';
-out = dotcase( str );
-// returns 'to.be.or.not.to.be.that.is.the.question'
-```
-
-</section>
-
-<!-- /.examples -->
-
-* * *
-
-
-
-<!-- Section for related `stdlib` packages. Do not manually edit this section, as it is automatically populated. -->
-
+<section class="usage">
+
+## Usage
+
+```javascript
+var dotcase = require( '@stdlib/string-dotcase' );
+```
+
+#### dotcase( str )
+
+Converts a string to dot case.
+
+```javascript
+var out = dotcase( 'foo bar' );
+// returns 'foo.bar'
+
+out = dotcase( 'IS_MOBILE' );
+// returns 'is.mobile'
+
+out = dotcase( 'Hello World!' );
+// returns 'hello.world'
+
+out = dotcase( '--foo-bar--' );
+// returns 'foo.bar'
+```
+
+</section>
+
+<!-- /.usage -->
+
+<!-- Package usage examples. -->
+
+<section class="examples">
+
+## Examples
+
+```javascript
+var dotcase = require( '@stdlib/string-dotcase' );
+
+var str = 'Hello World!';
+var out = dotcase( str );
+// returns 'hello.world'
+
+str = 'HELLO WORLD!';
+out = dotcase( str );
+// returns 'hello.world'
+
+str = 'To be, or not to be: that is the question.';
+out = dotcase( str );
+// returns 'to.be.or.not.to.be.that.is.the.question'
+```
+
+</section>
+
+<!-- /.examples -->
+
+
+
+<!-- Section for related `stdlib` packages. Do not manually edit this section, as it is automatically populated. -->
+
 <section class="related">
 
 ## See Also
 
 -   <span class="package-name">[`@stdlib/string-dotcase-cli`][@stdlib/string-dotcase-cli]</span><span class="delimiter">: </span><span class="description">CLI package for use as a command-line utility.</span>
-
-
-</section>
-
-<!-- /.related -->
-
-<!-- Section for all links. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
-
+
+
+</section>
+
+<!-- /.related -->
+
+<!-- Section for all links. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
 
 <section class="main-repo" >
 
@@ -150,8 +159,8 @@ Copyright &copy; 2016-2023. The Stdlib [Authors][stdlib-authors].
 [npm-image]: http://img.shields.io/npm/v/@stdlib/string-dotcase.svg
 [npm-url]: https://npmjs.org/package/@stdlib/string-dotcase
 
-[test-image]: https://github.com/stdlib-js/string-dotcase/actions/workflows/test.yml/badge.svg?branch=v0.0.4
-[test-url]: https://github.com/stdlib-js/string-dotcase/actions/workflows/test.yml?query=branch:v0.0.4
+[test-image]: https://github.com/stdlib-js/string-dotcase/actions/workflows/test.yml/badge.svg?branch=v0.1.0
+[test-url]: https://github.com/stdlib-js/string-dotcase/actions/workflows/test.yml?query=branch:v0.1.0
 
 [coverage-image]: https://img.shields.io/codecov/c/github/stdlib-js/string-dotcase/main.svg
 [coverage-url]: https://codecov.io/github/stdlib-js/string-dotcase?branch=main
@@ -182,12 +191,12 @@ Copyright &copy; 2016-2023. The Stdlib [Authors][stdlib-authors].
 [esm-url]: https://github.com/stdlib-js/string-dotcase/tree/esm
 [branches-url]: https://github.com/stdlib-js/string-dotcase/blob/main/branches.md
 
-[stdlib-license]: https://raw.githubusercontent.com/stdlib-js/string-dotcase/main/LICENSE
-
-[standard-streams]: https://en.wikipedia.org/wiki/Standard_streams
-
-[mdn-regexp]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions
-
-</section>
-
-<!-- /.links -->
+[stdlib-license]: https://raw.githubusercontent.com/stdlib-js/string-dotcase/main/LICENSE
+
+[standard-streams]: https://en.wikipedia.org/wiki/Standard_streams
+
+[mdn-regexp]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions
+
+</section>
+
+<!-- /.links -->

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+/// <reference path="../docs/types/index.d.ts" />
+import dotcase from '../docs/types/index';
+export = dotcase;

package/dist/index.js

@@ -0,0 +1,5 @@
+"use strict";var a=function(r,e){return function(){return e||r((e={exports:{}}).exports,e),e.exports}};var t=a(function(c,i){
+var s=require('@stdlib/assert-is-string/dist').isPrimitive,u=require('@stdlib/error-tools-fmtprodmsg/dist'),n=require('@stdlib/string-base-dotcase/dist');function o(r){if(!s(r))throw new TypeError(u('1gn3F',r));return n(r)}i.exports=o
+});var m=t();module.exports=m;
+/** @license Apache-2.0 */
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../lib/main.js", "../lib/index.js"],
+  "sourcesContent": ["/**\n* @license Apache-2.0\n*\n* Copyright (c) 2023 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar isString = require( '@stdlib/assert-is-string' ).isPrimitive;\nvar format = require( '@stdlib/string-format' );\nvar base = require( '@stdlib/string-base-dotcase' );\n\n\n// MAIN //\n\n/**\n* Converts a string to dot case.\n*\n* @param {string} str - string to convert\n* @throws {TypeError} must provide a string\n* @returns {string} dot-cased string\n*\n* @example\n* var out = dotcase( 'foo bar' );\n* // returns 'foo.bar'\n*\n* @example\n* var out = dotcase( 'IS_MOBILE' );\n* // returns 'is.mobile'\n*\n* @example\n* var out = dotcase( 'Hello World!' );\n* // returns 'hello.world'\n*\n* @example\n* var out = dotcase( '--foo-bar--' );\n* // returns 'foo.bar'\n*/\nfunction dotcase( str ) {\n\tif ( !isString( str ) ) {\n\t\tthrow new TypeError( format( 'invalid argument. First argument must be a string. Value: `%s`.', str ) );\n\t}\n\treturn base( str );\n}\n\n\n// EXPORTS //\n\nmodule.exports = dotcase;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2023 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n/**\n* Convert a string to dot case.\n*\n* @module @stdlib/string-dotcase\n*\n* @example\n* var dotcase = require( '@stdlib/string-dotcase' );\n*\n* var str = dotcase( 'foo bar' );\n* // returns 'foo.bar'\n*\n* str = dotcase( '--foo-bar--' );\n* // returns 'foo.bar'\n*\n* str = dotcase( 'Hello World!' );\n* // returns 'hello.world'\n*/\n\n// MODULES //\n\nvar main = require( './main.js' );\n\n\n// EXPORTS //\n\nmodule.exports = main;\n"],
+  "mappings": "uGAAA,IAAAA,EAAAC,EAAA,SAAAC,EAAAC,EAAA,cAsBA,IAAIC,EAAW,QAAS,0BAA2B,EAAE,YACjDC,EAAS,QAAS,uBAAwB,EAC1CC,EAAO,QAAS,6BAA8B,EA4BlD,SAASC,EAASC,EAAM,CACvB,GAAK,CAACJ,EAAUI,CAAI,EACnB,MAAM,IAAI,UAAWH,EAAQ,kEAAmEG,CAAI,CAAE,EAEvG,OAAOF,EAAME,CAAI,CAClB,CAKAL,EAAO,QAAUI,ICtBjB,IAAIE,EAAO,IAKX,OAAO,QAAUA",
+  "names": ["require_main", "__commonJSMin", "exports", "module", "isString", "format", "base", "dotcase", "str", "main"]
+}

package/docs/types/index.d.ts

@@ -1,44 +1,44 @@
-/*
-* @license Apache-2.0
-*
-* Copyright (c) 2023 The Stdlib Authors.
-*
-* Licensed under the Apache License, Version 2.0 (the "License");
-* you may not use this file except in compliance with the License.
-* You may obtain a copy of the License at
-*
-*    http://www.apache.org/licenses/LICENSE-2.0
-*
-* Unless required by applicable law or agreed to in writing, software
-* distributed under the License is distributed on an "AS IS" BASIS,
-* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-* See the License for the specific language governing permissions and
-* limitations under the License.
-*/
-
-// TypeScript Version: 2.0
-
-/**
-* Converts a string to dot case.
-*
-* @param str - string to convert
-* @returns dot-cased string
-*
-* @example
-* var str = dotcase( 'Hello World!' );
-* // returns 'hello.world'
-*
-* @example
-* var str = dotcase( 'foo_bar' );
-* // returns 'foo.bar'
-*
-* @example
-* var str = dotcase( 'foo-bar' );
-* // returns 'foo.bar'
-*/
-declare function dotcase( str: string ): string;
-
-
-// EXPORTS //
-
-export = dotcase;
+/*
+* @license Apache-2.0
+*
+* Copyright (c) 2023 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+// TypeScript Version: 4.1
+
+/**
+* Converts a string to dot case.
+*
+* @param str - string to convert
+* @returns dot-cased string
+*
+* @example
+* var str = dotcase( 'Hello World!' );
+* // returns 'hello.world'
+*
+* @example
+* var str = dotcase( 'foo_bar' );
+* // returns 'foo.bar'
+*
+* @example
+* var str = dotcase( 'foo-bar' );
+* // returns 'foo.bar'
+*/
+declare function dotcase( str: string ): string;
+
+
+// EXPORTS //
+
+export = dotcase;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stdlib/string-dotcase",
-  "version": "0.0.4",
+  "version": "0.1.0",
   "description": "Convert a string to dot case.",
   "license": "Apache-2.0",
   "author": {
@@ -37,10 +37,9 @@
     "url": "https://github.com/stdlib-js/stdlib/issues"
   },
   "dependencies": {
-    "@stdlib/assert-is-string": "^0.0.8",
-    "@stdlib/string-base-dotcase": "^0.0.1",
-    "@stdlib/string-format": "^0.0.3",
-    "@stdlib/error-tools-fmtprodmsg": "^0.0.2"
+    "@stdlib/assert-is-string": "^0.1.0",
+    "@stdlib/string-base-dotcase": "^0.1.0",
+    "@stdlib/string-format": "^0.1.0"
   },
   "devDependencies": {
     "tape": "git+https://github.com/kgryte/tape.git#fix/globby",