npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@shapediver/sdk.sdtf-primitives

v1.5.3

Published

Extension containing sdTF primitive types

Downloads

788

Readme

Structured Data Transfer Format - Integration for primitive types

The Structured Data Transfer Format (sdTF) is an API-neutral exchange and storage format for trees of data items as used by parametric 3D modeling software like Grasshopper®. This open, efficient, and easily extensible data format enables the exchange of complex data structures, independent of software vendors. See the sdTF documentation for more details.

The aim of this package is to extend the sdTF-v1 module to provide processing and typing functionality for primitive data.

It can be used in Node.js and modern Browsers, and exposes the respective TypeScript declarations.

Installation

npm i @shapediver/sdk.sdtf-v1 @shapediver/sdk.sdtf-primitives

This package is a plugin for the sdTF-v1 module and cannot be used by itself.

Usage

This code initializes the SDK and registers the integration for primitive types. After this step, the integration is fully included in all reading and writing processes of the SDK instance.

// index.ts
import { create, SdtfSdk } from "@shapediver/sdk.sdtf-v1"
import { SdtfPrimitiveTypeIntegration } from "@shapediver/sdk.sdtf-primitives"

(async () => {
    const sdk: SdtfSdk = await create({
        integrations: [ new SdtfPrimitiveTypeIntegration() ]
    })

    // Use the sdk here
})()

Supported types

The following table lists all type hints that are supported by this integration, their specific TypeScript types, and the provided type guard functions that can be used to infer a data content type.

| Type hint name | TypeScript type | Type guard | |----------------------------------------------------|------------------------------------|---------------------------------------------------------------------------------| | "boolean" or SdtfPrimitiveTypeHintName.BOOLEAN | boolean | SdtfPrimitiveTypeGuard.assertBooleanSdtfPrimitiveTypeGuard.isBoolean | | "char" or SdtfPrimitiveTypeHintName.CHAR | string | SdtfPrimitiveTypeGuard.assertStringSdtfPrimitiveTypeGuard.isString | | "color" or SdtfPrimitiveTypeHintName.COLOR | [number, number, number, number] | SdtfPrimitiveTypeGuard.assertColorSdtfPrimitiveTypeGuard.isColor | | "data" or SdtfPrimitiveTypeHintName.DATA | DataView | SdtfPrimitiveTypeGuard.assertDataViewSdtfPrimitiveTypeGuard.isDataView | | "decimal" or SdtfPrimitiveTypeHintName.DECIMAL | number | SdtfPrimitiveTypeGuard.assertNumberSdtfPrimitiveTypeGuard.isNumber | | "double" or SdtfPrimitiveTypeHintName.DOUBLE | number | SdtfPrimitiveTypeGuard.assertNumberSdtfPrimitiveTypeGuard.isNumber | | "guid" or SdtfPrimitiveTypeHintName.GUID | string | SdtfPrimitiveTypeGuard.assertStringSdtfPrimitiveTypeGuard.isString | | "image" or SdtfPrimitiveTypeHintName.IMAGE | DataView | SdtfPrimitiveTypeGuard.assertDataViewSdtfPrimitiveTypeGuard.isDataView | | "int8" or SdtfPrimitiveTypeHintName.INT8 | number | SdtfPrimitiveTypeGuard.assertNumberSdtfPrimitiveTypeGuard.isNumber | | "int16" or SdtfPrimitiveTypeHintName.INT16 | number | SdtfPrimitiveTypeGuard.assertNumberSdtfPrimitiveTypeGuard.isNumber | | "int32" or SdtfPrimitiveTypeHintName.INT32 | number | SdtfPrimitiveTypeGuard.assertNumberSdtfPrimitiveTypeGuard.isNumber | | "int64" or SdtfPrimitiveTypeHintName.INT64 | number | SdtfPrimitiveTypeGuard.assertNumberSdtfPrimitiveTypeGuard.isNumber | | "single" or SdtfPrimitiveTypeHintName.SINGLE | number | SdtfPrimitiveTypeGuard.assertNumberSdtfPrimitiveTypeGuard.isNumber | | "string" or SdtfPrimitiveTypeHintName.STRING | string | SdtfPrimitiveTypeGuard.assertStringSdtfPrimitiveTypeGuard.isString | | "uint8" or SdtfPrimitiveTypeHintName.UINT8 | number | SdtfPrimitiveTypeGuard.assertNumberSdtfPrimitiveTypeGuard.isNumber | | "uint16" or SdtfPrimitiveTypeHintName.UINT16 | number | SdtfPrimitiveTypeGuard.assertNumberSdtfPrimitiveTypeGuard.isNumber | | "uint32" or SdtfPrimitiveTypeHintName.UINT32 | number | SdtfPrimitiveTypeGuard.assertNumberSdtfPrimitiveTypeGuard.isNumber | | "uint64" or SdtfPrimitiveTypeHintName.UINT64 | number | SdtfPrimitiveTypeGuard.assertNumberSdtfPrimitiveTypeGuard.isNumber |

Additionally, the type guard SdtfPrimitiveTypeGuard provides functions to infer type hints by their respective TypeScript type:

typeGuard.isBooleanType:
Returns true when the given type hint name is SdtfPrimitiveTypeHintName.BOOLEAN.

typeGuard.isStringType:
Returns true when the given type hint name is of

  • SdtfPrimitiveTypeHintName.CHAR
  • SdtfPrimitiveTypeHintName.GUID
  • SdtfPrimitiveTypeHintName.STRING

typeGuard.isNumberType:
Returns true when the given type hint name is of

  • SdtfPrimitiveTypeHintName.DECIMAL
  • SdtfPrimitiveTypeHintName.DOUBLE
  • SdtfPrimitiveTypeHintName.SINGLE
  • SdtfPrimitiveTypeHintName.INT8
  • SdtfPrimitiveTypeHintName.INT16
  • SdtfPrimitiveTypeHintName.INT32
  • SdtfPrimitiveTypeHintName.INT64
  • SdtfPrimitiveTypeHintName.UINT8
  • SdtfPrimitiveTypeHintName.UINT16
  • SdtfPrimitiveTypeHintName.UINT32
  • SdtfPrimitiveTypeHintName.UINT64

typeGuard.isColorType:
Returns true when the given type hint name is SdtfPrimitiveTypeHintName.COLOR.

typeGuard.isDataViewType:
Returns true when the given type hint name is of

  • SdtfPrimitiveTypeHintName.DATA
  • SdtfPrimitiveTypeHintName.IMAGE

Example

This simple example reads a sdTF file and extracts the content of all data items which contain a numeric type hint. Since the extracted content data is of type unknown, a type guard function is used to check and infer the content type to number. The numbers are then summed up and shown on the console.
If any data item has a numeric type hint but does not contain numeric data, a corresponding error is thrown.

// index.ts
import { create, SdtfSdk } from "@shapediver/sdk.sdtf-v1"
import { SdtfPrimitiveTypeIntegration, SdtfPrimitiveTypeGuard } from "@shapediver/sdk.sdtf-primitives"

(async () => {
    const sdk: SdtfSdk = await create({
        integrations: [ new SdtfPrimitiveTypeIntegration() ]
    })

    // Reads the example file given in the sdTF specification v1:
    // https://github.com/shapediver/sdTF/tree/development/specification/1.0#a-complete-example
    const asset = await sdk.createParser().readFromFile("./test_data/sdTF_spec_example.sdtf")

    // Filter all data items with a numeric type hint (does not check the content!)
    const numericData = asset.items.filter(dataItem => SdtfPrimitiveTypeGuard.isNumberType(dataItem.typeHint?.name))

    let sum: number = 0
    for (const dataItem of numericData) {
        const content = await dataItem.getContent()             // load data content of type `unknown`
        SdtfPrimitiveTypeGuard.assertNumber(content)            // infers content to type `number`; throws if not possible
        sum += content                                          // add to sum
    }

    console.log("The sum of all numeric data content is", sum)  // Prints out: "The sum of all numeric data content is 479"
})()

Support

If you have questions, please use the ShapeDiver Help Center.

You can find out more about ShapeDiver right here.

Licensing

This project is released under the MIT License.