@acailic/vizualni-admin

Serbian Open Data Visualization Tool - Beta Release

About

This is a beta release of the @acailic/vizualni-admin package, based on the visualize-admin/visualization-tool. The package provides utilities and types for working with Serbian open data visualizations, with support for both Cyrillic and Latin scripts.

Installation

npm install @acailic/vizualni-admin

Or using yarn:

yarn add @acailic/vizualni-admin

What's Included

This beta release provides the following standalone utilities:

Locale Utilities

• defaultLocale - Default application locale
• locales - Array of supported locales
• parseLocaleString() - Parse locale strings

TypeScript Types

• Complete configuration types for chart configs
• Type-safe interfaces for data visualization

I18n Support

• Re-exported I18nProvider from @lingui/react

Usage

Basic Example

import { defaultLocale, locales, parseLocaleString } from '@acailic/vizualni-admin';

// Get default locale
console.log(defaultLocale); // 'sr-Latn'

// Get all supported locales
console.log(locales); // ['sr-Latn', 'sr-Cyrl', 'en']

// Parse a locale string
const userLocale = parseLocaleString('sr-Cyrl');
console.log(userLocale); // 'sr-Cyrl'

// Parse with fallback to default
const unknownLocale = parseLocaleString('de');
console.log(unknownLocale); // 'sr-Latn' (falls back to default)

TypeScript Support

The package includes full TypeScript declarations:

import type { Locale } from '@acailic/vizualni-admin';

// Locale is a union type: "sr-Latn" | "sr-Cyrl" | "en"
const myLocale: Locale = 'sr-Latn';

With React

import { I18nProvider } from '@acailic/vizualni-admin';
import { i18n } from '@lingui/core';

function App() {
  return (
    <I18nProvider i18n={i18n}>
      {/* Your app content */}
    </I18nProvider>
  );
}

What's NOT Included (Yet)

This is a minimal beta release focusing on core utilities. The following features are planned for future releases:

• Configurator components
• Chart components
• Full Next.js application components
• CLI tools
• Additional utilities

These components will be refactored for standalone usage in upcoming releases.

Supported Locales

The package supports three locales:

• sr-Latn (Serbian Latin) - Default
• sr-Cyrl (Serbian Cyrillic)
• en (English)

Requirements

Peer Dependencies

{
  "@babel/runtime": "^7.8.4",
  "next": "^13.0.0",
  "react": "^18.2.0",
  "react-dom": "^18.2.0"
}

External Dependencies

The following are marked as external and should be installed separately if needed:

• @lingui/react
• @lingui/core
• d3-format
• d3-time-format
• make-plural
• fp-ts
• io-ts

Module Formats

The package is published in multiple formats for maximum compatibility:

• CommonJS (dist/index.js) - For Node.js
• ES Modules (dist/index.mjs) - For modern bundlers
• TypeScript (dist/index.d.ts) - Type declarations

Contributing

Contributions are welcome! Please see the main repository for contribution guidelines.

Related Projects

• visualize-admin/visualization-tool - Original upstream project
• data.gov.rs - Serbian Open Data Portal

License

BSD-3-Clause - See LICENSE for details.

Repository

https://github.com/acailic/vizualni-admin

Issues

Report bugs and request features at: https://github.com/acailic/vizualni-admin/issues

Changelog

See CHANGELOG.md for release history.